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

724
Another Registered User

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

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

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

1

3 ответа на вопрос

2
Edd

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

\documentclass[options] \include \begin \tableofcontents \include \include \include \end 

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

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

1
user22303

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

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

1
Benjamin Bannier

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

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

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