11 Mai 10 Zugangsweg in Online-Hilfe darstellen

{lang: 'de'}

Anleitung: So koppeln Sie den Zugangspfad zu einem Fenster aus den Handlungsschritten aus und kennzeichnen den Zugang per ditaval-Datei.

Der Hinweis auf den Zugangsweg zum Fenster soll durch Flagging in der ditaval-Datei mit einem Cursor-Icon gekennzeichnet werden.

Abbildung 1. Cursor-Icon vorm Zugangspfad
Schreiben Sie dazu folgenden Eintrag in die ditaval-Datei:
```
<prop att="otherprops" val="zugang" action="flag">
  <startflag imageref="images/icon_cursor.gif"><alt-text>So kommen Sie hin.</alt-text></startflag>
</prop>
```
Bitte achten Sie auf die Pfadangabe bei imageref. Sie muss genauso übernommen werden. Im Beispiel liegt die ditaval-Datei und das Bild in eigenen Verzeichnissen unterhalb des Output-Hauptverzeichnisses:
```
\filters\zugang.ditaval\images\icon_cursor.gif
```
Erstellen Sie eine Topic-Datei, in der Sie das Bild icon_cursor.gif einbinden.
Binden Sie diese Topic-Datei (kann auch ein Concept u.a. sein) in die ditamap-Datei ein und stellen das Attribut toc=no ein. Dieses Einbinden garantiert, dass das icon_cursor.gif rechtzeitig! in den Output-Bilderordner kopiert wird.

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 id="konfigbzr" otherprops="zugang" outputclass="zugang">Klicken Sie
im <wintitle>Hauptmenü</wintitle> auf
<menucascade>
<uicontrol>Systemarbeiten</uicontrol>
<uicontrol>Konfiguration Module</uicontrol>
<uicontrol>BZR.</uicontrol>
</menucascade></p>
</prereq>

Optional:
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.
Optional:
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.


	Titel des Downloads:	Ideen für Dokumentationen und Online-Hilfen
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel als PDF-Datei. Ohne Leerseiten für die A4-Ausgabe optimiert.
	Aktualisiert am:	10.03.2011
	Anzahl der Downloads:	247

Tags: kontextsensitive Hilfe, Zugangsweg zum Bildschirm

Filed in Ideen für die Dokumentation with 0 Comments

11 Mai 10 Zugangsweg zum Bildschirm voranstellen

{lang: 'de'}

Es soll der Zugang zum jeweiligen Bildschirm der eigentlichen Handlungsanweisung vorangestellt und somit extra aufgeführt werden.

Handbuch vs. kontextsensitiver Hilfe

Es gibt zweierlei Arten des Lesens einer Online-Hilfe: linear als Buch oder per Verknüpfung aus der Anwendung. Und immer dann, wenn letzteres geschieht, also eine Handlungsanleitung gezielt durch die kontextsensitive Hilfe geöffnet wird, bedarf es keiner Beschreibung mehr, wie man zum jeweiligen Bildschirm
gelangt ist.

Dies ist nur bei Online-Hilfen relevant, jedoch kann man dies getrost auch in Handbüchern übernehmen. Der doppelte Aufwand, beim PDF-Output den Zugang zum Bildschirm extra in die normale Handlungsanleitung als Step zu integrieren, wäre zu hoch. Denn meistens wird man diese immerwiederkehrende Arbeitsschritte per conref-Mechanismus zentral pflegen und einfügen.

Vorschlag einer Zugangsauszeichnung

Abbildung 1. Zugangsbeschreibung zum beschriebenen Bildschirm auskoppeln

Nutzer, die durch die kontextsensitive Hilfe zum Hilfetopic geleitet wurden, können gleich mit Schritt 1 anfangen.


	Titel des Downloads:	Ideen für Dokumentationen und Online-Hilfen
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel als PDF-Datei. Ohne Leerseiten für die A4-Ausgabe optimiert.
	Aktualisiert am:	10.03.2011
	Anzahl der Downloads:	247

Tags: Zugangsweg zum Bildschirm

Filed in Ideen für die Dokumentation with 0 Comments

11 Mai 10 Zugangsweg in Online-Hilfe darstellen

11 Mai 10 Zugangsweg zum Bildschirm voranstellen

Handbuch vs. kontextsensitiver Hilfe

Vorschlag einer Zugangsauszeichnung

Tutorien

Blog + Tutorien

Schlagwörter

Der Autor

Blogroll

Monatsarchiv

Meta