Features

Doc-O-Matic ist ein mächtiges Werkzeug mit grosser Flexibilität. Dieser Abschnitt soll Ihnen die verschiedenen Features von Doc-O-Matic näher bringen und erläutern, wie diese Ihnen helfen können, Ihr Dokumentationsproblem zu lösen.

Zusammenfassung

Softwareentwicklung wird immer komplexer, daher ist ein verlässliches Programm, das die Anfertigung einer Dokumentation erleichtert und diese immer am aktuellen Stand hält, unentbehrlich. Softwareentwickler, die um ein gutes Produkt bemüht sind, brauchen eine Online Hilfe und druckbare Dokumente sowohl für die Benutzer der Software als auch für das Entwicklerteam.

Diese Arbeit kann erleichtert werden, wenn man ein Programm verwendet, das die Dokumentation in vielen leicht zugänglichen Formaten von nur einer Textquelle erzeugt.

Doc-O-Matic Facts

Die Verwendung von Doc-O-Matic hat folgende Vorteile:

  • Die Dokumentation ist immer aktuell und am neusten Stand.
  • Doc-O-Matic unterstützt viele der meistverwendesten Programmiersprachen.
  • Doc-O-Matic passt sich Ihrer Art Quellcode zu dokumentieren an und unterstützt XML Doc und JavaDoc.
  • Mit Doc-O-Matic kann man sowohl Quellcodedokumentation als auch Anwenderhilfe verfassen.
  • Doc-O-Matic erzeugt leicht zugängliche Ausgabeformate, die an die jeweiligen Bedürfnisse angepasst werden können.
  • Doc-O-Matic stellt Ihnen Vorlagen zur Verfügung mit deren Hilfe Sie Hilfe im Stil von Visual Studio und MSDN Hilfe und Delphi VCL Hilfe erstellen können.
  • Doc-O-Matic unterstützt Sie bei der Verwaltung Ihres Quellcodes mit einem Werkzeug zur graphischen Darstellung von Klassenhierarchien einem flexiblen Werkzeug zur Erstellung von Berichten und einem graphischen Tool zur Qualitätssicherung der Dokumentation.
  • Doc-O-Matic erzeugt Quellcodedokumentation und Anwenderhilfe in Browser basiertem HTML, HTML Help, Help 2, Help Viewer, PDF, RTF und XML.
  • Doc-O-Matic ist ein Tool das aus einer Quelle verschiedene Ausgaben erzeugt.
  • Doc-O-Matic ist ein selbständiges Windows Programm mit einem benutzerfreundlichen Oberfläche.
  • Doc-O-Matic stellt einen Kommandozeilenkompiler zur Verfügung, womit Doc-O-Matic leicht in einen automatische Erzeugungsprozess integriert werden kann.

Doc-O-Matic wird in allen Arten von Industrien eingesetzt, von Halbleiterherstellern bis zu Spieleentwicklungsfirmen. Lesen Sie mehr in der Sektion Was Kunden sagen.

Feature-Übersicht

Allgemeine Funktionen

  • Eingebaute Unterstützung für C/C++, C#, Delphi, VB.NET, IDL, Java, ASPX, JSP, JavaScript, Matlab und PHP
  • Integrierte Unterstützung für Macro-Auflösung, Bedingte Definitionen, Überspringen von Code und mehr
  • Verwendet die Benutzungsinformationen von Namesräumen für die Auflösung von Symbolreferenzen und automatisches Verknüpfen
  • Vollständige Sprachunterstützung, eine Konfiguration notwendig
  • Module und getrennte Hierarchien für Module
  • Member Ordner für Namensräume und Module
  • Erweiterte Methodenordner, Sichtbarkeitsordner
  • Memberübersichtsseiten
  • Unterstützt Unicode-Dateien und Unicode-Kennzeichner

Verwalten von Code und Dokumentation

  • Visueller Inhaltsmanager und Inhaltsverzeichnisdesigner
  • Projektmanager für Quelldateien, Bilder- und Include-Pfade, Module und Ausgabedateien
  • Projektweite Suche
  • Projektstatistik einschliesslich Wortzählung
  • Klassenhierarchie-Visualisierung und Design-Werkzeug
  • Berichte
  • QA Manager zum visualisieren des Dokumentationsstatus von Projekten
  • Qualitätssicherungsfunktionen um sicherzustellen, dass die Dokumentation auf dem neuesten Stand und vollständig ist
  • Master-Projekte, Fähigkeit die Inhaltsinformationen in externen Dateien zu speichern

