docutils/reStructuredText 템플릿 기능

Question

.rst 파일의 자리 표시자를 어떻게 실제 값으로 사용자 정의 할 수 있습니까? 나는 그것을인지 궁금 또한

rst2html example.rst -o example.html -Dcustom_text="this is the value of custom property" 

: 나는 다음 명령을 실행하여 값 this is the value of custom property와 ${custom_text} 속성을 대체 할

Header 
------------------------------------ 
${custom_text} 

: 예를 들어

, 나는 다음과 같은 내용으로 example.rst 파일이 파일 .properties을 사용하여 템플릿을 사용자 정의 할 수 있습니까? 예를 들어, 나는 다음과 같은 내용으로 example.properties 파일을 사용하여 rst2html example.rst -o example.html -p example.properties 명령을 실행하고 싶습니다 : 가능

custom_text=this is the value of custom property 

인가? reStructuredText는 템플릿 기능을 전혀 지원합니까?

편집 : 내가 명령 줄이나 기존의 .properties 파일을 사용하는 템플릿을 사용자 정의 할 수 있습니다 (관리 도구를 구축 개미/Maven을 사용할 수 있습니다).

Answer 1

replace 지시문을 사용하여 reStructuredText 파일에서 대체가 수행됩니다. 예를 들어 :

I am using |RST|. 

.. |RST| replace:: reStructuredText 

내가 reStructuredText를 사용하고있는 텍스트

가 발생합니다.

include 지시어를 사용하면 별도의 파일에 대체 템플릿 목록을 정의 할 수 있습니다.

Header 
====== 

.. Include templates from external file (this is a comment). 
.. include:: properties.rst 

I can include text, like |my custom text|, from other files. 

문서가 발생합니다

.. |my custom text| replace:: "example text" 

을 properties.rst : example.rst

예를 들어, 다음 두 파일 주어진

헤더

다른 파일의 "예제 텍스트"와 같은 텍스트를 포함 할 수 있습니다.

여기에서 rst2html.py example.rst 명령을 사용하여 HTML 출력을 생성했습니다.