Включение / включение в Sphinx статического генератора документов? - PullRequest
0 голосов
/ 27 сентября 2018

Я пишу документацию для семейства продуктов.Некоторые из подразделов идентичны для некоторых различных продуктов.Я хотел бы иметь возможность написать текст один раз и «включить» один и тот же текст на разных страницах, чтобы я не прерывал работу читателя, перепрыгивая в другое место, а затем возвращался обратно.

Бонусные баллы, если включенный текст может принимать «параметры».

Пример иерархии документов и текста:

  • Как чистить зубы взрослой зубной щеткой

    Go to the a drug store and buy an adult toothbrush. #include('common', 'adult toothbrush') Brush for 3 minutes.

  • Как чистить зубы детской зубной щеткой

    Ask your parent to go to the drug store and buy a kid toothbrush. #include('common', 'kid toothbrush') Brush until your parent says you are done.

Где обычноэто что-то вроде:

Put some toothpaste on your $arg1.

Из того, что я могу сказать, это не встроенная функциональность.Можно ли это сделать с расширением?

...