Sie können bei der Dokumentationsgenerierung leere Kapitel in Spiegelstrichlisten wandeln und leere Kapitel aus der Dokumentation entfernen.
Spiegelstrichwandlung
Sie können einstellen, dass Kapitelüberschriften, die keinen weiteren Inhalt haben, bei der Dokumentationsgenerierung in Spiegelstriche umgewandelt werden. Dies geschieht aber nur dann, wenn alle Überschriften unter dem gemeinsamen Oberkapitel keinen Inhalt haben. In Spiegelstriche gewandelte Kapitel werden beim Löschen leerer Kapitel nicht entfernt.
Beispiel
Sie haben in der Dokumentation für Klassen festgelegt, das zu der Klasse die Attribute und dazu der Typ ausgegeben wird. Die Klasse Beispiel hat zwei Attribute, von denen nur eines einen Typ hat. Wenn die Spiegelstrichwandlung aktiv ist, wird daraus eine Kapitelstruktur erzeugt, in der unter der Klasse die beiden Attribute in einem Kapitel ausgegeben werden, wobei das eine leer ist und das andere einen Eintrag in der Spiegelstrichliste (evtl. unter einer Zwischenüberschrift für den Typ) hat.
Entfernen leerer Kapitel
Sie können Dokumentationskommandos so konfigurieren, dass der Dokumentationsgenerator nach einer evtl. erfolgten Spiegelstrichwandlung alle Kapitel entfernt, die keinen Inhalt haben. Dieser Vorgang wird von den Blattknoten aus rekursiv nach oben durchgeführt, so dass auch größere Teile der Kapitelstruktur gelöscht werden können.
Beispiel (Fortsetzung)
Wenn in dem oben skizzierten Fall die leeren Kapitel vom Dokumentationsgenerator entfernt werden, wird auch die Überschrift des Attributs ohne Typ gelöscht.
Leere Kapitel nicht löschen
Da das generelle Löschen von leeren Unterkapitel mitunter nicht erwünscht ist (siehe Beispiel im vorigen Abschnitt), bietet Innovator für solche Kapitel die Option, dass sie behalten werden sollen. Dazu aktivieren Sie auf dem entsprechenden Modellelementaufzählungskapitel im Eigenschaften-Dialog im Register Merkmale die Eigenschaft leere Kapitel nicht löschen.
Verwandte Themen
