Welche Tools und Strategien für das Single Source Publishing stehen zur Verfügung?

1199
Another Registered User

Ich schreibe gerade eine 1000-Seiten-Dokumentation über einen riesigen Programmierrahmen. Ziel ist es, diese Dokumentation online in eine Webplattform zu bringen, damit Online-Benutzer sie durchsuchen und online lesen können. Gleichzeitig muss der Text zum Download im PDF-Format veröffentlicht werden. Gleichzeitig muss das Ganze auch in ein gedrucktes Buch aufgenommen werden (Print-on-Demand, sie möchten eine riesige PDF-Datei mit dem gesamten Buch).

Die PDF-Dateien: Der gesamte Inhalt ist in mehrere Kapitel unterteilt. Jedes Kapitel wird als eigenständiges PDF-eBook verfügbar sein. Schließlich werden alle Kapitel in einem großen gedruckten Buch verfügbar sein.

Ist LaTeX für so etwas geeignet? Kann es für Single Source Publishing verwendet werden? Oder müsste ich andere Technologien wie DocBook usw. betrachten?

1

3 Antworten auf die Frage

2
Edd

Ich nehme an, bei einem so großen Projekt werden Sie das Dokument in mehrere Dateien aufteilen, um die Dinge überschaubar zu halten. Wie ich dies tun würde, gibt es mehrere Dokumente auf Stammebene für die verschiedenen erforderlichen Ausgaben, die nicht viel mehr umfassen als die folgenden:

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

Die herunterladbaren PDF-Dateien können ein ähnliches Root-Dokument enthalten, das nur eine einzelne Kapiteldatei mit anderen \documentclass{}Optionen und Optionen enthält.

Um es HTML zu machen, würde ich solche Dinge betrachten . Ich habe es nicht selbst gemacht, aber es scheint machbar.

1
user22303

Einige Hilfedokumentations-Apps geben Ihnen möglicherweise das, wonach Sie suchen. "Hilfe und Handbuch" ist ein hervorragendes Programm, wahrscheinlich das Beste vom Los und ein Schnäppchen. Veröffentlichen Sie Ihr Dokumentationsprojekt in einer Reihe von ofrmats, einschließlich html und pdf.

Siehe Webseite unter: http://helpandmanual.com

1
Benjamin Bannier

Abhängig davon, wie viel / wie wenig Sie das endgültige PDF-Layout anpassen möchten, ist möglicherweise ein Blick auf asciidoc wert.

Die Eingabedateien sind sehr gut lesbare Textdateien, sodass Sie Ihr Dokument nicht nur als PDF oder Webseite, sondern auch als Text zur Verfügung stellen können. Es ist auch in der Lage, XML zu generieren, das mit benutzerdefinierten Stylesheets in zahlreiche Ausgabeformate wie Epub oder Infodateien gerendert werden kann.

Es gibt einige Beispiele auf der Asciidoc-Homepage.