이 설명서에 관하여¶
이 설명서는 구현된 도구와 의도적으로 정한 한계를 설명합니다. 제안, 결정, 검토 이력은 별도의 GDS 프로젝트에 기록합니다. 조판을 개선한다고 제안의 상태가 바뀌지는 않습니다.
실제 사용 흐름에 맞춰 구성했습니다. 튜토리얼로 배우고, 주제별 안내로 이해하고, 작업 안내로 실행하며, 참고 문서에서 세부 사항을 확인합니다. 내부 구조에서는 불변 조건과 증명을 설명합니다.
작은 예제를 들고, 가정을 명시하며, 요점을 직접 설명합니다. 독자가 직접 확인할 수 있는 설명을 지향합니다. 절제된 색상, 뚜렷한 제목, 읽기 편한 세리프 글꼴, 접근성을 고려한 탐색 기능을 사용합니다. 특정 저자의 문장이나 지면을 모방하지는 않습니다.
이 프로젝트는 guidedog quickstart로 만들었으며 Guidedog로 빌드합니다. 본문은 RST, 도표는 Graphviz, 수식은 LaTeX 수학 표기법으로 작성합니다. Typst는 PDF 조판 템플릿에만 사용합니다.
빌드 검증 기록¶
2026-10-01 원격 검증에서 CPython, Django, Flask의 HTML과 PDF를 각각 새로 빌드하고 증분 빌드했습니다. 명령 12개가 모두 성공했으며 진단과 링크 검사 결과는 기존 기준과 일치했습니다. Linux 테스트 1,039개와 대상별 sanitizer 테스트 94개가 통과했습니다. 이는 검사한 버전의 동작을 뒷받침할 뿐, Sphinx와 완전히 호환된다는 뜻은 아닙니다. 남은 한계는 Sphinx 호환성를 참조하세요.
문서 유지 관리 명령은 이 문서 관리하기에 있습니다.