Wie kann ich unterschiedliche Dokumentationen von einer Quelle erzeugen?

Wenn Sie verschiedene Arten von Dokumentation zum Beispiel eine für den internen Gebrauch und eine für Ihren Kunden erstellen möchten, tun Sie folgendes:

Verwenden Sie spezielle Abschnitte für alle Abschnitte, die nur in einer Ausgabe aufscheinen sollen.
Verhindern Sie die Wiedergabe der Abschnitte, die Sie für die aktuelle Version nicht verwenden möchten.
Markieren Sie Teile des Textes und verhindern Sie die Ausgabe von markierten Textteilen in bestimmten Konfigurationen.
Verwenden Sie Snippets und geben Sie diese in bestimmten Konfigurationen nicht aus.

Um Abschnitte für bedingten Text zu verwenden

Sie haben zum Beispiel ein Thema mit der ID Overview, die sowohl allgemeine Kommentare als auch versionsspezifische Information enthält:

  @@Overview
  This is the overview for my project, it contains
  information on the architecture but nothing specific
  to a certain SKU.

  Professional:
  The professional version of the product can do this and
  this.

  Enterprise:
  The enterprise version is the full product, which does
  more then the professional version. Therefore this
  information goes into the enterprise documentation
  only

Fügen Sie auf der Seite Sections zwei Abschnitte mit dem Namen Professional und Enterprise zu Ihrem Projekt hinzu und schreiben sie die versionsspezifischen Informationen in diese Abschnitte.
Fügen Sie eine Konfiguration Professional und Enterprise zu Ihrem Projekt hinzu.
Verhindern Sie die Ausgabe des Abschnittes Enterprise in der Konfiguration Professional und die Ausgabe des Abschnittes Professional in der Konfiguration Enterprise auf der Seite Files & Format > Sections.
Klicken Sie auf der Registerkarte Project, in der Grupper Build auf den Pfeil unter Build , und dann auf Build All.

Siehe auch

Hinzufügen von Abschnitten, Erstellen und Bearbeiten von Abschnitten

Verwandte Einstellungen

Abschnitte, Anzeige der Abschnitte