Estou prestes a escrever uma Documentação de 1000 páginas sobre uma grande estrutura de programação. O objetivo é colocar esta documentação on-line em uma plataforma da Web, para que os usuários on-line possam pesquisá-la e lê-la on-line. Ao mesmo tempo, o texto deve ser tornado público em formato PDF para download. E, ao mesmo tempo, a coisa toda precisa entrar em um livro impresso também (imprimir sob demanda, eles querem um arquivo PDF gigante com todo o livro).
Os arquivos PDF: todo o conteúdo é dividido em vários capítulos. Cada capítulo estará disponível como um eBook PDF autônomo. E finalmente, todos os capítulos estarão disponíveis em um enorme livro impresso.
O LaTeX é capaz de algo assim? Pode ser usado para publicação de fonte única? Ou eu teria que dar uma olhada em outras tecnologias, como o DocBook, etc.?
Alguns aplicativos de documentação de ajuda podem fornecer o que você está procurando. "Ajuda e Manual" é um programa excelente, provavelmente o melhor, e um ótimo negócio. Vamos publicar seu projeto de documentação em qualquer um dos vários programas, incluindo HTML e PDF.
Veja a página da web em: link
Suponho que com um projeto tão grande você estará dividindo o documento em vários arquivos para manter coisas manejáveis? Como eu faria isso é ter vários documentos em nível de raiz, para as várias saídas necessárias, consistindo em não muito mais do que o seguinte:
\documentclass[options]{book}
\include{commonpreamble}
\begin{document}
\tableofcontents
\include{chapIntroduction}
\include{chapBasics}
\include{chapAdvancedStuff}
\end{document}
Os pdfs para download podem incluir um documento raiz semelhante que inclui apenas um único arquivo de capítulo, com diferentes \documentclass{} e opções, conforme apropriado.
Quanto a tornar isso html, eu vejo coisas como estas . Eu não fiz isso sozinho, mas parece capaz.
Dependendo do quanto você deseja ajustar o layout final do pdf asciidoc pode valer a pena .
Seus arquivos de entrada são arquivos de texto legíveis para que você possa disponibilizar seu documento não apenas como pdf ou página da Web, mas também como texto simples. Ele também é capaz de gerar xml, que pode ser processado com folhas de estilo personalizadas para vários formatos de saída, como arquivos epub ou info.
Existem alguns exemplos na página inicial do asciidoc.
Tags latex publishing docbook