Я ищу систему шаблона документации или скорее буду создавать ту. Это должно поддерживать следующие функции:
Я попробовал ЛАТЕКС различными преобразователями TEX к HTML, но я не удовлетворен результатами. Я использовал DocBook некоторое время, но я думаю, что редактирование DocBook не легко записать, и поддержка формул еще не достаточна.
Основная проблема, что будут пользователи этой системы, которые не знают ЛАТЕКСНЫЙ синтаксис или DocBook. Я думал об альтернативе для этих пользователей, предоставляющих возможности редактирования синтаксис Wiki (преобразованный Python для Пропитки латексом).
Давайте подведем итог: Я хочу HTML и вывод PDF, по крайней мере, от ЛАТЕКСА и входа Wiki. DocBook мог использоваться в качестве промежуточного формата.
Кто-либо имел подобную проблему или может дать мне совет, на которых инструментах, и который форматы файлов я должен использовать?
Мы используем сфинкс: http://sphinx.pocoo.org
Почти все это делается.
Ваш питоновый скрипт, или ваши пользователи, или кто бы то ни было (я не могу следить за вопросом) могут создавать контент, используя RST-разметку (что, возможно, является самым простым из языков разметки). Вы запускаете его через Sphinx и получаете HTML и латекс.
Я создал препроцессор и питоновый модуль LaTeX, который позволяет встраивать питон или SQL в файл LaTeX. Выполняется python и/или SQL и выводится результат.
С помощью latex2html или latex2rtf вы можете использовать код LaTeX для создания HTM и RTF.
Я разместил его для вас по адресу http://simson.net/pylatex/
Arbortext изначально поддерживает LaTeX. Вы можете отправить издательский движок или напечатанный композитор LaTeX, и он передаст его напрямую.
Он также поддерживает множество других языков композиции и даже дает возможность манипулировать макетом страницы, как в InDesign (без головной боли и накладных расходов на ID).