Какие инструменты и стратегии публикации из одного источника доступны?
Я собираюсь написать 1000-страничную документацию об огромной среде программирования. Цель состоит в том, чтобы вывести эту документацию онлайн на веб-платформу, чтобы пользователи в Интернете могли осуществлять ее поиск и читать онлайн. В то же время текст должен быть опубликован в формате PDF для скачивания. И в то же время все это должно быть включено в печатную книгу (печатать по требованию, им нужен гигантский файл PDF со всей книгой).
Файлы PDF: весь контент разделен на несколько глав. Каждая глава будет доступна в виде отдельной электронной книги в формате PDF. И, наконец, все главы будут доступны в одной огромной печатной книге.
Может ли LaTeX на что-то подобное? Можно ли использовать его для публикации из одного источника? Или мне нужно взглянуть на другие технологии, такие как DocBook и т. Д.?
3 ответа
Некоторые приложения справочной документации могут дать вам то, что вы ищете. "Справка и руководство" - отличная программа, вероятно, лучшая из всех, и отличная сделка. Давайте опубликуем ваш проект документации в любом из множества форматов, включая html и pdf.
Смотрите веб-страницу по адресу: http://helpandmanual.com/
Я полагаю, что с таким большим проектом вы будете разбивать документ на несколько файлов, чтобы все было в порядке? Как бы я это сделал, у меня есть несколько документов корневого уровня для различных требуемых выходных данных, состоящих из не более чем следующего:
\documentclass[options]{book}
\include{commonpreamble}
\begin{document}
\tableofcontents
\include{chapIntroduction}
\include{chapBasics}
\include{chapAdvancedStuff}
\end{document}
Загружаемые PDF-файлы могут включать в себя аналогичный корневой документ, который включает в себя только один файл главы, с другим \documentclass{} и варианты в зависимости от обстоятельств.
Что касается создания HTML, я бы посмотрел на такие вещи. Я сам этого не делал, но, кажется, выполнимо.
В зависимости от того, сколько / как мало вы хотите настроить окончательный вариант макета PDF, стоит посмотреть на asciidoc.
Входные файлы - это очень удобочитаемые текстовые файлы, поэтому вы можете сделать свой документ доступным не только в виде PDF или веб-страницы, но и в виде простого текста. Он также способен генерировать xml, который может быть отображен с помощью пользовательских таблиц стилей в различные выходные форматы, такие как epub или info-файлы.
На домашней странице asciidoc есть несколько примеров.