HelpNDoc bietet eine leistungsstarke Scripting-Funktion, die die HelpNDoc API verwendet, um sich wiederholende Aufgaben zu automatisieren. Diese weitergehende Funktion ermöglicht es Ihnen, neue Scripts zu verfassen, bereits existierende Scripts zu laden, Scripts auszuführen und zu erstellen sowie Scripts für eine zukünftige Verwendung zu speichern.
HelpNDoc beinhaltet einen äußerst leistungsstarken Skript-Editor mit Zugriff auf mehrere API-Methoden, mit dem Sie nahezu alle Aspekte der Erstellung und Wartung Ihrer Dokumentationen automatisieren können. Wir haben uns bereits angesehen, wie Sie HelpNDocs Scripting-Fähigkeiten zum Automatisieren der Erstellung von Hilfe-Dokumentationen, zum Aktualisieren des Pfads externer Medienelemente, die verschoben wurden, und zum Exportieren von Hilfe-IDs und Hilfe-Kontext-Nummern für Ihre Entwickler verwenden können. Hier erklären wir Ihnen, wie Sie ein praktisches Skript zum automatischen Zurücksetzen der Hilfe-Kontext-Nummern für alle Themen eines Dokumentationsprojekts erstellen können
Ein Hilfe-Entwicklungstool wie HelpNDoc ist gewöhnlich eine Software, mit der man Inhalte zur Erstellung von Dokumentationsdateien für Endbenutzer schreiben und gliedern kann. Wenn Revisionen erforderlich sind, müssen die Inhalte übersichtlich bleiben, sodass in der Regel etliche mühsame und fehleranfällige Aufgaben wie etwa Kopieren/Einfügen von Inhalten, Löschen von Inhalten und Verschieben und Zusammenführen von Themen im gesamten Projekt erforderlich sind. Glücklicherweise bietet HelpNDoc einen leistungsstarken Scripting-Prozessor, der eine automatische Erstellung, Pflege und Neugliederung von Dokumenten ermöglicht. Hier zeigen wir Ihnen, wie Sie HelpNDocs Scripting-Fähigkeiten zum Zusammenführen mehrerer untergeordneter Themen in ein übergeordnetes Thema nutzen können
Sie können entscheiden, wie Ihre Bibliothekselemente (Bilder, Filme, Dokumente...) durch HelpNDoc gehandhabt werden: Sie können in Ihrem Projekt enthalten sein oder dynamisch zum Zeitpunkt der Generierung, wenn Sie Ihre endgültigen Dokumentationsdateien erstellen, eingefügt werden. Wenn Sie die zweite Option verwenden, bestimmen Sie einen Pfad für Ihre Medienelemente, sodass HelpNDoc die Elemente bei Bedarf finden und einfügen kann. Dies ist sehr nützlich, um die Elemente von außerhalb von HelpNDoc bearbeiten zu können, mit einer Drittsoftware zu teilen... Problematisch kann es jedoch werden, wenn die Elemente auf Ihrer Festplatte oder Ihrem Netzwerkpfad verschoben werden müssen: Um sicherzustellen, dass HelpNDoc Ihre Medienelemente weiterhin finden kann, müssen Sie sie alle der Reihe nach einzeln manuell aktualisieren. Da das eine sehr langwierige, langweilige und fehleranfällige Aufgabe sein kann, ist dies ein großartiger Anwendungsfall für HelpNDoc's leistungsstarken Script-Editor. Sehen wir uns an, wie wir ihn wirksam einsetzen können, um die gesamte Bibliothek in ein paar Sekunden zu aktualisieren
Die vor Kurzem veröffentlichte neue Version von HelpNDoc (HelpNDoc 6.4) bietet eine verbesserte einseitige HTML-Vorlage, mit der Sie Ihrer generierten einseitigen HTML-Dokumentation ein Inhaltsverzeichnis hinzufügen können. Wir haben diese einseitige Vorlage mit HelpNDocs leistungsfähigem Vorlagen-Editor modifiziert und denken, dass es eine gute Idee ist, diesen Vorgang zu Lernzwecken zu dokumentieren. Befolgen Sie die in diesem Artikel beschriebenen Schritte, um zu erfahren, wie Sie Ihre HTML-basierten Dokumentationsvorlagen mit den in HelpNDoc integrierten Tools erstellen und ändern können.
Sobald Sie Ihre Hilfe-Datei oder Dokumentations-Webseite verfasst haben, möchten Sie diese sicherlich mit bereits existierenden Produkten integrieren: Falls ein Nutzer Schwierigkeiten dabei hat eine Handlung auszuführen, kann dieser die Hilfedatei aufrufen und wird umgehend zum korrekt assoziierten Thema geleitet, welches die Handlung erklärt. Aus diesem Grund bieten die Hilfeentwicklungstools, wie HelpNDoc, für jedes Thema zwei einmalige Identifikatoren: Eine alphanumerische Hilfe-ID und eine numerische Hilfe-Kontext-Nummer. Dies ermöglicht den Zugriff auf ein spezifisches Thema von einer Software-Applikation oder Webseite aus. Als technischer Autor werden Sie jedoch höchstwahrscheinlich nicht für das "Schreiben" der Applikation oder Webseite mit der Hilfe-Datei verantwortlich sein und bevorzugen deshalb sicherlich den Entwicklern eine Liste mit den Themen-Identifikatoren zuzustellen.Dank HelpNDoc’s leistungsfähigem Skript-Editor, wird Ihnen genau dies ganz einfach gemacht!
HelpNDoc 6.0 bietet eine bessere Unterstützungsfunktion für den Status von Themen, die technischen Redakteuren die Pflege ihrer Dokumentationsprojekte deutlich erleichtert: Die Themen können als "Veraltet", "In Bearbeitung", "Zu überprüfen", "Vollständig" oder mit einem anderen benutzerdefinierten Status markiert werden. Sie können diese Funktion zur Aktualisierung eines alten Projekts nutzen, um zum Beispiel den Status aller Themen als "Zu überprüfen" zu markieren und die Themen anschließend der Reihe nach zu überarbeiten. Das Aktualisieren jedes einzelnen Themas in einem großen Projekt kann jedoch recht zeitaufwändig sein. Glücklicherweise kann HelpNDocs Scripting-Unterstützung den Status Ihres gesamten Dokumentationsprojekts im Bruchteil einer Sekunde aktualisieren. Im Folgenden erfahren Sie, wie Ihnen das gelingt.
HelpNDoc ist dermaßen benutzerfreundlich, dass es möglich ist, innerhalb kürzester Zeit, eine vollständige Dokumentation in mehreren Formaten und für mehrere Geräte zu produzieren. Dies ist sogar schon wenige Minuten nach dem Downloaden und dem ersten Austesten von HelpNDoc möglich und zwar dank der intuitiven Benutzeroberfläche und dem Themen-Editor, der Microsoft Word sehr ähnelt. HelpNDoc ist extrem Leistungsstark und bietet seinen Nutzern viele fortschrittliche Instrumente, um die Erstellung von fantastischen Hilfe-Dateien und Handbüchern zu vereinfachen und zu beschleunigen. Bei einer dieser fortgeschrittenen Funktionen handelt es sich um den Script-Editor, dank welchem Sie HelpNDoc mit einer Scriptsprache manipulieren können. Gerne zeigen wir Ihnen, wie der Script-Editor Ihnen dabei helfen kann, die zweckmäßigsten Hilfe-Dateien in möglichst kurzer Zeit zu erstellen
Das Schreiben einer Online-Hilfedatei, eines Benutzerhandbuchs, eines E-Books oder eines anderen durch HelpNDoc bearbeiteten Formats ist in der Regel ein langwieriger und nicht geradliniger Prozess. Mit zunehmender Entwicklung des Inhalts ist die übergreifende Themenhierarchie oft nicht mehr optimal, sodass eine Neugliederung erforderlich ist, um die Dokumentation einfacher lesbar und navigierbar zu machen. Obwohl HelpNDoc einige Tools zur einfachen Neugliederung des Inhaltsverzeichnisses bietet, kann dieser Vorgang mitunter langwierig und fehleranfällig sein, beispielsweise wenn eine alphabetische Themensortierung erforderlich ist. Zum Glück enthält HelpNDoc Scripts zum automatischen Umsortieren der Themen nach Titeln. Im Folgenden erfahren Sie, wie Ihnen das einfach und schnell gelingt
