Какие инструменты и стратегии публикации из одного источника доступны?

Question

Я собираюсь написать 1000-страничную документацию об огромной среде программирования. Цель состоит в том, чтобы вывести эту документацию онлайн на веб-платформу, чтобы пользователи в Интернете могли ее искать и читать онлайн. В то же время текст должен быть опубликован в формате PDF для скачивания. И в то же время все это должно быть включено в печатную книгу (печатать по требованию, им нужен гигантский файл PDF со всей книгой).

Файлы PDF: весь контент разделен на несколько глав. Каждая глава будет доступна в виде отдельной электронной книги в формате PDF. И, наконец, все главы будут доступны в одной огромной печатной книге.

Может ли LaTeX на что-то подобное? Можно ли использовать его для публикации с одним источником? Или мне нужно взглянуть на другие технологии, такие как DocBook и т.д.?

Answer 1

Я полагаю, что при таком большом проекте вы будете разбивать документ на несколько файлов, чтобы все было в порядке? Как бы я это сделал, у меня есть несколько документов корневого уровня для различных требуемых выходных данных, состоящих из не более чем следующего:

\documentclass[options]{book}
\include{commonpreamble}
\begin{document}
\tableofcontents
\include{chapIntroduction}
\include{chapBasics}
\include{chapAdvancedStuff}
\end{document}

Загружаемые PDF-файлы могут включать аналогичный корневой документ, который включает в себя только один файл главы, с другим \documentclass{} и соответствующими параметрами.

Что же касается , что делает его HTML, я смотрю на вещи , как они. Я не сделал это сам, но это кажется выполнимым.

Answer 2

Некоторые приложения справочной документации могут дать вам то, что вы ищете. "Справка и руководство" - отличная программа, вероятно, лучшая из всех, и отличная сделка. Давайте опубликуем ваш проект документации в любом из множества форматов, включая html и pdf.

Смотрите веб-страницу по адресу: http://helpandmanual.com

Answer 3

В зависимости от того, сколько / как мало вы хотите настроить окончательный формат PDF, может стоить посмотреть на asciidoc .

Входные файлы - это очень удобочитаемые текстовые файлы, поэтому вы можете сделать свой документ доступным не только в виде PDF или веб-страницы, но и в виде простого текста. Он также способен генерировать xml, который может быть отображен с помощью пользовательских таблиц стилей в различные выходные форматы, такие как epub или info-файлы.

На домашней странице asciidoc есть несколько примеров .