Kommentare extrahieren

  • Extrahiert existierende ungetagte Beschreibungen aus Kommentaren, Formatierung ohne Tags für Abschnitte, Listen Überschriften und Tabellen
  • Unterstützt einfache HTML Formatierungen in Kommentaren
  • Extrahiert Kommentare aus allen Quelldateien, die Kommentare unterstützen (zum Beispiel Assembler, VB6, SQL, Perl, LISP, Ada, Fortran, COBOL)
  • Optionale exklusive Verwendung von Dreifach-Slash-Kommentaren (C/C++, C#, Delphi) und Dreifach-Anführungszeichen-Kommentaren (VB.NET)

Handbücher-Schreiben und Editieren

  • "Single source" Hilfetool, erzeugt aus einer Quelle mehrere Ausgabeformate
  • Schreiben von bedingtem Text auf Buchstaben-, Abschnitts- und Themenebene
  • Visueller Inhaltsverzeichnisdesigner
  • Text-Wiederverwendungsfunktionen wie Schnipsel und Textvariablen
  • Labels um bestimmte Textteile zu kennzeichnen und automatisch bei der Ausgabe zu formatieren (benutzbar z.b. für Menüpfade, eingebettete Abschnitte und vieles mehr)
  • Integrierter Themeneditor mit einer gewohnten Benutzerschnittstelle
  • Vollständige Trennung von Hilfeschreiben und Ausgabedesign

Quellcode Beschreiben

  • Voll ausgestatteter Editor
  • QuickDoc Arbeitsablaufsmanagement
  • Live Rechtschreibkorrektur
  • Einfügen von Tabellen, Bildern, Verknüpfungen (innerhalb der Dokumentation und externe Verweise zu URLs und Dateien) Flags, Schlagworte, Farben, Titel, Buchstaben- und Absatzformatierung
  • Fügt Klartext-formatierte Kommentare und Quellcode oder externe Dokumentationsdateien ein
  • Benutzt Projektdatenbanken um einfach in andere Projekte und IDE-Hilfesysteme zu verweisen (MFC, VCL und .NET)
  • Vordefinierte aber anpassbare Dokumentationsabschnitte, die es ermöglichen einfach Zusammenfassungen, 'Siehe auch' Verweise, Beispiele, Parameterbeschreibungen, Rückgabewerte und Beispiel-Code zu erzeugen
  • Beschreiben Sie Code an verschiedenen Orten
  • Filter für Symbole
  • Quellcode-Ansicht die optional gesamte Dateien anzeigt
  • Importiert HTML-Dateien, Klartextdateien und Word-Dokumente

Werkzeuge

  • Kommandozeilen-Compiler
  • Werkzeuge um die Entwicklung im Team und das Zusammenfügen von Projekten zu unterstützen (Editorvorlagen, Projektimport und Projektvorlagen)
  • Werkzeug um Quellcodekommentare in externe Dateien zu verschieben
  • Code-Übersetzungs-Werkzeug um die Syntax-Übersetzungs-Matrix zu warten
  • HxBrowse um die Help 2 Namensraumregistry zu anzusehen
  • tfhxreg um Help 2 Dateien zu mit voller Unicode-Unterstützung zu registrieren

Allgemeine Ausgabeformatfunktionen

  • Hinzufügen von mehreren Konfigurationen für jedes Ausgabeformat
  • Benutzung von vorformatierten Vorlagen oder Verwendung von eigener Formatierung der Ausgabe
  • Erzeugt vollverknüpfte graphische Klassenhierarchien und Diagramme (einschliesslich abgeleiteter Klassen)
  • Vollständig anpassbare Symbolübersichten und Navigationsseiten. Optional einschliesslich Basisklassen-Members
  • Generiert Inhalt für Ordner und Member-Übersichtsseiten
  • Erzeugt Syntax-Abschnitte mit mehreren Programmiersprachen
  • Stellt vollautomatisches Erzeugen von Verknüpfungen innerhalb des Projekts, zwischen verschiedenen Projekten und zwischen Projekten und MFC, VCL und .NET Framework Hilfe zur Verfügung
  • Automatisches Erzeugen von verknüpften Berichten (z.b. "alle zu erledigen"-Abschnitte, "alle Fehler"-Abschnitte, alle veralteten Symbole und ein Glossar)
  • Fügt zusätzlichen Gruppierungsebenen für Symbole ein, die automatisch in Übersichtsseiten integriert werden
  • Anpassbare Ausgabeformatierung mit Inhaltsverzeichnis, Index, Kopf- und Fußzeilen für jedes Ausgabeformat
  • Stellt Übersetzungen für alle vordefinierten Worte in der Ausgabe zur Verfügung
  • Bedingter Text

PDF

  • Erzeugt PDF-Dateien und Handbücher ohne zusätzliche Werkzeuge
  • Inhaltsverzeichnis, Index, Titelseite und Impressum
  • Verweise mit Seitenangabe für zum Drucken bestimmte Handbücher
  • Verweise zu anderen PDF Dokumenten und zu URLs
  • Anpassbare Seiten- und Überschriftennummerierung in PDF
  • Doppelseitendruck
  • Kapitel-Register
  • Flexible Kopf- und Fußzeilenkonfiguration mit variablen-gesteuerten Werten für Thementitel, Nummerierung, Seitennummern und Seitenanzahl

HTML Hilfesysteme

  • Verwenden von Vorlagen für Visual Studio und Embarcadero Hilfestyles.
  • Unterstützung für Kontextsensitive Hilfe für C++ und Delphi
  • Stellt Projektdatenbanken für das Verknüpfen in Visual Studio Framework Hilfe, VCL Hilfe und MSDN zur Verfügung
  • Unterstützung für Visual Studio Dynamic Help
  • Zeigt optional alle Unterthemen auf einer Seite an (z.B. alle Members einer Klasse oder alle Variablen)
  • Voll anpassbare Willkommensseite, Möglichkeit zusätzliche Dateien zum Projekt hinzuzufügen
  • Unterstüzung für normales HTML, HTML Help, Help 2 und Help Viewer
  • Rahmen
  • Zusätzlicher CSS-Code fûr all Formatierungselement
  • Aufklappbare Abschnitte
  • Register-Abschnitte
  • Automatische Ankergenerierung für alle Abschnitte und "Nach oben"-Verknüpfungen
  • Popup-Unterstützung
  • Einbinden von vorformatierten HTML Dateien
  • Fixierter Kopfbereich
  • Verknüpfte Bilder, automatische "große Bilder" und Bilder mit "hover" Effekt
  • Dynamische Inhaltsseite mit automatischer Synchronisation mit dem ausgewählten Thema
  • HTML 5, XHTML 1 oder HTML 4.01 konforme Ausgabe

XML Ausgabe

  • Anpassbare Abschnitts-Tags
  • Symbolstruktur

Übersetzung

  • Das Übersetzen der Ausgabe wird in Doc-O-Matic Projekten an einer zentralen Stelle gesteuert, dem Übersetzungs-Wörterbuch. Alle Textteile im Projekt, die möglicherweise übersetzbaren Inhalt enthalten, werden bei der Ausgabe mit dem Wörterbuch übersetzt. Doc-O-Matic wird mit übersetzten Bildern für Buttons für HTML-Ausgabe geliefert und es gibt ein Werkzeug zum einfachen Umschalten der Sprache.

Feature-Matrix

  Professional Author*
Platformen
Unterstützt Windows 32-bit
Unterstützt Windows 64-bit
Programmiersprachen und Eingabeverarbeitung
Sprachgruppe I: C/C++, C++/CLI, C#, Delphi, VB.NET n/a
Sprachgruppe II: IDL, ASP.NET, Java, JavaScript, JSP, MATLAB, PHP n/a
Unterstützung für Quellcodekommentare n/a
Unterstützung für XML Dokumentationsdateien
Unterstützung für externe Dokumentation n/a
Unterstützt Dateien und Bezeichner in Unicode
Unterstützung für externe Unicode-Dokumentation
Master Projekte und externe TOC Dateien
Übersetzungsverzeichnis für Ausgabe in anderen Sprachen
Anpassbare Quellcode Parser Konfiguration n/a
Erweiterte C++ Parser Funktionen (System Includes, prototyplose Funktionen, Setter/Getter Konvertierung, Macro Expandierung) n/a
Namesbereich-Layout Konfiguration n/a
Erweiterte Pascal Parser Funktionen (Implementation Sektion Parsen, System auto-using) n/a
Unterstützung für bedingte Definitionen n/a
Code Skipping n/a
Grundlegende Kommentarfindungskonfiguration (Kommentartoken, Kommentarposition, Listen, Mauern, etc) n/a
Erweiterte Kommentarverarbeitung (Dreifachslash Kommentare, Parameterlistenbeschreibung, Ignorierte Zeilen, Kommentarausschlusstokens) n/a
Konfiguration von Themenverarbeitungsoptionen (Leere Themen, Auto-Combine Überladungen, Vererbte Dokumentation, Multi-Position Konfiguration) n/a
Automatischer Text Einstellungen (automatische Snippets, automatischer Text für undokumentierte Symbole)
Unterstützung für XML Doc, JavaDoc und natürliche Kommentare n/a
Grundlegende Abschnittskonfiguration (Typänderung und Starterstringänderung)
Erweiterte Abschnittskonfiguration (hinzufügen, löschen, Starter-Delimiter-Konfiguration, Leerzeichenverarbeitung)
Integrierte Editorkonfiguration
Farbeinrichtung
Managementfunktionen
Content Designer für Inhaltsverzeichnisdesign und individuelle Themenselektion
Visuelle Kontrolle über Exportstatus für individuelle Themen
Projektmanager
Symbol- und Themenfilterung
Projekt-Import-Werkzeug für Teamentwicklung
QuickDoc
Dokumentation-Verschiebungs-Werkzeug
Berichtemanager
Qualitätssicherungsmanager n/a
Klassenhierarchieanzeige n/a
Codeübersetzungsmatrixeditor n/a
Einfaches Projektkonfigurationstool    
Editor und Hilfeschreiben
Vollständig visueller WYSIWYG Editor
Standard Textverarbeitungsfunktionen einschliesslich fett, kursiv, unterstrichen, nichtproportional, tiefgestellt und hochgestellt
Farbkonfiguration mit Farbnamen
Listen, Tabellen, Bilder, geprüfte Links, Codeblöcke, Überschriften, Absatzausrichtung
Schnelle Themenerzeugung und Navigation
Einfaches Bildmanagement
Schnelle Editorfunktionen wie "Link folgen"
Bedingter Text mit Abschnitten
Snippets
Text Variablen
Live Rechtschreibüberprüfung und projektweite Rechtschreibüberprüfung
Automatisches Formatieren von Text Variablen
Text Labels
Bedingter Text mit Text Labels
Automatische Formatierung, Ersetzung und Textauszeichnung mit Text Labels
Generelle Ausgabefunktionen
Automatisch generierte Navigationstabellen
Automatisch generierte Navigationseiten
Vollautomatisches Verknüpfen innerhalb von Projekten und zu externen Projekten
Automatisch generierte Symbolübersichten n/a
Berichte
Glossar
Lokale Klassenhierarchien n/a
Klassenhierarchie für das Projekt n/a
Klassenhierarchie für alle Module n/a
Visueller Inhaltsverzeichnisdesigner
Module für die Unterteilung von Projekten n/a
Projektdatenbanken für Verknüpfungen zwischen Projekten
Automatisches Verknüpfen und Verknüpfungspseudonyme
Automatisches Einfügen von Snippets in alle Themen
AutoDoc Funktionen
Automatische Exportmengenselektion basierend auf Symboltypen (Klasse, Typ, Funktion, ...) n/a
Automatische Exportmengenselektion basierend auf Elementsichtbarkeit (public, protected, private) n/a
Automatische Exportmengenselektion basierend auf Dokumentationstatus n/a
Erweiterte Exportmengenselektion (Themen Status, Themenversionsinformation) n/a
AutoDoc Ordnerkonfiguration n/a
AutoDoc Seitentextkonfiguration n/a
Konfiguration der Navigationsbeschreibung
Beschränkung der Navigationsbeschreibungslänge
Konfiguration des Navigationstabellenlayoutes
Erweiterte Elementtabellenkonfiguration (vererbte Elemente, Subkategorien, Sichtbarkeitstypenkombination, Überladungen) n/a
Erweiterte Dateiabschnittskonfiguration n/a
Konfiguration der Indikatorbilder
Konfiguration der Vorgabetitel (Seitentitel, Inhaltstitel, Indextitel) n/a
AutoDoc Titelkonfiguration n/a
Automatische Indexgenerierung
Erweiterte Indexkonfiguration
Indexvorsilbenentfernung
Erweiterte Optionen für Navigationsabschnitte und Zusatzinformationsabschnitte (Benennung, Deklarationstext, Tabellenlayout)
Automatisches Erzeugen der Zusammenfassung
Automatische Generierung des Deklarationssourcecodes n/a
Konfiguration von Optionen für Deklarationsquellcode und Syntaxhervorhebung n/a
Multi-Sprach-Syntaxausgabe n/a
Funktionsrumpfausgabe n/a
Rumpfausgabe für Dateien n/a
Lokale graphische Klassenhierarchien n/a
Textklassenhierarchien n/a
Konfiguration für Layout und Design der graphischen Klassenhierarchien n/a
Projektdatenbanken für automatisches Verknüpfen zwischen Doc-O-Matic Projekten
Automatisches Verknüpfen
Erweiterte Auto-Linkeroptionen (minimale Wortlänge, verbotene Wörter)
Automatische Verknüpfungspseudonyme
Themen Flags
Automatische Qualitätssicherungsprüfungen (Dokumentations Status, Parameterbeschreibung, Parameternamen, Rückgabewertbeschreibung) n/a
Spezielle Ausgabeerzeugungsschritte
HTML, HTML Hilfe, Help 2, Help Viewer, Web Help
Grundlegende Datei- und Verzeichnisoptionen (Ausgabepfad, Dateinamen)
HTML 5, XHTML und HTML 4.01 konforme Ausgabe
Zusätzliche HTML-Ausgabe Dateioptionen (spezielle Dateibenennung, Vorlagedateien, zusätzliche Dateien, spezielle Willkommen-Seite)
Section Reihenfolge und Überschriftenkonfiguration
Erweiterte Abschnittsausgabeoptionen (automatische Tabellenkonfiguration, Navigationslinks und Sectionkonfiguration)
Zusammenklappbare Sections
Register-Abschnitte
Volle Kontrolle über das Layout und die Formatierung
Seiten Kopf- und Fusszeilenkonfiguration
Themen Pfade
Eingebettetes Inhaltsverzeichns und Index für Sofortzugriff
Dynamische Themenpfade
Erweiterte Ausgabeoptionen (Willkommen-Seite, Inhaltsverzeichnis, Index, Copy Links, ...)
Dynamisch expandierendes Inhaltsverzeichnis
Spezielle Headerinformation
HTML-Seiten Kodierung
Grosse Bilder und Hoverglanzlicht-Bilder
Spezielle Suchseitenintegration
HTML Dateivorlage zur einfachen Integration in bestehende Layouts
PDF
Anpassbare PDF Ausgabe
Doppelseitiger Druck
Wasserzeichen
Hyperlinks innerhalb und ausserhalb des Dokuments
Section Reichenfolge und Überschriftenkonfiguration
Erweiterte Abschnittsausgabeoptionen (automatische Tabellenkonfiguration, Navigationsverknüpfungen und Abschnittskonfiguration)
Volle Kontrolle über das Layout und die Formatierung
Seiten Kopf- und Fußzeilenkonfiguration
Volle Kontrolle über automatische Seitennummerierung und Themennummerierung
Erweiterte PDF Funktionen (Lesezeichen, Titelseite, Copyright Seite, Inhaltsverzeichnis, Nummerierung, Index, Kapitelregister)
Graphik für die Titelseite
Thementitelkonfiguration
Erweiterte Ausgabeoptionen (Bildauflösung, Ausgabebilder, Flag-Anzeige)
RTF
Anpassbare RTF Ausgabe
Doppelseitiger Druck
Hyperlinks innerhalb und ausserhalb des Dokuments
Section Reichenfolge und Überschriftenkonfiguration
Erweiterte Abschnittsausgabeoptionen (automatische Tabellenkonfiguration, Navigationsverknüpfungen und Abschnittskonfiguration)
Volle Kontrolle über das Layout und die Formatierung
Seiten Kopf- und Fußzeilenkonfiguration
Volle Kontrolle über automatische Seitennummerierung und Themennummerierung
Erweiterte RTF Funktionen (Titelseite, Copyright Seite, Inhaltsverzeichnis, Nummerierung, Index)
XML
Grundlegende Datei- und Verzeichnisoptionen (Ausgabepfad, Dateinamen)
Kodierung
Strukturoptionen
Tagoptionen
(*) Als reines Hilfe-Authoring-Tool hat Doc-O-Matic Author keine Quellcode-Dokumentationsfunktionen. Diese Funktionen sind in der Tabelle mit n/a gekennzeichnet.
Copyright © 2000-2024 toolsfactory software OG Alle Rechte vorbehalten.