RST 형식의 문서를 작성하고 Sphinx를 사용하여 HTML을 생성 중입니다.RST에서 Sphinx Documentation의 텍스트 재사용
RST 파일에 단락을 쓰고 동일한 단락의 다른 RST 파일에서 같은 단락을 다시 사용하고 싶습니다. 재사용을 원한다면 원본 단락을 변경하면 자동으로 Sphinx를 사용하여 HTML을 생성 할 때 참조 된 다른 모든 파일이 변경되어야합니다.
이렇게하려면 RST 구문이 있습니까? 어떤 도움을 주셔서 감사합니다.
include directive을 사용할 수 있습니다.
는 기본 포함를 들어, 다음과 같이 다시 사용하려는 단락 참조 :
Some text
.. include:: /path/to/file_to_include.rst
More text
우리의 예에서는, file_to_include.rst의 내용이 Included text입니다. 스핑크스 생성합니다 (위 링크)를 docutils 문서에서 볼 수 있듯이 예 라인의 범위에 포함 된 텍스트를 제한하기 위해, 당신은 선택적 옵션 세트를 지정할 수 있습니다
Some text
Included text
More text
.
고마워요! 전체 텍스트를 추가하고 시작 줄 또는 끝 줄을 추가 할 수도 있습니다. 그러나 범위를 표시하기위한 매개 변수로 시작 줄과 끝 줄을 모두 추가하면 나타나지 않습니다. 내가 사용하는 구문은 다음과 같습니다. include ... includedtext.rst : start-line : 11 \t \t : end-line : 14 – Ashwin
잘 작동합니다. 이슈를 재현하고 Sphinx/Docutils 버전을 제공 할 수있는 예제 프로젝트에 연결할 수 있습니까? 줄 번호를 올바르게 지정 하시겠습니까? 라인 수는 0부터 시작합니다. 'end-line'은 포함되지 않습니다. –
감사합니다! – Ashwin