Technische Redakteure müssen häufig Dokumentationen, Handbücher oder Hilfe-Websites erstellen und diese dann mit Teammitgliedern teilen oder ihren Endnutzern bereitstellen. Dies kann ein zeitaufwändiger Prozess sein, der Sorgfalt und Aufmerksamkeit erfordert, um sicherzustellen, dass die korrekte Version regelmäßig erstellt wird. Glücklicherweise kann das Hilfe-Entwicklungstool HelpNDoc zur Durchführung einer geplanten Dokumentationserstellung automatisiert werden. Im Folgenden erfahren Sie, wie Ihnen das gelingt.
Anwendung von HelpNDocs Kommandozeilenschnittstelle
Sie können HelpNDocs Vorgang zur Dokumentationserstellung durch eine Eingabeaufforderung oder PowerShell-Eingabeaufforderung zur Erstellung aller durch das Hilfe-Entwicklungstool unterstützten Formate automatisieren.
HelpNDoc bietet eine [äußerst leistungsfähige Kommandozeilenschnittstelle] (/documentation/html/Usagefromthecommandline.html), die zur Erstellung jedes unterstützten Dokumentationsformats ohne weitere Benutzerinteraktionen genutzt werden kann. Beispielsweise generiert die folgende Kommandozeile alle Builds, die in einem Projekt mit dem Namen MyProject.hnd
eingerichtet und aktiviert wurden:
hnd6.exe MyProject.hnd build
Die Kommandozeile build
bietet mehrere Optionen zur Festlegung des zu generierenden Dokumentationsformats, zur Auswahl der anzuwendenden Tags sowie zum Überschreiben von Variablen. Beispielsweise wird die folgende Kommandozeile nur solche Themen des HTML-Dokumentationsformats erstellen, die als Abgeschlossen
(für die öffentliche Nutzung bereit) markiert wurden:
hnd6.exe MyProject.hnd build -only="Build HTML documentation" -statuses="Build HTML documentation:Complete"
Sie können sich HelpNDocs Kommandozeilendokumentation ansehen, um mehr über die möglichen Optionen zu erfahren und die für Ihre spezifischen Anforderungen passende Kommandozeile einzurichten. Sobald Sie dies getan haben, können wir im nächsten Schritt eine Dokumentationserstellung als Aufgabe planen.
Automatisieren der Dokumentationserstellung
Nachdem die gewünschte Kommandozeile definiert wurde, können wir eine geplante Aufgabe zur periodischen Ausführung einrichten und sicherstellen, dass die generierte Dokumentation stets auf dem neuesten Stand ist.
Es gibt mehrere Werkzeuge für eine “kontinuierliche Integration” oder Build-Systeme zur Ausführung geplanter oder getriggerter Kommandozeilen. Wir verwenden beispielsweise Windows integrierte “Aufgabenplanung”, um täglich eine neue Version einer HTML-Dokumentation zu erstellen. So geht‘s:
- Klicken Sie auf das Windows-Logo in der Taskleiste.
- Beginnen Sie mit der Eingabe von “Aufgabenplanung” und klicken Sie das Programm an, um es zu starten.
- Klicken Sie im Menü “Aktion” auf “Aufgabe erstellen”.
- Geben Sie einen “Namen” und optional eine “Beschreibung” an und klicken Sie dann auf “Weiter”.
- Wählen Sie den gewünschte “Trigger” (z. B. “täglich”) aus und klicken Sie dann auf “Weiter”.
- Passen Sie die Trigger-Optionen wie z. B. die Startzeit an und klicken Sie dann auf “Weiter”.
- Wählen Sie die Aktion “Ein Programm starten” aus und klicken Sie dann auf “Weiter”.
- Geben Sie HelpNDocs vollständigen Pfad in dem Feld “Programm/Script” an. In der Regel lautet der Pfad:
"C:\Programmdateien (x86)\IBE Software\HelpNDoc 6\ hnd6.exe"
- Geben Sie den Rest der zuvor definierten Kommandozeile in das Feld “Argumente hinzufügen” ein, zum Beispiel:
MyProject.hnd -verysilent build -only="Build HTML documentation" -statuses="Build HTML documentation:Complete"
.
Hinweis: Das Kommandozeilenargument-verysilent
wurde hinzugefügt, um zu vermeiden, dass bei der Ausführung von HelpNDoc eine Eingabeaufforderung angezeigt wird. - Geben Sie den vollständige Pfad Ihrer HND-Projektdatei in das Feld “Starten in” ein, zum Beispiel:
C:\Dokumentation\
. Klicken Sie auf “Weiter”. - Überprüfen Sie alles, klicken Sie auf “Fertig stellen”, und schon haben Sie’s geschafft! Die Dokumentationserstellung wurde jetzt als Aufgabe geplant.
Durch die Nutzung von HelpNDocs integrierter Kommandozeilenschnittstelle sowie Windows Aufgabenplanung (oder eines anderen automatisierten Build-Systems) können Sie Ihre Dokumentationserstellung schnell und einfach automatisieren. HelpNDoc kann technischen Redakteuren so viel Zeit und Mühe bei der Bereitstellung aktueller Dokumentationen für Endbenutzer oder Teammitglieder sparen.
Das könnte Sie auch interessieren...
Transformieren Sie Ihren Unterrichtsraum mit HelpNDoc: Das ultimative Tool zur Unterstützung von Lehrkräften und Lernenden zu Beginn des neuen Lehrjahres
Angesichts des Beginns des neuen Lehrjahres sind Lehrkräfte und Lernende auf der Suche nach Hilfsmitteln, die die Inhaltserstellung vereinfachen, die Zusammenarbeit verbessern und die Lernerfahrung …
Mehr lesen →Anpassen der Ausgangsposition und -größe von CHM-Hilfedateien
Die Erstellung von CHM-Dateien (kompilierten HTML-Hilfedateien) mit HelpNDoc ist dank der benutzerfreundlichen Oberfläche und leistungsstarken Funktionen ein Kinderspiel. In diesem Artikel erfahren …
Mehr lesen →Balance zwischen Sicherheit und Benutzerfreundlichkeit: Die besten Dokumentationsformate für die interne Freigabe
Die effektive und sichere Freigabe von Dokumenten ist in modernen Arbeitsumgebungen von entscheidender Bedeutung. Egal, ob Sie Handbücher, Projektdokumentationen oder Unternehmensrichtlinien intern …
Mehr lesen →Die Geheimwaffe technischer Redakteure: Die einzigartigen Vorteile des Zeichen-Analysators von HelpNDoc
HelpNDoc hat sich als eine Lösung für Fachleute etabliert, die hochwertige, ansprechende und benutzerfreundliche Dokumentationen erstellen möchten. Es sind nicht nur die benutzerfreundliche Oberfläche …
Mehr lesen →