Zugangsweg in Online-Hilfe darstellen

Anleitung: So koppeln Sie den Zugangspfad zu einem Fenster aus den Handlungsschritten aus und kennzeichnen den Zugang per ditaval-Datei.
  1. Der Hinweis auf den Zugangsweg zum Fenster soll durch Flagging in der ditaval-Datei mit einem Cursor-Icon gekennzeichnet werden.

    Cursor-Icon
    Abbildung 1. Cursor-Icon vorm Zugangspfad
  2. Schreiben Sie dazu folgenden Eintrag in die ditaval-Datei:
    <prop att="otherprops" val="zugang" action="flag">
      <startflag imageref="images/icon_cursor.gif"></startflag>
    </prop>
    
    Bitte achten Sie auf die Pfadangabe bei imageref. Diese Pfadangabe bezieht sich auf den HTML-Output. Dort vermuten die HTML-Dateien das Bild.
  3. Versehen Sie den Absatz, der den Zugangsweg beinhalten soll, mit dem Attribut otherprops=”zugang”. Der obige Screenshot wurde über einen Absatz im prereq-Tag realisiert:
    <prereq>
    <p otherprops="zugang" outputclass="zugang">Klicken Sie
    im <wintitle>Hauptmenü</wintitle> auf
    <menucascade>
    <uicontrol>Systemarbeiten</uicontrol>
    <uicontrol>Systemverwalung</uicontrol>
    <uicontrol>Vorlagen</uicontrol>
    </menucascade></p>
    </prereq>
    
  4. Fügen Sie Ihrer Builddatei für den xhtml-Output einen Kopierbefehl copy hinzu.
    <target>
    <ant>
    ...
    </ant>
    <copy todir="${out-dir}${file.separator}${pubname}${file.separator}xhtml${file.separator}images">
    <fileset dir="D:${file.separator}Ihre-Doku-Quelldateien${file.separator}images">
    <include name="**/*.gif" />
    </fileset>
    </copy>
    </target>

    Im Beispiel gibt es innerhalb Ihres Quelldatei-Ordners eine Ordner \images, in welchem sich die benötigten Bilder, u.a. die Datei icon_cursor.gif, befinden. Sämtliche gif-Dateien werden in den Outputordner kopiert, welcher nach copy todir= angegeben wurde.

  5. Weitere Überlegung sollte sein, diesen Zugangsweg nur einmal zu editieren und dann per conref-Mechanismus in die jeweilige Handlungsanleitung zu ziehen. Falls sich doch mal ein Bildschirm oder Menü ändert, brauchen Sie nur in der Originaldatei den Pfad oder ähnliches ändern und durch Content Referenzierung wird die Änderung in sämtlichen Handlungsanleitungen übernommern.
  6. Falls Sie wie im Beispiel um den Zugangsweg einen Rahmen ziehen möchten, vergeben Sie neben dem otherprops-Attribut noch ein outputclass-Attribut und erstellen in der CSS-Datei eine Deklaration gleichen Names.