Особенности шаблона documenttils / reStructuredText - PullRequest
Новая
       75

Особенности шаблона documenttils / reStructuredText

0 голосов
/ 19 марта 2012

Как я могу настроить заполнители в моем файле .rst с фактическими значениями?

Например, у меня есть example.rst файл со следующим содержанием: 

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

Я хочу заменить свойство ${custom_text} значением this is the value of custom property, выполнив следующую команду: 

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

Также мне интересно, можно ли настроить шаблон, используя файл .properties? Например, я хотел бы запустить команду rst2html example.rst -o example.html -p example.properties, используя файл example.properties со следующим содержанием: 

custom_text=this is the value of custom property

Возможно ли это? Поддерживает ли reStructuredText функции шаблона вообще?

РЕДАКТИРОВАТЬ: Обратите внимание, что я хочу настроить шаблон из командной строки или с использованием обычного .properties файла (может использоваться инструментом управления сборкой Ant / Maven).

1 Ответ

9 голосов
/ 20 марта 2012

Подстановка в файлах reStructuredText выполняется с использованием директивы replace.Например: 

I am using |RST|.

.. |RST| replace:: reStructuredText

приведет к тексту

Я использую reStructuredText.

Вы можете использовать include директива для определения списка шаблонов замещения в отдельном файле.Например, для следующих двух файлов:

example.rst : 

Header
======

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

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

properties.rst 

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

приведет к документу:

Заголовок

Я могу включить текст, например, «пример текста», из других файлов.

Здесь я использовал команду rst2html.py example.rst для генерации вывода HTML.

...