adoc Studio - Schreibprogramm 4+

BIBLIOGRAPHIE

Die Bibliographie ist ein spezieller Abschnitt, der in keinem wissenschaftlichen Projekt fehlen sollte. Die Literaturliste ist ein eigener Bereich, der eine Vielzahl von Büchern, Aufsätzen und Artikeln umfasst. Als Verweise verwenden Sie die klassische Syntax für Referenzen im Text.


SF SYMBOLS FÜR ICON-MAKROS

Seit Version 2 kann adoc Studio mit dem Icon-Makro kleine Symbole aus der Font-Awesome-Bibliothek im Text platzieren. Ab sofort können Sie auch SF Symbole verwenden. Dabei handelt es sich um die Sammlung aller Symbole, die in den verschiedenen Apple-Betriebssystemen verwendet werden. In adoc Studio 3 haben Sie Zugriff auf mehr als 6.000 Bilder zur Beschreibung Ihrer App-Oberflächen.

Aktivieren Sie die Apple-Symbole mit den folgenden Attributen:

:icons: font
:icon-set: apple


DATEIGRÖSSEN REDUZIEREN

Ein wichtiges Thema beim Exportieren von Dokumenten sind Bilder. Die Herausforderung ist oft deren Größe. Das Produktteam liefert Bilder in der Regel in maximaler Auflösung. Aber ein Leser der Dokumentation, etwa auf dem iPhone, benötigt keine Bilder mit Hunderten von Megabytes.

In adoc Studio Version 3 gibt es neue Attribute, um die Auflösung Ihrer Bilder in der Ausgabe anzupassen. So können Sie mit folgenden Attributen die Dateigröße Ihrer Dokumente dynamisch reduzieren:

ads-max-image-resolution → Setzt die maximale Ausgabauflösung von Bildern (in dpi, dpcm oder dppx), wenn Höhe oder Breite im Quellcode definiert sind.

ads-max-image-width → Begrenzung der Bildbreite im HTML-Output, wenn keine feste Höhe oder Breite angegeben ist.

ads-rasterizing-resolution → PDF-, SVG-Bilder und STEM-Formeln werden in PNG konvertiert und auf eine definierte Auflösung gesetzt (in dpi, dpcm, dppx).

ads-static-stem → Normalerweise werden STEM-Formeln mit JavaScript exportiert. Mit dieser Option werden sie als SVG in das Dokument eingebunden (kein JavaScript mehr erforderlich).


PROJEKTWÖRTERBÜCHER FÜR IHR TEAM

Bisher nutzte adoc Studio das Systemwörterbuch Ihres lokalen Rechners. Alle Korrekturen flossen dort ein und standen anderen Teammitgliedern nicht zur Verfügung. Für professionelle Autoren, die an vielen verschiedenen Projekten arbeiten, war das nicht ideal. Deshalb gibt es in adoc Studio 3 jetzt projektspezifische Wörterbücher.

Wenn die Rechtschreibprüfung aktiviert ist (Bearbeiten → Rechtschreibung & Grammatik → „Rechtschreibung & Grammatik prüfen“ aktivieren), können Sie unbekannte Wörter direkt zu einem neuen Wörterbuch hinzufügen. Das neue Wörterbuch (.adict-Datei) erscheint in der Seitenleiste. Natürlich kann es versioniert, in andere Projekte übernommen und im Team gemeinsam verwendet werden.


AUTOMATISIERUNG MIT ADOC STUDIO

Dokumentationsprodukte werden häufig automatisch erzeugt – insbesondere bei fortlaufenden Projekten. Ab dieser Version können Sie adoc Studio in Ihre Prozesse integrieren. Sie können das adocstudio-Kommandozeilenwerkzeug über das adoc-Studio-Menü installieren und anschließend in allen Shell-Skripten verwenden. Es bietet folgende Unterbefehle:

Dokumentexport:

adocstudio export documents --project Projektname.adocproject --document Dokumentname.adoc (Verzeichnis)

Produkteexport:

adocstudio export products --project Projektname.adocproject --product Produktname (Verzeichnis)

Geben Sie einfach im Terminal „adocstudio help export products“ oder „adocstudio help export documents“ ein, um alle verfügbaren Befehle anzuzeigen.


NEUE DRAG-&-DROP-FUNKTIONEN

Text aus dem Quellcode-Editor ziehen

Jetzt können Sie mit Textbausteinen arbeiten. Ziehen Sie zum Beispiel Text aus dem Editor auf Ihren Schreibtisch, um automatisch einen neuen Textbaustein zu erstellen. Natürlich kann ein Textbaustein auch wieder in den Editor gezogen werden.

Drag & Drop in den Quellcode

Wenn Sie eine Datei aus dem Projektnavigator in den Editor ziehen, wird ein Include-Befehl eingefügt. Wenn Sie dabei die Optionstaste gedrückt halten, wird deren Inhalt immer eingefügt.