система шаблонов документации wiki/docbook/latex

Question

Я ищу систему шаблонов документации или, скорее, буду ее создавать.Он должен поддерживать следующие функции:

• Создание вывода в формате PDF и HTML
• Поддержка больших и сложных формул (LaTeX)
• Ссылки между документами
• Библиографии
• Шаблоны будут заполнены скриптом Python.

Я пробовал LaTeX с различными конвертерами TeX-HTML, но результаты меня не удовлетворили.Я использую DocBook некоторое время, но считаю, что редактировать DocBook непросто, а поддержка формул еще недостаточна.

Основная проблема в том, что найдутся пользователи этой системы, которые не знают синтаксиса LaTeX или DocBook.Я подумал об альтернативе для этих пользователей, предоставляющей возможность редактирования с помощью синтаксиса Wiki (преобразованного Python в LaTeX).

Подведем итоги:Мне нужен вывод HTML и PDF, по крайней мере, из ввода LaTeX и Wiki.DocBook можно использовать в качестве промежуточного формата.

Была ли у кого-нибудь подобная проблема или кто-нибудь может дать мне совет, какие инструменты и форматы файлов мне следует использовать?

Answer 1

Мы используем сфинкса: http://sphinx.pocoo.org

Он делает почти все это.

Ваш скрипт Python, ваши пользователи или кто-то еще (я не могу понять вопрос) могут создавать контент, используя RST-разметка (это, пожалуй, самый простой из языков разметки).Вы запускаете его через Sphinx и получаете HTML и Latex.

Answer 2

Я создал препроцессор LaTeX и модуль Python, который позволяет встраивать Python или SQL в файл LaTeX.Выполняется Python и/или SQL, и выходные данные сворачиваются.

С помощью latex2html или latex2rtf вы можете использовать код LaTeX для создания HTM и RTF.

Я разместил это для вас на http://simson.net/pylatex/

Answer 3

Арбортекст изначально поддерживает LaTeX.Вы можете отправить механизм публикации или распечатать LaTeX, и он передаст его напрямую.

Он также поддерживает множество других языков композиции и даже дает возможность манипулировать макетом страницы, как вы видите в InDesign (без головной боли и накладных расходов, связанных с ID).

Answer 4

я думаю что Аскиидок лучше ориентирован на то, что вы пытаетесь получить.Это простой язык разметки, он позволяет использовать латексные формулы и генерирует документы Docbook, из которых вы можете в дальнейшем генерировать читаемое представление HTML или Latex.