Clevere Dokumente mit Attributen erstellen
Stellen Sie sich vor, Sie haben eine neue Version Ihrer Software herausgebracht und müssen nun das Handbuch anpassen. Das hätte vor adoc Studio bedeutet, dass Sie jede Instanz einzeln von "Version X" auf "Version Y" umschreiben müssen.
Bei adoc Studio verwenden Sie Attribute, um Anpassungen zu beschleunigen. Wir definieren die Versionsnummer als Variable und platzieren diese Variable anstelle der Zahl im Text. Bei Änderungen passen Sie lediglich die Nummer in der Definition an und schon wird überall die aktuelle Versionsnummer angezeigt.
Dadurch lassen sich wiederkehrende Inhalte ganz einfach einfügen und anpassen. Nicht nur Versionsnummern, sondern beispielsweise auch der Name Ihres Produktes oder bestimmte URLs können damit schnell eingebaut werden.
Neben der Nutzung als Variable bietet adoc Studio eine Vielzahl an Standardattributen. Hier nur ein paar der beliebtesten Attribute:
:toc:
fügt ein Inhaltsverzeichnis in Ihr Dokument ein:icons: font
bildet Hinweise als Icon anstelle als Text ab:stem:
aktiviert mathematische Formeln und Gleichungen (nach AsciiMath oder LaTeXMath):ads-footnotes:
definiert, ob und wo Fußnoten angezeigt werden sollen:title-page:
fügt der PDF Ausgabe eine Titelseite hinzu:page-nums:
zeigt Seitenzahlen in der PDF Ausgabe an
Doch das ist längst nicht alles. Für einen kompletten Überblick drücken Sie einfach auf die ESC Taste, um den adoc Coach aufzurufen. Der Eintrag Attribute (Definition) listet nun alle Attribute mitsamt kurzer Erklärung auf.
Viele Attribute müssen oberhalb des Titels, im Dokumentkopf, eingefügt werden. So garantieren Sie, dass das Attribut im gesamten Dokument aktiv ist.