Система подготовки документов на основе текстовых файлов
Я ищу систему для подготовки внутренних технических документов, которая имеет следующие основные функции:
- исходные файлы должны быть удобочитаемыми текстовыми файлами, чтобы они хорошо играли с контролем версий
- поддерживает базовое форматирование (например, изображения, таблицы, жирный шрифт и т. д.)
- работает с английскими и китайскими иероглифами
- выводит в PDF
Я мог бы, например, пользователям писать HTML-страницы и печатать страницы в PDF, но это кажется сложным и подверженным ошибкам, а HTML только "читабелен" человеком. LaTeX также очень сложен и имеет много зависимостей, которые могут затруднить обработку документов, которым несколько лет.
У кого-нибудь есть предложения получше?
7 ответов
Одним из возможных решений является Docutils. Его формат "restructuredtext" более читабелен, чем другие опции, и он имеет встроенную поддержку таблиц. Сопровождающие, кажется, делают хорошую работу по документированию и обслуживанию пакета, что должно поддерживать его относительно стабильным.
Используете ли вы какой-нибудь серверный язык, такой как PHP?
если да, вы можете использовать библиотеку FPDF... ( http://html2fpdf.sourceforge.net/)
Вы в основном кормите его бейсик HTML, и он будет выводить PDF....
Я думаю, что лучший ответ здесь - DocBook.
Он основан на XML, поэтому источник
а) недвоичный,
б) человекочитаемый, и
в) контроль источника / дружественный к разным.
Вы можете использовать любые символы UTF-8, которые вам нравятся, если вы компилируете в PDF со шрифтом, который их поддерживает (если вы решите встроить открытый шрифт).
DocBook может быть "скомпилирован" в несколько форматов, включая HTML, PDF и некоторые другие.
Вот что я нашел при поиске уценки: Pandoc. Он может конвертировать ряд форматов, включая Markdown и Textile, в PDF. Единственное, чего не хватает - это контроль над версией механизмов разметки и форматирования, используемых при подготовке документов. Это делает вероятным, что исходные файлы должны будут постоянно обновляться, чтобы соответствовать последней версии Pandoc, что может стать серьезной проблемой в долгосрочной перспективе.
Не использовал это лично, но слышал хорошие сообщения от других. Быстрый поиск показывает, что он поддерживает китайский и PDF. Очень простая разметка и легко выучить, очевидно.
http://www.methods.co.nz/asciidoc/ Вы, очевидно, исследовали латекс / текс. Задумывались ли вы об использовании редактора WYSIWYG, такого как Lyx? http://www.lyx.org/ Судя по тому, что существуют и китайские проекты перевода LDP, поддержка LinuxDoc и Docbook для китайского языка также, вероятно, будет хорошей. Набор инструментов для преобразования документов также, вероятно, будет более зрелым / без ошибок.
Как насчет этого расширения для уценки (пока уценка не добавит поддержку таблиц и т. Д.)