Home

1ad1281d8a264d55836aceb0028df981

1. Copyright 2007 MegaSoft Fictional S R 2007 Bild 19 Topic in der Vorschau 46 4 1 Topics Auch in einer Online Hilfe ist der Text das erste Mittel der Wahl wenn es um die Kommunikation mit dem Leser geht Die Kommunikationssituation ist dabei eine besondere denn es fehlen unterst tzende Mittel wie Tonlage oder Gestik um der Botschaft Eindeutigkeit zu verleihen Hinzu kommt dass in einer Online Hilfe der typische lineare Text aufgebrochen ist in ein zelne Informationseinheiten die netzartig miteinander verbunden sind Online Hilfen sind Teil der gesamten Produkt Dokumentation Idealerweise erg nzen sich die Inhalte einer Online Hilfe und der brigen Dokumentation zu einem sinnvollen Ganzen mit m glichst wenig Redundanzen Dieses Kapitel schl gt einen Bogen von der Menge der Information die ein Produkt beschreibt bis zu den einzelnen Topics Es beschreibt die unter schiedlichen Textarten und sorten und die M glichkeiten diese Texte zu strukturieren und auf einzelne Topic Klassen aufzuteilen Text Ein Text hat eine praktische Bedeutung und ist in eine kommunikative Situation eingebettet Er hat damit eine Funktion und einen Zweck und wird auch als sprachliche Handlung betrachtet Linguisten beschreiben einen Text mit folgenden Kriterien Koh sion Grammatische und lexikalische Abh ngigkeit der Komponenten Koh renz Konzepte und Beziehungen Zusammenhang Intentionalit t Ziel des Autors
2. 6 3 6 3 1 Elementebene Information auf Feld oder Elementebene Aufruf z B uber das verschiebbare Fragezeichen Symbol e Eingebettete Hilfe Kurze Texte und Anleitungen die direkt in die Benutzeroberflache integriert sind Kontextfrei Diese Zugriffsart ffnet eine eigenst ndige Online Hilfe ohne Bezug zum aktuellen Zustand des Produkts Aufgerufen wird die kontextfreie Hilfe in der Regel ber das Hilfe Men Auf die kontextfreie Hilfe kann der Leser auch indirekt ber Links nach einem kontextsensitiven Aufruf z B in einer Dialogbeschreibung oder ber einen Hilfeagenten zugreifen Dann braucht er alle vorgenannten Mittel um die Informationen zu finden Navigationshilfen Da das Orientierungsproblem unterschiedliche Ursachen hat wurden auch unterschiedliche Navigationshilfen entwickelt die eine oder einige Ursa chen dieses Problems entsch rfen k nnen Deswegen findet sich in kon kreten Hypertexten auch meistens eine Kombination mehrerer Navigationshilfen Traditionelle Orientierungshilfen Traditionelle Orientierungshilfen sind Meta Informationen die auch in B chern verwendet werden und auf das Hypertext Konzept bertragen wurden Traditionelle Orientierungshilfen haben zum einen den Zweck die Textstruktur zu verdeutlichen zum anderen dienen sie dem schnellen Auf finden bestimmter Informationen Inhaltsverzeichnis In B chern sollen Inhaltsverzeichnisse den Lesern einen ersten berblick ber de
3. Avon K Notes e Inthe notes section you can list any special information Or cautions you may have for the user Tip It is easy to report a bug during beta testing There is a Submit a Bug link right on the Flare Start page Bild 42 Beispiel eingeschobener Text Ausklappbarer Text 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic das den ausklappbaren Text erhalten soll 3 Markieren Sie im Topic den Text der als sensitive Stelle Hotspot angezeigt werden soll 4 Wahlen Sie den Befehl Einf gen Ausklappbarer Text Der Dialog Ausklappbaren Text einf gen ffnet sich Der markierte Text steht schon in der Liste Head f r ausklappbaren Text 5 Klicken Sie auf OK um den ausklappbaren Text einzuf gen Der Dia log schie t sich und ein Symbol und zwei Paar eckige Klammern wer den an Stelle des markierten Textes untereinander im Topic eingef gt Das erste Klammerpaar enth lt den Text f r den Hotspot Head das zweite einen Blindtext Body 2 El Beispiel f r eine Phase Dies ist der ausklappbare Text 138 Umsetzung mit Flare 6 Geben Sie f r das zweite Klammerpaar den Text ein der nach einem Klick eingeblendet werden soll Ersetzen Sie dabei auch die eckigen Klammern 7 Sie k nnen jederzeit den Text bearbeiten oder formatieren Sie k nnen auch Bilder Tabellen oder weitere sensitive Elemente einf gen 8 Speichern Sie das Topic mit dem Befehl Datei
4. Stichwortverzeichnis Ein Stichwortverzeichnis ist ab einer Gr enordnung von etwa zehn Topics in einer Online Hilfe erforderlich F r alle Topics die ber das Stichwortver zeichnis erreichbar sein sollen sollten mindestens zwei bis f nf Stichw rter erfasst sein Bew hrt hat sich ein zweistufiger Index Ein Stichwort sollte aus m glichst wenigen aussagekr ftigen W rtern bestehen Eintr ge die allein nicht aussagekr ftig oder mehrdeutig sind sollten durch Untereintr ge weiter aufgegliedert werden Bei mehr als zehn Treffern zu einem Stichwort sollte dieses weiter unterteilt werden Die folgende Tabelle gibt einen berblick ber m gliche Stichw rter und ihre bliche Verwendung in einem deutschen Stichwortverzeichnis Tabelle 11 Formen von Stichworteintr gen Stichwort Form Beispiel Substantiv e ohne Artikel im Singular Datei Datei Endungen e Plural nur wenn es kein en Singular gibt oder es um gel htm eine Menge geht 8 mpj Adjektiv Grundform extern Link Variable Link extern intern Verb Infinitiv Datei speichern Speichern Datei Abk rzung h ufiger verwendete Form die Langform andere Form mit einem Siehe auch Verweis 112 Fazit f r Online Hilfen 6 5 2 Gerade wenn mehrere Autoren an einem Hilfeprojekt arbeiten sind ein deutige Festlegungen zur Erfassung von Stichw rtern erforderlich Dazu geh rt z B e _Gro Kleinschreibung f r Ver
5. itylest heet Editor 3 Erweiterte Ansicht X 23 X Formate importieren 8 Neue Klasse e Umbenennen Neues Medium Ze e Absatzformate Moo n Datentrager voreing zl SF B Z U nicht eingestellt e Name Bedingung Klasse PseudoKlasse Vorschau border bottom color border bottom style border botte R hi h2 Iw MadCap Sa h3 h3 MadCap Sofi h4 h4 MadCap Sofi p b p MadCap Soft p MadCap2 p MadCap2 MadCap Soft tip p tp 000000 Solid 1px 15 E MadCap Softw hs re MadCap Softwar div div MadCap Soft address address MadCap Soft blockquote blockquote MadCaj pre pre MadCap Sof center center MadCap Soft menu menu MadCayj dit dit MadCaj fieldset fieldset MadCap Soft Bild 27 Vereinfachte Darstellung im Stylesheet Editor Stylesheet bearbeiten erweiterte Darstellung E Setzen Sie die Sicht auf de Formatklassen auf Absatzformate In der Liste der Formatklassen werden nur die Absatzformate eingeblendet Setzen Sie die Sicht der Eigenschaften auf Anzeigen Gruppierte Eigenschaften W hlen Sie in der Liste der Formatklassen die Formatklasse H1 Die Eigenschaften dieser Formatklasse werden in der Liste der Eigen schaften in Gruppen sortiert angezeigt ffnen Sie die Eigenschaftsgruppe Font durch einen Klick auf das Plus Zeichen Alle Eigenschaften einer Gruppe haben einen Namen und einen Wert Klicken Sie auf den Wert von font family
6. seite mit der ausgew hlten Vorlage erstellt werden soll Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt die neue Vorgabeseite im Topic Explorer im Ordner Resources Vorgabeseiten an und ffnet sie zum Bearbeiten im Arbeitsbereich Hilfeseiteflmp x Startseite m e F Medium Voreinstel breadcrumbs Proxy 2 Topic Body Proxy Mini TOC Proxy Bild 25 Neue Vorgabeseite f r eine Online Hilfe 82 Umsetzung mit Flare 5 7 2 Vorgabeseite bearbeiten Die Vorgabeseite mit vordefinierten Eintr gen ist bereits im Editor von Flare ge ffnet Sie k nnen die Vorgabeseite wie jede andere Seite bearbeiten und beispielsweise den Mini TOC Proxy am Ende der Vorgabeseite l schen und statt dessen einen Copyright Vermerk einf gen nderungen der Vorgabeseite werden erst zum Generierungszeitpunkt wirksam d h Sie sehen in den Topic Dateien im Flare Projekt keine Auswirkungen Vorgabeseite zuweisen Eine Vorgabeseite k nnen Sie auf unterschiedliche Arten zuweisen e ber die Zieldefinition dann gilt die Vorgabeseite f r alle Seiten die mit dieser Zieldefinition verbunden sind siehe Abschnitt Wie alles zusam menkommt die Zieldefinition auf Seite 92 e ber das Inhaltsverzeichnis interessant f r Druckversionen dann gilt die Vorgabeseite f r alle folgenden Seiten bis zur Zuweisung einer anderen Vorgabeseite Styleshee
7. Bildschirm und die Nutzen Erwartung der Leser Beim Lesen folgen die Augen der geschriebenen Zeile von links nach rechts Wortsilhouetten wer den erkannt und als Impulse an das Gehirn weitergeleitet Die erkannten Worte werden im Ged chtnis mit bereits gespeicherten Begriffen abgeglichen und entschl sselt Das dauert f r lange oder zusam mengesetzte Worte l nger als f r kurze Denn das Auge sieht nur auf wenige Millimeter scharf Beim Lesen werden lange W rter in diesen Milli meterspr ngen erfasst im Kurzzeitged chtnis zusammengesetzt und mit Worten aus dem Ged chtnis abgeglichen Sinn wird gesucht Neue W rter werden dabei ber den Zusammenhang interpretiert und eingeordnet Je mehr Begriffe bereits im Ged chtnis vorhanden sind um so schneller und fl ssiger liest ein Mensch Die Lesbarkeit eines Textes h ngt somit von der Wortwahl ab das Verst ndnis vom Zusammenhang dem sogenannten Kontext Sprache bzw Textstruktur und Textorganisation steuern die Les barkeit und Benutzerfreundlichkeit von Online Hilfen 71 Layout Lesen ist ein erlernter Vorgang Seit Jahrhunderten sind wir durch die abendl ndische Kultur darauf trainiert von links nach rechts und von oben nach unten zu lesen Orientierung von Absatz zu Absatz und der Lesefluss von Zeile zu Zeile sind die Grundlagen jeder Textorganisation Suchen Eine Online Hilfe muss unterschiedlichen Suchstrategien gerecht werden Abh ngig vom Bildschirm kann die Le
8. Links sollten immer unterstrichen dargestellt werden und damit dem Defacto Web Standard folgen Bei einer mehrfachen Vergr erung eines Bildschirmausschnitts mit einem Screen Magnifier k nnen Nutzer eine sub tilere Auszeichnung wie beispielsweise fette oder blaue Schrift f r einen Link oftmals nicht erkennen Gr e Kn pfe und gro er Text f r Links erleichtert ihre Treffbarkeit f r Menschen mit motorischen Schwierigkeiten Viel Wei raum um diese Links stellt sicher dass solche Menschen nur die Seite ansteuern die sie ansteu ern wollen und nicht diejenige die dem zu treffenden Link folgt oder vor ausgeht 153 Barrierefreiheit 7 4 Umsetzung mit Flare Flare bietet mit seiner strikten Trennung von Inhalt und Gestaltung durch XHTML und Stylesheets gute Voraussetzungen barrierefreie Online Hilfen zu erstellen Stylesheets bieten ber den Parameter Medium Flare Daten tr ger die M glichkeit nicht nur Druck und Online Ausgaben zu unterst t zen sondern auch andere Ausgabeger te Eine Auswahl finden Sie in der folgenden Tabelle Tabelle 13 Medieneinstellung im Stylesheet Medium Bedeutung aural Sprachorientierte Ausgabeger te wie z B Screen Rea der braille Blindenschriftf hige Ausgabeger te embossed Blindenschriftf hige Drucker handheld Ausgabeger t mit kleinem Display wie z B ein PDA projection Video Beamer screen Bildschirme tty Ausgabegr te mit feststehenden
9. Programmiersprache usw Diese Informationen sind oft wie ein Nach schlagewerk organisiert damit Nutzer schnell und direkt auf bestimmte Informationen zum Programm zugreifen k nnen Dabei k nnen Ober fl chenbeschreibung und Referenzinformation ineinander greifen Die Programmbeschreibung ist als gedrucktes Nachschlagewerk hilfrei cher Informationen f r Papier Es gibt weiterhin Informationen die ber ein anderes Medium in der Regel Papier angeboten werden m ssen Das Produkthaftungsgesetzt verlangt dies f r Sicherheitshinweise soweit vom Produkt Gefahr f r Leib und Leben ausgehen kann Weiter sind dies Informationen die der Nutzer sonst zeitlich zu sp t erh lt wie z B Software Voraussetzungen technische Daten oder eine Installations Anleitung die nicht kontextsensitiv angebun den ist Topic Klassen bestimmen Wenn klar ist wie die Informationen erstellt und aufgeteilt werden sollen k nnen die Topic Klassen bestimmt werden wobei die Oberklassen fest stehen e Anleitung e Beschreibung Beide Oberklassen k nnen aber weiter unterteilt werden um den Anforde rungen des Produkts gerecht zu werden Beispielsweise kann es f r ein Produkt einfache Aufgaben geben und Abl ufe die sich aus einzelnen Auf gaben zusammen setzen Die Beschreibungs Klasse kann sich aufteilen in e Einleitung berblick e Dialog Beschreibung e Element Beschreibung im Dialog e Oberfl chenbeschreibung Men s Befehle Symbole
10. STS aen re EE E 89 5 7 4 Wie alles zusammenkommt die Zieldefinition 92 5 7 5 Bilder und Video 95 6 Navigation Sie a 8 a na a ee ee an 97 6 1 Orientierungsproblem 97 6 2 Informationen finden 99 6 3 Navigationshilfen 100 6 3 1 Traditionelle Orientierungshilfen 100 6 3 2 Orientierung durch Beschr nkung 102 6 3 3 R ckw rtsgerichtete Orientierungshilfen 104 6 4 Links wee Ad eS e e Pode d pa ee ee E 105 6 4 1 Link Arten 2 2 2 u nn ee we 105 6 4 2 Darstellung und Platzierung von Link Ankern 109 xi Inhalt 6 5 Fazit f r Online Hilfen 110 6 5 1 Traditionelle Orientierungshilfen 111 6 5 2 Beschr nkungen 2 2 a a 113 6 5 3 R ckw rtsgerichtete Orientierungshilfen 114 6 54 LINKS 2244 ie a AEN e A 114 6 6 Umsetzung mit Flare 2 2 on mn 117 6 6 1 Inhaltsverzeichnis 117 6 6 2 Stichwortverzeichnis 2 22 22 2 nu nn 119 6 6 3 Fachwortverzeichnis 2 22 2 nn nn 122 6 6 4 Lesepfade 125 6 6 5 LINKS set manoa E E e era ged ees 126 6 6 6 Link B ndel Siehe auch Verweise 132 6 6 7 Sensitive Elemente 2 2 Cm m nn 137 6 6 8 Interaktives Element nur HTMLHelp 22222 140 7 Barrierefreiheit 2 2 nenn 143 7 1 Assistive Technologie 143 7 2 Gesetzlicher Rahmen 145 7 3 Fazit f r Online Hilfe aa aaa 150 1 31 Layout seed ee sea ee eee ee OR a Ri 150 O32 Bilder u a dha d
11. Seitentitel Popup Text in einer Hilfe der nur angezeigt wird wenn Nutzer auf ein sensiti ves Element klicken Dadurch erst wird weiterer Text oder ein Bild in einem eigenen abh ngigen Fenster angezeigt Prim r Assistenz Alle Informationen die am Display eines Produkts auf den ersten Blick sichtbar sind z B Beschriftung der Benutzeroberfl che Vergleiche auch Assistenz System Sekund r Assistenz propriet r Dateiformate oder Hardware die nicht allgemein anerkannten Stan dards entsprechen also sozusagen hauseigene Entwicklungen sind oder nur auf einer bestimmten Plattform ablauff hig sind Proxy Programmmst ck f r Vorgabeseiten das zum Generierungszeitpunkt ausgef hrt wird Schaltfl che Sensitives Oberfl chen Element das einen Befehl ausl st Sekund r Assistenz Alle Informationen die an der Benutzeroberfl che nicht auf den ersten Blick sichtbar sind und f r die Nutzer erst etwas tun m ssen z B zur Ausgabe eines Tooltips die Maus bewegen Vergleiche auch Prim r Assistenz Assistenz System 183 Fachw rter Sensitives Element Hotspot Symbole oder Text die beim Anklicken eine Funktion Hilfe oder einen Befehl Anwendung ausf hren beispielsweise ein Verzweigen an eine andere Stelle Vergleiche auch Normales Element Kontextsensi tiv Schaltfl che Serifen Kleine Querbalken an den An und Abstrichen der Schriftzeichen Serifenlose Schriften Aus der Anti
12. Text in einer Hilfe der nur angezeigt wird wenn Nutzer auf ein sensiti ves Element klicken Dadurch erst wird der ausklappbare Text sichtbar Ausklappbarer Text besteht meist aus einem oder mehreren Abs tzen Die nachfolgenden Abs tze im Topic verschieben sich entsprechend nach unten Dies eignet sich z B f r weiterf hrende Erkl rungen f r eine kleinere Benutzergruppe beispielsweise Anf nger Vergleiche auch Erweiterbarer Text Popup Auszeichnung Typographie Darstellungsmittel Oberbegriff f r formale Textauszeichnungen zur Hervorhebung wichti ger Stellen oder festgelegter Elemente Auszeichnungen sind bei spielsweise fett kursiv unterstrichen farbig Befehl Men punkt Men Eintrag Men Option Men funktion Kommando Alles was an der Benutzeroberfl che durch eine Eingabe Mausklick Tastendruck eine Aktion ausl st Befehle k nnen direkt ber Men s eine Tastenkombination oder Schaltfl chen gestartet werden Benutzerfreundlichkeit Gebrauchstauglichkeit Usability Benutzbarkeit eines Produkts oder einer Dienstleistung Benutzeroberfl che GUI Bedienoberfl che grafische Bedienoberfl che Schnittstelle am Bildschirm zwischen Mensch und Produkt ber die Nutzer mit einer Anwendung oder einem Assistenz System interagie ren 176 Fachw rter Beschreibung Textsorte die einen Sachverhalt darstellt Vergleiche auch Handlungs anleitung Bildschirm Art eines Displays Ausgabeger t
13. e Relevanz fasst zusammengeh rende Informationen in Einheiten zusammen e Betitelung fordert den eindeutigen Bezug der berschriften zum Inhalt e Konsistenz verlangt die Gleichbehandlung vergleichbarer Elemente e Gileichwertigkeit der Informationstr ger stellt Text Tabellen Bilder und Diagramme auf eine Stufe e Verf gbarkeit der Einzelheiten damit Informationen an der Stelle ste hen an der sie gebraucht werden e Hierarchische Gliederung 50 Strukturierungsmethoden 4 2 2 Mit sechs sogenannten Informationsarten liefert Information Mapping Ordnungskriterien die die Informationen inhaltlich gliedern e Begriff definiert ein Objekt e Fakt definiert eine Objekteigenschaft e Prinzip beschreibt eine Gesetzm igkeit e Prozedur beschreibt eine Handlung e Prozess beschreibt die Funktionsweise eines Objekts e Struktur beschreibt den Aufbau eines Objekts Zuerst wird jede Information einer Informationsart zugeordnet beispiels weise geh ren Beispiele Metapher oder Gegenbeispiele zur Informations art Begriff Warnungen Zielsetzungen und Vorschriften zur Informationsart Prinzip Danach wird f r jede Informationsart ein Text erstellt Der Text selbst sollte aus f nf bis neun Informationstr gern hierzu z hlen z B Tabellen Diagramme usw bestehen die gleichwertig sind Die Wahl des Informationstr gers h ngt ab von der Zielgruppe und der Art der Pr senta tion die der Sachlogik am ehesten gerecht
14. eigener Formate zur Darstellung erm glicht eine ger te und nutzerorien tierte Darstellung von Texten und deren Ausdruck Diese Vorz ge nutzen schon heute blinde oder sehbehinderte Menschen mit ihren Endger ten Aber durch eine Anpassung an den Nutzer Rende ring Profiling k nnen auch andere Nutzergruppen erschlossen werden So ist die Aufbereitung der Texte durch Assistive Technologie zwar f r andere Nutzergruppen noch nicht sehr entwickelt aber Browser die Avatare Bil der und Animationen einsetzen um Texte f r die Nutzer aufzubereiten sind realisierbar Umgekehrt gilt dass alle Information die nicht als Text vorhan den ist eine Barriere f r viele Nutzer mit Behinderungen darstellt Da die Verwendung grafischer Mittel demgegen ber f r viele Nutzer sehr wichtig ist kann eine reine Textdarstellung nicht die L sung sein Bedienbarkeit Dieses Prinzip zielt auf die Ger teunabh ngigkeit insbesondere bei der Eingabe ab Beispielsweise k nnen Blinde einen Mauszeiger auf dem Bild schirm nicht bedienen Auch Seh und Mobilit tsbehinderte verwenden ten denziell die Tastatur anstatt der Maus H ufig lassen sich aber nur bestimmte Teile einer Seite mit der Tastatur steuern 146 Gesetzlicher Rahmen Die Bedingungen dieses Prinzips beg nstigen Menschen die e Blind oder sehbehindert sind e Schwierigkeiten mit der Augen Hand Koordination von Eingabeger ten haben e K rperlich behindert sind e Zeigegera
15. ndern 43 Das Hilfe Autorensystem Flare 3 6 2 3 6 3 22 Klicken Sie auf Akzeptieren um den Import mit den gew hlten Ein stellungen durchzuf hren Das neue Projekt wird angelegt und ge ff net Eine Kopie der Parameter f r den Import finden Sie in der Projektorganisation im Ordner Importe Zus tzlich zu den Dateien in einem neuen Projekt hat Flare folgende weitere Dateien beim Import angelegt Tabelle 7 Durch Import angelegte Dateien Datei Ort im Hilfeprojekt Topic Dateien Topic Explorer Content Bild Dateien Topic Explorer Resources Images Hilfeprojekt bearbeiten Grob gesagt enth lt ein Hilfeprojekt e Dateien mit den Inhalten oder Topic Dateien e Steuerdateien die bestimmen wie mit den Inhalten umzugehen ist Beide Dateiarten k nnen Sie anlegen bearbeiten l schen und miteinander verkn pfen Wie Sie Topics bearbeiten ist im Kapitel Topics auf Seite 47 beschrieben die wichtigsten Steuerdateien f r ein Flare Projekt sind in den Kapiteln Layout auf Seite 71 und Navigation auf Seite 97 beschrieben Online Hilfe generieren Die Generierung einer Ausgabe starten Sie ber die Zieldefinition Wenn Sie ein Vorg nger Projekt oder eine Word oder FrameMaker Datei impor tiert haben k nnen Sie daraus direkt eine Online Hilfe generieren Wenn Sie ein leeres Projekt angelegt haben brauchen Sie ein Topic und ein Inhaltsverzeichnis das dieses Topic enth lt Um eine O
16. nicht eingestellt Der Dialog Schriftfamilien Wahl ffnet sich W hlen Sie in aus der linken Liste Installierte Familien Alle Schriften die auf Ihrem Rechner installiert sind werden in der rechten Liste im Dialog eingeblendet W hlen Sie aus dieser Liste eine Schriftfamilie aus z B Verdana 87 Layout Best tigen Sie mit OK Der Dialog schlie t sich und die Schriftfamilie wird f r die Eigenschaft font family bernommen Der Dateiname des Stylesheets wird mit einem Stern markiert um die nderung anzuzei gen Klicken Sie auf den Wert der Eigenschaft font size Rechts wird ein Pfeil sichtbar Klicken Sie auf den Pfeil Ein Dialog zum Einstellen der Schriftgr e ffnet sich Setzen Sie zuerst die Einheit indem Sie auf den Pfeil neben em kli cken Eine Liste der m glichen Einheiten ffnet sich W hlen Sie die passende Gr eneinheit z B Punkt pt f r Druck ausgaben oder Pixel px f r Online Ausgaben Setzen Sie dann die Gr e f r die berschrift z B 14 Punkt Mit OK best tigen Sie Ihre nderungen Der Dialog schlie t sich und die Anderung wird f r die Eigenschaft font size bernommen Speichern Sie das Stylesheet mit dem Befehl Datei Speichern Der Stern neben dem Dateinamen des Stylesheets ist nicht mehr sichtbar Passen Sie die erforderlichen Formatklassen und ihre Eigenschaften an Ihre Layout Anforderungen an Stylesheet zuweisen Sie k nnen ein
17. nn nn nn 38 3 6 Erste Schritte 38 3 6 1 Projektanlegen 38 3 6 2 Hilfeprojekt bearbeiten 44 3 6 3 Online Hilfe generieren 44 4 Topics a en ee ee een ts nee ne Saar 47 AN Text ebe deg de a be E E 47 4 1 1 Linearer Text oosa ios aak g tie aa eap a e Ei e E a o a 48 4 1 2 Hypertext 48 4 2 Strukturierungsmethoden 22 8 50 4 2 1 Information Mapping 50 4 2 2 Funktionsdesign 51 4 2 3 Informationsdesign 52 4 2 4 Textsorien 53 4 3 Topic Klassen aoaaa a 54 4 3 1 Konzept Topics nn 55 4 3 2 Referenz Topics 2 2 22mm nn 55 4 3 3 Prozedur Topics 55 4 3 4 Fachwort Topics 2 2 22H a a 55 Inhalt 4 4 Fazit f r Online Hilfen e 55 4 4 1 Dokumentationsstruktur festlegen 2 2 22222 56 4 4 2 Topic Klassen bestimmen 2 2 2 nn nn 58 4 4 3 Struktur einer Topic Klasse festlegen 2 22 22 59 4 5 Umsetzung mit Flare e 60 4 5 1 Topic anlegen aaau a a a 60 4 5 2 Topic importieren 61 4 5 3 Topic Eigenschaften 61 4 5 4 Topic bearbeiten 63 4 5 5 Vorlagen 67 5 Layout EE e eee eee sarea 71 5 1 Seitengestaltung 73 5 2 Schrift aea aooi ee 74 5 3 Sprach oaoa tke e544 EE Oe ewes Bee SE BR 75 5 4 Farben gv bee eee RHE EHD EE eee ee taa 75 5 5 Bilder eg Bite Sel ee Ew ada ee Bowe A 77 5 6 FazitflrOnline Hilfen 2000 80 5 7 Umsetzung mit Pare e EN 5 1 Vorgabeseiten s a sso da E EE Gale wk wel EN 8 EN 5 7 2 Stylesheets 83
18. r kontextsensitive Hilfe auf Element Ebene Kontextsensitive Hilfe auf Dialogebene beschreibt einen Dialog ein Fenster oder ein Register insgesamt einschlie lich aller Elemente ihre Zusam menh nge und Abh ngigkeiten Je weniger Konzeptwissen f r die Zielgruppe und den Sachverhalt notwen dig ist um so eher eignen sich kontextsensitive Hilfen auf Element oder Dialogebene im Unterschied zu kontextfreien Hilfen Das Aussehen von kontextsensitiven Hilfen kann sehr unterschiedlich sein blich sind Bubble Help Popup Help eigene Fenster in denen die Online Hilfe angezeigt wird Wenn die kontextsensitive Hilfe in einem speziellen Bereich der Benutzeroberfl che angezeigt wird spricht man von eingebet teter Hilfe Die f r den Nutzer sichtbare Anbindung der Online Hilfe an die Software kann ebenfalls sehr unterschiedlich sein Folgende M glichkeiten gibt es e Hilfe Men in der grafischen Oberfl che die einzelnen Befehle ffnen bestimmte Teile der Online Hilfe z B den Suchen Dialog oder das Inhaltsverzeichnis e F1 Hilfe durch Dr cken der F1 Taste wird die passende Information f r das markierte Element im Hilfefenster angezeigt e Hilfe Schaltflache im Dialog oder Fragezeichen in Titelleiste e Dynamische Hilfe eingebettete Hilfe die selbstgesteuert passend zur aktuellen Handlung in der Benutzeroberfl che angezeigt wird 14 Arten von Online Hilfen 2 2 6 2 2 7 Auch hier h ngt die Erfassung un
19. usw e Weitere Klassen 58 Fazit f r Online Hilfen 4 4 3 F r jede Topic Klasse werden dann Eigenschaften und ihre Struktur festge legt Typische Eigenschaften k nnen sein e Klassenname e _ _Namenskonvention f r Dateiname e _Zugangsm glichkeiten e Erlaubte Links Struktur einer Topic Klasse festlegen Die Struktur einer Topic Klasse legt fest welche Informationsarten Infor mation Mapping oder funktionale Einheiten Funktionsdesign in ihr vor kommen d rfen Es empfiehlt sich f r jede Topic Klasse ein Muster mit erlaubten und optionalen Einheiten anzulegen F r die Topic Klasse Auf gabe k nnte so ein Muster wie folgt aussehen Titel Zielangabe Kurzbeschreibung der Aufgabe ohne Links Voraussetzungen Warnhinweise Schritte 1 Schritt ohne Links GSM Si Ergebnis Weiterf hrende Informationen Link zu Konzept Verwandte Aufgaben Link zu Aufgabe Bild 22 Muster f r Topic Klasse Aufgabe Anhand der Muster kann nun festgelegt werden welche Auszeichnung oder welcher Stil f r die einzelnen Elemente verwendet wird Beispiels weise m ssen bestimmte berschriften wie Voraussetzung oder Ergebnis immer so genannt werden wenn sie auftreten 59 Topics 4 5 4 5 1 Es lassen sich f r jede Topic Klasse ganz konkrete Schreibregeln entwi ckeln beispielsweise f r berschriften von Topic Klassen Verb am Ende f r Aufgaben Datei speichern oder Substa
20. z B f r unter schiedliche Auftraggeber unterschiedliche Hilfeformate oder unterschiedli che Produkte die Sie in einem Projekt verwalten Skin anlegen Um eine Skin anzulegen gehen Sie folgenderma en vor 1 W hlen Sie den Befehl Projekt Neue Skin Der Dialog Neue Skin 6ff net sich W hlen Sie eine Vorlage f r die Skin aus Geben Sie der Skin bei Dateiname einen Namen Klicken Sie auf Einf gen um die neue Skin anzulegen Der Dialog schlie t sich und es ffnet sich die Abfrage ob die Skin mit der ausge w hlten Vorlage erstellt werden soll 5 Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt die neue Skin in der Projektorganisation im Ordner Skins an und ffnet sie zum Bearbeiten im Arbeitsbereich 90 Umsetzung mit Flare e HTML Help Window x 2 Stylesheet Editor neu css y Startseite 3kin Editor Als DotNet Hilfefenster ansehen Als WebHelp Fenster ansehen Als HTML Hilfefenster ansehen Neue Klasse Basis 4 1 Titel ApplicationHelp Sample Gr e Benutzerdefinierte Titel unterst tzt DotNetHelp noch nicht WebHelp Einstellung Funktionen M Inhaltsverzeichnis Voreinstellung Als Voreinstellung WebHelp Symbollei Registerkarten in HTML M Index Help auBer Suchen HTMLhelp Einstellung Wortverzeichnisse und m Lesepfade welche im Inhaltsverzeichnis A Lesepfade Formate Iw Favoriten C Topic Kommentare C Aktuelle Kommentare angezeigt werden Akko
21. z IRCH Vorschau Bild 26 Neues Stylesheet in erweiterter Darstellung Darstellung im Stylesheet Editor Um die Absatz und Zeichenformate im Stylesheet zu bearbeiten k nnen Sie die vereinfachte oder erweiterte Darstellung nutzen Zwischen beiden Darstellungen schalten Sie mit der ersten Schaltfl che der lokalen Symbol leiste hin und her Flare speichert die aktuelle Darstellung des Stylesheets und ffnet alle anderen Stylesheets ebenfalls in dieser Darstellung Auch neue Stylesheets werden in dieser Darstellung ge ffnet Die erweiterte Darstellung zeigt Ihnen die Formatklassen und ihre Eigen schaften in zwei Listen an links die Formatklassen in einem hierarchischen Baum rechts die gruppierten Eigenschaften Mit den Auswahllisten ober halb der Listen k nnen Sie die Sicht auf Formatklassen und Eigenschaften filtern In der erweiterten Darstellung k nnen Sie die Eigenschaften jeweils einer Formatklasse bearbeiten Die vereinfachte Darstellung zeigt Ihnen die wichtigsten Eigenschaften der Formatklassen in einer Tabelle an In der vereinfachten Darstellung k nnen Sie die wichtigsten Eigenschaften mehrerer markierter Formatklassen bearbeiten Mehrere Formatklassen markieren Sie mit der Maus und gedr ckter Shift oder Ctrl Taste Ein Doppelklick auf die markierten For matklassen ffnet den Eigenschaftsdialog in dem Sie spezielle Eigen schaften ndern k nnen 86 Umsetzung mit Flare C Styles css x Startseite
22. 113 Links 114 ruckwartsgerichtet 104 Stichwortverzeichnis 112 Orientierungspfad 62 101 aktivieren 119 sensitive Elemente 111 Piktogramm 78 Popup 106 183 anlegen Glossar 131 anlegen Text 129 anlegen Topic 130 196 Stichw rter Prim r Assistenz 5 183 Projekt einlesen 37 Flare 36 Hilfe 36 Projektdatei 32 Projektorganisation 31 Proxy Body 81 breadcrumbs 81 Mini TOC 81 Prozedur Topic 55 Q Querverweis 128 R Referenz Information 58 Topic 55 Referenzieller Link 108 Robustheit 148 R ckmeldung 12 R ckw rts bl ttern 104 R ckw rtsgerichtete Orientierungshilfe 104 S Scannen 72 Schaltfl che 56 183 Schrift 74 Gr e 74 Laufweite 74 Screen Magnifier 144 Reader 143 Seitengestaltung 73 Informationsmenge 73 Sekund r Assistenz 5 183 Fenster 106 Sensitiv Orientierungspfad 111 Sensitives Element 184 Serifen 184 Server basiertes Hilfeformat 21 Shortcut siehe interaktives Element Sicherheitshinweis 56 58 Signalwort 184 Skin 89 184 bearbeiten 91 kontextsensitivem Topic zuordnen 166 neu anlegen 90 Sprache einstellen 172 bersetzen 172 Spationieren 74 184 Sprache 75 172 f r Flare Oberfl che 34 Sscreenshot siehe Bildschirmabzug Start Assistent 38 Statisches Bild 78 Statusmeldung 12 Steuerelement 159 182 Stichwort anlegen 119 Link 135 Trenner f r Stufen 120 Stichwortverzeichnis 101 112 Datei 36 Struktur Tabelle 65 XML Tags 64 Strukturierun
23. 175 Anwendung 175 API 175 f r DotNetHelp 20 HTMLHelp 17 HtmlHelpW 170 Winhelp 16 AppleHelp 20 Arbeitsbereich Flare 26 Arbeitsumgebung anpassen 33 ASCII 169 Assistent 12 175 Assistenz System 5 11 176 Assistent 12 Beschriftung 11 Hilfeart 179 kontextfreie Online Hilfe 15 kontextsensitive Online Hilfe 13 191 Stichw rter Assistenz System Meldung 12 Prim r Assistenz Sekund r Assistenz Tooltip 11 Assistive Technologie Ausgabe Audio Browser 144 Braille Zeile 143 Screen Magnifier 144 Ausgabeformat 37 92 Ausgabeger t Screen Reader 143 Ausgangsanker 105 116 Ausklappbarer Text 106 176 Auszeichnung 176 Autoren Tool siehe Hilfe Autorensystem 183 183 143 B Backtracking siehe r ckw rts Bl ttern Barrierefreiheit 143 assistive Technologie 143 Bilder 152 Layout 150 Links 153 Multimedia 152 Online Hilfe 150 Validierung 150 Bearbeiten Header Datei 163 Skin 91 Stylesheet 87 Vorgabeseite 83 XML Tag 28 Bedienbarkeit 146 Bedienoberfl che siehe Benutzerober fl che Befehl 56 176 Benutzbarkeit 1 Benutzerfreundlichkeit 1 176 Benutzeroberflache 176 Beschriftung 11 kontextfreie Online Hilfe 15 kontextsensitive Online Hilfe 13 Meldung 12 Tooltip 11 Tutorial 5 Benutzungsfreundlichkeit 1 Bericht 45 167 Beschreibung 177 Beschriftung 11 Bild 77 barrierefrei 152 dynamisch 78 statisch 78 Textbezug 77 bersetzen 172 Bildschirm 177 Bildschirmabzug 78 177 BITV 145
24. 179 Fachw rter durch den Text bahnen Hypertexte zeichnen sich also durch eine starke Delinearisierung und Individualisierung aus Image Map Grafik mit mehreren Links Informationsart Informationstyp Information die eine bestimmte Funktion f r Nutzer erf llt z B Vor aussetzung f r eine Handlungsanleitung ein einzelner Handlungs schritt oder ein Hinweis Informationstyp Informationssorte Informationsart Topics k nnen unterschiedlichen selbst definierten Informationstypen zugeordnet werden z B zu Zielgruppen Anf nger Fortgeschritte Experten Informationstypen dienen dazu die Topics in einer Online Hilfe zielgruppengerecht anzuzeigen Interaktion Aktion der Nutzer und Reaktion des Produkts ber die Benutzerober fl che Konfiguration Langfristige Einstellungen f r ein Produkt k nnen ber Befehle konfi guriert werden Eine Konfiguration ist im Vergleich zur Anpassbarkeit technischer Natur und dauerhaft bis zur erneuten Konfiguration Kontextmen Popup Men Men das sich f r ein ausgew hltes Objekt ffnet wenn Nutzer die rechte Maustaste dr cken Ein Kontextmen enth lt nur Befehle die f r das ausgew hlte Objekt ausgef hrt werden k nnen Kontextsensitiv Hilfe die zum angezeigten Nutzungskontext passt in der Regel auf Dialog oder Elementebene Unterschied zur kontextfreien Hilfe Ver gleiche auch Sensitiv 180 Fachw rter Kontextfrei Hilfe die nich
25. 2 2 1 2 3 Assistenz Systeme Assistenz Systeme umfassen alle Arten von Informationen die einen Nut zer beim Gebrauch eines Produkts am Bildschirm unterst tzen Sie bieten punktuelle Information und Hilfestellung zu einem Produkt Dazu geh ren z B e Beschriftung der Benutzeroberflache von Software wie z B Titelzeile Beschriftung f r Men s Schaltfl chen Felder usw e Tooltips Bubble Help e Meldungen e Assistenten Wizards e kontextsensitive Hilfe auf Element und Dialog Ebene e kontextfreie Hilfe Assistenz Systeme werden in Prim r Assistenz und Sekund r Assistenz unterschieden Prim r Assistenz Alle Informationen die an der Benutzeroberfl che auf den ersten Blick sichtbar sind ohne dass ein Nutzer etwas tun muss z B Beschriftungen Statuszeile usw Sekund r Assistenz Alle Informationen die nicht auf den ersten Blick sichtbar sind und f r die ein Nutzer erst etwas tun muss z B Tooltip Maus bewegen Lernprogramme Lernprogramme umfassen alle Arten von Informationen die einen Nutzer am Bildschirm zum Gebrauch eines Produkts anleiten und den Einstieg erleichtern Sie bieten einf hrende Unterst tzung und eine erkennbare Benutzerf hrung Dazu geh ren z B e Einstiege ohne direkte Verbindung zum Produkt computer based trai ning web based training e Einstieg mit Verbindung zum Produkt Tutorial e Lernvideo e berblick ber das Produkt Guided Tour Bedienungs
26. Body Proxy 81 Braille Zeile 143 Breadcrumbs Proxy 81 Browse Sequenz siehe Lesepfad Browser basierte Hilfe 18 Bubble help siehe Tooltip Buchinhalte 57 c CMS 38 CMS Funktion 38 Code Point 170 Corporate Design 76 CSH siehe kontextsensitive Anbindung Cursor XML Tag 30 D Darstellungsmittel 33 Datei ffnen 27 Vorlage 67 Dialog 177 Dialoghilfe Direkthilfe DITA 54 Docbook 25 14 177 13 178 192 Stichw rter DotNetHelp 20 APIs 20 Dynamisches Bild 78 E Echo 96 Effektivit t 2 Effizienz 2 Eigenschaft Topic 61 Topic Titel 62 Eingabeformat 37 Eingebettete Hilfe 178 Eingeschobener Text 106 178 Einlesen vorhandene Inhalte 42 Endung book 37 Ces 36 doc 37 docx 37 flali 36 161 flors 125 flglo 122 pn 32 36 far 36 fltoc 36 117 fm 37 h 36 hhp 37 htm 36 37 html 37 mchelp 20 mif 37 mp 37 rtf 37 xpj 37 Ergonomie 3 Expanded text siehe eingeschobener Text Explorer Index 121 Topic 31 Export Header Datei 163 Externer Sprung 127 Extra hypertextueller Link 107 F Fachwortverzeichnis 102 113 Datei 122 bersetzen 172 FAQ 57 Farbe 75 Fehlsichtigkeit 75 Wahrnehmung 75 Farbwahl 76 Favorit 105 178 Fehlermeldung 12 generieren 45 167 Fenster 178 Layout 36 positionieren 34 Sekund r 106 Filter 104 Flare anpassen 33 Arbeitsbereich 26 Ausgabeformate 37 Eingabeformate 37 Explorer 31 Fenster steuern 36 Hilfeprojekt 24 3
27. Doppelklick das Topic das Sie einem Themen gebiet zuordnen wollen 3 W hlen Sie den Befehl Extras Themengebiete Themengebiete fest legen Der Themengebiets Editor ffnet sich rechts im Arbeitsbereich Platzieren Sie den Cursor am Anfang des Topics Geben Sie dann im Themengebiets Editor den Titel des Themenge biets ein und schlie en Sie mit der Eingabetaste ab An der Stelle des Cursors im Topic wird eine Themengebietsmarke eingef gt 6 Wiederholen Sie diese Schritte f r alle Topics eines Themengebiets Link B ndel einf gen 1 ffnen Sie mit einem Doppelklick das Topic das Sie einem Themen gebiet zuordnen wollen 2 Platzieren Sie den Cursor an die passende Stelle im Topic z B in der letzten Zeile 134 Umsetzung mit Flare W hlen Sie den Befehl Einf gen Hilfe Steuerelement Konzept Link Der Dialog Konzept Link Steuerelement einf gen ffnet sich Konzept Link Steuerelement einf gen Ausgew hlte Themengebiete Alle Themengebiete Steuerelement ente Abbrechen A Bild 41 Themengebietsmarke einf gen W hlen Sie aus der Liste Alle Themengebiete das passende The mengebiet aus Klicken Sie auf lt lt um das Themengebiet in die Liste Ausgew hlte Themengebiete zu bernehmen Klicken Sie auf OK um Ihre Auswahl zu best tigen Der Dialog schlie t sich und im Topic wird an der Cursor Position ein Siehe auch Verweis eingef gt Speichern Sie das Topic mit dem B
28. Einlesen lassen sich in Flare e _RoboHelp Projekte Endung mp oder xpj e HTMLHelp Projekte Endung hhp e HTML Dateien Endung bim oder html e Word Dateien Endung doc docx oder rtf e FrameMaker Dateien und B cher Endung fm mif oder book Ausgabeformate Flare bietet unterschiedliche Ausgabeformate damit nicht nur Online Hil fen sondern auch B cher in Flare erstellt werden k nnen Generieren las sen sich aus Flare es HTML Hilfe e _Browser basierte Hilfe WebHelp e DotNetHelp e Word Dateien e FramekMaker Dateien und B cher 37 Das Hilfe Autorensystem Flare 3 5 4 3 6 3 6 1 PDF Dateien als Ausgabeformat k nnen Sie derzeit nur erzeugen wenn Word oder FrameMaker auf Ihrem Rechner installiert sind Dies soll sich aber mit der n chsten Version von Flare ndern CMS Funktionen Alle CMS Funktionen sind in der Projektorganisation zusammengefasst ber ein Inhaltsverzeichnis beispielsweise l sst sich konkret bestimmen welche Inhalte in welcher Reihenfolge in eine Ausgabe kommen ber Bedingungen k nnen spezielle Inhalte von der Ausgabe ausgeschlossen und f r jedes Ausgabeformat ein eigenes Layout und eine eigene Skin fest gelegt werden ber Variablen Sets lassen sich zudem schnell ver nderli che Text Informationen verwalten und aktuell halten Erste Schritte Dieser Abschnitt beschreibt im berblick die erforderlichen Schritte um eine Online Hilfe zu erstellen
29. Fachwortverzeichnis erkl rt die Fachbegriffe wie sie in diesem Buch verwendet werden in alphabetischer Reihenfolge Die Darstellung pro Begriff ist dabei folgende Verwendeter Begriff Synonyme Begriffe Stichwortartige Erkl rung Absatz Abschnitt Teil Paragraph Zusammenh ngende Textzeilen die einen Gedanken ausdr cken Anpassbarkeit Adaptierbarkeit Individualisierbarkeit Nutzer k nnen Einstellungen wie Farbe oder Schriftgr e an ihre indi viduellen Bed rfnisse anpassen Vergleiche auch Konfiguration Anwendung Applikation System L sung Programm Software Programm das auf einem lokalen PC im Netzwerk oder im Web installiert ist wie beispielsweise Web Anwendung oder Software Anwendung API Application Programming Interface programmierbare Schnittstelle zwi schen Programmen Assistent Wizard Software Funktion die Nutzer durch eine komplexe Abfolge von Hand lungsschritten leitet Ein Assistent kann von den Nutzern oder einer Anwendung gestartet werden 175 Fachw rter Assistenz System Assistenz Systeme umfassen alle Arten von Informationen die Nutzer beim Gebrauch eines Produkts am Bildschirm unterst tzen Sie bieten punktuelle Informationen und Hilfestellungen zum Produkt Es wird unterschieden nach Prim r Assistenz und Sekund r Assistenz Aufmerker Eyecatcher Blickfang Hervorhebung im Text z B andere Farbe oder animierte Grafik Ausklappbarer Text drop down text
30. Frustration und damit zu Fehlern und Zeitverlust Die psychischen Belastungen neh men zu und Kopfschmerzen Augenflimmern oder Stress k nnen die Folge sein Bei l ngerer Dauer k nnen auch k rperliche Beschwerden auftreten Aus diesem Grund geh rt die Software Ergonomie auch zu den rechtsver bindlichen Mindestanforderungen die bei Bildschirmarbeitspl tzen einge halten werden m ssen Die gesetzliche Grundlage hierf r bildet die DIN EN ISO 9241 Ergonomische Anforderungen f r B rot tigkeiten mit Bildschirm ger ten Zentral f r die Gestaltung von Software sind e Die Art und Weise menschlicher Informationsverarbeitung wie Kurz zeitged chtnis Metaphern Farbwahrnehmung usw e Die Aufgaben der Nutzer die mit der Software erledigt werden sollen e Das Umfeld der Organisation in dem die Aufgabe stattfindet Nut zungskontext Nur unter dieser Voraussetzung kann das Arbeitsmittel Software ergono misch und gut nutzbar sein Software Ergonomie umfasst damit die Nutzer und Aufgabenorientierung Begriffskl rungen 1 2 Online Dokumentation Vieles was heutzutage unter der Flagge Online segelt ist eher On Screen Denn der Begriff Online kam mit der ersten Internet Begeiste rung aus den USA nach Europa und steht platt bersetzt f r am Kabel h ngen oder genauer gesagt im Internet sein So sind Anleitungen im PDF Format auf CD oder ein lokales Hilfesystem nicht online
31. Gleiches gilt f r die Spracheinstellung eines Topics Die Sprache f r ein Topic stellen Sie ber den Eigenschaftsdialog ein siehe Abschnitt Topic Eigenschaften auf Seite 61 Sprache der Skin Die Sprache der Skin f r WebHelp und WebHelpPlus Ausgaben stellen Sie in der Zieldefinition ein Im Register Sprache der entsprechenden Ziel definition ist in der Sprachtabelle auch eine Spalte Lokalisierte Skins die angibt ob es f r die Zielsprache schon eine Skin gibt Wenn es noch keine Skin gibt muss auch die Skin bersetzt werden F r die HTMLHelp ist die Sprache der Skin abh ngig von der Sprachein stellung des Produktionsrechners Das bedeutet dass Sie z B eine chine sische Online Hilfe auch auf einem chinesisch eingestellten Rechner generieren m ssen Die Spracheinstellung des Rechners ndern Sie als Systemadministrator ber den Windows Befehl Start Einstellun gen Systemsteuerung Regions und Sprachoptionen 172 Umsetzung mit Flare 9 2 3 Schritte f r die Erstellung eines Zielsprachenprojekts Nachdem Sie die bersetzten Dateien zur ckerhalten haben sind folgende Schritte erforderlich 1 NE N Ze o Legen Sie gegebenenfalls ein neues Flare Projekt in der Zielsprache an Kopieren neues Flare Projekt oder importieren bestehendes Flare Projekt Sie die bersetzten Dateien in das Flare Projekt Stellen Sie gegebenenfalls die Sprache der Topics ein Pr fen und erg nzen Sie die Stichw r
32. HTML and We functionality without leaving WinHelj launching a Web browser Click on below to see HTML content in Wink gt gt gt gt Standard HTML Graphic files and background in Animated GIF files ES EY ON SI eM SN SY et CH ESI ES Bild 6 Beispiel fur Winhelp Format HTMLHelp HTMLHelp ist der Nachfolger von Winhelp Auch hier handelt es sich um ein proprietares Hilfeformat das auf 32 Bit Windows Systemen ab der Ver sion 98 ablauffahig ist Das Hilfeformat ist eine komprimierte chm Datei die nur auf Windows System ablauffahig ist Vorraussetzung fur das Hilfe fenster ist der Internet Explorer ab Version 4 0 Auch HTMLHelp ist mittlerweile ein ausgereiftes Hilfeformat das Microsoft aber seit einigen Jahren nur noch wartet und nicht mehr weiter entwickelt Die kontextsensitive Anbindung erfolgt Uber die HTMLHelp API die in der Oberflache des zu beschreibenden Produkts entsprechend angesteuert wird Das HTMLHelp Hilfefenster ist typischerweise ein Fenster mit drei Anzeige bereichen auch Tripane genannt Zu den Anzeigebereichen Symbolleiste und Inhalt ist die hierarchische Navigation hinzugekommen Quellformat sind mehrere HTML Dateien Madcap Flare unterst tzt das HTMLHelp For mat 17 Vom Input zum Output 2 3 3 E Disk Management lolx el e gt H Hide Back Forward Options Contents index Search ey Disk Management Dr E Checklist Adding a new d
33. Position ein Siehe auch Verweis eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern Wiederholen Sie diese Schritte f r alle Topics eines Stichwort Links Verwandte Topics Ein Verwandte Topics Link b ndelt singul re Links ohne Gemeinsamkei ten Diese Link B ndel sind schneller anzulegen aber schwieriger zu war ten da sie manuell aktualisiert werden m ssen 1 ffnen Sie mit einem Doppelklick das Topic in das Sie einen Ver wandte Topics Link einf gen wollen 2 Platzieren Sie den Cursor an die passende Stelle im Topic z B in der letzten Zeile 3 W hlen Sie den Befehl Einf gen Hilfe Steuerelement Verwandte Topics Der Dialog Verwandte Topics Steuerelement einf gen ff net sich 4 W hlen Sie aus der Liste Ordner den Ordner mit den passenden Topics aus auf die Sie verweisen wollen 5 W hlen Sie in der Liste Dateien das Topic das Sie in den Verwandte Topics Link aufnehmen wollen und klicken Sie auf lt lt um es in die Liste links zu bernehmen 6 Wiederholen Sie die Schritte 4 und 5 bis Sie alle erforderlichen Topics aufgenommen haben 136 Umsetzung mit Flare 6 6 7 8 Klicken Sie auf OK um Ihre Auswahl zu best tigen Der Dialog schlie t sich und im Topic wird an der Cursor Position ein Siehe auch Verweis eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern Sensitive Elemente Mit sensitiven Elementen k nnen Sie Inf
34. Proxy Beide Proxies erzeugen zum Generierungszeitpunkt einen Orientierungs pfad der breadcrumbs Proxy erzeugt ihn als erste Zeile einer Hilfeseite der Mini TOC Proxy als kleines Inhaltsverzeichnis am Ende der Hilfeseite Fur beide Proxies wird das Hauptinhaltsverzeichnis als Quelle genutzt Nat rlich k nnen Sie die Position der Proxies in der Vorgabeseite ndern oder die Proxies l schen Empfehlenswert ist der breadcrumbs Proxy zu Beginn der Hilfeseite da er dazu beitr gt sich in der Online Hilfe zu orientieren Platzsparend ist die Darstellung in einer Zeile Das Mini Inhaltsverzeichnis hat sich in der Praxis nicht wirklich durchgesetzt Am Ende einer Hilfeseite wird es oft nicht gese hen und es braucht einfach zu viel Platz 81 Layout Vorgabeseite anlegen Um eine neue Vorgabeseite anzulegen gehen Sie folgenderma en vor 1 ML Edtor Q T ID u SE Cer oa W hlen Sie den Befehl Projekt Neue Vorgabeseite Der Dialog Neue Vorgabeseite einf gen ffnet sich W hlen Sie eine Vorlage f r die Vorgabeseite aus F r Online Hilfen bietet Flare die Vorgabeseite Vorgabeseite flmsp an alle anderen Vorlagen f r Vorgabeseiten sind f r Druckversionen Geben Sie der Vorgabeseite bei Dateiname einen Namen Pr fen Sie bei Stylesheet ob das passende Stylesheet ausgew hlt ist Klicken Sie auf Einf gen um die neue Vorgabeseite anzulegen Der Dialog schlie t sich und es ffnet sich die Abfrage ob die Vorgabe
35. Schlie en einer ge n derten Datei fragt Flare ob die Datei gespeichert werden soll So k nnen auch nderungen verworfen und eine Datei geschlossen werden ohne die nderungen zu speichern e Der Befehl Datei Alle speichern speichert alle ge ffneten Dateien Der Befehl Fenster Alle Dokumente schlie en schlie t alle ge ffne ten Dateien Editoren bieten in der Regel eine zus tzliche lokale Symbolleiste mit den relevanten Befehlen f r das bearbeitete Objekt 27 Das Hilfe Autorensystem Flare Der wichtigste dieser Editoren ist der XML Editor f r die Hilfe Inhalte Dabei sind XML Kenntnisse nicht erforderlich die Umsetzung der Abs tze nach XML spielt sich im Hintergrund ab Wer sich aber etwas mit XML auskennt kann sich die Struktur der XML Tags anzeigen lassen und diese Tags mani pulieren Struktur Darstellung Im XML Editor l sst sich die XML Struktur eines Topics ber folgende Sym bole der lokalen Symbolleiste einblenden Blendet die Struktur Tags im Topic ein oder aus to II Blendet die DIV und SPAN Tags im Topic ein oder aus Il Gleiches gilt f r die Struktur Ihrer Tabelle die sich ber folgende Symbole der lokalen Symbolleiste einblenden l sst Blendet die Zeilen der Tabelle ein oder aus 5 Blendet die Spalten der Tabelle ein oder aus Jedes XML Tag l sst sich im Text oder in der Strukturansicht ber ein Kon textmen bearbeiten Ein Klick mit der rechten Maustaste auf ein Tag i
36. Seite 61 Das bedeutet dass Sie f r jedes Topic einen Topic Titel vergeben m ssen damit der Orientierungspfad in der sp teren Online Hilfe sauber generiert wird Beim Import eines Hilfe Projekts von Word oder FrameMaker Dateien werden die Topic Titel analog zur berschrift eines Topics ange legt F r neu erstellte Topics legt Flare nicht automatisch einen Topic Titel an Synchronisation mit dem Inhaltsverzeichnis Die Synchronisation eines ge ffneten Topics mit der Position im Inhaltsver zeichnis stellen Sie in der Skin ein siehe Abschnitt Skin bearbeiten auf Seite 91 Stichwortverzeichnis Flare verwaltet die Stichw rter auf Topic Ebene Das bedeutet dass es im Hilfeprojekt keine Datei mit Stichworten gibt sondern erst in der generier ten Online Hilfe Stichw rter zeigt Flare als Marken an Dabei ist die Posi tion eines Stichworts im Topic von Bedeutung denn in der sp teren Online Hilfe wird genau der Absatz zu Beginn des Hilfefensters angezeigt in dem das Stichwort steht Da die Stichw rter in den Topics verwaltet werden m ssen Sie die Zieldefi nition nicht mit einem Stichwortverzeichnis verbinden Den Inhalt im Stich wortverzeichnis steuern Sie ber die Topics die in der Online Hilfe enthalten sind Einzelnes Stichwort anlegen 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic in das Sie ein Stichwort einf gen wollen 3 Markieren Sie das Wort im Topic
37. Status oder St rung einschlie lich der Behebungsm glichkeit in einem eigenen Dialog oder der Statusleiste Men Menu sub menu drop down menu Eine Anzahl von Befehlen die als Gruppe unter einem Oberbegriff pr sentiert werden Wortfamilie Men leiste Hauptmen Untermen Kontextmen Navigation Schaltfl chen mit denen sich Nutzer durch eine bestimmte Daten menge bewegen k nnen z B Vor und Zur ck Vergleiche auch Hier archische Navigation Normales Element Texte oder Bilder die nicht sensitiv sind Nutzer Anwender Benutzer Personen die am Computer arbeiten Oberfl chen Beschreibung Referenz Programmbeschreibung Oberbegriff f r die Beschreibung aller Oberfl chen Elemente eines Produkts Oberfl chen Element Control Steuerelement Schaltfl che Button Jedes Teil der Benutzeroberfl che Oberfl chen Elemente werden auch als Steuerelemente bezeichnet da mit ihnen das Verhalten des Produkts und des Assistenz Systems gesteuert wird Beispiele Schalt fl che Men Dialog Fenster Beschriftungen 182 Fachw rter Online Hilfe Hilfesystem Hilfe Teil der Sekund r Assistenz Informationen zur punktuellen Unterst t zung bei der Arbeit mit einem Produkt Online Seite kurz Seite Page Website Screen Bildschirmseite Seite die am Display auf einen Blick sichtbar ist wobei Bl ttern m g lich sein kann Wortfamilie Seitenlayout Seitenformat Seitenr nder Startseite
38. Stichworteintr ge Die Volltextsuche ist ebenfalls eine aktivierbare Eigenschaft des Hilfefen sters F r die Suche k nnen W rter ausgeschlossen werden nach der die Suchdatenbank aufgebaut wird weil sie beispielsweise nicht wirklich sinn 110 Fazit f r Online Hilfen 6 5 1 behaftet sind wie z B der die das und usw Diese W rter sind in einer Liste gesammelt der sogenannten Stop Word Liste Flare kann einzelne Topics ber die Topic Eigenschaften von der Suche ausschlie en z B Topics die nur als Popups angezeigt werden sollen Traditionelle Orientierungshilfen Die traditionellen Orientierungshilfen wie Inhalts und Stichwortverzeichnis sind das R ckrat der Navigation in einer Online Hilfe Sie bieten neben der Volltext Suche die h ufigsten Einstiege in eine kontextfreie Hilfe Inhaltsverzeichnis Ein Inhaltsverzeichnis sollte in jeder Online Hilfe ab zwei Topics vorhanden sein Es legt eine logisch hierarchische Struktur ber die vernetzten Topics und bietet den direkten Zugang zu den einzelnen Informationen Dabei ist es die Aufgabe des Hilfe Autors das Inhaltsverzeichnis nicht zu tief aber auch nicht zu breit anzulegen Empfohlen wird eine Gliederungstiefe von vier Ebenen mit jeweils etwa sieben Topics Bei Online Hilfen f r komple xere Produkte ist diese Empfehlung sicher eine Herausforderung und spricht daf r nicht alle Topics ins Inhaltsverzeichnis aufzunehmen sondern sie ber Links zug ngli
39. Text formatieren Sie ber Symbole der Formatierungsleiste oder ber das Format Fenster siehe Abschnitt Einzelnes Format zuweisen auf Seite 89 Im Folgenden ist der generelle Umgang beschrieben mit e Listen e Tabellen e Vorlagen Listen Sie k nnen zwischen unsortierten und nummerierten Listen w hlen fol gende Aufz hlungszeichen bietet Flare J Blickfangpunkt Q Kreis u Quadrat 123 Arabische Zahlen abc Kleinbuchstaben ABC Gro buchstaben iii Kleine r mische Ziffern II Gro e r mische Ziffern 63 Topics Liste einf gen 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic in das Sie eine Liste einf gen wollen Markieren Sie die Abs tze die Sie zu einer Liste formatieren wollen 4 W hlen Sie den Befehl Format Liste und dann das gew nschte Listenformat Die Abs tze werden als ausgew hlte Liste formatiert Liste bearbeiten Sie k nnen sich im XML Editor die XML Struktur Ihrer Topics ber folgende Symbole der lokalen Symbolleiste einblenden Blendet die XML Tags links im Topic ein oder aus ur an Blendet die DIV und SPAN Tags oben im Topic ein oder aus Ic Die gesamte Liste k nnen Sie bequem ber die Anzeige der XML Tags bearbeiten 1 Blenden Sie dazu die XML Tags links im Topic ein 2 Klicken Sie mit der rechten Maustaste in der XML Strukturleiste auf das Listen Tag OL oder UL 3 W hlen Sie den passenden Befehl Liste sortie
40. Texte informieren den Nutzer ber grundlegende Sachver halte und liefern Hintergrundinformationen Sie vermitteln Wissen ber Zusammenh nge und ber die grafische Benutzeroberfl che und ihre Ele mente Beispiele f r berwiegend beschreibende Texte e Einf hrungen in ein Themengebiet e Funktionsbeschreibung e Oberflachenbeschreibung Anleitung Anleitende Texte wollen den Nutzer durch einen L sungsweg in die Lage versetzen sofort mit dem Produkt weiterzuarbeiten Sie vermitteln Informa tionen die den Nutzer in seinem Handeln direkt betreffen und veranschau lichen m gliche Arbeits und Vorgehensweisen Ein anleitender Text fordert den Leser auf etwas zu tun Beispiele f r berwiegend anleitende Texte e Wartungsanleitung e Inbetriebnahmeanleitungen e Handlungsanweisung Ein anleitender Text muss immer die tats chliche Abfolge der Arbeits schritte wiedergeben in der Reihenfolge in der sie auszuf hren sind Es d rfen keine Schritte oder Teilschritte fehlen Die Handlungsanweisung sollte keine allgemeinen Beschreibungen enthalten sondern nur die kon kreten Arbeitsschritte 53 Topics 4 3 Topic Klassen Topics sind der Kernpunkt jeder Hilfe Man kann sich dem Begriff Topic von verschiedenen Perspektiven her n hern e Fur den Leser ist ein Topic die Information die im Hilfefenster ange zeigt wird e Technisch betrachtet ist ein Topic eine HTML XML Datei oder Bestandteil einer Wo
41. Zeichentypen wie z B Terminal oder Handy tv Fernseher Ein m gliches Beispiel ist die Optimierung f r die Sprachausgabe Ebenso wie normaler Text mit Farben Schriftart oder gr e gestaltet werden kann kann er auch f r die Ausgabe in einem Sprach Browser gestaltet werden Dies k nnen beispielsweise unterschiedliche Stimmen oder besondere Betonungsmechanismen sein Sie k nnen dazu im Stylesheet ein neues Medium f r die Sprache anlegen und die Absatzformate ber dieses Medium f r die Sprachausgabe gestal ten Mit einer eigenen Zieldefinition k nnen Sie dann eine Online Hilfe f r Sprach Browser generieren Abschnitt Wie alles zusammenkommt die Zieldefinition auf Seite 92 154 Umsetzung mit Flare Neues Medium f r das Stylesheet anlegen 1 Ek RED D Wechseln Sie in den Topic Explorer ffnen Sie den Ordner Resources Stylesheets ffnen Sie das Stylesheet mit einem Doppelklick Stellen Sie gegebenenfalls die Erweiterte Ansicht ein W hlen Sie in der lokalen Symbolleiste des Stylesheet Editors die Schaltfl che Neues Medium Der Dialog Medium umbenennen ffnet sich Geben Sie dem neuen Medium einen Namen z B aural Klicken Sie auf OK um Ihre Angaben zu best tigen Der Dialog schlie t sich und ein neues Medium wird angelegt Das Medium steht in der Datentr gerliste ber der Liste mit den Eigenschaften W hlen Sie das neue Medium aus der Datentr gerliste aus W hlen S
42. den ist wird die Seite in der im Browser eingestellten Standardschriftart angezeigt in der Regel Times New Roman bei Windows und Times bei Mac OS Dieses Problem l sst sich mit dem Einbinden der entsprechen den Schriftdatei l sen Strukturierende Elemente wie berschriften Aufz hlungen Listen und Tabellen unterst tzen das Scannen der Informationen Die berschriften sollten sich deutlich vom normalen Text abheben und auch gen gend Wei raum haben Wei raum an sich ist ebenfalls ein strukturierendes Ele ment Farben und Bildschirmaufl sung Farben lenken den Blick auf sich und k nnen f r Informationen verwendet werden In einer Online Hilfe werden Farben haupts chlich f r Links genutzt Dazu sind zwei Farben erforderlich eine f r den Link an sich und eine abgeschw chtere f r den besuchten Link Als Entscheidungshilfe f r die zu verwendende Farbe bietet sich eine Analyse der Corporate Identity des Auftraggebers f r die Online Hilfe an Wenn sich hier nichts passendes findet kann man den Defacto Standard blau verwenden Zur Bildschirmaufl sung und der entsprechenden Anpassung des Hilfe fensters r t Jacob Nielsen die Darstellung f r eine Einstellung von 1024x768 zu optimieren Zur Zeit sind 60 aller Monitore auf eine Aufl sung von 1024x768 eingestellt Zum Vergleich Nur 17 der Nutzer ver wenden noch 800x600 Da sich die Mehrheitsverh ltnisse durch die Verbreitung besserer Bildschirme sicher weiter ver ndern we
43. durch ihre Funktionalit t und ihre Benutzerfreundlichkeit bestimmt Zweckm igkeit erreicht man indem man die Online Hilfe mit den Funktio nen ausstattet die n tig sind um alle wichtigen Ziele zu erf llen Dazu muss die Online Hilfe nicht nur die passende Beschreibung enthalten die Beschreibung muss auch auffindbar sein Hat ein Nutzer die Information erst gefunden muss er sie auch verstehen und umsetzen k nnen Somit ist ein weiter Rahmen f r die Benutzerfreundlichkeit einer Online Hilfe aufgespannt vom Nutzungskontext bis zur N tzlichkeit Beide werden bestimmt von den Erwartungen der Nutzer Vom Input zum Output Schon Bill Gates w nschte sich in den 80er Jahren Information at your fin gertips Auch wenn er hiermit eher das Web meinte gilt dieser Anspruch in besonderem Ma e f r Online Hilfen denn die sollen dem Leser schnelle Hilfe zu einem aktuellen Problem bieten Online Hilfen geben dem Leser also in erster Linie punktuelle Unterst tzung sie sind weniger als Nach schlagewerk gedacht Sie sollten aber auch einen Rahmen bieten um schon vorhandenes Wissen zu vertiefen Aus den Informationseinheiten zur punktuellen Unterst tzung ergibt sich ein Netzwerk aus gleichrangigen Informationen die der Autor f r seinen Leser zugreifbar machen muss siehe Kapitel Navigation Wobei gerade f r Online Hilfen der Satz gilt so viel Information wie n tig um das aktuelle Problem zu l sen aber so wenig wie m glich
44. einzelner Link oder als Schaltfl che Beide ffnen ein Men aus dem sich der Leser ein Topic zum Weiterlesen ausw hlen kann Zur Auflistung der Topics im Men wird die Topic Eigenschaft Topic Titel verwendet siehe Abschnitt Topic Eigenschaften auf Seite 61 132 Umsetzung mit Flare ApplicationHelp Sample Mozilla Firefox Datei Bearbeiten Ansicht Chronik Lesezeichen Extras Hilfe en SS GD FG Aeicmocmen D ZS Erste Schritte Q Aktuelle Nachrichten TOC EGE Welcome You are here Using gt Overview A Introduction AWhats new M 6etting_Started Using A Overview a Using FictionSoft Overview This could start a section of more advanced information and advanced procedures A Procedure 1a Linking back to the basic information can be a good idea B re 2a Advanced concepts can be explained M Contacting a Advanced language or jargon that a user will need to understand Any other information that a user would need Overview J toc Tip EXP procedure 1a Ve Flare user interface Almost every Sa de resized stretched or moved p Search 2007 EJ Glossary 200 Favorites Fertig Bild 40 Link B ndel im Topic einer Webhelp Flare bietet drei unterschiedliche Varianten von Link B ndeln die sich nicht durch ihre Art der Darstellung im Topic unterscheiden sondern durch die Art wie sie angelegt und
45. erhalten soll Setzen Sie den Cursor im Topic an die Stelle an der Sie das interak tive Element einf gen wollen W hlen Sie den Befehl Einf gen Hilfe Steuerelement Shortcut Steuerelement Der Dialog Shortcut Steuerelement einf gen ffnet sich Geben Sie die Werte ein die Sie von der Software Entwicklung f r die ses Element erhalten haben Klicken Sie auf OK um Ihre Angaben zu best tigen Der Dialog schlie t sich und das interaktive Element wird eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern 141 7 7 1 Barrierefreiheit Barrierefreies Design bedeutet dass Menschen mit Behinderungen ein elektronisches Angebot uneingeschr nkt und selbstst ndig nutzen k nnen Im Sinne der Nutzbarkeit muss die Barrierefreiheit beispielsweise einer Online Hilfe im Web einen Schritt ber die reine Zug nglichkeit hinausge hen auch behinderte Nutzer sollen mit ihren F higkeiten und Hilfsmitteln elektronische Angebote nutzen k nnen Barrierefreiheit ist somit Gebrauch stauglichkeit vor dem Hintergrund einer Behinderung oder Einschr nkung Die genaue Zahl der Abweichungen vom Durchschnitts Nutzer ist schwer einzusch tzen Der Verein f r Behinderte in Gesellschaft und Beruf sch tzt den Anteil derjenigen in Deutschland die wegen einer Einschr nkung Schwierigkeit mit elektronischen Medien haben auf ber 20 aller Nutzer Barrieren ergeben sich vor allem dann wenn Nutzer e schlecht oder gar nic
46. ffnen Sie mit einem Doppelklick das Topic das einen Link erhalten soll 3 Markieren Sie im Topic den Text oder das Bild Piktogramm f r den Ausgangsanker Hotspot 126 Umsetzung mit Flare 8 W hlen Sie den Befehl Einf gen Hyperlink Der Dialog Hyperlink einf gen ffnet sich W hlen Sie bei Link zu die Quelle f r den Zielanker und w hlen Sie dann rechts im Dialog die passende Quelle aus Mit den weiteren Feldern im Dialog k nnen Sie das Verhalten des Links weiter festelegen e Im Feld Link Text sehen Sie den Text den Sie vorher im Topic f r den Ausgangsanker markiert haben Wenn Sie diesen Text ndern wird er auch im Topic ge ndert e Bei Ziel Frame k nnen Sie einstellen ob das Ziel Topic im gleichen oder in einem anderen Fenster ge ffnet wird e Bei Bildschirm Tip k nnen Sie einen erkl renden Text Tooltip eingeben e Bei Formatklasse k nnen Sie eine Formatklasse vom Typ a lt formatklasse gt w hlen mit der der Link formatiert werden soll Wenn Sie keine Formatklasse angeben verwendet Flare das Basis A Tag Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und der Link wird in das Topic eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern Externer Sprung Hyperlink Ein externer Sprung ist ein Link auf ein Topic in einer anderen Online Hilfe Die Online Hilfe kann sp ter im gleichen oder in einem anderen Ordner lie gen Die Pfadan
47. gekennzeichnet ist Dies kann beispielsweise f r Optionen oder Suchbegriffe verwen det werden Hierarchische Navigation Struktur oft in Baumform mit der sich Nutzer hierarchisch durch eine bestimmte Datenmenge bewegen k nnen z B Inhaltsverzeichnis einer Online Hilfe oder die Baumansicht im Explorer Hilfe Agent Programm das zwischen Nutzer und Online Hilfe vermittelt und an das nat rlichsprachliche Anfragen formuliert werden k nnen Der Hilfe Agent beantwortet die Anfrage mit verschiedenen Antwortvor schl gen Aus diesen Vorschl gen k nnen Nutzer die Antwort ausw h len die ihnen am geeignetsten erscheint Hilfeart Teil eines Assistenz Systems z B Tooltip oder kontextsensitive Hilfe Hilfe Autorensystem HAT Programm mit dem Hilfen erstellt werden Hilfefenster Hilfe Viewer Fenster einschlie lich aller Fenster Steuerelemente in dem eine Online Hilfe angezeigt wird Hilfeformat Zielsystem Legt fest in welchem Hilfefenster die Online Hilfe angezeigt wird z B Winhelp oder JavaHelp Hypertext Information als Netz von Seiten durch das der Nutzer sich per Maus klick durchfindet meistens baumstrukturartig aufgebaut aber auch Querverweise sind m glich Ein Hypertext besteht aus Topics die Informationen enthalten und Links die die strukturellen Zusammen h nge zwischen den Topics explizit darstellen Es gibt keine vorgege bene Abfolge jeder Leser kann und soll sich seinen eigenen Weg
48. in des Wortes urspr nglicher Bedeutung Allerdings hat sich der Begriff online mittlerweile eingeb rgert und so gilt es ihn weiterzufas sen Die Bedeutung in Dateiform und am Bildschirm anzeigbar bietet sich an gebraucht wird sie in diesem Sinne schon lang Damit lassen sich die Begriffe Online Dokumentation und Online Hilfe besser fassen Online Dokumentation umfasst alle am Bildschirm anzeigbaren Informatio nen die ein Produkt dokumentieren und zu seinem Gebrauch anleiten Diese Definition folgt zum einen den Richtlinien der tekom e V zur Beurtei lung von Online Informationen zum anderen der ISO IEC 18019 Software and system engineering Guidelines for the design and preparation of user documentation for application software Der amerikanische Fachbegriff user assistance kommt dieser Definition von Online Dokumentation am n chsten Online Dokumentation l sst sich in drei Kategorien unterscheiden e Assistenz Systeme e Lernprogramme e _ Bedienungsanleitungen am Bildschirm Online Hilfen z hlen zu den Assistenz Systemen und sind somit ein Teil der Online Dokumentation Die Online Dokumentation selbst ist ein Teil der Online Information Online Information L A Online Pr sentation Online Dokumentation Assistenz System Lernprogramm Bedienungsanleitung Online Hilfe Bild 1 Kategorien der Online Information Online Dokumentation 1 2 1 1
49. k nnen die Merkleistung erh hen Abstrakte Begriffe und logische Zusammenh nge lassen sich oftmals schwer ber visuelle Analogien oder Symbole darstellen Logische Ver kn pfungen zwischen Aussagen trotzdem obwohl wenn dann und Ver neinungen sind ebenfalls schwer visualisierbar Bilder k nnen auch bei Vereinfachung mehrdeutig sein und ungewollte Botschaften transportieren Erkl render Text soll die Mehrdeutigkeit eines Bildes f r den Leser ein schr nken und die Interpretationsm glichkeiten einengen Text und Bild m ssen sich aufeinander beziehen und sich erg nzen um ein integratives Gesamtverst ndnis zu erreichen Drei Arten von inhaltlichen Text Bild Beziehungen werden unterschieden e Kongruenter Bezug Der Text beschreibt was das Bild zeigt e Komplementarer Bezug Das Bild erg nzt den Text und umgekehrt F r das Gesamtverstandnis ist eine Auswertung beider Darstellungen erforderlich e Elaborativer Bezug Der Text geht ber den Bildinhalt hinaus und umgekehrt Eine elaborative Beziehung ist nur sinnvoll wenn das pas sende Vorwissen vorausgesetzt werden kann Voraussetzung f r ein Zusammenwirken von Text und Bild ist die r umliche N he von Text und Bild damit die Augen hin und her springen k nnen Die Auswertung eines Bildes kann durch sprachliche oder visuelle Hin weise beeinflusst werden Sprachliche Hinweise bieten Bildtitel Bildbe schriftung und Bildlegende als visuelle Hinweise k nnen Pfeile
50. required an extremely high level of technical knowledge to work with This created a need for an entirely new breed of authoring tools tools for developing software documentation often referred to as Help Authoring Tools Most Help Authoring Tools were designed in the early to mid 1990 s suppor ting early versions of Microsoft Windows The tools were built with the best technologies of the day and did a remarkable job of taking what was origi nally a very technical and programmer oriented process and not only stre amlined that process handling the code oriented tasks behind the scenes but also added advanced authoring capabilities This made it possible for the professional writer or author to contribute to a very technical process with great efficiency Instead of focusing on code related issues such as hidden footnote codes in RTF documents or scripting functions the tools allowed authors to concentrate on writing quality content and structuring that content for the best user experience This helped to ensure that users could find the information they needed quickly and efficiently Over time many of the original technologies changed and changed and changed again The RTF based WinHelp led to Microsoft HTML Help a compiled format released with Windows 98 and leveraging the newer HTML technology RTF footnote codes and macros where replaced with ActiveX controls JavaScript and DHTML Later browser based options for delivering software do
51. s soas nn 5 1 2 3 Bedienungsanleitungen am Bildschirm 5 1 3 N tzlichkeit 6 2 Vom Input zum Output aaa aaa aaa 7 2 1 Erwartungen der Leser 2000 8 2 1 1 Zielgruppenanalyse 9 2 1 2 Nutzungsanalyse 10 2 2 Arten von Online Hilfen 11 2 2 1 Beschriftung ec is saset k eateries ee 11 2 2 2 Tooltips Bubble Hein 11 2 2 3 Meldungen 12 2 2 4 Assistent Wizard 2 12 2 2 5 KontextsensitiveHilfe 13 2 2 6 Kontextfreie Online Hilfe 2 2 2m nn 15 2 2 7 Zusammenfassung 15 2 3 Hilfeformate und Hilfefenster 16 2 3 1WinnelP eea eckes sekd a a a ea a a aa 16 2 3 2 HTMLHelp 2 2 17 2 3 3 Browser basierte Hilfe e 18 2 3 4 Vista Help 2 82 28 Swe ee eR A 22 2 3 5 Hilfe Viewer 2 2 23 2 4 Hilfeprojekt aoaaa 24 2 5 Online Hilfe generieren 24 Inhalt 3 Das Hilfe Autorensystem Flare 22220 25 3 1 berblick ber die grafische Oberflache 26 3 1 1 Das Hauptfenster von Flare 26 8 1 2 Editoren u saos aoe a ac EE ee rn 27 3 1 3 Explorer z sarg 2 ur a de en a 31 3 2 Flare Projekt auf Datei Ebene 31 3 3 Darstellungsmittel 33 3 4 Flare anpassen 33 3 4 1 Sprache der Benutzeroberflache 34 3 4 2 Fenster Layout 2 22 aaa a a 34 3 5 Flare Projekt sacs 2 222220 36 3 5 1 Zieldefinition 37 3 5 2 Eingabeformate nn 37 3 5 3 Ausgabeformate 37 3 5 4 CMS Funktionen 2 22 2
52. sich 3 W hlen Sie im Register Basis aus der Liste Tabellenformat das For mat aus das Sie der Tabelle zuweisen wollen 4 Bestatigen Sie Ihre Auswahl mit OK Der Dialog schlieBt sich und das Tabellenformat wird der Tabelle zugewiesen Vorlagen Flare selbst verwendet f r jedes Element sei es Topic oder Steuerdatei eine Vorlage Ein Satz von vordefinierten Vorlagen fiir jedes Element beginnend mit dem Flare Projekt wird mit Flare ausgeliefert Beim Neuan legen eines beliebigen Elements in einem Flare Projekt wie z B einem Topic oder einem Stylesheet m ssen Sie deswegen eine Vorlage ausw h len und das Kopieren dieser Vorlage beim Anlegen bestatigen Vorlagen helfen Ihnen beispielsweise dabei ein einmal festgelegtes Layout konsistent in allen Flare Projekten Ihrer Firma oder Ihres Auftraggebers zu verwenden Sie k nnen sich aber auch f r jede Topic Klasse eine Vorlage erstellen Dies gew hrt eine Projekt weite Konsistenz gerade wenn meh rere Autoren am Flare Projekt arbeiten Vorlagen k nnen Ihnen auch einfach Arbeit ersparen denn Sie k nnen f r alle Topic oder Steuerdateien eigene Vorlagen erstellen So k nnen Sie die f r Sie wichtigen Einstellungen beispielsweise f r bestimmte Zieldefini tionen oder Skins einmal setzen und diese dann als Vorlagen verwenden 67 Topics Leider funktionieren Vorlagen nur mit der englischen Flare Version pro blemlos Abgelegt werden die Vorlagen im Ordner C Dokumente
53. sie in der Skin f r die Darstellung in der Online Hilfe akti vieren 1 Wechseln Sie in die Projektorganisation 2 ffnen Sie im Ordner Skins die passende Skin mit einem Doppelklick 3 W hlen Sie im Register Basis aus der Liste Funktionen den Eintrag Lesepfade aus 4 Speichern Sie die Skin mit dem Befehl Datei Speichern 6 6 5 Links Die meisten Links k nnen Sie sowohl auf Topics und Dateien global als auch auf Lesezeichen innerhalb von Topics lokal setzen Deswegen ist hier zuerst beschrieben wie Sie ein Lesezeichen anlegen Lesezeichen anlegen 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic in das Sie ein Lesezei chen einf gen wollen 3 Setzen Sie den Cursor im Topic an die Stelle an der Sie das Lesezei chen einf gen wollen 4 W hlen Sie den Befehl Einf gen Lesezeichen Der Dialog Lesezei chen verwalten ffnet sich Geben Sie im Feld Neues Lesezeichen einen Namen ein Klicken Sie auf Einf gen um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und das Lesezeichen wird in das Topic an der Cursor Position eingef gt Wenn Sie sich die Marken einblenden las sen Befehl Ansicht Anzeigen Marken sehen Sie das Lesezeichen als Fahnensymbol 7 Speichern Sie das Topic mit dem Befehl Datei Speichern Interner Sprung Hyperlink Ein interner Sprung ist ein Link auf ein Topic in der gleichen Online Hilfe 1 Wechseln Sie in den Topic Explorer 2
54. t sich und das Text Popup wird in das Topic eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern 129 Navigation Ausdruck einschlie en Ausdruck ausschlie en Getting Started With FictionSoft This topic is a good place to explain the high level concepts that allow a user to be successful with FictionSoft Overall work flow for FictionSoft Important concepts necessary to be successful Special language ar jarann that a user will need to understand Any other inf Das ist ein ser would need Y 1 Text Popup Tip If you want ts sce cnc underlying structure of the document you are working on then select the Show Tags icon on the tool bar Bild 38 Text Popup in einer Online Hilfe Topic Popups Ein Topic Popup enth lt ein normales Topic das in einem Sekund r Fen ster angezeigt wird z B f r zus tzliche Erkl rungen oder Beispiele 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic das ein Topic Popup erhalten soll Markieren Sie im Topic den Text f r den Ausgangsanker Hotspot W hlen Sie den Befehl Einf gen Topic Popup Der Dialog Topic Popup einf gen ffnet sich Bei Ziel Frame ist Fenster schon einge stellt Der markierte Text f r die sensitive Stelle steht schon im Feld Link Text W hlen Sie bei Link zu die Quelle f r den Zielanker und w hlen Sie dann rechts im Dialog die passende Quelle aus Mit den weiteren Feldern im Di
55. tig darstellen Unicode enth lt neben den Buchstaben des lateinischen Alphabets mit all seinen landesspezifischen Besonderheiten auch das griechische kyrilli sche arabische hebr ische und thail ndische Alphabet sowie die so genannten CJK Schriften die verschiedenen chinesischen japanischen und koreanischen Schriften Damit ist Unicode unabh ngig von Sprachen und Schriftarten und unterst tzt die Internationalisierung Umgekehrt erm glicht Unicode auch die Lokalisierung ohne Programm nderung mit der Einstellung von landesspezifischen Eigenschaften und der Normalisie rung von diakritischen Zeichen Zus tzlich sind mathematische kaufm nni sche und technische Sonderzeichen codiert Statt der durch ISO definierten Bezeichnung UCS 2 wird h ufig die Bezeichnung UTF 16 UCS Transformation Format 16 Bit verwendet ein vom Unicode Konsortium definierter Standard Neben der Nutzung von UTF 16 ist auch der Einsatz von UTF 8 UCS Transformation Format 8 Bit weit verbreitet UTF 8 ist inzwischen die globale Zeichenkodierung im Internet Die Internet Engineering Task Force verlangt von allen Internet Kommunikationsproto kollen dass die Zeichenkodierung deklariert wird und dass UTF 8 eine der unterst tzten Kodierungen ist UTF 8 stellt jedes Unicode Zeichen abh n gig von seiner Position in einer L nge von ein bis vier Byte dar Die ersten 128 Zeichen stimmen mit der ASCII Codierung berein 169 Mehrsprachigkeit Ausf hr
56. und Einstellungen lt benutzer gt Meine Documente My Templates und dort in dem Unterordner der der Projektstruktur entspricht F r fol gende Elemente k nnen Sie Vorlagen erstellen Tabelle 8 Ordnernamen f r Vorlagen Datei Ordnername Aliasdatei Advanced Lesepfad Advanced Bedingungs Set ConditionalTagSets Kopierziel Destinations FrameMaker Import Imports Glossar Glossaries Header Datei Advanced Vorgabeseite MasterPages MS Word Import Imports Bilder Images Projekt Projects Suchfilter Set Advanced Skin Skins Informationsbaustein Snippets Synonym Datei Advanced Inhaltsverzeichnis TOCs Tabellenformat TableStyles Zieldefinition Targets Topic Content Stylesheet Stylesheets Variablen Set VariableSets 68 Umsetzung mit Flare Die Vorlagen z B f r Ihre Topic Klassen m ssen Sie im Ordner C Doku mente und Einstellungen lt benutzer gt Meine Dokumente My Templates Content ablegen Sie werden dann beim Neuanlegen des Topics in der Liste Templates angezeigt wenn Sie in der Liste Template Folder den Eintrag My Templates ausgew hlt haben Ss Add New Topic ki xi Template Folders Templates Description htm Procedure htm Preview Name of the Foilboard or HMI Description Image H Source File fie 777C Ookumente und Einstellungen pthieman Eigene Dateien My Templates Co Ei Folder ES Awork Place 1 Procedur
57. und farbige Hervorhebungen verwendet werden Sprachliche Bezeichnungen im Text und im Bild sollten bereinstimmen Allgemein lassen sich zwei Arten von Bildern unterscheiden statische und dynamische 77 Layout Statische Bilder Statische Bilder sind Bilder ohne jede Art von Bewegung Animation oder Interaktion Unterschieden werden realistische und abstrakte Darstellun gen e Realistische Darstellungen liefern ein m glichst realit tsnahes Bild einer realen Form Dazu z hlen Fotos Strichzeichnungen Schema zeichnungen Explosionszeichnungen aber auch Bildschirmabz ge d h Abbildungen von Teilen der grafischen Oberfl che Sie repr sentie ren als wahrnehmungs hnlicher Realit tsersatz visuelles Wissen ber das Aussehen von Dingen und ber r umliche Zusammenh nge e Abstrakte Darstellungen werden auch als instruktionale Bilder bezeich net Sie verdeutlichen logische Zusammenh nge beispielsweise in Diagrammen Modellen oder Tabellen Zu dieser Kategorie geh ren auch Piktogramme Eine vereinfachte Darstellung lenkt die Aufmerksamkeit auf die relevanten Bildinhalte und vermindert Ablenkung Eine reduzierende Bildbearbeitung umfasst folgende Schritte e Unwichtige Inhalte weglassen e Wichtige Inhalte hervorheben e Zusammengeh rige Inhalte gruppieren Insbesondere die r umliche Organisation ist f r die Verarbeitung entschei dend Eine sinnvolle Anordnung erleichtert es dem Nutzer sich zu orientie re
58. wird Abschlie end werden die Texte zu den Informationseinheiten Block und Map zusammengefasst und mit einem Titel berschrieben der den Zusam menhang zwischen berschrift und Inhalt verdeutlicht Die Zuordnung zu den Ordnungskriterien ist nicht immer eindeutig und manchmal muss sich der Autor zwischen zwei Informationsarten entschei den Interessant ist dass unterschiedliche Informationstr ger wie Tabellen Listen oder Diagramme ebenso wie einfacher Flie text gleichwertig neben einander stehen und die korrespondierende Informationsart als zus tzliche Beschreibungsebene ber den Informationstr gern fungiert Funktionsdesign Das Funktionsdesign wurde von Muthig Sch flein Armbruster speziell f r die Technische Kommunikation entwickelt Die Sprechakt Theorie und die Kommunikationsanalyse betrachten Kommunikation als regelgeleitetes sprachliches Handeln Auf dieser Basis definiert das Funktionsdesign eine variable Anzahl funktionstragender Elemente f r vier Strukturierungsebe nen e Informationsprodukt e Sequenzmuster e Funktionale Einheit e Auszeichnungselement Auf der obersten Ebene wird das Produktwissen in Informationsprodukte d h Dokumentarten wie Bedienungsanleitungen Servicehandb cher oder 51 Topics 4 2 3 Online Hilfen aufgeteilt Oberstes Kriterium dabei ist die Zielgruppe und der Zeitpunkt zu dem die Informationen ben tigt werden Informationsprodukte bestehen aus sogenannten Sequenzm
59. 115 Navigation Basis eines solchen Link Konzepts k nnen folgende Festlegungen sein e Erlaubte Link Arten in einem Topic e Position der Links im Topic e Maximale oder minimale Anzahl der Links pro Topic e Erlaubte Link Arten zwischen Topic Klassen e Erlaubte Topic Klassen f r Links Beispielsweise kann man Links an einer Stelle im Topic b ndeln siehe Abschnitt Link B ndel Siehe auch Verweise auf Seite 132 und im Text selbst nur eingeschobenen oder ausklappbaren Text verwenden Andere Online Hilfen nutzen Links und Popups sparsam im Text geben aber dem Nutzer ber Tooltips oder Symbole Piktogramm einen Hinweis was pas siert wenn er auf einen Link klickt Folgende Arten der Link Darstellung sind f r Nutzer verwirrend e Grafik Links die nicht als solche zu erkennen sind e Schein Links d h unterstrichener Text e Image Maps wenn es auch anders geht e Anklickbare B lle oder Zeichen vor dem Text e Zu viele Links im Text e Gar keine Links in einem Topic ungewollte Sackgasse e Gleiche wiederholte Links in einem Topic Die Ausganganker der Links sollten m glichst aussagekr ftig sein damit sich der Nutzer vorstellen kann welche Information ihn erwartet Schon die Formulierung kann einem Leser mitteilen ob ihn eine Beschreibung oder eine Handlungsanleitung erwartet Auch im Sinne der Barrierefreiheit soll ten Ausgangsanker mehr als ein Wort umfassen Nutzer scannen Topics oft nur nach Ausgan
60. 3 2 F LongTime 00 34 05 4 Variable Siehe auch Verweis See Also ber das Men Ansicht Anzeigen Marken k nnen Marken ein oder aus geblendet und ihre Darstellung im Topic ver ndert werden z B Gr e oder Farbe Explorer Die Explorer werden im Bereich der Navigation angezeigt und dienen der besseren bersicht bestimmter Teile des Hilfeprojekts Wichtigster Explorer ist der Topic Explorer der alle Topics im Projekt und die Topic relevanten Steuerdateien anzeigt die im Ordner Resources verwaltet werden Ebenfalls Teil der Navigation ist die Projektorganisation in der die Pro jekt relevanten Steuerdateien verwaltet werden Flare Projekt auf Datei Ebene Flare verwaltet alle Teile eines Hilfeprojekts auf Datei Ebene Hier findet sich die Struktur der grafischen Benutzeroberfl che wieder Wenn nichts anderes angegeben ist legt Flare alle Projekte in folgendem Ordner an C Dokumente und Einstellungen lt benutzer gt Eigene Doku mente Meine Projekte 31 Das Hilfe Autorensystem Flare ki E Flare SMSDemag omaz File Edit View Favorites Tools Help Om x wor wi K Search gt Folders L Folders cms Content File Folder oma output File Folder Oma Project File Folder Content oma2 flprj 1KB FLPRI File O Output ID Project I Advanced LC ConditionTagSet 3 Destinations ID Glossaries LD Imports OD Reports O Skins OD Targets Tocs D CH Users
61. 6 Navigation 26 neues Projekt anlegen 39 Projektdatei 32 Sprache einstellen 34 Versionskontrolle 39 XML Editor 28 Zieldefinition 37 Flare Projekt 36 aus Word Datei 42 Datei 36 Datei ffnen 27 Sprache 172 Zielsprache 173 193 Stichw rter Format Tabelle 66 Funktionalit t 6 Funktionsdesign 51 G Gebrauchstauglichkeit Generieren 44 45 167 Glossar 102 Popup 131 Grafische Bedienoberfl che siehe Be nutzeroberfl che GUI siehe Benutzeroberfl che 176 1 176 H Handlungsanleitung 55 178 HAT siehe Hilfe Autorensystem Header Datei 24 36 160 bearbeiten 163 einlesen 164 exportieren 163 neu anlegen 162 Hierarchische Navigation 179 Hilfe 183 Agent 179 Autorensystem 25 Viewer 23 179 Hilfe Autorensystem 15 Hilfe Projekt 36 Hilfeart 179 Hilfefenster 23 179 Hilfeformat 179 AppleHelp 20 Browser basierte Hilfe 18 DotNetHelp 20 HTMLHelp 17 JavaHelp 20 Server basiert 21 VistaHelp 22 Winhelp 16 Hilfeprojekt 24 36 Datei ffnen 27 importieren 40 neu anlegen 39 History Liste 105 HTMLHelp 17 API 17 Projekt einlesen 37 Sprache einstellen 172 Unicode 170 Hyperlink siehe Link Hypertext 179 Hypertrail 103 I Icon 184 Identifier 160 Topic zuweisen 165 Identifikation 56 Image Map 107 anlegen 139 Importieren Header Datei 164 Hilfeprojekt 40 Projekt 37 Stylesheet 84 Topic 61 Word Datei 42 Index siehe Stichwortverzeichnis Index Explorer 121 Information andere Medien 58 Konzept 57 Referenz 58
62. 7 3 2 Dynamische Effekte Auf Java und JavaScripts muss nicht verzichtet werden Jedoch sollte bei Stellen die f r die Interaktion wichtig sind eine Alternativeingabe ber einen Link m glich sein Insbesondere dynamisch erzeugte Ergebnisse interpretieren Screen Reader nicht korrekt Manche Screen Reader k nnen Flash Demos nicht abspielen oder Ton Sequenzen bert nen die synthetische Sprachausgabe Auch hier ist eine alternative bermittlung der relevanten Informationen hilfreich Popups und Sekund r Fenster sollten vermieden werden da diese gar nicht oder erst nach mehreren Versuchen erkannt werden Gerade Popups berdecken oftmals relevante Informationen die f r Screen Reader dann nicht mehr erkennbar sind Den Nutzern bleibt oft nur die M glichkeit die Seite zu schlie en Ton und Video Multimedia Effekte werden immer f r einen bestimmten Personenkreis eine Barriere aufstellen So sollte es beispielsweise f r jedes akustische Signal eine optische Entsprechung geben Bilder Die Nutzer von Screen Readern k nnen Bilder prinzipiell nicht ansehen Der einzige Weg etwas ber den Inhalt eines Bildes zu erfahren ist der Alternativtext der f r jedes Bild im HTML Quelltext angegeben werden kann Ein Screen Reader der beim bersetzen einer Seite ein Bild inter pretiert gibt lediglich die Angabe Grafik und den Alternativtext aus Deshalb haben die Alternativtexte f r Screen Reader Nutzer eine sehr wichtige F
63. Akzeptabilit t Einstellung des Lesers Situationalit t Bedeutung in einer bestimmten Situation Informativit t Erwartungshaltung und Bekanntheitsgrad Intertextualit t Beziehung zu anderen Texten 47 Topics Texte schreiben und Texte lesen sind eine Kommunikation mit zeitlicher Verz gerung Ein Nutzer liest einen Text im Rahmen eines gr eren Hand lungszusammenhangs der das Ziel des Lesens vorgibt Die Intentionalit t eines Textes gilt demzufolge nicht nur f r den Autor sondern auch f r den Leser Der Leser erwartet dabei einen koh siven und koh renten Text der f r ihn n tzlich und relevant ist um z B Wissen zu vertiefen oder ein Pro blem zu l sen Damit ein Text seinen kommunikativen Zweck erf llen kann muss er nicht nur verst ndlich sein es muss auch der richtige Text sein Richtig bedeutet im Rahmen der technischen Dokumentation sachlich richtig und vollst n dig was durch die Phase des Korrekturlaufs im Erstellungsprozess sicher gestellt wird Texte sind unterschiedlich strukturiert und k nnen unterschiedlich pr sen tiert werden Unterschieden werden linearer Text und Hypertext Linearer Text In einem linearen Text sind die einzelnen Informationseinheiten wie an einer Perlenschnur aufgereiht Eine Information geht in die n chste ber Umwege sind nicht eingeplant Das beliebsteste Beispiel f r einen linearen Text ist ein Buch das sich aus Kapiteln und Abschnitten zusammensetzt Technische Do
64. C VariableSets zU cms zip 8 messen gt DI RR m 4 objects Disk free space 56 8 GB 109 bytes 4 My Computer L Bild 15 Flare Projekt auf Datei Ebene F r jedes Hilfeprojekt legt Flare einen eigenen Ordner an in dem sich die Projektdatei Endung flprj befindet Darunter liegen die Ordner e Content f r die Topics und Topic relevanten Steuerdateien e Project f r die Projekt relevanten Steuerdateien e Output f r die unterschiedlichen Ausgabeformate Bis auf den Ordner Output entspricht die Struktur auf Datei Ebene genau der in der grafischen Benutzeroberfl che so dass sich alle Dateien gut wie derfinden lassen Im Ordner Output sind die Ausgabeformate nach Benut zerkennungen und danach nach Ausgabeformat geordnet 32 Darstellungsmittel 3 3 3 4 Darstellungsmittel Zur Auszeichnung von Elementen auf der grafischen Oberflache von Flare und im Dateisystem werden in diesem Buch folgende Darstellungsmittel genuizt Tabelle 4 Darstellungsmittel in diesem Buch Auszeichnung Bedeutung fette Schrift Kennzeichnet alle Elemente der grafischen Oberflache dicktengleiche Schrift Kennzeichnet alle Elemente auf Datei Ebene Men Befehl Kennzeichnet einen Befehl aus einem Men der Men zeile lt formatklasse gt Spitze Klammern kennzeichnen variable Werte f r die Sie eigene Werte einsetzen m ssen GROSSBUCHSTABEN Kennzeichnen ein XHTML
65. Die Vertiefung zu einzelnen Themen finden Sie in den nachfolgenden Kapiteln Die ersten Schritte gliedern sich in e Projekt anlegen e Projekt bearbeiten e Online Hilfe generieren Projekt anlegen Sie haben verschiedene M glichkeiten ein Flare Projekt anzulegen und Inhalte aufzunehmen Sie k nnen ein Projekt erstellen indem Sie e Ein leeres Projekt anlegen und danach Inhalte neu erstellen oder importieren e Ein Projekt erstellen indem Sie ein Vorh nger Projekt importieren Dies gilt f r die RoboHelp Projekte und HTMLHelp Projekte e Ein Projekt erstellen indem Sie eine Word oder FrameMaker Datei importieren Auf der Startseite bietet Ihnen Flare die Start Assistenten f r diese Vorge hensweisen an 38 Erste Schritte Leeres neues Projekt anlegen 1 W hlen Sie den Befehl Datei Neues Projekt Der Assistent f r ein neues Projekt ffnet sich mit dem ersten Dialog Geben Sie hier den Projektnamen und den Ordner an in dem das Projekt abgelegt werden soll Wenn Sie mit einem Versionskontrollsystem wie z B Sourcesafe arbeiten k nnen Sie dieses mit der Option An Quellsteuerung bin den angeben Sie k nnen dann im n chsten Dialog Namen und Pfad des Versionskontrollsystems angeben und eine Verbindung festlegen Klicken Sie auf Weiter Der Dialog Sprache w hlen ffnet sich W hlen Sie die Sprache f r dieses Flare Projekt Diese Spracheinstel lung k nnen Sie in der Zieldefinition bersteuern
66. Dr cken Sie die Taste F10 Flare f gt vor das markierte Wort das Stichwort in einer Stichwortmarke ein 119 Navigation Mehrere Stichw rter anlegen 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic in das Sie Stichw rter ein f gen wollen W hlen Sie den Befehl Extras Index Stichw rter einf gen Der Stichwort Editor ffnet sich rechts im Arbeitsbereich des Flare Haupt fensters Stichwort TT zi r Begriffe Geben Sie die Stichw rter ein Verwenden Sie Doppelpunkte CL um die Ebenen zu trennen See gt information CS Bedingungen Bedingungen w hlen Bedingungen Zum Ausw hlen klicken Bild 35 Stichwort Editor Positionieren Sie den Cursor im Text an die Stelle an der Sie Stichw r ter eingeben wollen Geben Sie dann im Stichwort Editor in die Liste Begriffe ein Stichwort ein Die erste Hierarchiestufe trennen Sie von der zweiten Stufe mit einem Doppelpunkt ohne Leerzeichen z B Datei speichern Schlie en Sie das Stichwort mit der Eingabe Taste ab Flare f gt das Stichwort in einer Stichwortmarke ein Im Stichwort Editor springt der Cursor automatisch auf den zweiten Eintrag in der Liste Begriffe Stichwort bearbeiten 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic dessen Stichw rter Sie bearbeiten wollen Klicken Sie auf eine Stichwortmarke und w hlen S
67. Ein zuviel an Information in einer Online Hilfe wird entweder nicht gelesen oder sie lenkt den Leser von der Information ab die er sucht Online Hilfen werden vom Typ her eher der Software zugeordnet als der Dokumentation Sie beschreiben zwar die grafische Benutzeroberfl che einer Software aber sie sind eng mit ihr verzahnt speziell kontextsentive Online Hilfen Von daher gelten Online Hilfen ein bisschen als Zwitterwe sen da sie zum einen eine Erg nzung der herk mmlichen Dokumentation eines Produkts sind zum anderen zwischen Produkt und sonstiger Doku mentation stehen Dieses Kapitel will einen Bogen schlagen zwischen Input und Output In der Mitte zwischen beiden steht der Hilfe Autor und schreibt seine Online Hilfe Als Input gelten dabei neben der reinen Produktbeschreibung die Erwartun gen der Leser und die verschiedenen Hilfearten Output meint das jewei lige Hilfeformat Beide beeinflussen die M glichkeiten die ein Autor f r die Online Hilfe nutzen kann Vom Input zum Output 2 1 Erwartungen der Leser Mittlerweile ist es f r viele Software Produkte selbstverst ndlich dass eine grafische Benutzeroberfl che Nutzern einen leichteren Zugang zu Produkt Funktionen bietet Zum guten Ton geh rt es auch dass diese grafische Benutzeroberfl che in einer Online Hilfe beschrieben ist Trotzdem zeigen Befragungen dass viele Nutzer die Online Hilfe nur in den seltensten F llen sozusagen als allerletztes Mitte
68. Hilfe sein Solche Anderun gen der Einstellungen gelten auch f r die Programme und somit auch f r Browser In manchen F llen f hrt das zu Problemen wenn Gestalter Far ben teils selbst definieren teils ihre Definition dem Betriebssystem berlas sen Maus Ersatz Andere Nutzer k nnen keine Maus benutzen und sind statt dessen auf die Tastatur zur Navigation oder zur Bedienung der Maus angewiesen Eine bergest lpte Tastaturschablone hilft Menschen mit motorischen Schwie rigkeiten eine Taste korrekt zu treffen Gerade auch Experten unter den Computernutzern verwenden gerne die Tastatur statt der Maus Die Arbeit geht mit der Tastatur oftmals schneller von der Hand 144 Gesetzlicher Rahmen 7 2 Tastaturk rzel f r HTML Seiten sind zwar nicht unbedingt vorgesehen aber machbar Die M glichkeit eine Seite ausschlie lich mit der Tastatur zu bedienen ist ein wichtiges Kriterium f r Zug nglichkeit und Barrierefrei heit Menschen die beispielsweise Ihre H nde nicht mehr ffnen k nnen nut zen auch Track B lle zur Navigation Allerdings sind diese oftmals ungenau beim Positionieren Weitere Barrieren Ein gro er Teil der Sehbehinderten steht auch dann vor Barrieren wenn sie keinen Screen Reader oder Magnifier einsetzen m ssen Da dieser Perso nenkreis aufgrund der Vielf ltigkeit der Augenerkrankungen meist sehr indi viduelle Anforderungen an die Anzeige des Bildschirms hat ist es hier schwierig o
69. Information Mapping 50 Informationsart 180 Informationsbaustein bersetzen 172 Informationsdesign 52 Informationsmenge 73 Informationstyp 180 Inhalt Buch 57 Online Hilfe 56 Inhaltsverzeichnis 100 111 bearbeiten 118 Datei Ausgabe 36 Datei Quelle 36 117 194 Stichw rter Inhaltsverzeichnis neu anlegen 117 bersetzen 171 Inter hypertextueller Link 107 Interaktion 180 Interaktives Element 109 140 Interner Sprung 126 Intra hypertextueller Link 106 ISO 169 J JavaHelp 20 K Knoten siehe Topic Kontextfrei 181 Online Hilfe 15 Kontextmen 28 180 Kontextnummer 160 Kontextsensitiv 180 Anbindung 36 Kontextsensitive Anbindung 24 159 Aliasdatei 161 Header Datei 160 Skin zuordnen 166 testen 167 URL 161 Kontextsensitive Hilfe 13 Dialogebene 14 Elementebene 13 Konzept Information 57 Link 115 134 Topic 55 L Laufweite 74 181 Layout barrierefrei 150 Bilder 77 Farbe 75 Farbwahl 76 Flare Fenster 36 Schrift 74 Lernprogramm 5 Lernvideo 5 Lesbarkeit 71 181 Lesepfad 103 113 181 Datei 125 Leserlichkeit 71 181 Lesertyp 10 Lesestimme 155 Lesevorgang 71 Lesezeichen 181 anlegen 126 bersetzen 172 Lingo 171 Link 49 99 114 181 Anker 109 Arten 105 Ausgangsanker 105 116 barrierefrei 153 externer Sprung 127 extra hypertextuell 107 Glossar Popup 131 Image Map 139 inter hypertextuell 107 interaktives Element 140 interner Sprung 126 intra hypertextuell 106 Konzept 115 Konzept Lin
70. N EN ISO 14915 SW Ergonomie f r Multimedia Benutzerschnittstellen Teil 1 Gestaltungsgrunds tze und Rahmenbedingungen Teil 2 Multimedia Navigation und Steuerung Teil 3 Auswahl und Kombination von Medien ISO IEC 15910 1999 Information technology Software user documenta tion process ISO IEC 18019 2004 Software and system engineering Guidelines for the design and preparation of user documentation for application software DIN 33455 Barrierefreie Produkte DIN VDE 1000 Teil 10 Anforderungen an im Bereich der Elektrotechnik t tige Personen tekom e V 2006 QualiAssistent http www tekom de index_neu jsp url serviet ControllerGUI action voll amp id 1 981 W3C 2004 Accessibility Guideline http Awww w3 org WAI GL WCAG20 189 Stichw rter css 36 doc 37 docx 37 flali 36 161 flbrs 125 flgo 122 Tor 36 far 36 fltoc 36 117 fm 37 h 36 hhp 37 htm 36 37 mchelp 20 mif 37 mp 37 rtf 37 xpj 37 book 37 A Absatz 175 Accessibility Guideline 145 Bedienbarkeit 146 Robustheit 148 Verst ndlichkeit 148 Wahrnehmbarkeit 146 Aliasdatei 24 36 161 bearbeiten 165 Endung 36 neu anlegen 164 Animation 78 Anlegen Aliasdatei 164 Header Datei 162 Hilfeprojekt 39 Image Map 139 Inhaltsverzeichnis 117 interaktives Element 140 Lesepfad 125 Lesezeichen 126 Neues Medium f r Stylesheet 155 Stichwort 119 Topic 60 Vorgabeseite 82 Zieldefinition 92 Anpassbarkeit
71. Online Hilfen auf Win dows Systemen sein wird 22 Hilfeformate und Hilfefenster 2 3 5 Hilfe Viewer Das Hilfefenster ein Teil des Hilfe Viewers zeigt die generierte Online Hilfe an F r unterschiedliche Betriebssysteme und Hilfeformate gibt es unter schiedliche Hilfe Viewer Die folgende Tabelle gibt einen berblick ber die wichtigsten Hilfe Viewer Tabelle 3 Hilfe Viewer f r verschiedene Betriebssysteme Betriebs Winhelp HTML WebHelp DotNet JavaHelp Oracle system Help Help Help for Java Windows _ integriert Browser Madcap Java Oracle 3 1 in BS Viewer Viewer Viewer Windows integriert Internet Browser Madcap Java Oracle 95 NT in BS Explorer Viewer Viewer Viewer Windows integriert Internet Browser Madcap Java Oracle 98 2000 in BS Explorer Viewer Viewer Viewer XP 2003 Windows extern Internet Browser Madcap Java Oracle Vista Explorer Viewer Viewer Viewer Macintosh extern extern Browser Java Oracle Viewer Viewer Unix Li extern extern Browser Java Oracle nux Viewer Viewer Das Aussehen jedes Hilfefensters l sst sich ver ndern Die nderungs m glichkeiten h ngen vom Hilfeformat ab 23 Vom Input zum Output 2 4 Hilfeprojekt Zum Erstellungszeitpunkt in der Quelle bestehen Online Hilfen aus mehr als einer Datei und sind deswegen in Hilfeprojekten zusammengefasst Ein Hilfeprojekt besteht aus mindestens folge
72. Petra Thiemann Benutzerfreundliche Online Hilfen Petra Thiemann Benutzerfreundliche Online Hilfen Grundlagen und Umsetzung mit MadCap Flare Mit 45 Abbildungen PRAXIS Ges VIEWEG TEUBNER Bibliografische Information Der Deutschen Nationalbibliothek Die Deutsche Nationalbibliothek verzeichnet diese Publikation in der Deutschen Nationalbibliografie detaillierte bibliografische Daten sind im Internet ber lt http dnb d nb de gt abrufbar Das in diesem Werk enthaltene Programm Material ist mit keiner Verpflichtung oder Garantie irgend einer Art verbunden Der Autor bernimmt infolgedessen keine Verantwortung und wird keine daraus folgende oder sonstige Haftung bernehmen die auf irgendeine Art aus der Benutzung dieses Programm Materials oder Teilen davon entsteht H chste inhaltliche und technische Qualit t unserer Produkte ist unser Ziel Bei der Produktion und Auslieferung unserer B cher wollen wir die Umwelt schonen Dieses Buch ist auf s urefreiem und chlorfrei gebleichtem Papier gedruckt Die Einschwei folie besteht aus Poly thylen und damit aus organischen Grundstoffen die weder bei der Herstellung noch bei der Verbrennung Schadstoffe freisetzen 1 Auflage 2008 Alle Rechte vorbehalten Vieweg Teubner Verlag GWV Fachverlage GmbH Wiesbaden 2008 Lektorat Sybille Thelen Andrea Bro ler Der Vieweg Teubner Verlag ist ein Unternehmen von Springer Science Business Media www viewegteubner de Da
73. Sie die Abfrage mit OK Der Dialog schlie t sich und das neue Topic wird im ausgew hlten Ordner angelegt und zum Bearbei ten im XML Editor ge ffnet Wenn Sie vorher keinen Ordner ausge w hlt oder angegebenen haben wird das Topic im Ordner Inhalte angelegt 60 Umsetzung mit Flare 4 5 2 4 5 3 Topic importieren Schon bestehende Topics aus anderen Projekten oder HTML Dateien k n nen Sie importieren 1 2 Wechseln Sie in den Topic Explorer W hlen Sie im Topic Explorer den Ordner aus in das das Topic importiert werden soll W hlen Sie den Befehl Projekt Neues Topic Der Dialog Neues Topic anlegen ffnet sich Klicken Sie bei Quelldatei auf die Schaltfl che mit den drei Punkten und w hlen Sie im Dialog Offnen den Ordner und die Datei aus die Sie importieren wollen Pr fen Sie bei Ordner ob das Topic in diesen Ordner kopiert werden soll W hlen Sie gegebenenfalls einen anderen Geben Sie dem Topic gegebenenfalls einen neuen Dateinamen W hlen Sie das passende Stylesheet aus Best tigen Sie Ihre Einstellungen mit Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob das Topic kopiert werden soll Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und e das Topic wird in den ausgew hlten Ordner kopiert und zum Bear beiten im XML Editor ge ffnet Wenn Sie keinen Ordner ausge w hlt und zugewiesen haben wird das Topic im Ordner Inhalte angelegt e wenn da
74. Sie in die Projektorganisation 2 ffnen Sie den Ordner Zieldefinitionen 3 Klicken Sie mit der rechten Maustaste auf die passende Zieldefinition und w hlen Sie den Befehl Als Voreinstellung verwenden aus dem Kontextmen Die Zieldefinition ist als Voreinstellung markiert und wird fett im Ordner dargestellt 4 Dr cken Sie die Taste F6 Die voreingestellte Zieldefinition wird gene riert Bilder und Video Konkret k nnen Sie mit Flare folgende Bild Formate importieren e bmp e gif jpg jpeg png e tif tiff F r Videos gibt es das swf Format Bild einf gen 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic in das Sie ein Bild einf gen wollen 3 Positionieren Sie den Cursor an die Stelle an der Sie das Bild einf gen wollen 4 W hlen Sie den Befehl Einf gen Bild Der Dialog Bild einf gen ff net sich 5 W hlen Sie entweder ein neues Bild mit Suchen oder ein Bild aus dem Projekt 6 Geben Sie gegebenenfalls Text f r einen Tooltip und oder als Alterna tiven Text an 95 Layout 7 Best tigen Sie Ihre Angaben mit OK Das Bild wird an der Cursor Position in das Topic eingef gt Ein neues Bild kopiert Flare in den Ordner Resources Bilder im Topic Explorer Bildgr e ndern 1 Markieren Sie das Bild mit einem Klick In der rechten unteren Ecke des Bildes wird ein Symbol eingeblendet Setzen Sie die Maus auf das Symbol der Curso
75. Softwareentwickler die auf Windows programmieren hat Microsoft alles bereitgestellt was zur Programmierung mit Unicode gebraucht wird Von fast jeder Funktion aus der Windows API gibt es zwei Versionen Eine ist f r die Unicode Version zust ndig die andere f r die ASCII Version Dies gilt auch f r die kontext sensitive HTML Hilfe die ber die entspre chende API aufgerufen wird Die Funktion HTMLHelp gibt es eigentlich gar nicht Das ist nur eine Defi nition die je nach definiertem oder nicht definiertem _UNICODE auf eine der beiden folgenden Funktionen abgebildet wird HtmlHelpA gt ASCII oder ANSI Version HtmlHelpW gt Unicode Version W f r wide char Dies ist in der Windows API Dokumentation nicht explizit beschrieben aber es trifft f r alle Windows API Funktionen zu Also ist hier f r Programmierer der erste Schritt getan Unicode auch f r eine kontextsensitive Anbindung an HTML Hilfen zu nutzen 170 Umsetzung mit Flare 9 2 9 2 1 Unicode Zeichensatz Voraussetzung f r den Einsatz von Unicode und damit auch f r die ber setzung der Online Hilfe in osteurop ische und asiatische Sprachen sind spezielle Unicode Zeichens tze F r jede Schriftfamilie gibt es auch eine Unicode Auspr gung die auf dem Produktionsrechner installiert sein muss Unicode Zeichens tze k nnen bei verschiedenen Anbietern gekauft werden Umsetzung mit Flare Flare unterst tzt den Unicode Standard nicht nur
76. Speichern Ausdruck einschlie en Ausdruck ausschlie en gt Procedure 2 Overview information El about this procedure or task Steps necessary to complete a task Step Step Step Final step ah on Hr El Notes R Dies sind die ausklappbaren Hinweise e Inthe notes section you can list any special information Or cautions you may have for the user Tip It is easy to report a bug during beta testing There is a Submit a Bug link right on the Flare Start page Bild 43 Beispiel ausklappbarer Text Image Map 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic das die Image Map erhal ten soll F gen Sie eventuell das Bild ein mit dem Befehl Einf gen Bild Klicken Sie im Topic mit der rechten Maustaste auf das Bild und w h len Sie den Befehl Imagemap aus dem Kontextmen Der Imagemap Editor ffnet sich mit dem markierten Bild 5 W hlen Sie aus der Symbolleiste des Imagemap Editor ein Formen Symbol aus z B ein Rechteck 139 Navigation 10 11 12 13 Ziehen Sie mit der gedr ckten rechten Maustaste ein Rechteck ber einen Bereich des Bildes f r das Sie einen Link hinterlegen wollen Sobald Sie die Maustaste loslassen wird das Rechteck rot umrandet und markiert angezeigt Sie k nnen ein markiertes Objekt jederzeit in seiner Gr e oder Position ndern oder l schen W hlen Sie den Befehl Bearbeiten Eigenschafte
77. Stylesheet mehreren Topics zuweisen aber auch umge kehrt mehrere Stylesheets einem Topic Um ein Stylesheet mehreren Topics zuzuweisen gehen Sie folgenderma Ben vor 1 2 W hlen Sie den Befehl Ansicht Dateiliste Die Dateiliste ffnet sich W hlen Sie die Topic Dateien aus denen Sie ein Stylesheet zuweisen wollen Klicken Sie mit der rechten Maustaste auf diese Auswahl und w hlen Sie den Befehl Eigenschaften aus dem Kontextmen Der Dialog Eigenschaften ffnet sich W hlen Sie das Register Topic Eigenschaften W hlen Sie aus der Liste Stylesheet das passende aus Mit OK best tigen Sie Ihre Auswahl 88 Umsetzung mit Flare 5 7 3 Um mehrere Stylesheets einem Topic zuzuweisen gehen Sie folgenderma Ben vor 1 2 3 Wechseln Sie in den Topic Explorer Offnen Sie das Topic dem Sie die Stylesheets zuweisen wollen Wahlen Sie den Befehl Extras Stylesheet Links Der Stylesheet Links Dialog ffnet sich W hlen Sie rechts aus der Liste die Stylesheets aus die Sie dem Topic zuweisen wollen Klicken Sie dann auf den doppelten Pfeil zwischen den Listen lt lt um dem Topic die Stylesheets zuzuweisen W hlen Sie OK um die Zuweisung zu best tigen Der Dialog schlie t sich Einzelnes Format zuweisen Die einzelnen Formate aus dem Stylesheet k nnen Sie entweder ber die Formatierungsleiste oder ber das Formate Fenster zuweisen 1 1 Wechseln Sie in den Topic Explorer ffnen Sie
78. Tag z B XREF Tag Flare anpassen Flare ist ein sehr komplexes Werkzeug das vielen Anspr chen und Anfor derungen gerecht werden soll Flare versucht aber auch unerschiedliche Arbeitsweisen zu unterst tzen Beispielsweise lassen sich die meisten Befehle auf mehrere Arten ausf hren e Men s e Symbole der allgemeinen oder einer lokalen Symbolleiste e Tastenkombinationen e Kontextmen f r jedes anklickbare Element der Oberfl che Zur Benutzerfreundlichkeit einer Software geh rt auch dass die Oberfl che sich an die Bed rfnisse der Nutzer anpassen l sst Dies sollte nat rlich in besonderem Ma e f r Hilfe Autorensysteme gelten Flare bietet viele M g lichkeiten die Oberfl che anzupassen Im folgenden sind nur zwei M glich keiten beschrieben e Die Sprache der Benutzeroberfl che anpassen e Das Fensterlayout anpassen 33 Das Hilfe Autorensystem Flare 3 4 1 3 4 2 Sprache der Benutzeroberfl che Die Flare Oberfl che wird in vier Sprachen angeboten Die Oberfl che von Flare wird in der Sprache angezeigt die am Anfang der Sprachenliste steht Die Reihenfolge k nnen Sie wie folgt ndern 1 W hlen Sie den Befehl Extras Optionen Der Dialog Optionen ffnet sich 2 W hlen Sie die Option Sprache einstellen Dialog beim Start anzei gen 3 Best tigen Sie Ihre Einstellung mit OK Danach wird Ihnen bei jedem Start von Flare folgender Dialog anzeigt BER Reihenfolge der Spra
79. UI Objekte auflisten die eine kontextsensitive Hilfe erhalten sol len e URLs oder Identifier und Kontextnummern f r jedes GUI Objekt festle gen 161 Die kontextsensitive Anbindung 8 2 e Header Date oder Matrix mit URLs erstellen oder einlesen e Aliasdatei anlegen e Alias den einzelnen Topics zuweisen e Hilfe generieren Hilfe testen Aufgaben GUl Entwickler Abh ngig von den Absprachen k nnen auf einen GUI Entwickler folgende Aufgaben zukommen e Alle GUI Objekte auflisten die eine kontextsensitive Hilfe erhalten sol len e Fur jedes GUI Objekt die Hilfe Eigenschaft und den Hilfe Aufruf festle gen e Header Date anlegen oder einlesen e _Kontextsensitive Anbindung testen Umsetzung mit Flare Mit Flare k nnen Sie Header Dateien sowohl erstellen und exportieren als auch einlesen Die Header Datei wird in Flare als Textdatei verwaltet die Sie beliebig bearbeiten k nnen Flare bietet konkrete Anschlussunterst t zung f r folgende Programmier Umgebungen e C C Endung Header Datei h oder hh e Visual Basic Endung Header Datei bas e Java Endung Header Datei properties e Delphi Pascal Endung Header Datei mc Header Datei anlegen Eine Header Datei legen Sie an wenn Sie als Hilfe Autor verantwortlich fur die Erstellung und Pflege sind 1 W hlen Sie den Befehl Projekt Erweitert Neue Header Datei Der Dialog Neue Header Datei einf gen ffnet sich 2 Wahlen Sie gege
80. a Leser den Unterschied zwi schen r ckw rts Bl ttern und Zur ckbl ttern oft nicht verstehen W hrend die Zur ckbl ttern Schaltfl che des Lesepfads zu einem Topic f hrt das im linear angelegten Lesepfad vor dem aktuellen Topic steht f hrt die Zur ck Schaltfl che des Browsers zum zuvor angesehenen Topic Wenn der Unterschied zwischen diesen beiden Navigations Funktionen nicht eindeutig umgesetzt ist landet ein Leser eventuell bei einem Topic das er nie zuvor gelesen hat Hier zeigt sich dass die Buch Metapher Hypertext spezifische Konzepte nur unzureichend abbilden kann 104 Links 6 4 6 4 1 Verlauf History Liste Eine History Liste ist eine spezielle Funktion die alle zuvor besuchten Topics automatisch der Reihe nach auflistet Der entscheidende Unter schied zum r ckw rts Bl ttern besteht darin dass auf alle schon besuchten Topics direkt zugegriffen werden kann indem die entsprechende Zeile oder der entsprechende Topic Name angeklickt wird History Listen k nnen tempor r d h nur f r die Dauer der aktuellen Sit zung oder dauerhaft gespeichert werden Bei dauerhafter Speicherung ist es sinnvoll Datum Zeit und Listenname aufzuzeichnen Zus tzlich zu den Vorw rts R ckw rts Funktionen bieten manche Viewer auch eine Verlaufsverwaltung Darin kann die Anzeige der letzten Topics variiert werden z B Ansicht nach Datum oder Site Favoriten Favoriten speichern Lesezeichen setzen ist eine akt
81. achw rter sind im Fachwortverzeichnis tabellarisch dargestellt In den Spalten Definition Link und Klasse sehen Sie die jeweiligen Eigenschaf ten eines Fachworts Neue Fachw rter f gen Sie mit dem ersten Symbol der lokalen Symbolleiste ein 1 Klicken Sie auf in der lokalen Symbolleiste oder doppelklicken Sie auf ein Fachwort in der Fachworttabelle Der Dialog Eigenschaften ffnet sich f r das Fachwort 2 Geben Sie im Register Glossarbegriff das Fachwort ein oder ndern Sie es 3 Geben Sie eine passende Erkl rung bei Definition ein Sie k nnen auch auf ein Topic verweisen in dem die Erkl rung steht 4 Legen Sie im Register Format gegebenenfalls fest wie das Fachwort im Topic ausgezeichnet werden soll 5 Klicken Sie auf OK um Ihre Einstellungen zu best tigen Das Fach wort wird mit seinen Eigenschaften in die Tabelle eingetragen 6 Speichern Sie das Fachwortverzeichnis mit dem Befehl Datei Spei chern 123 Navigation Fachwortverzeichnis f r Online Hilfe aktivieren Fachwortverzeichnisse geh ren nicht zur Grundausstattung eines Hilfefen sters Deswegen m ssen Sie sie in der Skin f r die Darstellung in der Online Hilfe aktivieren 1 Wechseln Sie in die Projektorganisation 2 ffnen Sie im Ordner Skins die passende Skin mit einem Doppelklick 3 W hlen Sie im Register Basis aus der Liste Funktionen den Eintrag Glossar aus 4 Speichern Sie die Skin mit dem Befehl Datei Speichern Fachwortve
82. aktualisiert werden Konzept Link B ndelt mehrere Topics mit einer Themengebiets marke zu einem Themengebiet Wenn Sie diese Marke aus einem Topic l schen und in weitere Topics einf gen aktualisiert Flare automatisch das Link B ndel Stichwort Link B ndelt mehrere Topics anhand eines gemeinsa men Stichworts Wenn Sie das Stichwort aus einem Topic l schen und in weitere Topics einf gen aktualisiert Flare automatisch das Link B n del 133 Navigation Verwandte Topics B ndelt singul re Links ohne Gemeinsamkeiten Diese Link B ndel sind schneller anzulegen aber schwieriger zu warten da sie manuell aktualisiert werden m ssen Konzept Link B ndelt mehrere Topics zu einem Themengebiet Sie k nnen beliebig viele Themengebiete in einem Projekt erstellen Topics werden ber eine The mengebietsmarke einem Themengebiet zugeordnet Alle Topics mit dersel ben Themengebietsmarke werden bei der Generierung zu einem Link B ndel zusammengefasst Wenn Sie diese Marke aus einem Topic l schen oder in weitere Topics einf gen aktualisiert Flare automatisch das Link B ndel F r einen Konzept Link m ssen Sie zuerst in jedem Topic eine Themenge bietsmarke erstellen das zu dem Link B ndel dazugeh ren soll Danach f gen Sie einen Siehe auch Verweis auf das Link B ndel in jedes Topic des Themengebiets ein Themengebiet festlegen 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem
83. alog k nnen Sie das Verhalten des Links weiter festlegen e Im Feld Link Text sehen Sie den Text den Sie vorher im Topic f r den Ausgangsanker markiert haben Wenn Sie diesen Text ndern wird er auch im Topic ge ndert 130 Umsetzung mit Flare e Bei Bildschirm Tip k nnen Sie einen erkl renden Text Tooltip eingeben e Bei Formatklasse k nnen Sie eine Formatklasse vom Typ A lt formatklasse gt w hlen mit der der Link formatiert werden soll Wenn Sie keine Formatklasse angeben verwendet Flare das Basis A Tag 7 Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und das Topic Popup wird in das Topic eingef gt 8 Speichern Sie das Topic mit dem Befehl Datei Speichern Ausdruck einschlie en Ausdruck ausschlie en gt Getting Started With FictionSoft This topic is a good place to explain the high level concepts that allow a user to be successful with FictionSoft e Overall work flow for FictionSoft Important concept e Special language d About FictionSoft Any other informati Company Information Add information about your company The company history mission statement or any other information you want to communicate If you want to st Tip document you are wo on the tool bar Contact Information Akann Bild 39 Topic Popup in einer Online Hilfe Glossarbegriff Links Mit Glossarbegriff Links k nnen Si
84. anleitungen am Bildschirm Bedienungsanleitungen am Bildschirm umfassen alle Informationen die Assistenz Systeme Lernprogramme und Papierdokumentation erg nzen oder ersetzen und das Produkt komplett beschreiben Sie werden z B auf CD ROM und oder im Internet bereitgestellt Dazu geh ren z B Online B cher Begriffskl rungen 1 3 e als direkte Umsetzung der Druckversion z B Bedienungsanleitungen Wartungsanleitungen Installationsanleitungen Montageanleitungen usw zum Drucken f r den Nutzer e die speziell f r den Bildschirm aufbereitet sind z B Prozessbeschrei bung Produktbeschreibung Bedienungsanleitung usw Ein Buch l sst sich dadurch definieren dass es seitenorientiert und haupt s chlich linear aufgebaut ist Es hat eine Kapitel Abschnitt Struktur und ist unabh ngig vom Produkt ausliefer und zugreifbar N tzlichkeit F r den Usability Experten Jakob Nielsen ist die Gebrauchtauglichkeit Usability ein Teilgebiet des Oberbegriffs N tzlichkeit Usefulness Gleich zeitig grenzt er die Gebrauchstauglichkeit gegen ber der Funktionalit t Utility ab N tzlichkeit EN Gebrauchstauglichkeit Funktionalit t Bild 2 Kategorien der N tzlichkeit Ein System ist n tzlich wenn seine Funktionalit t und Gebrauchstauglich keit einen Nutzer in die Lage versetzen ein bestimmtes Ziel problemlos zu erreichen Die N tzlichkeit einer Online Hilfe wird demnach
85. ar e Variablen e Bedingungen Das bedeutet alles was in der generierten Ausgabe wirksam werden soll ist auf die eine oder andere Weise mit der Zieldefinition verbunden Zieldefinition anlegen Um eine neue Zieldefinition anzulegen gehen Sie folgenderma en vor 1 W hlen Sie den Befehl Projekt Neue Zieldefinition Der Dialog Neue Zieldefinition einf gen ffnet sich W hlen Sie eine Vorlage f r die Zieldefinition aus z B HTMLHelp Geben Sie der Zieldefinition bei Dateiname einen Namen Klick Sie auf Einf gen um die neue Zieldefinition anzulegen Der Dia log schlie t sich und es ffnet sich die Abfrage ob die Zieldefinition mit der ausgew hlten Vorlage erstellt werden soll 5 Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt die neue Zieldefinition in der Projektorganisation im Ordner Ziel definitionen an und ffnet sie zum Bearbeiten im Arbeitsbereich 92 Umsetzung mit Flare F MyWebHelp x neu css Startseite tieldefinition bearbeiten 2 do Sh Pag Kommentar Application Help Sample Bedingter Text Ausgabetyp WebHelp Plus Variablen DotNetHelp Microsoft HTMLHelp Kopiere Microsoft Word H Adobe FrameMaker R Glossar Erweitert Start Topic voreingestellt z g Druckversion Optionen f r Sprungschaltfl che Leistung Feedback Service Skin voreingestellt z _Bearbeten ade Hauptinhaltsverzeichnis voreingestellt E _ Bearb
86. bHelp Inhalts und Stichwortverzeichnis erstellt DotNe werden Diese Optionen sind vor allem f r tHelp komplexe Online Hilfen interessant Feedback Aktiviert den Feedback Service von Mad Online Service cap Software Hilfen Sprache Stellt die Sprache f r die Ausgabe ein Alle For mate Zieldefinition bearbeiten Um die Zieldefinition zu bearbeiten gehen Sie wie folgt vor Exemplarisch ist hier das Einstellen der Skin des Medientyps f r die Ausgabe und die Vorgabeseite beschrieben Wechseln Sie in die Projektorganisation 2 ffnen Sie den Ordner Zieldefinitionen 3 ffnen Sie mit einem Doppelklick die passende Zieldefinition 4 W hlen Sie im Register Basis aus der Liste Skin die passende Skin aus Wechseln Sie zum Register Erweitert 6 W hlen Sie aus der Liste Vorgabeseite die passende Vorgabeseite aus 7 W hlen Sie aus der Liste Stylesheet Datentr ger den Eintrag non print f r eine Online Hilfe oder print f r eine Druckausgabe aus 8 Speichern Sie die Zieldefinition mit Datei Speichern 94 Umsetzung mit Flare 5 7 5 Voreinstellung f r Generierung nutzen ber die Zieldefinition steuern und starten Sie die Generierung der Aus gabe Generell starten Sie die Generierung einer Ausgabe ber das Kon textmen der entsprechenden Zieldefinition Sie k nnen sich eine Zieldefinition als Voreinstellung ausw hlen und deren Generierung dann mit der Taste F6 starten 1 Wechseln
87. ben und Adjektive z B immer Gro schreibung Gro schreibung nur auf erster Stufe oder entsprechend der Wortform e Verwendung von Singular und Plural e Umgang mit einem Begriff in unterschiedlichen Kontexten e Minimale Anzahl Untereintr ge pro Stichwort e Maximale Anzahl Untereintr ge pro Stichwort F r ein Stichwort kann es Treffer in ein oder mehreren Topics geben Diese Topics werden in der fertigen Online Hilfe dann als Men angezeigt aus dem sich der Nutzer das f r ihn passende Topic aussuchen kann Zur Aufli stung der Topics in diesem Men werden die Topic Titel verwendet siehe Abschnitt Topic Eigenschaften auf Seite 61 Fachwortverzeichnis Glossar Ab drei oder vier Fachw rtern in der Online Hilfe empfiehlt sich ein Fach wortverzeichnis Ein Fachwortverzeichnis oder Glossar ist eine Zusammen stellung der verwendeten Fachausdr cke mit Erkl rung Es enth lt alle erkl rungsbed rftigen Worte wie e Fachbegriffe e Fremdw rter e Abk rzungen Eine Online Hilfe kann sowohl ber ein zentrales Glossar verf gen als auch ber direkte Erkl rungen der Fachworter direkt im Topic M gliche Umset zung dazu sind e Popups _ Eingeschobener Text Beschrankungen Lesepfade sind etwas aus der Mode geraten Sie eignen sich beispiels weise f r spezielle Zielgruppen z B Einsteiger oder wichtige Abl ufe Lesepfade empfehlen sich immer dann wenn Nutzer bestimmte Informatio nen z B Teilaufgaben in e
88. benenfalls eine andere Vorlage f r de Header Datei aus 3 Geben Sie der Header Datei einen Dateinamen 162 Umsetzung mit Flare 4 Klicken Sie auf Einf gen Der Dialog schlie sich und es ffnet sich die Abfrage ob die Header Datei mit der ausgew hlten Vorlage erstellt werden soll 5 Best tigen Sie die Abfrage Der Dialog schlie t sich und die neue Header Datei wird in der Projektorganisation im Ordner Erweitert angelegt und zum Bearbeiten ge ffnet Header Datei bearbeiten Die Header Datei ist eine simple Textdatei die Sie beliebig bearbeiten k n nen Sie k nnen die Header Datei direkt mit dem Texteditor von Flare bear beiten oder aber implizit ber die Aliasdatei 1 Wechseln Sie in die Projektorganisation ffnen Sie den Ordner Erweitert ffnen Sie die passende Header Datei mit einem Doppelklick Geben Sie die neuen Identifier ein HL Be a Jo Speichern Sie die Header Datei mit dem Befehl Datei Speichern Header Datei exportieren Um den aktuellen Stand der Header Datei an die Entwicklung zu berge ben m ssen Sie sie f r die verwendete Programmier Umgebung exportie ren 1 Wechseln Sie in die Projektorganisation ffnen Sie den Ordner Erweitert Klicken Sie mit der rechten Maustaste auf die Header Datei und w h len Sie den Befehl Header Datei exportieren aus dem Kontextmen Der Dialog Header Datei exportieren ffnet sich 4 W hlen Sie die Programmiersprache f r die Sie ein
89. bersetzungs kandidaten sind die Dateien die bersetzungsrelevanten Text enthalten k nnen wie beispielsweise Topics Ob die Inhalte dieser Dateien wirklich bersetzungsrelevant sind muss der Hilfe Autor in einem zweiten Schritt pr fen Es kann sein dass manche potentielle Kandidaten wie z B eine Vorgabeseite so gestaltet sind dass sie nicht bersetzt werden m ssen Komponenten f r die bersetzung Folgende Dateien eines Hilfeprojekts k nnen Kandidaten f r die berset zung sein e Topics und damit auch Tabellen Stichworteintr ge M Inhaltsverzeichnis 171 Mehrsprachigkeit 9 2 2 e Fachwortverzeichnis e Vorgabeseite e Bilder e Variablen e nformationsbausteine e Lesezeichen e Skin Alle bersetzungsrelevanten Dateien k nnen Sie als XML Dateien an die Ubersetzung bergeben Verwenden Sie im Hilfeprojekt und bei der Gene rierung immer die gleiche Spracheinstellung z B f r Russisch immer Kyril lisch Russland und nicht Kyrillisch Mongolei Spracheinstellungen im Flare Projekt In einem Flare Projekt k nnen Sie an unterschiedlichen Stellen die Sprache einstellen Diese Spracheinstellungen wirken sich unterschiedlich aus Sprache im Projekt Die Projekt Sprache legen Sie beim Anlegen eines Projekts fest siehe Abschnitt Leeres neues Projekt anlegen auf Seite 39 Diese Sprachein stellung wirkt sich haupts chlich auf die Rechtschreibpr fung aus Sprache eines Topics
90. ch zu machen Es gibt verschiedene M glichkeiten der Gliederung in einem Inhaltsver zeichnis Man kann sich beispielsweise an die Topic Klassen halten und diese dann wieder nach Zielgruppen oder Abl ufen unterteilen e _ Konzept Topics lernorientierte Informationen e Prozedur Topics aufgabenorientierte Informationen e _ Referenz Topics funktionsorientierte Informationen Eine andere Variante w re bereits auf oberster Ebene nach Zielgruppen zu gliedern und diesen dann die passenden Topic Klassen zuzuordnen Im Inhaltsverzeichnis einer Online Hilfe k nnen auch Strukturebenen B cher der Baumstruktur mit einem Topic verkn pft werden Dieses Topic wird angezeigt wenn der Nutzer im Inhaltsverzeichnis auf das Buch klickt Es gibt Argumente f r und gegen diese Technik Einzige Empfehlung f r diese Methode Durchg ngigkeit Wenn nur jede zweite oder dritte Struktur ebene mit einem Topic verkn pft ist muss ein Nutzer f r jedes Topic aus probieren ob er wertvolle Informationen erh lt oder verpasst F r Flare gilt in diesem Zusammenhang eine Besonderheit wenn die Strukturebenen mit Topics verkn pft sind sind die Elemente eines Orientie rungspfades sensitiv Der Leser kann sie somit zur Navigation nutzen Ideal ist die Synchonisierung der Topics mit dem Inhaltsverzeichnis und ein Orientierungspfad in den einzelnen Topics damit Nutzer die aktuelle Posi tion in der Online Hilfe immer genau kennen 111 Navigation
91. chen f r Benutzeroberfl che w hlen IV Diesen Dialog beim Start anzeigen x Bild 16 Dialog f r die Sprachauswahl 4 Markieren Sie in diesem Dialog die Sprache in der die Oberfl che von Flare angezeigt werden soll und positionieren Sie sie mit der Schaltfl che Nach oben an den Anfang der Liste Fenster Layout Sie k nnen die Flare Arbeitsumgebung an Ihre Bed rfnisse anpassen Sie k nnen beispielsweise jedes Fenster an eine beliebige Stelle ziehen oder aber einzelne Fenster ausblenden Wenn Sie sich Ihre Arbeitsumgebung eingerichtet haben k nnen Sie diese Einstellungen speichern und bei Bedarf laden Im folgenden ist exemplarisch die Anordnungsflexibilit t f r die einzelnen Fenster beschrieben Fenster frei positionieren Um ein Fenster das als Register im Arbeitsbereich angezeigt wird aus die sem zu l sen und frei zu positionieren gehen Sie folgenderma en vor 34 Flare anpassen 1 Holen Sie das Fenster z B eine Topic Datei in den Vordergrund indem Sie auf den Titel des Registers klicken 2 W hlen Sie den Befehl Fenster Frei positionieren Sie k nnen auch mit einem Rechtsklick auf den Titel des Registers das Kontextmen ffnen und dort den Befehl ausw hlen Das Fenster wird aus der Re gisterkartenordnung gel st und Sie k nnen es an jeder beliebigen Stelle am Bildschirm positionieren Der Befehl Frei positionieren wirkt wie ein Schalter mit dem Sie die Funktion ein und aus
92. ches gilt f r Informationen im oberen Bereich des Bildschirms Diese werden oft erst beim dritten oder vierten Aufruf einer Seite bemerkt Es gibt zwei unterschiedliche Meinungen dazu wieviel Information auf einer Hilfeseite untergebracht werden sollte soll man zusammengeh rige Inhalte auf mehrere Seiten verteilen Paging oder alles auf einer langen Seite unterbringen Scrolling Jacob Nielsen hat in Usability Tests festge stellt dass Nutzer nicht gerne klicken und alle Informationen auf einen Blick sehen wollen Jared Spool dagegen hat gezeigt dass Nutzer durchaus bereit sind auch eine l ngere Seite zu durchbl ttern wenn sie davon ber zeugt sind noch relevante Informationen zu finden Das Fazit zu diesen beiden Str mungen kann nur sein Informationen so kompakt zu pr sentieren dass nur wenige Klicks erforderlich sind um sie zu erfassen und beide Gestaltungsm glichkeiten sinnvoll zu verbinden Folgende Forderungen haben Usability Experten an die Seitengestaltung e Flexibles Layout das sich der Bildschirm und Browser Fensterbreite des Nutzer Systems anpasst MN Kein horizontales Bl ttern e Kurze Seiten e Wichtige Informationen sollten ohne Bl ttern above the fold sichtbar sein 73 Layout 5 2 Schrift Im Unterschied zu Papier sind am Bildschirm Serifenschriften in kleinen Schriftgraden schlechter lesbar als Serifenlose Das liegt an der Bildschirm aufl sung die durchschnittliche Aufl sun
93. chirm befinden Ob sitzend stehend oder kniend ob 10 Arten von Online Hilfen 2 2 2 2 1 2 2 2 mit guter oder weniger guter Beleuchtung oder in welchen Platzverh ltnis sen l sst sich nur schwer generalisieren Lange hat man vermutet dass Nutzer von Online Hilfen sich wahrscheinlich in einer Problem oder Stress Situation befinden Auch der Handlungsdruck und damit der Stress lie sich nur sch tzen Befragungen haben ergeben dass Nutzer eine Online Hilfe nicht nur demotiviert in einer Stress Situation zu Rate ziehen sondern auch um Wis sen zu vertiefen Weiter zeichnet sich eine typische Nutzungssituation dann auch eher durch Ruhe und Motivation aus als durch Stress und Frustra tion Online Hilfen unterst tzen die Arbeit sind aber f r die Arbeit nicht unmittelbar erforderlich Sie unterst tzen Lernprozesse sind aber keine Lernprogramme Arten von Online Hilfen Je nach Projekt und Auftrag kann ein Hilfe Autor mit unterschiedlichen W nschen f r eine Online Hilfe konfrontiert werden Der Begriff Assistenz System umfasst alle Arten von Online Hilfen die einen Nutzer beim Gebrauch einer Software Oberfl che unterst tzen sollen Im folgenden sind die einzelnen Teile eines Assistenz Systems kurz beschrieben Der Fokus dieses Buches liegt auf den Online Hilfen Die DIN EN ISO 13407 Benutzer orientierte Gestaltung interaktiver Systeme legt das Vorgehen beim Entwickeln einer Software Oberfl che fest Be
94. chriebenen grafischen Benutzeroberfl che Sie sind meistens durch eine spezielle Schaltfl che oder Symbol dargestellt Beispielsweise kann der Klick auf ein interaktives Element in einem Handlungsschritt den genannten Dialog einer Anwendung ffnen Dies erspart den Nutzern zum einen umst ndliches Navigieren in der Anwendung zum anderen erspart es dem Hilfe Autor m glicherweise Informationen die im Dialog auf einen Blick sichtbar sind Allerdings sollten interaktive Elemente nicht als Ersatz f r einen Hand lungsschritt oder eine komplette Prozedur zweckentfremdet werden Denn Leser brauchen die Information wie sie den jeweiligen Dialog in der Anwendung ffnen k nnen Interaktive Elemente sind nur mit HTMLHelp nutzbar Darstellung und Platzierung von Link Ankern In Hypertexten gibt es die unterschiedlichsten Methoden Link Anker zu platzieren und darzustellen Links k nnen direkt in den Text integriert oder von diesem getrennt sein Sind die Links direkt in den Text integriert dann spricht man von eingebet teten Links Eine Technik zur Darstellung dieser eingebetteten Links ist die Markierung des Wortes selbst der sogenannte Hotspot Die Markierung wird meist durch eine besondere Farbe und Unterstreichung des Wortes angezeigt Der Link Anker ist in diesem Falle das Wort selbst d h um zu dem Topic zu gelangen auf den der Link verweist muss ein Leser einfach das markierte Wort anklicken Auch durch ein vorangestelltes oder ang
95. cumentation were developed This allowed authors to break the Windows PC desktop barrier allowing single documentation systems to be delivered to multiple platforms such as Macintosh or Linux These new formats could also be published on Intranets Extranets or even on the World Wide Web Now we are in the latest evolutionary changes in the documentation industry With advancements such as XML newer pro gramming languages new frameworks like NET and modern and compli ant browsers it was time for a new authoring tool with a brand new architecture to not only accommodate these new technologies but to lever age their strengths The main goal of MadCap Software is to take all of the skills we developed during the first evolutionary years in this industry and combine that know ledge with the absolute latest in available technologies to bring the techni cal writing community a tool no an authoring platform that will carry them many years into the future The goal in creating MadCap Flare was to pro vide a modern purpose built single sourcing system that is standards compliant XML based Unicode and with a completely transparent archi tecture Many may still use the phrase Help Authoring Tool and while the concepts behind Flare can be traced back to those humble beginnings the Flare publishing system has been designed to be much more A system for creating software documentation policies procedures knowledge bases or any oth
96. d Verwaltung der Hilfetexte vom Program miersystem und dem Programmierer ab sie k nnen in Ressource Dateien Textdateien oder als eigenst ndiges Hilfesystem vorliegen Kontextfreie Online Hilfe Kontextfreie Online Hilfen bieten Informationen zum Produkt unabh ngig vom aktuellen Kontext in dem der Nutzer sich gerade befindet Sie sind in der Regel eine eigenst ndige Online Hilfe die in einem Hilfefenster ange zeigt wird Navigation Verzeichnisse Topic siehe Abschnitt Hilfeformate und Hilfefenster auf Seite 16 Online Hilfe die kontextfrei angeboten wird eignet sich f r berblicke Ein stiegsinformationen und bergreifende Arbeitsabl ufe Sie wird in der Regel ge ffnet ber e das Hilfe Men in der Benutzeroberfl che e das Dateisystem Zusammenfassung F r einen Hilfe Autor gibt es verschiedene M glichkeiten Online Hilfen oder weitere Teile eines Assistenz Systems zu erstellen und zu verwalten Die folgende Tabelle gibt einen berblick f r die Einzelteile eines Assis tenz Systems Die Abk rzung HAT steht f r Hilfe Autorensystem Tabelle 1 Darstellung einzelner Teile eines Assistenz Systems Inhalt Anzeige Datenformat Beschriftung der Ober grafische Oberfl che abh ngig von SW fl che ASCII XML Tooltips grafische Oberfl che abh ngig von SW ASCII XML Meldungen grafische Oberfl che abh ngig von SW ASCII XML Online Hilfe f r Assi grafische Oberfl c
97. d oder man mit der Maus dar ber streicht Dies gilt f r Absatz Tags genauso wie f r Zeichen Tags Ein Klick auf die orange Marke ffnet das Kontextmen mit den passenden Befehlen f r dieses Tag 29 Das Hilfe Autorensystem Flare Welcome htm xo Whats new htm Ce Overview a htm Y Proce sML Editor T JE ee Oo rm H op E e e El a Mec Welcome FictionSoft the best fictional software ever place your product tagline here Most online help systems have a welcome page The Welcome page can provide ove or product logos or any other information that you think will help your users Typici 1 Anoverview of what your software does 2 Features and benefits 3 Many aldo use the welcome page for company product branding 4 T is the Typical User Tips Always use style sheets to control text formatting This allows for style sheet associated with a topic go to the Tools menu and select Style Bild 14 Marke f r XML Tag im Text Cursor Formen im Text Bei der Arbeit im Topic kann der Cursor folgende Formen annehmen Markiert den Beginn eines XML Tags Markiert das Ende eines XML Tags Zeigt an dass der Cursor innerhalb eines oder zwischen zwei XML Tags steht Marken Flare steuert Topic Funktionen ber Marken Folgende Marken k nnen in einem Topic vorhanden sein i XML Tag e Stichwort Preview A Lesezeichen oder benanntes Element test Themengebiet 30 Flare Projekt auf Datei Ebene
98. das Topic das Sie formatieren wollen 2 W hlen Sie den Befehl Ansicht Symbolleisten Text Formatierung oder Ansicht Formate Das gew hlte Element ffnet sich 3 W hlen Sie im Topic den Absatz oder die Zeichen die Sie formatieren wollen F r den Absatz reicht es dass der Cursor im Absatz steht 4 W hlen Sie in der Symbolleiste oder im Formate Fenster das Format f r den Absatz oder die Zeichen Die Formatierung ndert sich ent sprechend dem ausgew hlten Format Skin Eine Skin legt die Darstellung und eventuell das Verhalten des Hilfefensters fest Je nach Hilfeformat ist die Skin mehr oder weniger ver nderbar und die Darstellung kann unterschiedlich sein Folgende Eigenschaften k nnen Sie f r jedes der drei Hilfeformate HTMLHelp WebHelp DotNetHelp fest legen Gr e und Anfangsposition des Hilfefensters Titel des Hilfefensters Symbole in der Symbolleiste Elemente der Navigation Register 89 Layout e Synchonisation mit dem Inhaltsverzeichnis in der fertigen Online Hilfe wird das aktuelle Topic im Inhaltsverzeichnis markiert e _Kommentarfunktion f r den Feedback Service Eine Skin muss den Hilfeseiten ber die Zieldefinition zugewiesen werden siehe Abschnitt Wie alles zusammenkommt die Zieldefinition auf Seite 92 Sichtbar sind die Effekte nach der Generierung im Hilfefenster siehe Abschnitt Online Hilfe generieren auf Seite 44 Sie k nnen in einem Projekt mehrere Skins verwenden
99. de von Madcap Software speziell f r Visual Studio 2005 Programmierer entwickelt und umfasst auch den Madcap Hilfe Viewer der frei weitergegeben werden kann und spezielle Steuerelemente f r Visual Studio 2005 Programmierer f r die kontextsensitive Anbindung Je nach Art der kontextsensitiven Anbindung kommen unterschiedliche APIs zum Einsatz e HelpViewerClient API e HelpViewerEmbeddedClient API e EmbeddedHelpSystem API e ICSHIDProviderAPI berblick ber die grafische Oberfl che Flare ffnet mit dem Hauptfenster das in drei Hauptbereiche aufgeteilt ist e Hierarchische Navigation links e Arbeitsbereich mitte e Dialoge f r spezielle Aufgaben rechts Das Hauptfenster von Flare Von oben nach unten betrachtet beginnt das Hauptfenster von Flare mit e Titelleiste die das aktuell ge ffnete Projekt anzeigt e Men leiste in der alle Befehle zur Bearbeitung in Men s sortiert sind e Allgemeine Symbolleiste die die wichtigsten Befehle zusammenfasst e Symbolleiste f r die Textformatierung ausschaltbar 26 berblick ber die grafische Oberfl che E Beispielprojekt flprj MadCap Flare 3 ia Titelleiste X Datei Bearbeiten Ansicht Einf gen Format Projekt Generieren Extras Tabele Fenster Hilfe M enu le l ste A a Ge Berg Bons x Zur cksetzen A R ckg ngig zur cksetzen v 25 B Symbolleisten x li D X D az G A wie D serdara Spt R L z uje x ANEJA Es e ten x A 0 Whatsn
100. der und Sym bole beispielsweise sind weiterhin nicht sichtbar Nutzer von Screen Rea dern m ssen erst einmal zuh ren bevor sie entscheiden k nnen ob die Information hilfreich ist Je erfahrener ein Nutzer ist desto eher l sst er sich nur den Anfang der Abs tze oder nur Links vorlesen Er scannt somit audi tiv Jemand der nicht sehen kann kann auch keine Maus bedienen Die Screen Reader Hersteller haben zwar L sungsans tze hierf r gefunden aber es kann durch den ge nderten Nutzungskontext zu Missverst ndnis sen kommen beispielsweise ob ein Objekt einmal oder doppelt angeklickt werden soll Auch das Layout das visuell intuitiv sein mag kann zu Ver st ndnisproblemen f hren Ver nderte Ausgabe Ein Screen Magnifier stellt einen Teil der normalen Darstellung vergr ert auf dem Bildschirm dar Das bedeutet dass der Nutzer jeweils nur einen kleinen Teil des Bildschirms sehen kann Ist er auf eine vierfache Vergr e rung angewiesen sieht er also jeweils nur 1 16 der Bildschirmanzeige Dadurch k nnen Zusammenh nge verloren gehen die f r das Verst ndnis wichtig sind Viele Nutzer sitzen trotz des Screen Magnifiers sehr nah am Bildschirm um etwas zu erkennen Dies f hrt zu einer verkrampften Haltung und erm det die Augen Auch andere Anpassungen der Darstellung durch Ver nderungen in der Systemsteuerung von Microsoft Windows z B eine neue Einstellung der Farben k nnen f r Sehbehinderte eine gro e
101. die Projektorganisation 2 ffnen Sie den Ordner Zieldefinitionen 3 Klicken Sie mit der rechten Maustaste auf die passende Zieldefinition und w hlen Sie Generieren aus dem Kontextmen Die Online Hilfe wird generiert und im angegebenen Ordner abgelegt Fehlermeldungen beim Generieren k nnen Sie in einem Protokoll spei chern Das Protokoll liegt dann in der Projektorganisation im Ordner Berichte mit Datum und Uhrzeit Das Protokoll ffnen Sie mit einem Dop pelklick Ein weiterer Doppelklick auf ein fehlerhaftes Topic im Protokoll ff net dieses zur Bearbeitung Kontextsensitive Anbindung testen Um die kontextsensitive Anbindung zu testen m ssen Sie zwei Perspekti ven beachten e Richtige Zuordnung der Identifier zu Topics e Richtige Zuordnung der Identifier zu Oberfl chenelementen Die erste Perspektive k nnen Sie mit Flare Mitteln testen die zweite muss der Systemtest oder die GUI Entwicklung bernehmen 1 Wechseln Sie in die Projektorganisation 2 ffnen Sie den Ordner Zieldefinitionen 3 Klicken Sie mit der rechten Maustaste auf die Zieldefinition und w hlen Sie CSH API Aufrufe testen aus dem Kontextmen Der Dialog Test f r kontextsensitive Hilfe CSH API ffnet sich Test f r kontextsensitive Hilfe CSH API Zieldefinition Microsoft HTML Help Generierte Datei D cognitas Checker Terme T ermControl_Flare englisch Output pe Microsoft HTML Hel Topic Identi
102. e bersetzen 172 Verkn pfung siehe Link Versionskontrolle 25 Anbindung 39 Verst ndlichkeit 148 verwandte Topics Link 136 Video 78 Viewer 185 VistaHelp 22 Volltextsuche 99 110 198 Stichw rter Vorgabeseite 81 185 bearbeiten 83 neu anlegen 82 bersetzen 172 zuweisen 83 Vorlage Flare Dateien 67 VW WSC 145 Validierungs Service 150 Wahrnehmbarkeit 146 Web 186 WebHelp Skin Sprache einstellen 172 Winhelp 16 API 16 Word Datei einlesen 42 Wort Abstand 74 Silhouette 74 WWW 186 WYSIWYG 25 X XML 25 186 Editor 25 28 Schema 25 Struktur einblenden 28 64 Tag 184 XML Tag bearbeiten 28 Cursor Formen 30 Z Zeichen Darstellung 170 Laufweite 181 Zeichenkodierung UTF 8 169 Zeichensatz Unicode 171 Zeilenabstand 74 Zielanker 105 Zieldefinition 37 92 Datei 36 neu anlegen 92 Zielgruppenanalyse 9 Zufriedenheit 2 Zuweisen Einzelnes Format 89 Stylesheet 88 Tabellenformat 67 Vorgabeseite 83 199
103. e Header Datei exportieren wollen 5 W hlen Sie aus der Liste alle Header Dateien die Sie exportieren wol len 6 Stellen Sie den Ordner ein in den die Header Dateien exportiert wer den sollen 7 Wahlen Sie Export Die ausgew hlten Header Dateien werden in den eingestellten Ordner exportiert 8 Beantworten Sie die folgende Abfrage ob der Ordner ge ffnet werden soll 163 Die kontextsensitive Anbindung Header Datei einlesen Wenn die Header Datei von der Entwicklung gepflegt wird lesen Sie sie in Ihr Flare Projekt ein 1 W hlen Sie den Befehl Projekt Erweitert Neue Header Datei Der Dialog Neue Header Datei einf gen ffnet sich W hlen Sie gegebenenfalls eine Vorlage f r die Header Datei aus W hlen Sie bei Quelle den Pfad und die Header Datei aus die Sie einlesen wollen Geben Sie der Header Datei gegebenenfalls einen neuen Dateina men Klicken Sie auf Einf gen Der Dialog schlie sich und es ffnet sich die Abfrage ob die Header Datei kopiert werden soll Best tigen Sie die Abfrage Der Dialog schlie t sich und die neue Header Datei wird in der Projektorganisation in den Ordner Erwei tert kopiert Aliasdatei anlegen Die Erstellung und Pflege der Aliasdatei ist unabh ngig davon wer die Header Datei pflegt F r die kontextsensitive Anbindung ber Steuerda teien brauchen Sie immer eine Aliasdatei die die Elemente der grafischen Oberfl che auf die entsprechenden Topics abbi
104. e Links werden nicht rein willk rlich gesetzt Referenzielle Links sind oft Links bei denen ein Begriff als Ausgangsanker dient Meist verweist solch ein Link dann auf ein Topic das mehr Informa tionen zu dem Begriff enth lt Eine spezielle Form assoziativer Verkn pfun gen sind Notizen Annotation die nicht als selbstst ndige in sich abgeschlossene Einheiten konzipiert sind Sie ergeben nur im Zusammen hang mit der auf sie verweisenden Einheit einen Sinn Notizen werden nicht in separaten Hypertext Topics abgelegt sondern tempor r in einem sepa raten Fenster neben oder ber dem aktuellen Text eingeblendet 108 Links 6 4 2 Typisierte Links Typisierte Links sind Verkn pfungen die die Art der Beziehung zwischen zwei Topics angeben Sie dienen der Strukturierung von Hypertexten und werden auch als strukturierende organisatorische oder organisationelle Links bezeichnet Conklin versteht unter organisationellen Links solche die eine hierarchische Struktur im Sinne von Is a Relationen aufbauen Hypertexte sind nicht v llig strukturlos Sie verf gen oft neben den assozia tiven Verkn pfungen auch ber typisierte Links die dem Text sein dem Inhalt angemessenes Ger st verleihen Je nach Anwendungsbereich wer den spezielle Linktypen zur Verf gung gestellt um den Nutzern die Text struktur zu verdeutlichen Interaktive Elemente Interaktive Elemente Shortcut sind direkte Verkn pfungen mit der bes
105. e wie Bit maps f r Piktogramme und Symbole oder GIF JPEG Bilder Verlustfreie und verlustbehaftete Kompressionsverfahren wie beispielsweise JPEG ver ringern die Dateigr e und beschleunigen damit die Anzeige am Bild schirm Dieselbe beschleunigende Wirkung haben sogenannte interlaced GIF Bilder die zeilenweise aufgebaut werden 79 Layout 5 6 Fazit f r Online Hilfen Eine Online Hilfe kommt mit einem recht einfachen Layout aus Das quasi standardisierte Hilfefenster legt schon wichtige Bereiche fest um die sich ein Hilfe Autor nicht mehr intensiv k mmern muss die Navigation im linken Bereich des Hilfefensters und die Symbolleiste Was hier angezeigt wird l sst sich im Hilfefenster einstellen F r Navigation und Symbolleiste kann der Hilfe Autor bestimmen was und wie etwas angezeigt wird beispielsweise ein zweistufiger Index in der Navi gation oder ein Symbol zum Drucken des angezeigten Textes in der Sym bolleiste Das bedeutet dass die Gestaltung einer Online Hilfe sich auf die Textgestaltung und die Textmenge konzentriert Schrift und Textstruktur Als Schrift empfiehlt sich eine serifenlose vorzugsweise f r den Bildschirm entwickelte Schrift wie Verdana Diese Schrift sollte auch auf den meisten Rechnern vorhanden sein denn Browser k nnen lediglich die Schriftarten anzeigen die auf dem jeweiligen Rechner des Nutzers installiert sind Wenn die Schriftart einer Seite auf dem System des Nutzers nicht vorhan
106. e zum einen w hrend des Schreibens im Topic auch das Fachwortverzeichnis erg nzen zum anderen zeichnen Sie mit dieser Funktion die Fachw rter im Text aus 1 Wechseln Sie in den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic das einen Glossarbegriff Link erhalten soll 3 Markieren Sie im Topic das Fachwort 131 Navigation 4 W hlen Sie den Befehl Einf gen Glossarbegriff Link Wenn Sie das Fachwort im Fachwortverzeichnis e schon angelegt haben wird es entsprechend der Eigenschaft For matklasse im Topic ausgezeichnet e noch nicht angelegt haben ffnet sich der Dialog Glossarbegriff anlegen Bei Begriff ist das markierte Fachwort schon eingetra gen Geben Sie bei Definition die Erkl rung f r das Fachwort ein W hlen Sie bei Glossardatei w hlen das Fachwortverzeichnis in das das neue Fachwort aufgenommen werden soll 7 Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und der Glossarbegriff Link wird in das Fachwortverzeich nis und das Topic bernommen Die Formatklasse f r das Fachwort k nnen Sie im Fachwortverzeichnis einstellen siehe Abschnitt Fach wortverzeichnis bearbeiten auf Seite 123 8 Speichern Sie das Topic mit dem Befehl Datei Speichern 6 6 6 Link B ndel Siehe auch Verweise Link B ndel Siehe auch Verweise pr sentieren im Topic eine Link Sammlung zu verwandten Themen Dargestellt wird ein Link B ndel als
107. eaae ere Ea ere er 152 7 3 3 Tabellen 2 24 eke 22 ee wen nel weh wlan 153 COALINKS ae ee en RAs eS ORE a 153 7 4 Umsetzung mit Flore 154 8 Die kontextsensitive Anbindung 159 8 1 Rei verschlussprinziP 160 8 1 1 Gemeinsame Aufgaben 161 8 1 2 Aufgaben Hilfe Autor 2 2 2 2 un nn nn 161 8 1 3 Aufgaben GUI Entwickler 00 4 162 82 Umsetzung mit Flare ss sessa rero esaera ik 162 xii Inhalt 9 Mehrsprachigkeit a noaoo 169 91 Unicode asos awi ee 169 9 2 Umsetzung mit Flare ua we ware nee 171 9 2 1 Komponenten f r die Ubersetzung 171 9 2 2 Spracheinstellungen im Flare Projekt 172 9 2 3 Schritte f r die Erstellung eines Zielsprachenprojekts 173 F chw rter r ana aa arm an Ee a a a a ee Se 175 Literatur o 24 220 200 EE antenne 187 Stichw rter 22m nn nn 191 xiii 1 1 1 Begriffskl rungen Intuitiv bedienbar soll ein Produkt sein besonders wenn es sich um Soft ware handelt Dass dem nicht so ist erleben Nutzer und Technikredakteure immer wieder Die intuitive Bedienbarkeit liegt zumindest nicht bei komple xen Produkten noch in weiter Ferne Wenn ein Produkt nicht intuitiv bedienbar ist brauchen seine Nutzer eine Bedienungsanleitung Wenn es sich bei dem Produkt um Software handelt sollen Online Hilfen die Nutzer zum Ziel f hren Software kann dabei sowohl ein Internet Shop sein als auch die Steue
108. efehl Datei Speichern Wiederholen Sie diese Schritte f r alle Topics eines Themengebiets Stichwort Link Ein Stichwort Link b ndelt mehrere Topics anhand eines gemeinsamen Stichworts Sie k nnen beliebig viele Stichw rter in einem Projekt erstellen Alle Topics mit derselben Stichwortmarke werden bei der Generierung zu einem Link B ndel zusammengefasst Wenn Sie das Stichwort aus einem Topic l schen oder in weitere Topics einf gen aktualisiert Flare automa tisch das Link B ndel 135 Navigation F r einen Stichwort Link m ssen Sie zuerst in jedem Topic das gleiche Stichwort einf gen das zu dem Link B ndel geh ren soll siehe Abschnitt Einzelnes Stichwort anlegen auf Seite 119 Danach f gen Sie einen Siehe auch Verweis auf das Link B ndel in jedes Topic des B ndels ein Link B ndel einf gen 1 ffnen Sie mit einem Doppelklick das Topic das Sie einem Stichwort Link zuordnen wollen 2 Platzieren Sie den Cursor an die passende Stelle im Topic z B in der letzten Zeile 3 W hlen Sie den Befehl Einf gen Hilfe Steuerelement Stichwort Link Der Dialog Stichwort Link Steuerelement einf gen ffnet sich 4 W hlen Sie aus der Liste Alle Stichw rter das passende Stichwort aus 5 Klicken Sie auf lt lt um das Stichwort in die Liste Ausgew hlte Stich w rter zu bernehmen 6 Klicken Sie auf OK um Ihre Auswahl zu best tigen Der Dialog schlie t sich und im Topic wird an der Cursor
109. eh ngtes Symbol das auf den Link Anker hinweist l sst sich ein eingebetteter Link darstellen Sensitive und interaktive Elemente arbeiten mit dieser Technik In manchen Hypertexten sind die Hotspots nicht markiert es ndert sich lediglich die Form des Cursors wenn er ber sie hinwegf hrt Vorteil dieser 109 Navigation 6 5 nicht sichtbaren Link Anker soll sein dass der Lesefluss durch die Hervor hebungen nicht unn tig beeinflusst wird Wenn ein Topic viele Links unter schiedlicher Art enth lt kann sich die permanente Markierung eingebetteter Anzeigen sehr st rend auf den Leseprozess auswirken Ein eklatanter Nachteil dieser Darstellung ist aber dass viele Leser diese Links nicht erkennen und ihnen somit auch nicht folgen k nnen Die h chste Aufmerksamkeit erh lt ein Link mitten im Text Sofern es nicht zu viele gibt und die Farbe entsprechend gew hlt ist sichert das h chste Aufmerksamkeit Eine geschickte Platzierung der Links nimmt den Leser quasi an die Hand und f hrt ihn durch den Hypertext Trotzdem bleibt die Freiheit der Entscheidung gewahrt Aber es kann auch passieren dass sich wilde Bl tterer gerade durch diese Aufmerksamkeit vom gesuchten Inhalt weg navigieren In einigen Hypertexten findet sich eine strikte Trennung zwischen dem Textteil und den Links Die Links k nnen dabei entweder st ndig aktiv sicht bar sein oder m ssen explizit vom Nutzer z B ber eine Schaltfl che auf gerufe
110. eiten Lesepfade voreingestellt _ Bearbeiten Ausgabedatei voreingestellt X Ausgabeordner voreingestellt i Ve Source Control IT Vor Erstellung der Zieldefinition automatisch die neueste Version aller Dateien einholen DE d Bild 29 Neue Zieldefinition f r Browser basierte Hilfe In der Zieldefinition steuern Sie ber die Angaben in den unterschiedlichen Register wie Ihre Ausgabe generiert werden soll und eventuell was danach mit ihr passieren soll Tabelle 10 Register der Zieldefinition Register Bedeutung Ausgabe Basis Allgemeine Einstellungen f r alle Ausga Alle beformate wie Ausgabetyp oder Name der Ausgabedatei Bedingter Text Steuert Uber Bedingungen die Sie ein Alle und ausschalten k nnen welche Topics in die Ausgabe aufgenommen werden Variablen Steuert die Variablenbelegung f r die Aus Alle gabe 93 Layout Tabelle 10 Register der Zieldefinition Register Bedeutung Ausgabe Kopiere Legt Kopierziele fest zu denen die gene Alle rierte Ausgabe automatisch kopiert wer den soll z B einen File Server Glossar Steuert welche Glossare in der Ausgabe Alle verwendet werden Erweitert Steuert das Layout der Ausgabe Alle Druckversion Steuert spezielle Optionen f r die Druck Druckver version z B wie Popups und eingescho sion bener Text behandelt werden sollen Leistung Steuert fur WebHelp und DotNetHelp wie We
111. en ausreichend robust sein damit sie mit heutigen und zuk nf tigen Techniken funktionieren Dieses Prinzip ist eher technischer Natur und spricht den Einsatz verf gba rer und zug nglicher Standards an Die Verwendung von X HTML zur Strukturierung von Informationen und Cascading Stylesheets CSS f r Layout und Formatierung ist ein Aspekt aber auch weitere Techniken wie Multimedia sollen entsprechend den Standards eingesetzt werden damit jegliche Zugangssoftware sich auch danach richten kann 148 Gesetzlicher Rahmen Die Einhaltung von Standards stellt auf Dauer die Anwendbarkeit in einem komplexen System her e Sicherstellung von Kompatibilit t e Sicherheit f r die Entwicklung neuer Agenten und Werkzeuge e Sicherheit der Nutzbarkeit f r die Nutzer e Maschinelle Vor Verarbeitung der Inhalte und angepasste Darstellun gen Rendering Wenn Standards nicht korrekt angewendet werden entstehen Anwen dungsinseln die nur unter besonderen Voraussetzungen nutzbar sind Dies gilt z B wenn eine korrekte Darstellung nur mit bestimmten Browsern und deren propriet ren Funktionen mit bestimmten Programmzus tzen Plug ins mit einer bestimmten Bildschirmaufl sung usw erreicht werden kann Wenn Auszeichnungen Tags falsch verwendet werden interpretieren Agenten den Inhalt m glicherweise inkorrekt Ein besonderes Problem sind Formatanweisungen zur Repr sentation einer Struktur oder Strukturanwei sungen f r ein be
112. en besser transportieren wie z B die Farbe Rot als Unterst t zung Signalfarbe f r Warnhinweise Farben k nnen auch als Stilmittel f r Vordergrund und Hintergrundbeziehung f r Auszeichnungen oder in Sym bolen verwendet werden Insgesamt gibt es acht Grundfarben die zwei unbunten Grundfarben Wei und Schwarz und die sechs bunten Grundfarben Rot Gelb Gr n Cyan Blau und Magenta Die Bildschirmdarstellung arbeitet mit dem additiven Farbsystem dem RGB Modell benannt nach den ersten Buchstaben der Prim rfarben Rot Gr n und Blau Zusammen bilden sie Wei Wenn sich zwei Prim rfarben berlappen entsteht eine dritte Farbe die sog Sekun d rfarbe aus Rot und Gr n entsteht Gelb aus Rot und Blau entsteht Magenta Purpur und aus Blau und Gr n entsteht Cyan Cyanblau Farben setzen sich am Bildschirm anders zusammen als die Pigmentfar ben auf Papier Hier gilt das CMYK Modell die Pigmentfarben des Vierfarb drucks Cyanblau Magentarot Yellow und K Kontrast Schwarz reflektieren auf wei em Hintergrund das Restlicht im Zusammendruck ergeben sie Schwarz Die Bildschirmdarstellung gleicht in keinem Fall dem Druckergebnis Ausdrucke auf Papier sind generell nur in CMYK m glich Bei der Farbwahl f r eine Online Hilfe sollten die Besonderheiten des Bild schirms ber cksichtigt werden Der Bildschirm ist eine aktive Lichtquelle so dass es zu berstrahlung kommen kann L ngeres Lesen erm det das Auge und ist unangeneh
113. enntnisse und ber einen vergleichbaren Bildungsstand verf gen Zumindest Einsteiger und Profis sollte man als Autor unterscheiden Begriffskl rungen Lange hat man angenommen dass Nutzer auf Hilfen haupts chlich dann zugreifen wenn sie ein konkretes Problem mit einem Produkt l sen wollen Christian Bartsch stellte in einer Befragung deutscher und italienischer Nut zer fest dass diese Annahme zwar f r den Gro teil der Nutzer gilt Ein Drit tel seiner befragten Nutzer konsultieren eine Online Hilfe aber auch um bereits vorhandenes Wissen ber das Produkt zu erweitern und zu vertie fen Diese Nutzer sehen Hilfen nicht als letzten Rettungsanker wenn alle anderen Mittel wie Kollegen und anderweitige Recherche versagen Gerade diese Experten nutzen Online Hilfen h ufiger und erfolgreicher als Einsteiger Das bedeutet f r Hilfe Autoren dass der Nutzungskontext nicht nur von Zeitdruck gepr gt sein muss der Stress erzeugt sondern auch von Neu gier und Interesse gesteuert sein kann Die Effektivit t beschreibt die Genauigkeit und Vollst ndigkeit mit der Nut zer ein bestimmtes Ziel erreichen Eine Online Hilfe ist effektiv wenn ein Nutzer sein Ziel erreicht Das Ziel eines Nutzers ist im einfachsten Fall lediglich das Finden einer Information kann aber auch die L sung eines ganz konkreten Problems sein Je genauer und vollst ndiger das Ergebnis desto besser ist auch die Effektivit t Der daf r ben tigte Aufwand geht i
114. ensweisen e F r die Informationen in Online Hilfe und Buch werden unterschiedli che Quellen und Werkzeuge genutzt die f r das jeweilige Medium optimiert sind es Alle Informationen werden in einer Quelle Topic orientiert erfasst Erst danach wird entschieden welche Informationen in die Online Hilfe kommen und welche ins Buch Diese Vorgehensweise ist flexibler und als Single Sourcing bekannt Beide Vorgehensweisen laufen fr her oder sp ter auf eine Entscheidung hinaus welche Informationen den Lesern im Buch angeboten werden und welche in einer Online Hilfe Informationen f r die Online Hilfe Konkret geh ren folgende Informationen in eine Online Hilfe e Zuordnung zum jeweiligen Produkt Identifikation damit der Nutzer wei dass er mit der richtigen Online Hilfe arbeitet vorzugsweise in der Titelzeile der Online Hilfe e Sicherheitshinweise wenn vom Produkt Gefahr f r Leib und Leben ausgehen kann oder wenn Datenverlust droht soweit sie die Informa tionen in der Online Hilfe betreffen Entweder in einem eigenen Kapitel oder dort wo der Gefahrenfall eintreten kann e Eine Einf hrung als Orientierung f r die Nutzer mit folgenden Informa tionen e Sinn und Zweck der Online Hilfe und ihrer Teile e BestimmungsgemaBe Verwendung des Produkts e Zielgruppe n der Online Hilfe oder ihrer Teile B cher e Verwendete Darstellungsmittel in der Online Hilfe z B f r Aufmer ker usw e Zweck des Produkts e Ku
115. enzen damit aufrufen So lassen sich verschiedenste Medientypen in eine Online Hilfe integrieren Man spricht dann auch von Hypermedia Die einzelnen Informationseinheiten in einem Hypertext werden auch als Knoten bezeichnet Ahnlich wie ein Buch sich aus Kapiteln und Abschnitten aufbaut ist ein Hypertext aus Knoten aufgebaut die ber elektronische Verweise die Links miteinander verbunden sind In einer Online Hilfe ver steht man unter einem Knoten ein Topic Beide Begriffe werden in diesem Zusammenhang synonym verwendet Im Deutschen gibt es noch den Begriff Thema Hypertexte k nnen sehr komplex werden wie das Web deutlich zeigt Man kann hier die verschiedensten Dokumente untereinander verkn pfen Der Nutzer kann sich dadurch nach seinen individuellen Bed rfnissen Informa tionen suchen und Wissen dort vertiefen wo es f r sein Verst ndnis not wendig ist und der eigenen Interessenslage entspricht Dies entspricht einem konstruktivistischen Ansatz nach dem sich jeder Mensch seine eigene Welt konstruiert indem er Wahrgenommenes auf dem Hintergrund bestehender Wissenskonstrukte interpretiert und formt Ein kritischer Punkt bei Hypertexten sind Koh renz und Koh sion die sich durch die zu geringe oder zu tiefe Aufteilung eines Themas in Informations einheiten ergibt Oft sind Inhalte so stark aufgesplittert dass Nutzer schon dadurch beansprucht werden den Zusammenhang zwischen diesen Bruchst cken wieder herzustellen Sie k nnen s
116. er Datei ist eine reine Textdatei die jedem Element einer Oberfla che einen Identifier und eine Kontextnummer zuweist Der Identifier ist auch unter dem Namen Map ld bekannt Die meisten Programmier Umge bungen erzeugen die Header Datei auf Knopfdruck aber auch Flare kann eine Header Datei erzeugen Die Header Datei muss zwischen Hilfe Autor und GUI Entwicklung abgestimmt werden und aktuell sein Die Header Datei hat folgenden Aufbau define lt identifier gt lt kontextnummer gt Trennzeichen zwischen den drei Komponenten ist ein Leerzeichen der Identifier oder die Kontextnummer d rfen kein Leerzeichen haben Beide d rfen jeweils nur einmal vorkommen in einem Hilfeprojekt und m ssen damit eindeutig sein Beispiele define willkommen 1 define neues projekt dialog 2 define neueDateiDialog 3 Gerade bei umfangreichen Hilfeprojekten empfiehlt sich eine Namenskon vention fur Identifier So erschlieBt sich auch bei mehreren Autoren auf den ersten Blick auf welches Element der Identifier verweisen soll Der Hilfe Compiler unterscheidet bei Identifiern nicht zwischen Gro und Kleinbuch staben Leerzeichen d rfen enthalten sein sollten aber nicht zu Beginn oder am Ende stehen Die meisten Sonderzeichen sind erlaubt In einem Flare Projekt liegt die Header Datei in der Projektorganisation im Ordner Erweitert 160 Rei verschlussprinzip Aliasdatei Die Aliasdatei ist der eigentliche Rei verschluss der Top
117. er Symbole vor den Eintr gen im Inhaltsverzeichnis markieren einen fehlenden Link f r den entsprechenden Eintrag Flare bietet f r das Bearbeiten des Inhaltsverzeichnisses zwei Darstellun gen an die hierarchische und die tabellarische Darstellung Zwischen bei den Darstellungen schalten Sie mit der ersten Schaltfl che der lokalen Symbolleiste hin und her Die hierarchische Darstellung eignet sich besser f r das Erstellen des Inhaltsverzeichnisses die tabellarische Darstellung eher f r das Uberarbei ten einzelner Einstellungen wie beispielsweise Bedingungen Um ein Inhaltsverzeichnis zu bearbeiten gehen Sie folgenderma en vor 1 ffnen Sie mit einem Doppelklick das Inhaltsverzeichnis zum Bearbei ten 2 Erstellen Sie gegebenenfalls mit Symbolen der lokalen Symbolleiste neue B cher 3 Verschieben Sie im Inhaltsverzeichnis gegebenenfalls die B cher mit der Maus an eine neue Position 118 Umsetzung mit Flare 6 6 2 Wechseln Sie gegebenenfalls in den Topic Explorer Ziehen Sie mit der Maus Topics aus dem Topic Explorer an die pas sende Stelle im Inhaltsverzeichnis 6 Speichern Sie Ihr Inhaltsverzeichnis mit dem Befehl Datei Speichern Orientierungspfad Den Orientierungspfad erzeugt der breadcrumbs Proxy den Sie auf der Vorgabeseite einstellen siehe Abschnitt Vorgabeseite bearbeiten auf Seite 83 Der breadcrumbs Proxy arbeitet mit den Topic Titeln siehe Abschnitt Topic Eigenschaften auf
118. er complex documentation which you may need to create and publish This book will help you in exploring and learning the capabilities of the Mad Cap Flare publishing system and MadCap Software would like to thank the author for doing such a commendable job in teaching and explaining its many capabilities San Diego January 2008 Mike Hamilton Vice President MadCap Software vi Vorwort Stellen Sie sich vor Sie befinden sich in einer fremden Stadt und haben einen Termin den Sie gerne einhalten wollen Wie werden Sie Ihren Zielort erreichen Wenn Sie ein Navigationsger t mit dem neuesten Kartenmate rial besitzen stehen die Chancen gut dass Sie p nktlich ankommen Oder Sie kaufen sich einen Stadtplan und finden mit dessen Hilfe zu Ihrem Ziel ort Vielleicht nehmen Sie auch ein Taxi und lassen sich bis zu Ihrem Zielort fahren oder Sie verlassen sich auf Ihren guten Orientierungssinn Ihr Orien tierungssinn kann dabei durch die Bauweise der Stadt mehr oder weniger unterst tzt werden denn in einer schachbrettartig angeordneten Stadt wer den Sie sich wahrscheinlich schneller zurecht finden als in einer chaotisch gewachsenen Vielleicht fragen Sie ja auch in Ihrem Hotel nach dem Weg Man nennt Ihnen dort Orientierungsmarken f r ihren Weg die entweder hilfreich sein k nnen oder Sie zus tzliche Zeit kosten Wenn Sie nicht gerade mit dem Taxi fahren oder ein Navigationsger t benutzen ist es ziemlich wahrschein lich das
119. erden Merkmale festlegen Eine Zielgruppe hat selten einen homogenen Wissens und Erfahrungshin tergrund In der Regel setzt sie sich aus mehreren Gruppen wie Einstei gern erfahrenen Nutzern und Experten mit ganz unterschiedlichem Vorwissen und Anspr chen zusammen Die DIN VDE 1000 Anforderungen an im Bereich der Elektrotechnik t tige Personen nennt diese Gruppen auch Laien unterwiesene Personen und Fachleute Das vermutete Vorwissen kann sich auf mehreren Ebenen unterscheiden beispielsweise hinsichtlich des Produkts der Branche der speziellen Fach kenntnisse usw Diese Unterschiede gilt es zu ermitteln und zu gruppieren z B in einem oder mehreren Rastern in dem dann auch das zumutbare Fachvokabular oder das Handlungs und Lernverhalten eingetragen wer den kann Vom Input zum Output Informationsbedarf ermitteln Der Informationsbedarf der einzelnen Gruppen entscheidet wesentlich dar ber welche Informationen wie pr sentiert werden Es stellen sich Fragen ob Leser e sich informieren wollen e nachschlagen wollen e Wissen ber das Produkt aufbauen oder vertiefen wollen e Sich anweisen lassen wollen Ein Experte braucht beispielsweise keine spezielle Lernumgebung oder berblicksinformationen wie ein Einsteiger Seine Ankn pfungspunkte sind vielf ltig und sein Wissenzuwachs ist durch sein Vorwissen unaufwendiger und tiefer Lesertypen zuordnen Es lassen sich mehrere Lesertypen mit eigene
120. ere Infor mationen als ein erfahrener Nutzer e Das Problem das ein Nutzer l sen will ist oftmals eine Aufgabe oder ein konkretes Ziel Von daher erwartet er in der Online Hilfe auch eine handlungsorientierte Pr sentation mit aufgabenbezogenen Anleitun gen Handlungsanleitungen Schritt f r Schritt Anleitung Damit ein Hilfe Autor diese Erwartungen erf llen kann muss er seine Leser m glichst genau kennen Dies erreicht er durch eine Zielgruppen und eine Nutzungsanalyse Erwartungen der Leser Zielgruppenanalyse Unterschiedliche Zielgruppen erfordern unterschiedliche Informationstiefen und jeweils eine spezifische Sprache Was f r das Verst ndnis der einen Zielgruppe f rderlich ist kann die andere Zielgruppe hindern oder sogar ver rgern So haben Untersuchungen gezeigt dass Einsteiger mehr Infor mationen und eine einfachere Sprache brauchen als Experten Experten wiederum profitieren ebenso wie Einsteiger von einem gut gegliederten und strukturierten Text Es gibt unterschiedliche Methoden f r eine Zielgruppenanalyse beispiels weise e Vorwissen aus betroffenen Abteilungen wie Marketing Kundenbetreu ung oder Vertrieb zusammentragen e Zielgruppenanalyse eines hnlichen Produkts oder des Vorg ngerpro dukts auswerten e Interview e Fragebogen e Benuitzertest e Kombination mehrerer Methoden Unterschiedlich sind auch die Informationen die bei einer Zielgruppenana lyse als relevant betrachtet w
121. erhalb des Buches durch visuelle Hin weise Zu einer zus tzlichen Verwirrung im Hypertext kann es durch die vielf lti gen Vernetzungen kommen wenn z B ein und dieselbe Seite ber ver schiedene Pfade im System erreicht werden kann der Inhalt der Seite aber nicht an diese Tatsache angepasst ist Die einzelnen Seiten m ssen in einem sinnvollen Kontext zueinander stehen Anmerkungen wie siehe oben oder vergleiche vorherige Seite beziehen sich z B auf eine kon krete vorangegangene Seite Dies f hrt beim Nutzer zur Verwirrung er hat das Gef hl etwas berlesen zu haben 98 Informationen finden 6 2 Informationen finden Browsen und Navigieren sind die wichtigsten Aktivit ten in Hypertexten Der Begriff Browsen bedeutet soviel wie schm kern sich unverbindlich umsehen Browsen geht immer mehr in Navigieren ber je mehr die Leser sich im Informationsraum auskennen also eine Vorstellung dar ber entwi ckelt haben wie die einzelnen Topics zueinander in Beziehung stehen Oft wird die Navigation in Hypertexten mit der Navigation in nat rlichen Umge bungen verglichen Auf die Informationen eines Hypertextes k nnen Leser auf drei Arten zugreifen e durch Links e durch Volltextsuche e ber die Navigation im Browser Inhalts und Stichwortverzeichnis Links sind neben den traditionellen Suchmechanismen Eingabe von Such begriffen und deren logischer Verkn pfung eine zus tzliche M glichkeit In
122. es Dependent Disturb d File name NewT opic Style 1st Heading d Leave blank to use file name Stylesheet Styles d Cancel A Bild 24 Eigene Vorlagen f r Topics 69 5 Layout Das Lesen am Bildschirm ist m hsamer als das Lesen von Papier Ver schiedene Studien bis in die 1990er Jahre belegen dass bei identischem Inhalt Papierleser schneller lesen l nger durchhalten und auch mehr vom Gelesenen behalten als Bildschirmleser Zumindest die Lesegeschwindig keit h ngt auch vom Bildschirm ab der oftmals eine schlechtere Aufl sung hat als Papier Neuere Studien zeigen dass sich die Lesegeschwindigkeit beim Lesen von flimmerfreien und hochaufl senden Bildschirmen sich immer mehr der Lesegeschwindigkeit von Papier angleicht Das Layout einer Online Hilfe soll die Verst ndlichkeit eines Textes und damit die Lesbarkeit und die Leserlichkeit unterst tzen Die Leserlichkeit eines Textes bestimmt wie schnell er gelesen werden kann wohingegen die Lesbarkeit eines Textes beschreibt wie einfach sich ein Text lesen ver stehen und nachvollziehen l sst Die Leserlichkeit bezieht sich damit auf die Gestaltung von Buchstaben Zeilen und Fl chen eines Textes die Les barkeit auf die Wortwahl und Sprache Das Layout soll die Darbietung der Inhalte an die menschliche Aufnahmef higkeit unterst tzen Don t make me think Lesen Gut lesbare Texte unterst tzen den Lesevorgang das Medium Papier oder
123. esheet bei Dateiname gegebenenfalls einen ande ren Namen Klicken Sie auf Einf gen um das Stylesheet zu importieren Der Dia log schlie t sich und es ffnet sich die Abfrage ob das gew hlte Sty lesheet ins Projekt kopiert werden soll Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare kopiert das Stylesheet im Topic Explorer in den Ordner Resources Stylesheets und ffnet es zum Bearbeiten Neues Stylesheet anlegen Um ein neues Stylesheet anzulegen gehen Sie folgenderma en vor 1 W hlen Sie den Befehl Projekt Neues Stylesheet Der Dialog Neues Stylesheet einf gen ffnet sich ndern Sie gegebenenfalls die Vorlage f r das Stylesheet Geben Sie dem Stylesheet bei Dateiname einen Namen Klicken Sie auf Einf gen um das neue Stylesheet anzulegen Der Dialog schlie t sich und es ffnet sich die Abfrage ob das Stylesheet mit der ausgew hlten Vorlage erstellt werden soll Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt das neue Stylesheet im Topic Explorer im Ordner Resources Stylesheets an und ffnet es zum Bearbeiten im Arbeits bereich 85 Layout Styles css x Startseite itylesheet Editor EB vereinfachte Ansicht Formate importieren Neue Klasse Umbenennen Neues Medium r Lieerbte Arsen EDESA EN Absatzformate ER Datentr ger voreing x METE Formate Eigenschaften address blockquote center dir STEE 3
124. ew htm SZ vy wa x Ges Projektorganisat style sheet associated with Po nn atopic go to the Tools menu Topic Explorer and select Stylesheet Links H O Inhaltsverzeichnisse H O Variablen Editor cj T ID D Es 06 Suchen Welcome FictionSoft the best fictional software ever place your product tagline here Most online help systems have a welcome page The Welcome page can provide overview information links company or product logos or any other information that you thinkwill help your users Typical information indudes lokale Symbolleisten al 1 Anoverview of what your software does 2 Features and benefits 3 Many also use the welcome Optionen pagefor company product Suchen in aktuetles Dokument branding 4 Whois the Typical User Dateitypen Tips Always use style sheetsto control text gt formatting This allows for easy updates To control the T In Quelldatei finden Navigation Arbeitsbereich Dialoge f r die Bearbeitung 3 1 2 Bild 12 Das Hauptfenster von Flare Editoren Alle Dateien eines Flare Projekts k nnen mit entsprechenden Editoren bearbeitet werden beispielsweise Stylesheets mit dem Stylesheet Editor Jede Datei ffnet sich nach einem Doppelklick und bleibt so lange ge ffnet bis sie explizit geschlossen wird Ge nderte Dateien werden im Titel des Registers mit einem Sternchen neben ihrem Dateinamen gekennzeichnet Vor dem
125. f r Anwendungen und Assistenz Systeme Bildschirmabzug Screenshot Snapshot Capture Abbildung des gesamten Bildschirms eines Fensters oder eines Teils davon Bl ttern Scrollen Angezeigten Bereich eines Fensters mit Bildlaufleisten vertikal oder horizontal bewegen Buch Kapitel Zusammengeh rende Themen Topics in einer Hilfe Die Gruppe wird visuell meist als Buch dargestellt CMS Content Management System Programm mit dem Inhalte von Text und Multimedia Dokumenten Content in einer Quelle erstellt und organisiert werden kann Der Fokus liegt dabei auf einer medienneu tralen Datenhaltung CMS sind meist XML basiert sie sollen ohne Pro grammier oder XML Kenntnisse genutzt werden k nnen Dialog Dialogfeld Dialogbox Dialogfenster Oberfl chen Element f r die Interaktion mit einer Anwendung Der Dia log wird mit Schaltfl chen z B OK oder Abbrechen geschlossen Vergleiche auch Fenster Dialoghilfe kontextsensitive Hilfe Kontextsensitive Hilfe auf Dialogebene Eine Erkl rung wird passend zum Dialog angezeigt in dem die Online Hilfe aktiviert wurde 177 Fachw rter Direkthilfe F1 Hilfe Kontextsensitive Hilfe auf Elementebene Eine Erkl rung wird passend zum Element angezeigt zu dem die Online Hilfe aktiviert wurde Eingebettete Hilfe Hilfe die Teil der Benutzeroberfl che einer Anwendung ist Einblendbare Informationen Oberbegriff f r Informationen wie Texte Tabellen Gra
126. f r die Topic Dateien son dern auch f r die Steuerdateien eines Hilfeprojekts Alle Dateien eines Hil feprojekts verwenden die UTF 8 Kodierung F r die bersetzung eines Flare Projekts k nnen Sie z B Lingo einsetzen ein Translation Memory System von Madcap Software speziell f r Flare Projekte Mit Lingo k nnen Sie ein Flare Projekt in der Ausgangssprache laden dort alle erforderlichen Texte bersetzen und ein Flare Projekt in der Zielspra che exportieren Zus tzlich bietet Lingo ber das Austauschformat TMX einen Anschluss an andere Translation Memory Systeme wie z B Across oder Trados Wenn Sie Lingo nicht nutzen gliedert sich die bersetzung und Generie rung eines Flare Projekts in der Zielsprache in mehrere Schritte Zum einen m ssen Sie entscheiden ob Sie mehrere Sprachen in einem Flare Projekt verwalten wollen oder jede Sprache in einem eigenen Flare Projekt Beide Vorgehensweisen sind m glich und haben Vor und Nachteile F r ein Flare Projekt spricht dass Sie alle Informationen zu einem Produkt in einer Quelle halten Dagegen spricht die wachsende Un bersichtlichkeit je komplexer das Produkt angelegt ist und je mehr Sprachen im Spiel sind F r mehrere Sprachprojekte spricht eine gr ere bersichtlichkeit und eine klare Sprachzuordnung dagegen ein gr erer Verwaltungsaufwand Wenn die Verwaltung der Sprachen entschieden ist geht es darum die Kandidaten f r die bersetzung herauszufinden Potentielle U
127. f die Version 2 0 aktuali siert die zur Zeit noch als Entwurf vorliegt Noch bis Februar 2008 k nnen Korrekturen eingereicht werden Die Accessibility Guideline ist in vier Prin zipien untergliedert e Wahrnehmbarkeit e Bedienbarkeit 145 Barrierefreiheit e Verst ndlichkeit e Robustheit der Technik Wahrnehmbarkeit Nutzer brauchen die Inhalte und alle Funktionen in einer f r sie wahrnehm baren Form Insbesondere die haupts chliche Textorientierung und geeig nete Kontraste und Farben sind zu beachten Die Bedingungen dieses Prinzips beg nstigen Menschen mit e _Sehbehinderungen e Kognitiven Behinderungen e Sprachst rungen Text und Hypertext sind heute die einzigen Darstellungsformen f r Informa tion die auf allen in der Computerwelt vorhandenen Ausgabemedien wie dergegeben werden k nnen Text kann automatisch ausgewertet werden und in vielerlei Formen pr sentiert werden Textumwandlung in akustische Ausgaben ist Standard und Text bersetzung in andere Sprachen begrenzt m glich Die Verkn pfung von Text mit Symbolen Bildern oder Animatio nen basierend auf der Textinterpretation ist prinzipiell m glich Eine auto matische Interpretation von grafischen Informationen ist demgegen ber viel komplizierter Fazit mit Text und aus Text l sst sich Vieles machen Texte lassen sich auf kleinen Bildschirmen mit begrenzter Aufl sung dar stellen wohingegen Bilder oft nicht mehr darstellbar sind Die Verwendung
128. fier Settings st Dialogs Edit_Settings htm v estellt E Overview Welcome htm voreingestellt sl Dialogs Database htm voreingestellt sl Dialogs corrinfo htm voreingestellt sl 167 Die kontextsensitive Anbindung In der Liste stehen alle Identifier der Header Dateien und die Identifier Zuordnung die Flare in der Aliasdatei gefunden hat W hlen Sie gegebenenfalls eine Skin f r den Test Klicken Sie auf Test f r jeden Identifier Das verkn pfte Topic ffnet sich Wenn sich das richtige Topic ffnet funktioniert alles wie gew nscht das falsche Topic ffnet korrigieren Sie die Zuordnung in der Alias datei e kein Topic ffnet fehlt die Zuordnung 168 9 1 Mehrsprachigkeit Gerade in Zeiten der Globalisierung ist Mehrsprachigkeit auch f r Online Hilfen ein wichtiges und spannendes Thema Mit dem N herr cken des osteurop ischen und asiatischen Marktes m ssen sich Hilfe Autoren auch mit ungewohnten Sprachen und Zeichens tzen auseinandersetzen Unicode Unicode ist ein internationaler Standard der langfristig alle weltweit bekannten Textzeichen Buchstaben Ziffern Satzzeichen Silbenzeichen Sonderzeichen sowie Ideogramme in einem einzigen alphanumerischen Zeichensatz zusammenfassen soll Unicode wurde von der International Standardisation Organisation ISO und dem Unicode Konsortium entwi ckelt Mit Unicode k nnen Sie mehrere Sprachen im selben Text gleichzei
129. fiken usw die Nutzer durch Klicken auf ein sensitives Element sichtbar machen k n nen Es gibt verschiedene Darstellungsarten Eingeschobener Text Ausklappbarer Text Popup Eingeschobener Text expanded text Text in einer Online Hilfe der nur angezeigt wird wenn Nutzer auf ein sensitives Element klicken Dadurch erst wird der eingeschobene Text sichtbar Der Text wird direkt nach dem sensitiven Element in der Zeile eingeblendet Der nachfolgende Text in der Zeile verschiebt sich ent sprechend Dies eignet sich beispielsweise f r Erkl rungen zu Abk r zungen oder Fachw rtern Vergleiche auch Ausklappbarer Text Popup Favorit Benutzerspezifischer Einsprungspunkt in einer Hilfe Fenster Hauptfenster Unterfenster Dialog Oberfl chen Element das eine Men leiste eine Symbolleiste Naviga tions und Arbeitsbereich haben kann Wird geschlossen mit Befehl oder Schaltfl che Handlungsanleitung Handlungsfolge Arbeitsschritt Arbeitsanleitung Arbeitsanweisung Schritt f r Schritt Anleitung um eine gestellte Aufgabe zu l sen ein gestelltes Ziel zu erreichen Eine Handlungsanleitung ist eine eigene Textsorte die speziell ausgezeichnet sein sollte 1 2 Eine Hand lungsanleitung enth lt neben den einzelnen Handlungsschritten das Ziel die Voraussetzungen und das Feedback der Anwendung 178 Fachw rter Hervorgehobene Stelle highligthed markiert Textbereich der mit einer anderen Schrift oder Farbe
130. formationen zu finden Oft wissen Leser gar nicht wonach sie genau suchen und k nnen ihre Suchanfrage folglich auch nicht exakt formulieren In diesen F llen bieten Links eine flexible M glichkeit der Informationssu che die Nutzer m ssen die Suche nicht im Vorhinein planen sondern k n nen frei durch den Informationsraum browsen Dies kommt Nutzern mit schwebender Aufmerksamkeit entgegen Neben diesem Hypertext spezifischen Zugriffsmechanismus der Links ist die Volltextsuche eine der wichtigsten Zugriffsstrategien in einen Hypertext Wenn das Suchziel exakt formuliert werden kann und die Einordnung der gesuchten Information in ihren Kontext nicht erforderlich ist dann hat die ser Mechanismus einen eindeutigen zeitlichen Vorteil Die dritte Art des Informationszugriffs in Hypertexten geschieht ber die Navigation im Hilfefenster Browser Ein Topic wird im Browser z B im Inhalts oder Stichwortverzeichnis direkt angeklickt und am Bildschirm angezeigt In einer Online Hilfe l sst sich zudem unterscheiden wie sie aufgerufen wird Kontextsensitiv Dem Nutzer wird die passende Information zur aktuellen Situation im Pro dukt angezeigt der Nutzer muss die Information nicht erst suchen Der Kontext kann sich auf drei verschiedene Ebenen beziehen e Dialogebene Information zum aktuellen Dialog zum Fenster oder zum Register Aufruf z B ber die Hilfe Schaltfl che einen Hilfe Link oder die F1 Taste 99 Navigation
131. g a sound file D Previewing a sound file c Working with images D Adding still images DN Editing an image D Importing an image D Previewing an image EI working with text D Adding scroning credits Fa DN Adding sequential credits DN Adding subtiles D Editing text D Importing text DN Previewing text EI working with video O Adding a video clip D Editing a video clip DN Importing a video mp DN Adding a voice track f S Previewing a sound file To Preview a Video Clip Preview File 1 On the Tools menu click Preview File 2 Select the file you wish to preview 3 Click OK Previewing a video clip Previewing an image Previewing text Previewing your movie Bild 10 Beispiel fur JavaHelp Vista Help VistaHelp vormaliger Codename Longhorn Help ist das neue Hilfeformat das Microsoft seit einigen Jahren ankUndigt und dessen Freigabe sich ein ums andere Mal verschiebt Urspr nglich war dieses Hilfeformat mit der Freigabe des neuen Betriebssystems Windows Vista geplant Mittlerweile ist die erste Version des Betriebssystems Windows Vista auf dem Markt und offiziellen Verlautbarungen von Microsoft ist zu entnehmen dass es auch zur Version 2 von Windows Vista nichts mit dem neuen Hilfe format werden wird Microsoft will das neue Hilfeformat erst noch fur die eigenen Anwendungen nutzen und testen Hilfe Autoren werden auf die HTMLHelp verwiesen die noch lange Standard f r
132. g im Inhaltsverzeichnis Durch diese Art der Umsetzung muss keine zus tzliche Bibliothek mit der Online Hilfe ausgeliefert werden WebHelp Register in der Navigation der Online Hilfe DotNetHelp Register in der Navigation der Online Hilfe Sie k nnen beliebig viele Fachwortverzeichnisse in einem Flare Projekt anlegen und f r unterschiedliche Ausgaben verwenden Welche Fachwort verzeichnisse Flare f r eine Ausgabe verwendet legen Sie in der Zieldefini tion fest siehe Abschnitt Fachwortverzeichnis zuweisen auf Seite 124 Fachwortverzeichnis anlegen 1 W hlen Sie den Befehl Projekt Neues Glossar Der Dialog Glossar einf gen ffnet sich 2 W hlen Sie gegebenenfalls eine andere Vorlage f r das Fachwortver zeichnis Geben Sie der Datei einen Namen 4 Klicken Sie auf Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob das Fachwortverzeichnis mit der ausgew hlten Vor lage erstellt werden soll 5 Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt das neue Fachwortverzeichnis im Ordner Glossare in der Pro jektorganisation an und ffnet es zum Bearbeiten Die Datei hat die Endung flglo 122 Umsetzung mit Flare LR Neues Glossar x C Neue Skin i MyHtmlHelp Glossar bearbeiten X 2a x Begriffe Definition Link Klasse Mein Begriff Meine Definition Bild 37 Neues Fachwortverzeichnis Fachwortverzeichnis bearbeiten Die F
133. g von 72 dpi besitzt eine Pixel gr e von etwa 0 35 mm was ann hernd dem typografischen Punkt entspricht Grunds tzlich gilt deshalb je kleiner die Bildschirmschrift und je feiner die Linien desto schlechter ihre Darstellung am Bildschirm Serifen betonte Schriften mit breitlaufendem Charakter sind gut lesbar wie beispielsweise Courier Aber auch aus ergonomischen Gr nden sollte Text am Bildschirm grunds tzlich in einem gr eren Schriftgrad gesetzt sein als auf Papier Der Leseabstand ist gr er Die Laufweite Buchstabenabstand mancher Schriften ist zu eng f r die Bildschirmdarstellung Es scheint als ob die Buchstaben sich ber hren oder ineinander laufen und aus r und n wird beispielsweise ein m Das erschwert das Lesen erheblich Abhilfe schafft das Spationieren leichtes Sperren des gesamten Textes Bei hellem Text auf farbigem oder schwar zem Hintergrund ist diese Korrektur unbedingt notwendig da die Uber strahlung am Bildschirm die Buchstabenabst nde optisch verringert Es gibt Schriften die speziell f r das Lesen vom Bildschirm entwickelt wur den wie z B Tahoma Geneva Verdana oder Chicago Ihr Schriftbild ist an den 72 dpi Bildschirm angepasst Die Lesbarkeit der Schrift h ngt auch ab von der Schriftgr e die mit dem Seitenlayout und der vermuteten Bild schirmgr e und aufl sung abgestimmt sein muss Angemessene Wortabst nde definieren klare Wortsilhouetten Zu geringe Abst nde hi
134. gabe e sechsmal erfolgreicher als Nutzer die einen Screen Reader benutzten e viermal erfolgreicher als Nutzer die einen Screen Magnifier benutzten Layout Wenn Farbe oder Zeichenformate nicht nur zur Hervorhebung sondern als Unterscheidungsmerkmal eingesetzt werden k nnen dies Blinde und viele Sehbehinderte nicht erkennen Gerade auch Farbenblinde oder Rot gr n Sehbehinderte haben an dieser Stelle die meisten Probleme Dies l sst sich vermeiden wenn zus tzlich zur Farbe oder zum Zeichenformat wei tere Unterscheidungsmerkmale z B Sonderzeichen eingesetzt werden Um auch den besonderen Bed rfnissen Sehbehinderter entgegenzukom men sollte man bei der Gestaltung darauf achten dass e Sich die Farben von Text und Hintergrund deutlich von einander abhe ben Farben einzelner Zeichen oder Elemente kontrastreich sind e Schriftgr en relativ definiert sind 150 Fazit f r Online Hilfe Rote Schrift auf gr nem Hintergrund ist schwieriger zu erkennen als gelb auf blau oder schwarz auf wei Bei der Gestaltung von Schaltfl chen oder Symbolen ist dies besonders wichtig denn diese sind im Browser nicht manipulierbar Dagegen kann der Browser bei Texten die Farbeinstellung ignorieren Zur Sehbehinderten gerechten Gestaltung geh rt auch die relative Gr Benangabe f r Frames Tabellen und Text Diese relativen Angaben ber cksichtigen geringe Bildschirmaufl sungen Im Browser festgelegte benutzerdefinierte Schr
135. gaben m ssen deshalb immer relativ zum Ausgangs Topic sein Folgende Informationen brauchen Sie bevor Sie einen externen Sprung anlegen Name der externen Hilfe Name des Topics in der externen Hilfe Falls die Online Hilfe in einem anderen Ordner liegen wird Pfad zur externen Hilfe Um einen Sprung auf ein Topic in einer externen Online Hilfe anzulegen gehen Sie folgenderma en vor 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic das einen Link erhalten soll Markieren Sie im Topic den Text f r den Ausgangsanker Hotspot 127 Navigation 4 W hlen Sie den Befehl Einf gen Hyperlink Der Dialog Hyperlink einf gen ffnet sich W hlen Sie bei Link zu die Option Externes Topic Geben Sie dann rechts bei nach externem Topic suchen direkt das Ziel Topic in folgender Syntax ein Wenn die externe HTMLHelp im gleichen Ordner liegen wird lt externeHilfe gt chm lt topic gt htm Wenn die externe HTMLHelp in einem anderen Ordner liegen wird mk MSITStore lt pfadZuExternerHilfe gt lt externeHilfe gt chm lt topic gt htm Wenn die externe Online Hilfe eine WebHelp Plus oder DotNetHelp ist geben Sie f r jeden bergeordneten Ordner ein z B lt pfadZuExternerHilfe gt lt nameExternerHilfe gt Content lt pfadZuTopic gt lt topic gt htm 7 Legen Sie gegebenenfalls mit den weiteren Feldern im Dialog das Ver halten des Links weite
136. genschaften von Topics Der Topic Eigenschaft Topic Titel kommt eine besondere Bedeutung zu Sie entspricht nicht der Uberschrift eines Topics sondern ist ein eigenes Element das f r unterschiedliche Zwecke genutzt wird e Topic Name im Inhaltsverzeichnis siehe Abschnitt Inhaltsverzeichnis auf Seite 117 e Topic Name im Orientierungspfad breadcrumbs Proxy siehe Abschnitt Vorgabeseite bearbeiten auf Seite 83 es Topic Name im Men bei mehreren Treffern im Stichwortverzeichnis siehe Abschnitt Stichwortverzeichnis auf Seite 119 62 Umsetzung mit Flare 4 5 4 es Topic Name im Men eines Siehe auch Verweises siehe Abschnitt Link B ndel Siehe auch Verweise auf Seite 132 e Topic Name im Men bei mehreren Treffern in der Volltextsuche Flare erstellt Topic Titel nur f r die Topics automatisch die durch Import im Projekt angelegt werden Der Topic Titel wird dann aus der berschrift des Topics gebildet F r neue Topics die Sie anlegen erstellt Flare keinen Topic Titel Deswegen sollten Sie es sich angew hnen beim Anlegen eines neuen Topics auch den Topic Titel mit zu pflegen Auch wenn Topic Titel und die berschrift eines Topics verschiedene Elemente sind sollten sie textlich bereinstimmen um dem Leser Orientierung zu bieten Topic bearbeiten Sie k nnen ein Topic im XML Editor wie gewohnt bearbeiten indem Sie den Cursor im Text positionieren und schreiben Den
137. gsankern Wenn dieser nur aus einem Wort besteht muss oft der umgebende Kontext gelesen werden was das schnelle Scannen verhindert Zus tzlich in ihrer Motorik eingeschr nkte Nutzer k nnen auch Schwierigkeiten damit haben den Ausgangsanker anzusteuern Spr nge und Popups sollten unterschiedlich gekennzeichnet sein damit der Leser wei was nach dem Klick passiert Damit l sst sich der Sorge der Nutzer vorbeugen sich im Hypertext zu verirren und die einmal gefun denen Information nicht wiederzufinden Der Defacto Standard im Web gibt vor dass Hyperlinks traditionell blau sind gesichtete Links purpur Wenn das Layout der Online Hilfe von die sem Standard abweicht sollten gesichtete Hyperlinks deutlich anders dar gestellt sein als ungesichtete sonst fehlt den Lesern eine wichtige Orientierungshilfe 116 Umsetzung mit Flare 6 6 6 6 1 Umsetzung mit Flare Mit Flare k nnen Sie alle genannten Orientierungshilfen und Link Arten ein setzen Inhaltsverzeichnis Das Inhaltsverzeichnis legt eine logische und hierarchische Struktur ber die Topics einer Online Hilfe Alle Topics eines Flare Projekts werden in eine Online Hilfe generiert Wenn Sie Topics nicht in einer Online Hilfe haben wollen m ssen Sie sie durch Bedingungen von der Generierung ausschlie en Wenn Sie eine Druckausgabe generieren werden nur die Topics in die Druckausgabe generiert die Sie im Inhaltsverzeichnis angeben Sie k nnen beliebig v
138. gsmethode Funktionsdesign 51 Information Mapping 50 Informationsdesign 52 Stylesheet 83 bearbeiten 87 Datei 36 Editor 86 importieren 84 neu anlegen 85 neues Medium anlegen 155 Stimme einstellen 155 zuweisen 88 Suchstrategien 72 Symbol 184 197 Stichw rter Symbolleiste 26 lokale 27 T Tabelle bearbeiten 65 einf gen 65 Format 66 Format zuweisen 67 Struktur einblenden 65 Tag 184 Target siehe Zieldefinition Tastaturbelegung 173 Template siehe Vorlage Test Kontextsensitivit t 167 Text Auszeichnung 74 Bildbezug 77 Menge 184 Popup 129 Sorte 184 Verst ndlichkeit 75 Thema siehe Topic Themengebiet anlegen 134 Titelzeile 26 TOC siehe Inhaltsverzeichnis Tooltip 11 185 Topic 185 anlegen 60 Eigenschaft 61 Identifier zuweisen 165 importieren 61 Klasse 54 Konzept 55 Marken 30 Orientierungspfad 119 Popup 130 Prozedur 55 Referenz 55 Skin fur Kontextsensitivitat zurordnen 166 Sprache 172 Titel 62 bersetzen 171 XML Struktur einblenden 28 64 Topic Explorer 31 Translation Memory 25 Lingo 171 Tutorial 5 Typisierter Link 109 U bersetzungsmanagement 25 berstrahlung 185 UCS 2 169 Unicode 169 185 Windows 170 Zeichendarstellung 170 Zeichensatz 171 Unterl nge 185 URL 161 Usability 1 176 Usability siehe auch Benutzbarkeit Usability Test 185 Usefulness siehe N tzlichkeit User assistance 4 UTF 16 169 UTF 8 169 Utility siehe Funktionalit t Vv Validierungs Service 150 Variabl
139. h dem Element pause before Pause vor dem Element speech rate Sprechgeschwindigkeit W hlen Sie bei den pause Eigenschaften den Wert nicht zu hoch da der Sprachfluss sonst unn tig gest rt wird Pausen bieten sich auch bei Auf z hlungen Abs tzen oder berschriften an Beispiel berschriften H1 H2 usw pause before 1500ms pause after 1000ms Normaler Text P UL OL usw pause before 500ms pause after 500ms Auszeichnung pause 500ms speak spell out 156 Umsetzung mit Flare Besondere Spracheinstellung Bei einigen Elementen wie beispielsweise Tabellen bietet es sich an den normalen Textfluss etwas abzu ndern damit der Zuh rer dem Kontext leichter folgen kann Dazu gibt es speziell f r Tabellen eine Eigenschaft die es erlaubt das Lesen von Tabellen zu kontrollieren Die speak header Eigenschaft die Sie ebenfalls in der Gruppe Nicht eingeordnet finden Die speak header Eigenschaft legt fest wann und wie oft Spalten ber schriften gelesen werden Die Werte once einmalig und always jedes Mal beschreiben dabei ob die berschrift vor jeder Zelle jedes Mal oder nur vor jeder Spalte einmalig vorgelesen werden sollen Je nach Gr e und Umfang der Tabelle ist die eine oder andere Variante zu empfehlen Beispiel Lebensmittel Preis Menge Brot 2 50 EUR 1 Milch 1 40 EUR 3 Wenn Sie f r die Tabelle die Eigenschaft speak header auf always setzen w rde diese Tabe
140. he abh ngig von SW stent oder Hilfefenster oder HAT kontextsensitive Hilfe Hilfefenster abh ngig vom HAT kontextfreie Hilfe Hilfenster abh ngig vom HAT 15 Vom Input zum Output 2 3 2 3 1 Ein Hilfe Autor arbeitet auf drei Ebenen die sich wechselseitig beeinflus sen 1 Ebene das zu beschreibende Produkt mit seiner grafischen Oberfl che 2 Ebene das Quellformat der Online Hilfe im HAT 3 Ebene das Hilfeformat im Hilfefenster Hilfeformate und Hilfefenster Die Online Hilfe wurde mit dem zweiten Quasistandard f r grafische Ober fl chen eingef hrt Microsoft Windows Seit Windows 3 0 liefert Microsoft mit seinem Betriebssystem einen Hilfe Viewer mit hier Hilfefenster genannt Den entsprechenden Hilfe Compiler und ein Werkzeug zum Erstellen von Online Hilfen den HelpWorkshop kann man sich seit dieser Zeit bei Microsoft herunterladen Mit den wechselnden Versionen von Windows haben sich auch die Hilfefor mate gewandelt und auch andere Hersteller haben Hilfeformate entwickelt Winhelp Winhelp war das erste propriet re Hilfeformat von Microsoft Es ist eine komprimierte hlp Datei die auf 16 Bit Windows Systemen ablauff hig ist Winhelp wird von allen Windows Systemen bis zur Version 2000 XP unter st tzt Auf Windows Vista ist Winhelp nur noch ber ein Zusatzprogramm ablauff hig das sich Nutzer der Winhelp bei Microsoft herunterladen m s sen Winhelp ist ein ausgereiftes Hilfeformat das Mic
141. hkeit verbessert die allgemeine Benutzbarkeit So wird durch eine dem Inhalt angemessene einfache Sprache die Verst ndlichkeit der Dokumente gef rdert Dokumente die klar gegliedert sind unterst tzen das Verst ndnis Grafiken Bilder oder Tondokumente k nnen den Inhalt f r viele besser erfassbar machen Abk rzungen und englische Ausdr cke sind in der heutigen Sprache weit verbreitet Eine Erkl rung an Ort und Stelle hilft den Nutzern Damit k nnen auch Menschen mit unterschiedlichen Bildungsniveaus oder Deutsch als Zweitsprache bei externer Ablenkung oder Erm dung usw Dokumente leichter erfassen Das aktive Bem hen um Verst ndlichkeit ist besonders wichtig f r Men schen mit Geb rdensprache als Muttersprache Einfache Sprache mediale Elemente Symbole Bilder usw helfen Menschen mit Lernschwierigkeiten oder Lernbehinderungen mit geistigen Behinderungen oder Menschen mit starken Leseschwierigkeiten die Inhalte zu erfassen Auch Menschen die Sprachausgabe nutzen k nnen den Inhalt leichter erfassen wenn sie keine Bandwurms tze verfolgen m ssen Um das Verst ndnis zu f rdern sollte man auch die unterschiedlichen Lernmethoden und Erfahrungen der Nutzer beachten Eine einfache plasti sche Sprache naheliegende Metaphern die Hervorhebung von Unter schieden und Ahnlichkeiten der Konzepte und die Erkl rung ungew hnlicher Begriffe k nnen dazu beitragen die Verst ndlichkeit zu erh hen Robustheit Inhalte m ss
142. ht sehen e schlecht oder gar nicht h ren e in der Bewegung also bei der Bedienung der Maus eingeschr nkt sind Dazu kommen weitere Barrieren die auf kognitiven Einschr nkungen wie z B Konzentrationsschw che beruhen Aber es sind nicht nur Menschen mit Behinderungen die vor Barrieren stehen sondern es kann jeder der keinen Standard Computer mit Standard Eingabe und Ausgabeger ten einsetzt auf Barrieren sto en Assistive Technologie Wer schlecht oder gar nicht sieht hat bei elektronischen Medien sicherlich mit den h chsten Barrieren zu k mpfen Das liegt daran dass sie spezielle technische Hilfen auch assistive Technologien genannt benutzen m ssen Alternative Ausgabe Blinde und viele Sehbehinderte ben tigen eine Software die die Signale f r den Bildschirm abf ngt und neu interpretiert Eine Variante ist die Spezial oder Br ckensoftware die als Screen Reader bezeichnet wird Ein Screen Reader bersetzt den Bildschirminhalt entweder in synthetische Sprache z B ber eine Soundkarte oder in Blindenschrift ber die Braille Zeile Dies ist ein spezielles Ausgabeger t das Teile des Bildschirminhal 143 Barrierefreiheit tes in Blindenschrift auf einem taktilen Display wiedergibt und meist mit einer Tastatur als Ein und Ausgabeger t kombiniert ist Ein Audio Browser gibt Inhalt und Formatierung einer Seite rein akustisch aus Beide Hilfsmittel sind mit Einschr nkungen verbunden Bil
143. ich nicht ausschlie lich auf 49 Topics 4 2 4 2 1 das Lesen des eigentlichen Inhaltes beschr nken da dieser durch viele Links un bersichtlich wird Um den Inhalt eines Abschnitts zu lesen muss ein Nutzer vielleicht erst alle diese Links anklicken und sich so die Informationen St ck f r St ck zusam mensuchen Er ist mehr mit dem Navigieren durch das System als mit dem eigentlichen Lesen und Lernen besch ftigt Andererseits kann der Nutzer bei zu gro en Informationseinheiten schnell vergessen dass er sich berhaupt in einem Hypertext befindet und wird so mit der Zeit weniger aktiv beim Durchlesen der einzelnen Seiten die jeweils viel Zeit in Anspruch nehmen Strukturierungsmethoden Wie also lassen sich Informationen sinnvoll aufteilen oder strukturieren Im Umfeld der Technischen Kommunikation sind drei Strukturierungsmetho den bekannt die Informationen nach unterschiedlichen Gesichtspunkten einteilen und strukturieren e Information Mapping e Funktionsdesign e Informationsdesign Information Mapping Information Mapping wurde von dem Psychologen Robert E Horn entwi ckelt Ausgangspunkt f r Horn waren Erkenntnisse Uber die Funktions weise und die Informationsverarbeitung im menschlichen Gehirn Ziel sind lesergerecht strukturierte Texte die den selektiven Zugang zu Informatio nen f rdern Dazu formulierte Horn sieben grundlegende Prinzipien e Gliederung in berschaubare Einheiten
144. ich zu machen Gerade mit sensitiven Elementen wie ausklappbarem Text l sst sich Infor mation schichten Das hat den Vorteil dass die Nutzer den umgebenden Kontext nicht verlassen und sich Detailinformationen auf Knopfdruck anfor dern k nnen Eine Online Hilfe kann folgenden Arten von Links enthalten Tabelle 12 Link Arten Link Art Bedeutung Sprung Innerhalb des Hauptfensters Inhalt wird ver schoben oder ausgetauscht Zu einem Sekund rfenster der Kontext bleibt erhalten z B f r Beispiele oder Prozeduren M glich sind interne Spr nge innerhalb der Online Hilfe oder externe Spr nge au erhalb der Online Hilfe Topic Popup Normales Topic das in einem Sekund rfenster angezeigt wird z B f r zus tzliche Erkl run gen oder Beispiele 114 Fazit f r Online Hilfen Tabelle 12 Link Arten Link Art Bedeutung Text Popup Text der in einem speziellen Textfenster ange zeigt wird hnlich den Tooltips z B f r Fach w rter oder Abk rzungen Link B ndel Sinnvolle Links zu verwandten Themen z B Siehe auch Verweise Eingeschobener Text Text wird nach der sensitiven Stelle Hotspot eingeblendet z B f r kurze Erkl rungen oder Abk rzungen Ausklappbarer Text Text wird unterhalb der sensitiven Stelle einge blendet z B f r weiterf hrende oder vertie fende Informationen Image Map Grafik mit sensitiven Bereichen z B zur Orien tierung in
145. icht nur das lateinische Zeichensystem sondern stellt Zeichen mit 16 Bit dar so dass sich 65 536 Zeichen codieren lassen Zeichen die in unterschiedlichen Sprachen vorkommen sind in Unicode nur einmal vorhanden was insbesondere im chinesisch japanisch koreanischen Sprachraum zu einer starken Reduzierung der ben tigten Codes f hrt Unterl nge Ausdehnung der Buchstaben g q p y oder j die die Schriftlinie nach unten unterschreiten Usability Test berpr ft die Gebrauchstauglichkeit einer Software oder Hardware mit den potentiellen Benutzern Viewer System kurz Viewer Betrachter Betrachter Software oder Anzeigesystem z B HTMLHelp Viewer oder Hilfe Viewer Vorgabeseite Master page Seitenvorlage f r eine Ausgabedatei die zum Generierungszeitpunkt ausgef hrt wird 185 Fachw rter Web WWW Grafisch dargestellter Teil des Internets Wortkombinationen Web Far ben Web Schriften Web Anwendungen XML eXtensive Markup Language Auszeichnungssprache zur Darstellung hierarchisch strukturierter Daten in Form von Textdateien XML wird bevorzugt fur den Austausch von Daten zwischen unterschiedlichen IT Systemen eingesetzt speziell ber das Internet 186 Literatur Adkisson Heidi 2002 Identifying De Facto Standards for E Commerce Web Sites A thesis submitted in partial fulfillment of the requirements for the degree of Master of Science University of Washington Bartsch Christian 2001 D
146. ics und Identifier aufeinander abbildet In der Aliasdatei k nnen die kontextsensitiven Topics auch mit einer Skin verkn pft werden die beispielsweise die Navigation ausblendet In einem Flare Projekt liegt die Aliasdatei in der Projektorganisation im Ordner Erweitert und hat die Endung flali URL Die URL legt die Position eines Topics in der Online Hilfe eindeutig fest Die URL besteht f r ein Topic eines Flare Projekts aus dem Pfad und dem Topic Namen im folgenden Format lt hilfename gt Contents lt pfadZuTopic gt lt topicname gt htm Abh ngig von der gew hlten Anbindung reichen oft auch der Name der Online Hilfe und der Topic Name Gemeinsame Aufgaben Die kontextsensitive Anbindung kann nur in enger Zusammenarbeit zwi schen Hilfe Autor und GUI Entwicklung funktionieren In einer oder mehre ren Abstimmrunden gilt es folgendes zu kl ren e Art der kontextsensitiven Anbindung Elementebene Dialogebene Meldungen e Elemente die angebunden werden bersicht mit Namen und Aufruf in Tabelle oder Liste e Hilfeformat e Art des Aufrufs Steuerdateien JavaScript oder URL e Art der Hilfe eigene Hilfe f r kontextsensitive Informationen oder alles in einer Hilfe e Erforderliche Informationen und deren Austausch Header Datei Iden tifier Kontextnummern Topic Namen und Pfade usw Aufgaben Hilfe Autor Abh ngig von den Absprachen k nnen auf einen Hilfe Autor folgende Auf gaben zukommen e Alle G
147. ie Verstandlichkeit von Software Hilfesyste men L beck Schmidt R mhild Ballstaedt Steffen 1997 Wissensvermittlung Die Gestaltung von Lern material Weinheim Beltz Psychologische Verlags Union Closs Sissi 2007 Single Source Publishing Topicorientierte Strukturie rung und DITA entwickler press Conklin J 1987 A Survey of Hypertext MCC Technical Report No STP 356 Rev Dezember 1987 Edelmann Anja 2003 Hypertextbasierte Softwaredokumentation Eine experimentelle Untersuchung zur Rezeption L beck Schmidt R mhild Dentz Dorothea 2001 Informationsdesign f r technische Dokumentation in einem Dokumentenmanagementsystem In J Hennig und M Tjarks Sobhani Hrsg Informations und Wissensmanagement f r technische Dokumentation L beck Schmidt R mhild Dyson Mary C 2005 How do We Read Text on Screen in Creation Use and Deployment of Digital Information Edited by H van Oostendorp L Breure and A Dillon New Jersey Erlbaum Gr nwied Gertrud 2005 Software Dokumentation Grundlagen Praxis L sungen Renningen expert verlag Horn R E 2001 Knowledge Mapping for Complex Social Messes http www stanford edu rhorn Klante Palle 2007 Barrierefreie Informationsangebote Accessability In J Hennig und M Tjarks Sobhani Hrsg Usability und technische Dokumentation L beck Schmidt R mhild Knopp Sandra 2000 Aufbau Gestaltung und Struktur von Online Hilfe s
148. ie den Befehl W h len aus dem Kontextmen Die Marke ist ausgew hlt und ihr Inhalt wird im Stichwort Editor angezeigt Sie k nnen die Marke jetzt l schen oder aber ihren Inhalt bearbeiten 120 Umsetzung mit Flare Stichwortverzeichnis bearbeiten Schon aus Konsistenzgr nden bietet Flare den Index Explorer an der alle Stichw rter im Projekt anzeigt Um den Index Explorer zu ffnen w hlen Sie den Befehl Ansicht Index Explorer Index Explorer 7 Contacting Information htm Topics Contacting Information htm E Company E Concepts Contact 7 Contacting Information htm Topics Contacting Information htm Address Contacting Information htm Topics Contacting Information htm lt a gt lt a gt E Email E Phone amp Drop down text E Email E Fax E Ei History E Mission E Phone oi Preview ai Structure E Using this sample El What s New as Fj Bild 36 Index Explorer Der Index Explorer zeigt alle Stufen und Eintr ge des zuk nftigen Stich wortverzeichnisses an Unter jedem Eintrag finden Sie die Topics in denen das Stichwort enthalten ist Das jeweilige Topic ffnen Sie mit einem Dop pelklick Die Stichwortmarken bearbeiten Sie wie gewohnt siehe Abschnitt Stichwort bearbeiten auf Seite 120 121 Navigation 6 6 3 Fachwortverzeichnis Fachwortverzeichnisse werden in der generierten Online Hilfe abh ngig vom Hilfeformat dargestellt HTMLHelp Eintra
149. ie f r die Darstellung der Eigenschaften die gruppierte Anzeige aus Stimmen Um die Lesestimme festzulegen stehen in der Gruppe Nicht eingeordnet mehrere Eigenschaften zur Verf gung Hierzu z hlen pitch Stimmenlage pitch range Stimmbereich richness Helligkeit speech rate Sprechgeschwindigkeit stress Betonung voice family Klang Um nun beispielsweise den Text f r den Zuh rer akustisch etwas anzurei chern k nnen Sie mit diesen Eigenschaften zwei unterschiedliche Stimm lagen anlegen Ein Beispiel berschriften H1 H2 usw voice family female richness 35 pitch medium speech rate medium 155 Barrierefreiheit Normaler Text P UL OL usw voice family male richness 75 pitch low speech rate slow Auszeichnung Zeichenformat stress 75 speak spell out Es empfiehlt sich manchmal nur bestimmte Worte oder Wortgruppen mit eigenen Sprachdefinitionen zu versehen Hier wird durch die speak Eigen schaft beschrieben dass bei Elementen der Klasse Auszeichnung alle Buchstaben einzeln ausgesprochen werden sollen Damit wird der so defi nierte Text deutlich artikuliert wodurch sich eine Abk rzung oder ein Fach wort vom normalen Text abheben Pausen Neben verschiedenen Stimmen bieten sich auch Pausen oder verschie dene Geschwindigkeiten zur Gestaltung von gesprochenen Texten an Dazu finden Sie in der Gruppe Nicht eingeordnet folgende Eigenschaften pause Pausendefinition pause after Pause nac
150. iele Inhaltsverzeichnisse in einem Flare Projekt anle gen und dar ber unterschiedliche Ausgaben steuern Welches Inhaltsver zeichnis Flare f r eine Ausgabe verwendet legen Sie in der Zieldefinition fest siehe Abschnitt Zieldefinition bearbeiten auf Seite 94 Neues Inhaltsverzeichnis anlegen 1 W hlen Sie den Befehl Projekt Neues Inhaltsverzeichnis Der Dialog Neues Inhaltsverzeichnis einf gen ffnet sich 2 W hlen Sie gegebenenfalls eine andere Vorlage f r das Inhaltsver zeichnis 3 Geben Sie der Datei einen Namen Klicken Sie auf Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob das Inhaltsverzeichnis mit der ausgew hlten Vorlage erstellt werden soll 5 Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt das neue Inhaltsverzeichnis im Ordner Inhaltsverzeichnisse in der Projektorganisation an und ffnet es zum Bearbeiten Die Datei hat die Endung fltoc 117 Navigation o TOColh x gt Primary TOC wiper ee e nn j Inhaltsverzeichnis bearbeiten Strukturansicht fs oe 9 el w SI Neuer Eintrag 1 Neuer Eintrag 2 eues Buch 2 Neuer Eintrag 3 Neuer Eintrag 4 LA aka Z Bild 34 Neues Inhaltverzeichnis in der hierarchischen Darstellung Inhaltsverzeichnis bearbeiten Flare legt ein neues Inhaltsverzeichnis schon mit zwei Buchsymbolen und darunter mit zwei Topic Symbolen an um eine m gliche Struktur zu ver deutlichen Die K f
151. ierungshilfen R ckw rtsgerichtete Orientierungshilfen sollen diejenigen Orientierungs probleme vermindern die durch die Frage aufgeworfen werden Wie kam ich hier her Wie komme ich zur ck an einen bestimmten schon besuch ten Punkt Rechner intern werden solche Hilfen durch die Aufzeichnung einer Navigationsgeschichte dialog history realisiert R ckw rts Bl ttern R ckw rts Bl ttern Backtracking ist eine der wichtigsten und von fast allen Hypertext Systemen unterst tzte Navigationshilfe Durch r ckw rts Bl ttern k nnen Nutzer ihren Weg durch das Hypertext Netz Schritt f r Schritt zur ckverfolgen indem sie auf die Zur ck Schaltfl che des Brow sers klicken Die Topics werden damit eins nach dem anderen in umge kehrter Lesereihenfolge angesteuert Bei Orientierungsproblemen k nnen die Leser ihren Weg zur ckverfolgen bis sie auf ein vertrautes Topic sto Ben oder wieder am Anfang ankommen R ckw rts Bl ttern sollte zum einen immer m glich und zum anderen immer auf die gleiche Weise aufruf bar sein Die Aufzeichnung des zur ckgelegten Pfades sollte immer bis an dessen Anfang reichen R ckw rts bl ttern kann aber f r unge bte Hypertext Nutzer ein Problem darstellen da diese Funktion in linearen Texten keine Entsprechung hat Wenn es in einem Hypertext neben dem r ckw rts Bl ttern auch Schaltfl chen zum seitenweisen Vor und Zur ckbl ttern in einem Lesepfad gibt kann es zu Missverst ndnissen kommen d
152. iftgr en werden nur dann ber cksichtigt wenn der Quelltext dies erlaubt Das Layout sollte vor dem produktiven Einsatz mit einem Screen Magnifier getestet werden Gerade bei Schriften kann es passieren das bei gro er Aufl sung der Treppeneffekt zu Lasten der Leserlichkeit geht Ay j at H Detail oe ZLA Records For Bild 44 Treppeneffekt bei gro er Schrift Nutzer von Screen Magnifiern m ssen viel bl ttern um alle Informationen einer Seite zu erfassen Die Nutzer von Screen Readern m ssen diese Informationen auditiv erfassen Kleine Informationseinheiten erleichtern ihnen den berblick redundanter oder unn tiger Text ist Argernis Frames Screen Reader k nnen immer nur einen Frame zu einem bestimmten Zeit punkt betrachten D h wenn beispielsweise eine Seite in mehrere Frames eingeteilt ist muss der Screen Reader Nutzer immer hin und her springen Frames sind zwar grunds tzlich kein Problem mehr f r blinde und sehbe hinderte Nutzer aber als unproblematisch kann man sie dennoch nicht bezeichnen Browser basierte Online Hilfen nutzen die Frame Technik um das Hilfefen ster analog dem Microsoft Hilfeformat darzustellen Die Frames sind in der Regel mit sinnvollen Namen versehen wie Navigation Inhalt und Tool bar Ideal w re die Verwendung des Noframe Tags z B mit einem Men zur Navigation auf der Seite Dies k me den blinden Text Browser Nutzern zugute 151 Barrierefreiheit
153. inander 105 Navigation Diese Link Art wird meistens dann verwendet wenn der Topic Inhalt umfangreich und nicht komplett im Hilfefenster darstellbar ist Topic Bild 30 Intra hypertextueller Link Eine Sonderform der intra hypertextuellen Links in einer Online Hilfe sind einblendbare Informationen Sie sind beim Aufruf des Topics hinter sensiti ven Elementen verborgen und werden erst beim Anklicken eingeblendet Einblendbare Informationen haben verschiedene Darstellungsarten e Popup Die Information meist eine Grafik oder eine Begriffserklarung wird in einem eigenen kleinen Fenster angezeigt Das Popup ffnet sich in der N he des sensitiven Elements e Eingeschobener Text Die Information wird rechts neben dem sensiti ven Element eingeblendet e Ausklappbarer Text Die Information wird unterhalb des sensitiven Ele ments eingeblendet Inter hypertextuelle Links verbinden zwei Topics desselben Hyperdoku ments miteinander Inter hypertextuelle Links sind die h ufigsten Links in einer Online Hilfe Dabei wird in der Regel der Inhalt des Hilfefensters gegen den neuen Inhalt ausgetauscht Der neue Inhalt kann aber auch in einem zweiten Fenster angezeigt werden dem sogenannten Sekund r Fenster Topic1 BER U Bild 31 Inter hypertextueller Link 106 Links Eine Sonderform der inter hypertextuellen Links in einer Online Hilfe sind
154. iner bestimmten Reihenfolge lesen oder abar beiten sollen Lesepfade m ssen e Eindeutig identifizierbar sein e _ Einen erkennbaren Anfang und ein erkennbares Ende haben 113 Navigation 6 5 3 6 5 4 F r die erste Version von HTMLHelp konnten Hilfe Autoren ber Informa tionstypen die Topics einer Online Hilfe z B speziellen Zielgruppen oder Produktvarianten zuordnen Ein Informationstyp war sozusagen ein Filter den ein Hilfe Autor ber das Hypertext Netz legte Die Nutzer konnten dann vor dem ffnen der Online Hilfe ber einen Dialog ausw hlen welche Informationen sie in der Online Hilfe sehen wollten Diese Art von Filter wird in der aktuellen HTMLHelp Version nicht mehr unterst tzt so dass ein Hilfe Autor bei Bedarf selbst Filter einrichten muss beispielsweise ber das Inhaltsverzeichnis oder ber Zielgruppen orientierte Hilfen Weitere Beschr nkungen wie z B Hypertrails sind f r Online Hilfen nicht oder nur schwer umzusetzen R ckw rtsgerichtete Orientierungshilfen Die meisten r ckw rtsgerichteten Orientierungshilfen werden vom Hilfe fenster unterst tzt beispielsweise die Nutzung von Favoriten oder die Home Schaltfl che Links Hyperlinks in Hilfetexten bieten Nutzern schnellen Zugriff auf weiterf h rende oder vertiefende Informationen Hilfe Autoren bieten sie die M glich keit ein Topic kurz zu halten sich auf den Kern des Themas zu beschr nken und Randinformation anderweitig zug ngl
155. isk You use Disk Management snap in in Windows XP to perform disk related tasks such as creating partitions and volumes formatting them and assigning drive letters On computers running Windows XP or a New ways to do familiar tasks E Best practices a AJ HowTo F Manage dynamic volumes e Z w Concepts e Before adding a disk to your computer see Checklist Adding a new disk D Configure the Disk Manage Windows 2000 Server you can also use Disk m Manage disks Management to perform advanced tasks such as creating and repairing fault tolerant Manage basic volumes Salsa E Disk Management overviet gt gt E Understanding Disk Manag For tips about using Disk Management 5 Ge p Using Disk Management see Best practices D amp Resources For help with specific tasks see How E Troubleshooting to For general background information see Concepts For problem solving instructions see Troubleshooting Bild 7 Beispiel f r HTMLHelp Format Browser basierte Hilfe Die Browser basierte Hilfe oder auch WebHelp ist ein Hilfeformat auf HTML Basis die in jedem Web Browser auf jedem Betriebssystem ablau fen kann Das Hilfeformat sind mehrere HTML Dateien die in einem beliebigen Browser dargestellt werden k nnen Das Hilfefenster arbeitet wie die HTMLHelp mit drei Anzeigebereichen die als Frames nachgebildet wer den Quellformat sind mehrere HTML Dateien Madcap Fla
156. ive Navigationshilfe Der Leser kann interessante Topics markieren und so zu einem sp teren Zeitpunkt leicht auf sie zur ckgreifen oder sie ausdrucken Anfang Home Mit der Home Schaltfl che springt der Leser zur ck auf ein Topic das der Hilfe Autor vordefiniert hat oder auf den Ausgangspunkt Links Links setzen die Topics zueinander in Beziehung Erst sie erlauben den Lesern die Navigation durch das Informationsnetz Links und Topics zusammen ergeben die typische nicht lineare Hypertext Struktur Alle Links haben einen Start und einen Zielpunkt die auch Ausgangs oder Zielanker genannt werden F r Ausgangsanker finden sich in der Literatur auch die Begriffe references linkpoints Link Indikatoren link icons hot words hot spots oder buttons F r Zielanker finden sich auch die Begriffe link regions destination points und reference points Link Arten Links k nnen unidirektional oder bidirektional sein In den meisten Hyper text Systemen k nnen Links nur entlang einer Richtung verfolgt werden und zwar vom Ausgangsanker hin zum Zielanker Diese Links sind unidi rektional Bidirektionale Links werden meist nur indirekt durch das r ck w rts Bl ttern unterst tzt Das bedeutet der umgekehrte Weg kann nur dann gegangen werden wenn zuvor die Vorw rtsrichtung verfolgt wurde Weiter k nnen Links intra inter oder extra hypertextuell sein Intra hyper textuelle Links verbinden zwei Bereiche innerhalb eines Topics mite
157. k 134 Lesezeichen 126 Querverweis 128 referenziell 108 Stichwort Link 135 Text Popup 129 Topic Popup 130 typisiert 109 verwandte Topics Link 136 Zielanker 105 Link B ndel Konzept Link 134 Stichwort Link 135 verwandte Topics Link 136 195 Stichw rter Liste bearbeiten 64 einf gen 64 L sungsbeschreibung 57 M Madcap Echo 96 Lingo 171 Mimic 96 Map Id siehe Identifier Marke 30 ein ausblenden 31 Master page siehe Vorgabeseite Maus Ersatz 144 Medium 154 neu anlegen 155 Meldung 12 57 182 Men 56 182 Men zeile 26 Mimic 96 Mini TOC Proxy 81 Multimedia 152 N Navigation 26 57 99 182 Fachwortverzeichnis 113 hierarchisch 179 Inhaltsverzeichnis 111 Lesepfad 113 Links 114 Stichwortverzeichnis 112 Navigationshilfe 100 Nutzer 182 Erwartungen 8 N tzlichkeit 6 Nutzungsanalyse 10 Nutzungskontext 1 O Oberfl chenelement 182 ffnen Datei 27 Online 4 Dokumentation 4 Information 4 Online Hilfe 183 barrierefrei 150 Einf hrung 56 Erwartungen der Nutzer 8 Fachwortverzeichnis 113 FAQ 57 generieren 44 167 Hilfe Agent 179 Hilfefenster 179 Hilfeformat 179 Inhalt 56 Inhaltsverzeichnis 111 kontextsensitive Anbindung 159 Lesepfad 113 Links 114 Meldung 57 Navigation 57 Schrift 74 Seitengestaltung 73 Stichwortverzeichnis 112 Onscreen 4 Ordner Berichte 45 167 Orientierungshilfe 100 Fachwortverzeichnis 113 Favoriten 105 History Liste 105 Inhaltsverzeichnis 111 Lesepfad
158. kende Anzahl Funktionen f r das Erstellen von Online Hilfen Flare wurde als Hilfe Autorensystem entwickelt ist aber ein Werkzeug f r alle Arten von Informationen die am Bildschirm ausgegeben werden Das m ssen nicht unbedingt Hilfesysteme sein obwohl hierauf der Schwerpunkt liegt sondern das k nnen z B auch Web Seiten oder Wis sensdatenbanken f r Intranet oder Call Center Stichwort Knowledgebase sein Flare ist XML basiert und bietet einen eigenen XML Editor im WYSIWYG Verfahren What you see is what you get an XML basiert bedeutet dass alle Dateien eines Flare Projekts Inhalte und Steuerdateien in sauberem XML Format ohne propriet re Tags vorliegen Damit lassen sich unter anderem Texte leichter austauschen Gleichzeitig bietet das XML Format einen leichteren Zugang zu Versions Kontrollsystemen und bersetzungs management Systemen Translation Memory F r beide Funktionen bietet Flare Anschlussm glichkeiten Derzeit dient noch XHTML als Schema gegen das alle Dateien eines Flare Projekts validiert werden Weitere XML Schemata wie beispielsweise DITA sind angek ndigt wurden aber mit der Version 3 von Flare noch nicht umgesetzt Auch firmeneigene Schemata oder Docbook Adaptionen k n nen derzeit noch nicht mit Flare verwendet werden Mit Flare k nnen folgende Hilfeformate generiert werden e HTMLHelp e WebHelp e DotNetHelp 25 Das Hilfe Autorensystem Flare 3 1 3 1 1 DotNetHelp DotNetHelp wur
159. komplexen Systemen Interaktives Element nur HTMLHelp Direkte Verbindung mit dem beschriebenen Programm Wegen der vielen M glichkeiten von Links sollte man sich auf eine gewisse Auswahl beschr nken Zudem sind Oberfl chen und Online Hilfen auch Moden und neueren Erkenntnissen aus Usability Tests unterworfen So gal ten gerade in den Anf ngen der grafischen Oberfl chen mehrere Fenster und Popups als modern und besonders benutzerfreundlich heute kommen eher geschichtete Informationen mit eingeschobenem und ausklappbarem Text zum Einsatz In Usability Tests hatte sich herausgestellt dass Nutzer sich von allzu vielen ge ffneten Fenstern verwirren lassen und auch M he hatten die einmal ge ffneten Fenster wieder zu schlie en Auch wenn Links im Text besonders viel Aufmerksamkeit erregen haben sie ihre Nachteile durch die besondere Aufmerksamkeit sind Nutzer ver sucht diesen Links zu folgen ohne den umgebenden Text zu lesen Sie navigieren von der gefundenen Information weg ohne sie zu bemerken Ein anderer Teil der Nutzer will die gefundene Information nicht wieder ver lieren und traut sich deswegen nicht dem Link zu folgen Beide Alternati ven st rzen manche Leser in ein Dilemma Abhilfe schafft ein m glichst transparentes Link Konzept das die Nutzer schnell lernen und an das sie sich halten k nnen Voraussetzung dazu ist dass das Link Konzept in der gesamten Online Hilfe durchg ngig umge setzt wird
160. kt anlegen Der Import von FrameMaker und Word Dateien funktioniert ana log Unterschiede sind angemerkt Word Datei einlesen Gehen Sie folgenderma en vor um mit dem Einlesen einer Word Datei ein neues Flare Projekt anzulegen 1 W hlen Sie Datei Projekt importieren MS Word Dokumente impor tieren Der Assistent Microsoft Word Dateien importieren ffnet sich Klicken Sie im ersten Dialog auf Weiter Der zweite Dialog ffnet sich in dem Sie die zu importierende Word Dateien ausw hlen k nnen Klicken Sie auf Hinzuf gen Der Dialog ffnen ffnet sich W hlen Sie den Ordner und die Word Datei en aus die importiert werden sollen Klicken Sie auf ffnen Der Dialog schlie t sich und die Word Datei wird in die Liste MS Word Dateien im Assistenten bernommen Deaktivieren Sie die Option Generierte Dateien mit Quelldateien verkn pfen Diese Option ist nur dann interessant wenn Word der Editor bleiben soll Klicken Sie auf Weiter Nach der berpr fung der Importdatei ffnet sich der n chste Dialog des Assistenten W hlen Sie hier einen Ordner f r das Projekt und geben Sie ihm einen Namen Klicken Sie auf Weiter Der Dialog Format bei dem ein neues Topic erstellt werden soll ffnet sich Hier k nnen Sie die Formate ausw h len mit denen ein neues Topic beginnen soll z B berschriften W hlen Sie aus der Liste Word Formate die entsprechenden Formate aus und klicken Sie auf gt gt gt Die Fo
161. kumente lassen sich als quasi linear bezeichnen Sie sind zwar linear aufgebaut werden aber nicht so benutzt beispielsweise durch den Zugriff ber Verzeichnisse Index bersichtstabellen Querverweise usw Auch Lexika sind eher modular aufgebaut m He gt gt gt Bild 20 Linearer Text Hypertext Online Hilfen sind sogenannte Hypertexte Ein Hypertext enth lt Informati onseinheiten oder Knoten die nicht linear vernetzt und vielf ltig verschach telt sein k nnen Die starre lineare Struktur eines Buches wird bei Hypertexten verlassen Es entsteht eine Netzstruktur die f r den Nutzer nicht transparent ist Der Grad der Vernetzung ist dabei bei verschiedenen Systemen unterschiedlich Teils kann man die Pfade sehr variabel w hlen teils ist der Weg durch das System eher vorgegeben 48 Text a Bild 21 Hypertext Allgemein kann man in Hypertexten ber Verkn pfungen sog Hyperlinks von einer Stelle im Text dem sogenannten Anker eine logische Verbindung zu einer beliebigen anderen Stelle in diesem Text oder zu einem anderen Dokument herstellen Diese Links werden meist als grafische Kn pfe oder farblich hervorgehobene Textstellen realisiert Die Hyperlinks m ssen aber nicht unbedingt zu anderen Texten f hren es lassen sich auch Abbildungen Grafiken Animationen oder Film und Ton sequ
162. kundefn Fertig e Ausgabe ansehen Schlie en A Bild 18 Fortschrittsanzeige bei der Generierung 11 Klicken Sie auf Ausgabe ansehen um die generierte Ausgabe zu ff nen Fehlermeldungen beim Generieren k nnen Sie in einem Protokoll spei chern Das Protokoll liegt dann in der Projektorganisation im Ordner Berichte mit Datum und Uhrzeit Das Protokoll ffnen Sie mit einem Dop pelklick Ein weiterer Doppelklick auf ein fehlerhaftes Topic im Protokoll ff net dieses zur Bearbeitung Vorschau nutzen Wenn Sie Ihre Online Hilfe bearbeiten m ssen Sie sie nicht jedesmal generieren um sich die Auswirkung Ihrer Anderungen in einem Topic anzu sehen Mit dem Symbol der lokalen Symbolleiste des XML Editors k n nen sich jedes Topic in der Vorschau ansehen 45 Das Hilfe Autorensystem Flare Ausdruck einschlie en leerer Ausdruc Ausdruck ausschlie en Introduction to this sample This is a sample Flare project for a fictional application called FictionSoft and a fictional company called MegaSoft Fictional Software This project can be used to experiment with Flare or it can be used as a template to build a larger project Tip The Copyright below is implemented using the Flare Snippets feature To edit the copyright locate the snippet file Go to the Content Explorer and open the Resources folder There you will find a Snippets sub folder where all of the project snippets are stored
163. l nutzen Zuerst pro bieren sie mittels Versuch und Irrtum zum Ziel zu gelangen Danach wer den Kollegen oder Bekannte um Rat gefragt oder im Internet nach L sungsm glichkeiten gesucht Erst danach kommen Handbuch und Online Hilfe in der Rangliste f r m gliche Unterst tzung Die Ursachenforschung ergab dass Online Hilfen generell einen schlech ten Ruf haben Man findet die richtige Information nicht oder nur m hsam Hat man die Information gefunden kann man oft nur wenig damit anfan gen Die Erwartungen der Nutzer an eine Online Hilfe werden nur ungen gend erf llt DIN EN ISO 9241 Ergonomische Anforderungen f r B rot tigkeiten mit Bildschirmger ten misst der Erwartungshaltung der Nutzer eine hohe Bedeutung zu Was also k nnten Nutzer von einer Online Hilfe erwarten e Nutzer wollen ihr Problem l sen und die daf r erforderliche Information schnell finden Dabei gilt es unterschiedliche Suchstrategien und Vor gehensweisen zu befriedigen entsprechend der Unterschiedlichkeit der Nutzer e Wenn die Nutzer die Information gefunden haben wollen sie sie auch verstehen und erwarten demzufolge eine leicht verst ndliche Sprache und kurze pr gnante Texte e Auch mit Abk rzungen oder unbekannten Fachw rtern will ein Nutzer nicht allein gelassen werden sondern er erwartet eine Erkl rung ent weder an Ort und Stelle oder in einem zentralen Ordner e Der Einsteiger in ein Thema oder eine Software will detailliert
164. ldet 1 W hlen Sie den Befehl Projekt Erweitert Neue Aliasdatei Der Dia log Neue Aliasdatei einf gen ffnet sich W hlen Sie gegebenenfalls eine andere Vorlage f r die Aliasdatei aus Geben Sie der Aliasdatei einen Dateinamen Klicken Sie auf Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob die Aliasdatei mit der ausgew hlten Vorlage erstellt werden soll Best tigen Sie die Abfrage Der Dialog schlie t sich und die neue Ali asdatei wird in der Projektorganisation im Ordner Erweitert angelegt und zum Bearbeiten ge ffnet 164 Umsetzung mit Flare Es Language Checker Eh a WebHelp P Selecting a Language for the WebHelp Interface Le Alias Editor Alle Identifier Alle Topics X Identifier Topic Wert skin c ma Fischen About htm Database Dialogs Databas 2 Check_Document htm Settings Dialogs Edit_Set 3 EE Check_Paragraphs htm Welcome Overview Welco 4 checkint_book htm Neu zuordnen checkint_doc htm Edit_Termlist htm Reset_Document htm Reset_Paragraphs htm Save_Sentences htm Save_Words htm Settings htm Undo_Last_Replacement htm Skin ffnen voreingestellt New Window gt Neuer Identifier Entfernen Topic ffnen Ir Lesezeichen anzeigen Bild 45 Aliasdatei im Alias Editor Alias den einzelnen Topics zuweisen In der Aliasdatei werden die Identifier die mit den Elementen der grafi schen Benutzeroberfl che verbu
165. le im Topic an Stellen Sie im Register R nder gegebenenfalls die R nder f r die Tabelle ein Klicken Sie OK um Ihre Angaben zu best tigen Der Dialog schlie t sich und die Tabelle wird in das Topic eingef gt Tabelle bearbeiten Sie k nnen sich im Topic die Struktur Ihrer Tabelle ber folgende Symbole der lokalen Symbolleiste einblenden 5 Blendet die Zeilen der Tabelle ein oder aus Blendet die Spalten der Tabelle ein oder aus 65 Topics Die gesamte Tabelle k nnen Sie bequem ber die Strukturdarstellung bear beiten 1 Blenden Sie dazu die Struktur der Tabelle ein 2 Klicken Sie mit der rechten Maustaste auf ein Strukturelement der Tabelle f r Spalte oder Zeile Das Kontextmen ffnet sich f r das aus gew hlte Element Hier k nnen Sie beispielsweise e die Spaltenbreite ndern die Zeilenh he ndern e neue Zeilen oder Spalten einf gen e den Inhalt der Zeilen oder Spalten l schen leeren Sie k nnen ber die Strukturdarstellung der Tabelle auch Zeilen oder Spal ten verschieben 1 Fahren Sie dazu mit dem Cursor in der Tabellenstruktur ber das jeweilige Element bis der Cursor mit einem kleinen Rechteck darge T stellt wird A 2 Dr cken Sie die linke Maustaste und verschieben Sie das Tabellenele ment bis ein blauer Pfeil sichtbar ist 3 Lassen Sie das Tabellenelement los Die Zeile oder Spalte wird an die Stelle des blauen Pfeiles in der Tabelle verschoben Tabelle
166. liasdatei auch neue Identifier eintragen und damit impli zit die zugeordnete Header Datei bearbeiten 1 2 3 4 oO o aN D Wechseln Sie in die Projektorganisation Offnen Sie den Ordner Erweitert Offnen Sie mit einem Doppelklick die passende Aliasdatei Klicken Sie unter der Tabelle der Identifier auf Neuer Identifier Flare f gt eine neue Zeile mit dem voreingestellten Namen Neut in die Tabelle der Identifier ein Klicken Sie das erste Feld der neuen Zeile um den Identifier anzupas sen Das Feld wird editierbar ndern Sie den Eintrag entsprechend Ihren Anforderungen Verkn pfen Sie den neuen Identifier mit dem passenden Topic F gen Sie gegebenenfalls weitere Identifier in die Aliasdatei ein Speichern Sie die Aliasdatei mit dem Befehl Datei Speichern Aliasdatei zuweisen Damit die richtigen Identifier in die Ausgabe bernommen werden m ssen Sie die Aliasdatei der Zieldefinition zuweisen 1 2 Wechseln Sie in die Projektorganisation ffnen Sie im Ordner Zieldefinitionen die passende Zieldefinition mit einem Doppelklick Die Zieldefinition ffnet sich W hlen Sie im Register Erweitert aus der Liste Aliasdatei die Alias datei aus die Flare bei der Generierung der Ausgabe verwenden soll Speichern Sie die Zieldefinition mit dem Befehl Datei Speichern 166 Umsetzung mit Flare Online Hilfe generieren Um eine Online Hilfe zu generieren gehen Sie folgenderma en vor 1 Wechseln Sie in
167. liche Informationen zu Unicode finden sich auf der Internet Seite des Unicode Konsortiums http www unicode org standard translati ons german html Zeichendarstellung In Unicode wird jedem Zeichen eine Nummer der Code Point zugeordnet Ein Unicode Code Point wird im Allgemeinen in der Form U n angegeben wobei n aus vier bis sechs Hexadezimalzahlen besteht Die Menge aller Code Points bildet den Code Space Der Code Space der Unicode Norm V4 umfasst 1 114 112 Code Points von denen die meisten noch nicht vergeben sind Unterteilt ist der Code Space in Ebenen Jede Ebene umfasst 65 536 Code Points Die wichtigste Ebene ist die Ebene 0 die Basic Multilanguage Plane BMP die die Code Points von U 0000 bis U FFFF aufspannt Die Code Points von U 0000 bis U 00FF stimmen mit denen von ISO8859 1 berein Die Code Points f r alle Zeichen die im Unicode Standard definiert sind sind in so genannten Code Charts auf gelistet Sie finden diese Tabellen in der gedruckten Ausgabe des Unicode Standards oder im Internet z B auf den Seiten des Unicode Konsortiums Unicode und Windows Obwohl man auf der Oberfl che von Windows noch viel mit ASCII oder ANSI arbeitet arbeitet die Windows NT Reihe dazu geh ren auch Win dows 2000 Windows XP und Windows 2003 seit der Version 4 0 intern komplett mit Unicode Es gibt nur noch eine Handvoll Systemfunktionen die nur in ASCII verf gbar sind da sie speziell ASCII bezogene Themen abdecken F r
168. lien heben die origin re Wortsilhouette auf und erschweren damit das Scannen des Textes Glei ches gilt f r doppelte Auszeichnungen Der Bildschirm erfordert seine eigenen Layout Regeln das bedeutet aber nicht dass die Regeln f r ein gutes Layout nicht mehr gelten Sprache Viel ist schon zu Textverst ndlichkeit und Sprache geforscht und geschrie ben worden Hier eine kurze Zusammenfassung der wichtigsten Erkennt nisse Gebr uchliche Worte bekannte Begriffe und treffende Verben in kurzen berschaubaren S tzen machen Texte leichter und schneller lesbar und damit auch verst ndlich Je exakter ein Autor die Sprache seiner Ziel gruppe trifft um so h her die Akzeptanz des Gelesenen Je deutlicher die Satzaussage um so besser das Verst ndnis und die Merkbarkeit berschriften sollten den nachfolgenden Inhalt kurz zusammenfassen und keine Wortspiele oder Ironie enthalten Wichtige Informationen sollten schon am Anfang des Textes stehen Das Scannen wird weiter erleichtert wenn nicht jede Seite mit dem gleichen Wort beginnt und generell eine markante Struktur erkennbar ist Pr gnant und kurz zu formulieren ist sicherlich die wichtigste Forderung f r einen verst ndlichen Text Zudem sollten Texte nicht im Werbungsjargon verfasst werden die wenig bis keine n tzliche Information erhalten und die Erwartungen der Nutzer nicht befrie digen Farben Farben machen den Leser nicht nur aufmerksam sie wecken auch Emotio nen und ver
169. lle in etwa so gesprochen werden Lebensmittel Brot Preis 2 50 EUR Lebensmittel Brot Menge 1 Lebensmittel Milch Preis 1 40 EUR Lebensmittel Milch Menge 3 Wenn Sie f r die Tabelle die Eigenschaft speak header auf once setzen w rde diese Tabelle in etwa so gesprochen werden Lebensmittel Brot Preis 2 50 EUR Menge 1 Lebensmittel Milch Preis 1 40 EUR Menge 3 157 Die kontextsensitive Anbindung Sobald eine Software eine grafische Benutzeroberfl che anbietet erwarten die Nutzer auch eine kontextsensitive Hilfe Die kontextsensitive Hilfe ist ein Teil der Software und wird oft auch mit der Software verwaltet Die kontext sensitive Hilfe bietet dem Leser Information zu dem Element der grafischen Benutzeroberfl che f r das sie aktiviert wurde Eine Online Hilfe kann kon textsensitiv an verschiedene Steuerelemente der Oberfl che angebunden sein Tabelle 14 M glichkeiten kontextsensitiver Anbindung Steuerelement Aufruf Anzeige Dialog Hilfe Schaltfl che F1 Online Hilfe Fragezeichen Feld Befehl F1 Fragezeichen Online Hilfe Schaltfl che Me M F n Symbolleiste ee mit der Tooltip Statuszeile aus Die kontextsensitive Hilfe auf Elementebene kann nur sehr punktuelle und isolierte Informationen geben da sie sich immer nur auf das einzelne Ele ment beschr nkt Nicht jedes Element der grafischen Benutzeroberfl che muss zwanghaft mit einer kontextsensitiven Hilfe ver
170. llt haben wird das neue Projekt in Flare ge ffnet Beispielprojekt ffnen RoboHelp Projekt importieren Projekt aus FrameMaker Dateien erstellen I Dialog beim Programmstart anzeigen Abbrechen Bild 4 Beispiel f r eingebettete Hilfe in einem Assistenten Auch hier h ngt die Erfassung und Verwaltung von Hilfetexten vom Pro grammiersystem und dem Programmierer ab sie k nnen in Ressource Dateien vorliegen oder aber auch als kontextsensitive Online Hilfe einge bunden werden Kontextsensitive Hilfe Kontextsensitive Hilfe ist eine Online Hilfe die zum angezeigten Nutzungs kontext passt in der Regel auf Dialog oder Elementebene Die kontextsen sitive Hilfe auf Elementebene wird auch Direkthilfe genannt Elemente k nnen dabei einzelne Felder Schaltfl chen Befehle usw sein Online Hilfe auf Elementebene kann nur sehr punktuelle und isolierte Informatio nen geben 13 Vom Input zum Output Paste Special SS xl Source Unknown Source OK As Cancel FrameMaker Interchanae Format Embeds the copied information into your document Changes you make to the embedded information will not be reflected in the original document and changes to the original document will not appear in this document F Display As cori Inserts the contents of the clipboard into your document as Original FrameMaker Text S Bild 5 Beispiel f
171. lsweise WebHelp InterHelp oder WebworksHelp hei t Der Browser als Anzeigesystem kann in der Regel beliebig sein Einige Software Hersteller haben eigene Hilfeformate entwickelt die unter der Rubrik Browser basiert laufen da sie HTML basiert sind Allerdings brauchen viele dieser Formate einen speziellen Hilfe Viewer der zwar Browser hnlich ist aber nicht mehr beliebig Der Hilfe Viewer wird damit zur Voraussetzung f r den korrekten Ablauf der Online Hilfe Eine AppleHelp l sst sich mit ein paar Einschr nkungen in einem beliebigen Browser anzeigen f r eine JavaHelp gilt das nicht mehr 19 Vom Input zum Output Die folgende Tabelle stellt die bekanntesten Hersteller spezifischen HTML basierten Hilfeformate einander gegen ber Tabelle 2 HTML basierte Hilfeformate DotNet OracleHelp Help JavaHelp for Java AppleHelp Hersteller Madcap Sun Micro Oracle Inc Macintosh Software systems Betriebssy Windows Windows Windows Mac OS stem Mac OS Mac OS Unix Linux Unix Linux Unix Linux Vorausset JRE JVM zung Hilfeformat HTML Java Archiv Java Archiv HTML Dateien Dateien Aufrufdatei mchelp kontextsensi mehrere JavaHelp JavaHelp AppleHelp tive Anbin APIs API API API dung Viewer Madcap Java Help Oracle Hel AppleHelp Helpviewer viewer pviewer Viewer Browser Skin in meh Ja reren Spra chen f r den Viewer dynamische Ja
172. m Dem l sst sich durch einen etwas farbigen Hin tergrund entgegenwirken z B hellgrau oder gelb Neuere Studien haben allerdings ergeben dass wir schwarze Schrift auf einem wei en Hinter grund als am konstrastreichsten wahrnehmen also am besten lesen k n nen Bei der Farbauswahl f r eine Online Hilfe sollten nicht nur die Vorgaben des Corporate Designs die in vielen Unternehmen f r die Gestaltung exis tieren eine Rolle spielen sondern auch folgende funktionale Kriterien e Wiedererkennbarkeit des Erscheinungsbildes e Gute Lesbarkeit von Text und Bild e Navigation und Benutzerf hrung durch systematischen Farbeinsatz e Kontrast 76 Bilder 5 5 Obwohl sich kein allgemeing ltiger Ratschlag f r den Einsatz von Farben formulieren l sst kann man sich bei der Verwendung von Farben wie auch von anderen Stilmitteln an den alten typographischen Leitsatz halten Weniger ist mehr Bilder Bilder k nnen in Online Hilfen verschiedene Funktionen im Lern und Merk prozess erf llen und Inhalte nicht nur sprachlich sondern auch visuell ver mitteln Sie sind dann n tzlich wenn sie relevante Informationen enthalten und in direktem Zusammenhang mit der Textinformation stehen Ergebnisse der Imagery Forschung zeigen dass Bilder mit geringer gedanklicher Anstrengung aufgenommen und verarbeitet werden Sie wer den zudem leicht erinnert und haben einen starken emotionalen Einfluss Insbesondere Text Bildkombinationen
173. mit der richtigen Pr sentation in einer Online Hilfe zu unterst tzen ist das Kern thema dieses Buches Demonstriert wird die Umsetzung mit dem Hilfe Autorensystem Flare V3 1 Flare ist momentan das modernste Werkzeug am Markt zur Erstellung von Online Hilfen Flare unterst tzt als Hilfe Autorensystem auch das Erstellen von Online Hilfen und Bedienungsanleitungen in einer Quelle Dieses sogenannte Single Sourcing wird in diesem Buch nicht beschrieben Die Erstellung einer Online Hilfe ist eingebettet in einen Dokumentations prozess und dieser wiederum in einen Entwicklungsprozess Idealerweise richten sich beide Prozesse an den Nutzern aus und interagieren miteinan der das sogenannte user centered engineering Mit diesem Verfahren und seinen Methoden besch ftigt sich dieses Buch nur indirekt Bedanken m chte ich mich bei allen die mich beim Schreiben dieses Buches unterst tzt und best rkt haben allen voran bei meiner Firma der cognitas GmbH und meinen Korrekturlesern Durch Nachfragen und fachli che Erg nzungen haben sie zur Vertiefung einzelner Themen und zu ihrer Abrundung beigetragen Alfred Holland Hannemarie Kolbus Dr Claus Noack Dr Christine Platz Mathias Rehs ft und Evelyn Reichardt viii Inhalt 1 Begriffskl rungen 2 6 ee ee ee 1 1 1 Benutzerfreundlichkeit Usability A Co 1 1 2 Online Dokumentation 20200000004 4 1 2 1 Assistenz Systeme 5 1 2 2 Lernprogramme
174. mitteln Botschaften Die menschliche Farbwahrnehmung basiert auf mehreren Aspekten So bestimmt der biologische Faktor dass Farben verschieden gewichtet wahrgenommen werden da die Anteile der Sinneszellen unterschiedlich sind Es gibt 64 Sinneszellen f r Rot aber nur 2 f r Blau Eine biologische Ursache hat auch die weitverbreitete Farbfehlsichtigkeit z B bei Rot Gr n Blindheit Farben sind aber auch kulturabh ngig und k nnen in unterschiedlichen Kulturen unterschiedliche Bedeutung haben Beispielsweise wird in man chen Kulturen die Farbe Schwarz mit Trauer assoziiert in anderen Kulturen die Farbe Wei Neben den biologischen und kulturellen spielen auch psychologische Aspekte bei der Wahrnehmung eine entscheidende Rolle Denn Farben so stellte die Farbpsychologie fest l sen auf individuellen Erfahrungen beru hende Assoziationen und Emotionen aus Zudem beeinflussen sogenannte archetypische Vorstellungen also kulturelles Wissen bzw das unbewuss 75 Layout te kollektive Bewusstsein das Farbempfinden Rot wird als warm Blau eher als kalt empfunden Zudem wird bestimmten Farben auch eine symbolische Kraft zugespro chen Blau symbolisiert den Himmel und die Ewigkeit Gelb Zeit und Ver ganglichkeit Nicht zuletzt beeinflussen pers nliche Vorlieben Abneigungen Erfahrungen und Modetrends die individuelle Farbwahrneh mung Trotz all dieser Besonderheiten k nnen Farben konsistent eingesetzt Information
175. mportieren 1 W hlen Sie den Befehl Datei Projekt importieren Nicht Flare Pro jekt importieren Der Assistent f r Projektimport ffnet sich mit dem ersten Dialog Klicken Sie neben dem Feld Projektdatei auf die Schaltfl che mit den drei Punkten Der Dialog Offnen ffnet sich W hlen Sie im Dialog ffnen den Pfad und die Projekt Datei aus Sie k nnen folgende Projekttypen ausw hlen Endung xpj RoboHelp Version X5 Endung mpj RoboHelp Version X4 Endung hhp HTML Hilfeprojekt Klicken Sie auf ffnen Der Dialog schlie t sich und die ausgew hlte Hilfeprojekt Datei wird in das Feld Projektdatei bernommen Klicken Sie auf Weiter um den n chsten Dialog zu ffnen Geben Sie hier den Projektnamen und den Ordner an in dem das Projekt abgelegt werden soll Klicken Sie auf Weiter Der Dialog Importoptionen ausw hlen ffnet sich W hlen Sie ob sie alle Topics nach XHTML konvertieren wollen Wenn Sie diese Option nicht w hlen wird ein Topic dann nach XHTML konvertiert wenn Sie es in Flare zum erstenmal ffnen Es empfiehlt sich diese Option auszuw hlen 40 Erste Schritte 9 Klicken Sie auf Weiter Der Dialog Flare Projektsprache ausw hlen ffnet sich 10 W hlen Sie die Sprache f r dieses Flare Projekt Diese Spracheinstel lung k nnen Sie in der Zieldefinition bersteuern wenn Sie beispiels weise mehrere Sprachen in einem Flare Projekt verwalten 11 Klicken Sie auf Fertig
176. n Der Dialog Bereich Eigenschaften ffnet sich W hlen Sie bei Link zu die Quelle f r den Zielanker und w hlen Sie dann rechts im Dialog die passende Quelle aus Mit den weiteren Feldern im Dialog k nnen Sie das Verhalten des Links weiter festelegen e Bei Ziel Frame k nnen Sie einstellen ob das Ziel Topic im gleichen oder in einem anderen Fenster ge ffnet wird e Bei Bildschirm Tip k nnen Sie einen erkl renden Text Tooltip eingeben Klicken Sie auf OK um die Link Eigenschaften zu bernehmen Der Dialog schlie t sich und der Link wird in die Image Map eingetragen Markieren Sie so weitere Bereiche im Bild W hlen Sie den Befehl Datei OK um die Image Map zu speichern Der Imagemap Editor schlie t sich Speichern Sie das Topic mit dem Befehl Datei Speichern 6 6 8 Interaktives Element nur HTMLHelp Bevor Sie ein interaktives Element Shortcut erstellen k nnen brauchen Sie von der Software Entwicklung folgende Informationen Pfad zur ausf hrbaren Datei Eventuelle Parameter die das Programm erwartet Eine Meldungs Id Werte f r W und L Parameter Interaktive Elemente funktionieren nur in einer HTMLHelp die Im Hilfefenster angezeigt wird Auf einem lokalen Laufwerk liegt 140 Umsetzung mit Flare Um ein interaktives Element einzuf gen gehen Sie folgenderma en vor 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic das das interaktive Ele ment
177. n die Effizienz ein Effizienz bezeichnet den geringstm glichen Aufwand den ein Nutzer zur Erreichung seiner Ziele ben tigt Effizienz bezieht sich somit auf den Weg der zur L sung f hrt Die Online Hilfe sollte deshalb so einfach wie m glich gestaltet sein Der relevante Aufwand kann psychische oder physische Beanspruchung Zeit Material oder finanzielle Kosten enthalten Zus tzlich soll der Nutzer bei der Arbeit mit einer Online Hilfe zufrieden sein Zufriedenheit stellt sich ein wenn die Erwartungen erf llt oder ber troffen werden Zufriedenheit nach der ISO Norm wird dabei erst erreicht wenn die Erwartungen bererf llt werden Die Effektivit t und Effizienz einer Online Hilfe lassen sich objektiv messen indem man eine Testperson nach bestimmten Informationen suchen l sst und dabei beobachtet ob sie alles findet und wie viele Schritte sie dazu ben tigt Das letzte Kriterium f r eine benutzerfreundliche Online Hilfe die Zufriedenheit ist dagegen nicht messbar Ob eine Online Hilfe zufriedenstellend ist findet man heraus indem man eine Testperson nach ihrer subjektiven Meinung fragt Wie gef llt Ihnen die Hilfe Hatten Sie den Eindruck dass Sie sich gut zurecht gefunden haben Wie schwer fanden Sie es die gesuchten Informationen zu finden k n nen m gliche Fragen eines Fragebogens dazu sein Nat rlich sollte man nicht nur eine sondern nach M glichkeit mehrere Testpersonen befragen um handfeste Aus
178. n tzlich sind oder nicht Deswegen finden sich in manchen Online Hilfen Informationen die in der oberen Liste nicht aufgef hrt sind Dabei handelt es sich um Informationen die in einem Buch besser aufge hoben sind denn sie gehen ber das eigentliche Anliegen einer Online Hilfe die punktuelle Unterst tzung weit hinaus wie z B e Konzeptinformation die zur Benutzung des Produkts notwendig sind Sie informieren ber grundlegende Sachverhalte und sollen die Nutzer zum Verst ndnis des Produkts f hren so dass sie Sonderfunktionen nutzen und Fehlfunktionen nachvollziehen k nnen Konzeptinformatio nen sind nicht f r die konkrete Probleml sung bestimmt sondern die nen dem Aufbau von Wissen ber das Produkt Zu den Konzeptinformationen z hlen z B e Funktionsweise des Produkts e Produkt Konzept und Prinzipien e Prozess bersicht sprachlich bildlich e bersicht des Arbeitsablaufs sprachlich bildlich e Strategien f r Vorgehensweisen effiziente Wege zum Einsatz des Produkts e Produkt Struktur sichtbare 57 Topics 4 4 2 e Innere Logik des Produkts versteckte funktionale Abh ngigkeiten z B verstreute Parameter e Generelle Beschreibung zu einem Problemfall e Quellen und Literaturverweise e Referenzinformation die alle Informationen zum Programm oder Pro dukt enthalten die die Oberfl chenbeschreibung nicht abdeckt z B Befehle einer Kommandozeile Anweisungen oder Parameter einer
179. n Inhalt und die hierarchische Struktur eines Textes vermitteln Wei terhin erlauben sie ber die Seitenangaben f r die einzelnen Kapitel einen gezielten Zugriff auf bestimmte Textpassagen ber ein Inhaltsverzeichnis kann im Hypertext direkt auf die interessieren den Topics zugegriffen werden indem der entsprechende Eintrag ange klickt wird Das Inhaltsverzeichnis bietet eine logische und meistens auch hierarchische Sicht auf den Hypertext Die Darstellung dieser Hierarchie ist nach dem heutigen Stand der Technik eine auf und zuklappbare Baum struktur Allerdings darf man hierbei nicht vergessen dass es die logische Sicht des Autors ist die im Inhaltsverzeichnis zum Tragen kommt Diese logische Sicht muss mit der logischen Sicht der Nutzer nicht zwangsl ufig berein stimmen 100 Navigationshilfen Nicht jedes Topic muss im Inhaltsverzeichnis stehen aber jedes Topic muss ber das Inhaltsverzeichnis erreichbar sein Ob alle oder nur die wichtigsten Topics im Inhaltsverzeichnis aufgef hrt werden sollen h ngt von mehreren Kriterien ab e Umfang der Online Hilfe e Verteilung der Informationen auf Topics e Alternative Zugriffe auf Topics die nicht im Inhaltsverzeichnis stehen Ob vollst ndig oder nicht oberstes Ziel eines Inhaltsverzeichnisses sollte seine bersichtlichkeit und Uberschaubarkeit sein Nur dann kann es den Nutzern auch Orientierung bieten Dies l sst sich erreichen durch e Gliederung des Inhalts
180. n Sehbehinderte von Hyperlink zu Hyperlink oder von berschrift zu berschrift navigieren Daher m ssen Linknamen oder berschriften f r sich alleine m glichst sinnvoll sein Linkbezeichnun gen wie Hier klicken mehr Information oder Frame Namen wie Frame1 Frame2 usw sind ohne Kontextinformation inhaltslos Falsch geschachtelte berschriften sind sehr verwirrend Auch Menschen mit Lernschwierigkeiten Lernbehinderungen oder geistigen Behinderungen ben tigen ein solides Navigationsger st um sich auf einer Seite zurechtzu finden Auch allgemein ist der konkrete Bezug zum Inhalt wichtig um z gig die gesuchte Information zu finden F r Mobilit tsbehinderte und Sehbehin derte kommen gerade bei grafischen Elementen die Aspekte der Gro fl chigkeit und Lesbarkeit hinzu 147 Barrierefreiheit Eine gute und konsistente Navigation ist eine wichtige Grundlage f r die all gemeine Benutzbarkeit eines Hypertextes Volltextsuche und Navigations mechanismen sollen helfen sich besser zurechtzufinden Ein zielgerichtetes Suchen mittels bersichtlicher und aussagekr ftiger Naviga tion ist hilfreich Sinnvolle Bezeichnungen von Navigationselementen und Hyperlinks nachvollziehbare Gliederungen Information ber die aktuelle Position in einem Dokument R cksprungmarken zu den Hauptkategorien usw sind daher l ngst g ngige Praxis auf vielen gut gemachten Seiten Verst ndlichkeit Verst ndlic
181. n Such und Nutzungsstrate gien unterscheiden e Der disziplinierte Leser will sich in das Thema einlesen und liest meist linear Dieser Lesertyp ist der seltenste und von daher wenig exempla risch Eine Variante des disziplinierten Lesers ist der aktive Leser mit eigenen Strategien sich Wissen anzueignen wie beispielsweise mit Notizen oder Lesezeichen e Der undisziplinierte Leser oder wilde Bl tterer hat noch keine Vorstel lung dar ber wie lange er sich mit dem Text besch ftigen wird Er liest selektiv und sucht den schnellen Erfolg sprich viel Information in m g lichst wenig Zeit e Der Fachmann schl gt gezielt nach und sucht nach neuen oder tiefe ren Informationen Er hat konkrete Ziele und Erwartungen e Der Praktiker will haupts chlich die Theorie in die Praxis umsetzen Nutzungsanalyse Die Nutzungsanalyse beleuchtet die Situationen in denen eine technische Dokumentation benutzt wird den sogenannten Nutzungskontext Die Online Hilfe f r ein Steuerprogramm muss anders aussehen als die Online Hilfe f r einen Internet Shop Aus der Nutzungsanalyse lassen sich Nut zungsszenarien entwickeln die eine benuterfreundliche Online Hilfe unter st tzen sollte Je gr er aber die Einsatzm glichkeiten eines Produkts und je breiter die Zielgruppe gestreut ist desto schwieriger lassen sich Nut zungsszenarien entwickeln F r eine Online Hilfe l sst sich in erster N herung festhalten dass sich die Nutzer vor einem Bilds
182. n das XHTML Format aus der Liste Flare Formate Klicken Sie danach auf Abbilden Das Zielformat wird in die Liste MS Word Format bertragen Bilden Sie alle erforderlichen Absatzformate aufeinander ab und kli cken Sie auf Weiter Im Dialog Zeichenformate abbilden k nnen Sie festlegen in welche XHTML Zeichenformate die Word Zeichenfor mate beim Import konvertiert werden sollen W hlen Sie dazu zuerst das Word Format aus der Liste Word For mate und dann das XHTML Format aus der Liste Flare Formate Klicken Sie danach auf Abbilden Das Zielformat wird in die Liste MS Word Format bertragen Bilden Sie alle erforderlichen Zeichenfor mate aufeinander ab 19 a Beim FrameMaker Import klicken Sie auf Weiter Im Dialog X Ref Formate abbilden k nnen Sie festlegen in welche XHTML Querverweisformate die FrameMaker Querverweisformate beim Import konvertiert werden sollen 19 b W hlen Sie dazu zuerst das FrameMaker Format aus der Liste FrameMaker Formate und dann das XHTML Format aus der Liste Flare Formate 19 c Klicken Sie danach auf Abbilden Das Zielformat wird in die Liste FrameMaker Format bertragen Bilden Sie alle erforderlichen Querverweisformate aufeinander ab Klicken Sie auf Fertigstellen Die Ausgangsdatei wird importiert in Topics aufgeteilt und das Ergebnis im Dialog Importe Dokumente akzeptieren als Vorschau angezeigt Gehen Sie gegebenenfalls mit Abbrechen schrittweise zur ck um spezielle Einstellungen zu
183. n der Strukturleiste ffnet das Kontextmen 28 berblick ber die grafische Oberfl che 5 x Beispielprojekt flprj MadCap Flare 3 Ge Si x x SZ Datei Bearbeiten Ansicht Einf gen Format Projekt Generieren Extras Tabelle Fenster Hilfe 918399855 X S FS I EI bh Verdana gt 10pt Br ux m H 2 E z B er mm x Whatsnew htm 6 Welcome htm x Introduction htm a Ua Welchme M Edtor 7 om Ei SIE Ee De RB A What s New in Thi I EE E El E Sar TZ 7 Key Features IS Welcome E Tour of the Flare 4 lt h1 gt place your product tagline e D Quick Start Video ay w E Quick Start for Rot te ge The Welcome page can e D How to Create a H Einklappen or product logos or any other Best Practices Knoten und alle untergeordneten Knoten ausklappen information indudes Features es User Interface Eler w hlen 7 FAQs company product branding Informationsbaustein erstellen Formatklasse gt z ol text formatting This Block lt h1 gt fam style sheet associated select Stylesheet Links Block lt body gt gt Block lt html gt E oe Projektorganisat Topic Explorer Hilfe Inhaltsverz Bild 13 Strukturansicht im XML Editor mit Kontextmen Das Kontextmen f r ein spezielles XML Tag l sst sich auch direkt im Text ffnen Jedes XML Tag im Topic zeigt eine orangene Marke wenn es ange klickt wir
184. n und aktiviert werden die sogenannten Link B ndel oder Siehe auch Verweise Ein Vorteil dieser Link B ndelung kann darin bestehen dass vielen Lesern diese Art der Interaktion aus anderen Anwendungen vertraut ist Der Nach teil der r umlichen Trennung von Text und Links k nnte in einer reduzierten Bereitschaft der Leser liegen diesen Links zu folgen Diese reduzierte Bereitschaft l sst sich aber auch als Vorteil werten da so ein unkontrollier tes chaotisches Navigieren im Hypertext zum Teil verhindert oder reduziert wird Fazit f r Online Hilfen Eine Online Hilfe bietet durch die Pr sentation im Hilfefenster schon eine eingebaute Navigation die voreingestellt ist Das quasi standardisierte Hil fefenster legt f r die Online Hilfe schon wichtige Bereiche fest um die sich ein Hilfe Autor nicht mehr k mmern muss die Navigation im linken Bereich des Hilfefensters und die Symbolleiste Was hier angezeigt wird wird bei den Eigenschaften des Hilfefensters festgelegt Auch r ckw rtsgerichtete Orientierungshilfen sind zum gro en Teil als Eigenschaften des Hilfefen sters umgesetzt Bei einer HTMLHelp ist die Aufteilung im Hilfefenster und damit die Position der Navigation nicht ver nderbar Bei einer Browser basierten Hilfe l sst sich fast alles einstellen da es sich hier um HTML Frames handelt Die Art der Navigation legt der Hilfe Autor durch die Erfassung fest beispielsweise der zweistufige Index ber die Erfassung der
185. n und sich das Bild als sinnvollen Gesamtzusammenhang einzupr gen Gerade f r kontextsensitive Hilfen ist es nicht empfehlenswert Bildschirm abz ge zu verwenden Dies empfiehlt auch die ISO IEC 18019 Software and system engineering Guidelines for the design and preparation of user documentation for application software Schnell kann sich der Nutzer in den Fenstern verirren d h er klickt in der Online Hilfe auf ein Symbol im Bildschirmabzug und wundert sich dass nichts passiert Wenn es f r einen Hilfe Autor unerl sslich ist einen Bild schirmabzug zum besseren Verst ndnis anzubieten sollte er daf r sorgen dass der Bildschirmabzug auch als solcher erkennbar ist indem er bei spielsweise nur einen Ausschnitt pr sentiert oder die R nder ausfransen l sst Dynamische Bilder Dynamischer Bilder umfassen beispielsweise Videos oder Animationen und eignen sich besonders um Bewegungen Bewegungsbahnen Ver n derungen und zeitliche Abl ufe darzustellen Eine Sonderform der dynami schen Bilder sind interaktive Bilder Simulationen 78 Bilder Ein dynamisches Bild kann den Reiz erh hen der von einem Gegenstand oder Sachverhalt ausgeht Dabei kann die Visualisierung das Verst ndnis erleichtern und die Erinnerungsf higkeit unterst tzen Alle Arten der Visualisierung dienen der Transformation von Informationen in eine sinnvolle und benutzbare visuelle Darstellung die es dem Leser erlaubt die Ausgang
186. nden Dateien e Projekt Datei e Dateien mit Hilfe Themen oder Topics MN Datei mit Inhaltsverzeichnis e Datei mit Layout Vorlage e Je nach Hilfe Autorensystem weitere Steuerdateien z B Zieldefini tion Vorgabeseite Fachwort Datei e F r kontextsensitive Anbindung eine Header Datei und eine Aliasdatei f r die Zuordnung der Online Hilfe zu den Elementen oder Dialogen der grafischen Oberfl che 2 5 Online Hilfe generieren Erst das Kompilieren oder Generieren macht aus den einzelnen HTML Dateien und Steuerdateien in einem Hilfeprojekt eine ausf hrbare Online Hilfe Beim Kompilieren wird auch das Stichwortverzeichnis erzeugt und die Volltextsuche zur Online Hilfe gebunden ee an ez Ba A Erstinbetriebnanme des Notedook Bild 11 Generierung Generieren einer Online Hilfe DECHE DE 1 gt 0 a p dtaa 209 Voa zg Dueh ben Wei leg Suchen m Fire Fu J A re arh hn en TE x H ve d b 1 none Serum 24 Das Hilfe Autorensystem Flare Flare von Madcap Software ist das Hilfe Autorensystem mit dem die Umsetzung der typischen Elemente einer Online Hilfe demonstriert werden sollen Deswegen bietet dieses Kapitel eine kurze Einf hrung in die Organi sation von Flare Es ist in keiner Weise als Dokumentation gedacht Zur Kl rung von Detailfragen hilft die Online Hilfe von Flare weiter Flare ist in der dritten Version auf dem Markt und bietet neben vielen Neue rungen eine beeindruc
187. nden sind mit einem Topic verkn pft Die Aliasdatei verarbeitet dazu die Header Dateien im Flare Projekt Die Alias datei ist so eingestellt das sie die Identifier aller Header Dateien anzeigt Sie k nnen sich aber auch aus der Liste links oben im Dialog die Header Datei w hlen deren Identifier angezeigt werden sollen In der Tabelle links stehen alle Identifier der ausgew hlten Header Datei in der rechten Liste alle Topics im Projekt Sobald Sie die Zuordnung der Iden tifier zu den Oberfl chen Elementen mit den GUI Entwicklung abgestimmt haben k nnen Sie die Identifier mit den entsprechenden Topics verkn p fen 1 Um einen Identifier mit einem Topic zu verkn pfen w hlen Sie aus der Tabelle links den Identifier 2 Wahlen Sie in der rechten Liste das passende Topic 165 Die kontextsensitive Anbindung Klicken Sie auf Zuordnen um den Identifier mit dem Topic zu verkn p fen Der Dateiname des Topics wird beim verkn pften Identifier in die Liste bernommen W hlen Sie gegebenenfalls f r die Verkn pfung eine Skin mit Skin zuordnen aus wenn die kontextsensitiven Topics in einem anderen Hilfefenster z B ohne Navigation angezeigt werden sollen Auch diese Auswahl wird in die Liste der Identifier bernommen Wiederholen Sie die Schritte 1 4 f r alle kontextsensitiven Topics Speichern Sie die Aliasdatei mit dem Befehl Datei Speichern Neuen Identifier in die Aliasdatei eintragen Sie k nnen in die A
188. ndern den Lesefluss und damit die Suche nach dem Sinn Zu gro e oder unregelm ige Wortabst nde sind benutzerunfreundlich denn sie behindern ebenfalls den Lesefluss Sie entstehen vor allem bei unsach gem em Blocksatz einer zu geringen Zeichenzahl pro Zeile zu kurzer Zeile oder bei erzwungenem Blocksatz Ein zu geringer Zeilenabstand st rt fl ssiges Lesen Die Wortsilhouette wird durch die zu nahe Folgezeile gest rt und der n chste Zeilenanfang schlechter gefunden Bei langen Texten k nnen Einz ge der nach rechts versetzte Beginn der ersten Zeile eines Absatzes die Orientierung f r dern F r das Lesen am Bildschirm sind kurze Zeilen mit h chstens 55 60 Zeichen f r das bessere Verstehen geeignet Textauszeichnungen leiten das Auge zus tzlich beim Scannen einer Seite Fast schon eingeb rgert hat sich die fette Schrift f r die Auszeichnung von Oberfl chenelementen Unterstreichung hat sich ebenfalls schon fast eingeb rgert f r Links Solche Defacto Standards zu bernehmen erleich tert das Nutzen einer Online Hilfe denn der Nutzer muss weniger neue Konzepte lernen und kann sein Vorwissen nutzen Dagegen sollte kursive Schrift gar nicht oder nur f r einzelne W rter einge setzt werden da sie am Bildschirm verzerrt oder verschwommen darge 74 Sprache 5 3 5 4 stellt wird Auch Versalien Gro buchstaben f r berschriften oder zur Textauszeichnung sind eine schlechte Wahl Versa
189. nformat anlegen 1 W hlen Sie den Befehl Projekt Neues Tabellenformat Der Dialog Neues Tabellenformat einf gen ffnet sich W hlen Sie eine Vorlage z B f r ein Zeilenformat Geben Sie dem Tabellenformat einen Namen Best tigen Sie Ihre Einstellungen mit Einf gen Der Dialog schlie t sich und das Tabellenformat wird im Ordner Resources Tabellenfor mate angelegt und zum Bearbeiten ge ffnet 5 Im Register Allgemein k nnen Sie einstellen e AuBenrander der Tabelle F llung zwischen Zelleninhalt und Zellenrand e Ob der Zellenrand mit dem Tabellenrand verschmilzt oder nicht e Die Breite des Zeilenendes 66 Umsetzung mit Flare 4 5 5 6 In den weiteren Registern Zeilen Spalten Kopfzeile Fu zeile k n nen Sie ein Muster einstellen e Die Liste Muster zeigt die definierten Muster und ihre Wiederho lungsrate an Voreingestellt sind zwei Muster f r die Hintergrund farbe die sich jede Zeile abwechseln Sie k nnen ein neues Muster hinzuf gen oder das ausgew hlte l schen oder bearbeiten e Bei den Mustereigenschaften k nnen Sie das ausgew hlte Muster bearbeiten und beispielsweise die Wiederholungsrate oder die Hintergrundfarbe ndern 7 Speichern Sie das Tabellenformat mit Datei Speichern Tabellenformat zuweisen 1 Setzen Sie den Cursor in die Tabelle der Sie ein Tabellenformat zuweisen wollen 2 Wahlen Sie den Befehl Tabelle Tabelleneigenschaften Der Dialog Tabelleneigenschaften ffnet
190. nline Hilfe zu generieren gehen Sie folgenderma en vor 1 ffnen Sie die Projektorganisation 2 ffnen Sie den Ordner Zieldefinitionen 3 ffnen Sie die passende Zieldefinition mit einem Doppelklick siehe Abschnitt Wie alles zusammenkommt die Zieldefinition auf Seite 92 4 Weisen Sie im Register Basis das Start Topic zu Start Topic ist dasje nige Topic das angezeigt wird wenn sich die Hilfe kontextfrei z B ber das Hilfe Men ffnet W hlen Sie gegebenenfalls eine Skin aus W hlen Sie ein Inhaltsverzeichnis aus 44 Erste Schritte 7 Benennen Sie gegebenenfalls die Ausgabedatei und den Ausgabeord ner 8 W hlen Sie im Register Erweitert gegebenenfalls eine Vorgabeseite und die Glossare aus 9 Speichern Sie die Zieldefinition mit dem Befehl Datei Speichern 10 Klicken Sie mit der rechten Maustaste auf die Zieldefinition und w hlen Sie Generieren aus dem Kontextmen Die Online Hilfe wird generiert und im angegebenen Ordner abgelegt W hrend der Generierung informiert Sie eine Fortschrittsanzeige ber den aktuellen Stand der Generierung und ber Fehler Fortschritt bei der Generierung Ioj xj I I Meldungen Fehler Links in Ausgabedateien l sen aj Such Datenbank generieren Suchdatenbank f r Speichern vorbereiten Suchdaten Dateien speichern Abschlie ende Generierung der Ausgabe Default htm erstellt Ergebnis speichern Output generiert ind Se
191. ntiv f r Oberfl chenbeschrei bung Men Datei Umsetzung mit Flare Vieles aus diesem Kapitel wirkt sich auf ein konkretes Flare Projekt nur mit telbar aus so dass hier nur die generellen Aufgaben f r ein Topic an sich beschrieben sind wie Topic anlegen und Topic bearbeiten Wenn Sie mit Topic Klassen arbeiten k nnen Sie f r jede Topic Klasse eine Vorlage defi nieren und verwenden siehe Abschnitt Vorlagen auf Seite 67 Topic anlegen Um ein Topic anzulegen gehen Sie folgenderma en vor 1 Wechseln Sie in den Topic Explorer 2 Wahlen Sie im Topic Explorer den Ordner aus in das das neue Topic eingef gt werden soll 3 W hlen Sie den Befehl Projekt Neues Topic Der Dialog Neues Topic anlegen ffnet sich 4 W hlen Sie gegebenenfalls eine andere Vorlage f r das neue Topic aus siehe Abschnitt Vorlagen auf Seite 67 5 Pr fen Sie bei Ordner ob das Topic in diesem Ordner angelegt wer den soll W hlen Sie gegebenenfalls einen anderen 6 Geben Sie dem neuen Topic einen Dateinamen Bei Bedarf k nnen Sie auch schon die Erste berschrift eingeben und das passende Format zuweisen 8 Pr fen Sie bei Stylesheet ob das richtige Stylesheet ausgew hlt ist W hlen Sie gegebenenfalls ein anderes 9 Best tigen Sie Ihre Einstellungen mit Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob das Topic mit der ausgew hlten Vorlage erstellt werden soll 10 Best tigen
192. nur noch im System umher und versucht den berblick zur ckzugewinnen Lost in Hyperspace Eine Verirrung im System kann aber auch zuf llig zu n tzlichen Informationen und berraschenden Quer verbindungen f hren die letztlich in den aktuellen Lernprozess passen Mitnahmeeffekt Orientierungsproblem Das Orientierungsproblem und das damit eng zusammenh ngende Pro blem der kognitiven berlastung werden als bis heute ungel ste Probleme der Hypertext Technologie angesehen Ein Gro teil der Forschung ist der L sung dieser beiden Probleme gewidmet Das Orientierungsproblem l sst sich in mehrere Teilprobleme zerlegen Die Nutzer wissen nicht e wo genau in Relation zu den anderen Informationen des Hypertextes sie sich gerade befinden e wie sie zu einer bestimmten Information kommen von der sie vermu ten oder wissen dass sie im Hypertext enthalten ist 97 Navigation e wie sie am besten den Einstieg in den Hypertext finden sollen welches der optimale Startpunkt f r sie ist e wie sie zu einer bestimmten Stelle zur ckkommen die sie schon ein mal gesehen haben e welches der f r ihre Fragestellung optimale Weg durch den Hypertext ist e ob sie wirklich alle relevanten Informationen gesehen haben e wie umfangreich der Hypertext ist welche Informationen er enth lt e was sie an ihrer aktuellen Position tun oder wohin sie gehen k nnen Einige dieser Probleme lassen sich auch beim Lesen traditionelle
193. oder die Nutzer verursacht haben Gerade Fehlermeldungen sind oft kryptisch und unverst ndlich und lassen den Nutzer eines Produkts oftmals nur die M glichkeit auf OK zu klicken Hier bietet sich eine Online Hilfe an die Ursache und Handlungsm glich keiten aufzeigt Bei Meldungen h ngt die Erfassung und Verwaltung von Hilfetexten vom Programmiersystem und dem Programmierer ab sie k nnen in Ressource Dateien vorliegen oder aber auch als kontextsensitive Online Hilfe einge bunden werden Assistent Wizard Ein Assistent ist eine Software Funktion die Nutzer durch eine komplexe Folge von Handlungsschritten leitet Ein Assistent kann von den Nutzern oder einer Anwendung gestartet werden Ein Assistent bietet in der Regel mehrere Dialogschritte die nacheinander vom Nutzer abgearbeitet werden Viele Assistenten arbeiten mit eingebetteter Hilfe das bedeutet die Hilfe Information wird direkt im Dialog des Assistenten angezeigt 12 Arten von Online Hilfen 2 2 5 E Startassistent E 2 x Willkommen zu MadCap Flare V3 zz Was wollen Sie zuerst machen I Aktion B Ein neues Projekt starten Anleitung 6 Schritte zur Online Hilfe anschauen Diese Option ffnet den Neues Projekt Assistenten der Sie durch die Neues Projekt starten Basisschritte zum Erstellen eines neuen Flare Projektes f hrt Wenn Sie den Neues Projekt Assistenten mit Projekt aus MS Word Dateien erstellen Informationen gefu
194. ont Paivio A 1979 Imagery and verbal processes Hillsdale New Jersey Erlbaum Spool J Scanlon T Schroeder W Snyder C amp DeAngelo T 1999 Web Site Usability A Designers Guide San Francisco Morgan Kaufman Standford Encyclopedia of Philosophie Center for the Study of Language and Information Stanford University Stanford CA http plato stan ford edu tekom e V Hrsg 2004 Kriterien zur Beurteilung von Online Informatio nen Stuttgart Thissen Frank 2001 Screen Design Handbuch Effektiv informieren und kommunizieren mit Multimedia 2 Uberarb und erw Aufl Berlin Springer Wieser Verena 2004 Usability versus Design ein Widerspruch Theo rie und Praxis der Gestaltung von Websites Studien der Erlanger Buchwis senschaft VI Universitat Erlangen 188 Literatur Normen und Standards IEEE 1063 2001 Standard for Software User Documentation DIN EN ISO 6385 2004 05 Grunds tze der Ergonomie f r die Gestaltung von Arbeitssystemen ISO 6385 2004 Deutsche Fassung EN ISO 6385 2004 DIN EN ISO 9241 Ergonomische Anforderungen f r B rot tigkeiten mit Bildschirmger ten Teil 110 Grunds tze der Dialoggestaltung ersetzt den bisherigen Teil 10 Teil 11 Anforderungen an die Gebrauchstauglichkeit Teil 12 Informationsdarstellung Teil 171 Leitlinien f r die Zug nglichkeit von Software DIN EN ISO 13407 2000 Benutzer orientierte Gestaltung interaktiver Systeme DI
195. ormationen in einem Topic schich ten Die Informationen sind dann zwar im Topic vorhanden aber nicht auf den ersten Blick sichtbar Leser k nnen sich Details mit einem Klick auf das sensitive Element zus tzlich einblenden Eingeschobener Text 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic das den eingeschobenen Text erhalten soll Markieren Sie im Topic den Text der als sensitive Stelle Hotspot angezeigt werden soll W hlen Sie den Befehl Einf gen Erweiterter Text Der Dialog Erwei terbaren Text einf gen ffnet sich Der markierte Text steht schon in der Hotspot Liste Klicken Sie auf OK um den eingeschobenen Text einzuf gen Der Dia log schie t sich und zwei Paar eckige Klammern werden nebeneinan der an Stelle des markierten Textes im Topic eingef gt Das erste Klammerpaar enth lt den Text und ein T Symbol f r den Hotspot Everloren itl JR 7 Geben Sie im zweiten Klammerpaar den Text ein der nach einem Klick eingeblendet werden soll L schen Sie dabei die eckigen Klammern nicht Sie k nnen jederzeit den Text in den eckigen Klammern bearbeiten Speichern Sie das Topic mit dem Befehl Datei Speichern 137 Navigation Ausdruck einschlie en Ausdruck ausschlie en Ir Procedure 2 Overview information Er ist eingeschobener Text about this procedure or task Steps necessary to complete a task Step Step Step Final step
196. ptimierte Anforderungen zu formulieren Es gibt eine ganze Reihe anderer Einschr nkungen etwa f r Menschen mit Konzentrationsschw chen Eine logisch aufgebaute und leicht nachvoll ziehbare Navigation kann dann eine besondere Unterst tzung sein Ein weiteres Beispiel je nach Art der Einschr nkung k nnen auch blinkende Elemente zur v lligen Ablenkung von den Inhalten auf einer Seite f hren und zum Teil auch gesundheitliche Gefahren bedeuten Gesetzlicher Rahmen Am 1 Mai 2002 erhielt die Barrierefreiheit in Deutschland einen gesetzli chen Rahmen Mit dem Behindertengleichstellungsgesetz werden die Rechte behinderter Menschen entsprechend Artikel 3 Absatz 3 des Grund gesetzes Niemand darf wegen seiner Behinderung benachteiligt werden auch f r elektronische Informationsangebote wie das Web und grafische Programmoberflachen z B CD ROMs und DVDs geregelt Seit Juli 2002 ist in Deutschland die Barrierefreie Informationstechnik Ver ordnung BITV in Kraft Darin finden sich zahlreiche Anforderungen an die Barrierefreiheit Anlage 1 der BITV f hrt die zur Umsetzung der Rechtsver ordnung anzuwendenden Standards auf Diese sind in 14 Anforderungen mit Bedingungen gegliedert Die Bedingungen sind in die Priorit ten und Il klassifiziert Bei den Bedingungen handelt es sich um eine bersetzung der Web Con tent Accessibility Guidelines 1 0 aus dem Jahr 1999 Im Jahr 2004 hat das WSC die Web Content Accessibility Guidelines au
197. qua entstandene Schriften oft mit linearem Strich die keine Serifen aufweist Signalwort Normierter Begriff z B in Warnhinweisen Gefahr Warnung Vorsicht der nicht au erhalb des festgelegten Kontextes benutzt werden sollte Skin Legt das Aussehen des Hilfefensters fest Spationieren Vergr erter Zeichenabstand zwischen Buchstaben Symbol Icon Button Ikone Ein Symbol ist ein Piktogramm mit einer speziellen Bedeutung Ein Symbol kann auch sensitiv sein Tag XML Tag Auszeichnung von XML Elementen Textmenge Quantitativer Umfang eines Textes Textsorte Textart Texttyp Texte werden nach ihrer Zielrichtung unterschieden Eine Beschrei bung stellt einen Sachverhalt dar ein anleitender Text ist f r eine Handlungsanleitung sinnvoll Vergleiche auch Informationsart 184 Fachw rter Tooltip Bubble help Teil der Sekund r Assistenz Kurze Information zu einem Oberfl chen Element das bei berstreichen mit dem Mauszeiger angezeigt wird Topic Thema Knoten Logische Informationseinheit in einer Hilfe berstrahlung Darstellungsproblem des Bildschirms berstrahlung l sst beispiels weise schwarze Schrift auf hellem Hintergrund d nn und unscharf erscheinen Gleiches gilt f r die inverse Darstellung von wei er Schrift auf schwarzem Hintergrund Unicode Internationaler Standardzeichencode f r den internationalen Aus tausch von Dateien und deren Bearbeitung Unicode ber cksichtigt n
198. r ndert sich zu einem Kreuz Ziehen Sie das Bild mit gedr ckter rechter Maustaste zur gew nschten Gr e Filme und T ne Zum Einbinden von Filmen und Ton Sequenzen in Ihre Topics k nnen Sie die Zusatzprodukte von Madcap Software nutzen Mimic f r Filme Echo f r T ne 96 6 1 Navigation Traditionelle Texte sind linear organisiert Sie sollen durch die Aneinander reihung der Abschnitte in einer vorgegebenen Reihenfolge gelesen wer den d h von der ersten bis zur letzten Seite In nicht linearen Hypertexten haben Nutzer immer mehrere Lesealternativen sie k nnen w hlen wel ches Topic sie als n chstes lesen m chten Es gibt bei Hypertexten folglich keine fest vorgesehene Lesereihenfolge Bei Texten entspricht die physika lische Struktur die sequentielle Abfolge der Abschnitte nicht der logi schen Textstruktur die meist hierarchisch ist und Querverweise enth lt Das Hauptproblem bei Hypertexten oder Hypermedia Anwendungen ist die Orientierung im komplexen und vielf ltig vernetzten System von Informatio nen und damit die Navigation Oft wei ein Nutzer nicht mehr genau wie er berhaupt zu der aktuellen Seite gekommen ist oder wie er zu einer vorher betrachteten Seite zur ckkommt da er durch das Anklicken sehr vieler Links zahlreiche Ebenen des Systems durchwandert und immer mehr die Orientierung verloren hat In diesem Fall kann man nicht mehr von gezielter Suche sprechen sondern der Nutzer irrt
199. r die im Text vorkommenden Fachbe griffe und dar ber hinaus Verweise auf das Vorkommen des Begriffes im Text In Hypertexten gibt es die verschiedensten Arten dynamischer Fachwort verzeichnisse Beispielsweise kann sich durch Anklicken eines Begriffes im Hypertext ein Fenster Popup ffnen mit der Erkl rung zum jeweiligen Begriff Dar ber hinaus kann ein Fenster auch Hinweise auf andere Text stellen enthalten die f r den Begriff relevant sind Wird ein solcher Hinweis im Glossar angeklickt wird der entsprechende Text wiederum im Hilfefen ster angezeigt Das Glossar kann auch eine alphabetische Liste aller im Glossar enthalte nen Eintr ge sein Durch Anklicken eines Begriffs in dieser Liste wird die dazugeh rige Erkl rung direkt eingeblendet oder in einem speziellen Glos sarfenster angezeigt Orientierung durch Beschr nkung Orientierungsprobleme kann man auch reduzieren indem man die Komple xit t der Hypertext Struktur verringert Die Nutzer arbeiten dann mit Teil strukturen Auch hier bieten sich wieder verschiedene M glichkeiten an 102 Navigationshilfen Lesepfade Lesepfade Browse Sequenzen sind vom Autor ausgew hlte Wege durch das Hypertext Netz Sie dienen der Reduktion umfangreicher und komple xer Hypertext Strukturen auf interessierende oder zentrale Inhalte um neuen Lesern die Navigation zu erleichtern Man kann sich diese Lese pfade vorstellen als eine Art Superlink der nicht nur zwei Topics
200. r fest 8 Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und der Link wird in das Topic eingef gt 9 Speichern Sie das Topic mit dem Befehl Datei Speichern Querverweise Querverweise sind ebenfalls interne Spr nge und k nnen genauso verwen det werden wie Links Querverweise haben im Gegensatz zu Spr ngen den Vorteil dass man sie ber das Stylesheet automatisieren kann Sie k nnen das Querverweisformat cross reference so anlegen dass z B immer der aktuelle Titel des Ziel Topics als Ausgangsanker verwendet wird Bei der Generierung der Online Hilfe werden alle Querverweise aktualisiert Ein Sprung hingegen ist immer an den Text am Ausgangsanker gebunden den Sie markiert oder eingegeben haben Wenn sich der Kontext f r diesen Link ndert m ssen Sie den Link Text manuell nachbearbeiten 1 ffnen Sie den Topic Explorer 2 ffnen Sie mit einem Doppelklick das Topic das einen Querverweis erhalten soll 3 Markieren Sie im Topic den Text f r den Ausgangsanker Hotspot W hlen Sie den Befehl Einf gen Querverweis Der Dialog Querver weis einf gen ffnet sich 5 W hlen Sie bei Link zu die Quelle f r den Zielanker und w hlen Sie dann rechts im Dialog die passende Quelle aus 128 Umsetzung mit Flare 9 W hlen Sie bei Querverweis Eigenschaften eine Formatklasse vom Typ XREF mit der der Link formatiert werden soll Rechts daneben sehen Sie im XREF Format Be
201. r linearer B cher beobachten besonders dann wenn solche B cher schlecht struk turiert sind und ein mangelhaftes Inhalts oder Stichwortverzeichnis haben Auch die Leser eines Buches k nnen Probleme damit haben eine zuvor gelesene Stelle wiederzufinden oder abzusch tzen ob eine bestimmte Information im Text enthalten ist Andere Probleme sind eher Hypertext spezifisch beispielsweise werden die Leser eines linearen Textes kein Problem damit haben dass sie an einer bestimmten Stelle nicht wissen was sie als n chstes tun k nnen denn es gibt ja nur ein Vor und Zur ck Wenn sie das Buch durchgelesen haben wissen sie dass sie alle Seiten gelesen haben Auch die Sch tzung des Textumfangs bereitet bei traditionellen B chern keine Probleme w h rend die Leser eines Hypertextes dessen Umfang nicht so genau einsch t zen k nnen B cher enthalten im Gegensatz zu Hypertexten vielf ltige Orientierungshil fen die durch den h ufigen Umgang mit diesen fast schon automatisch genutzt werden k nnen Z B gibt die Seitenzahl den Lesern ebenso wie der Vergleich der Dicke von rechter und linker H lfte des aufgeschlagenen Buches Aufschluss ber die relative Position im Buch Der Umschlag eines schon gelesenen Buches neu abgenutzt Farbe usw erlaubt ein schnel les Auffinden zwischen anderen B chern und der unterschiedliche Aufbau der Seiten Fu noten Bilder berschriften usw erleichtert die Suche nach bestimmten Informationen inn
202. rd Datei e Von der inhalts logischen Seite aus betrachtet sollte ein Topic eine in sich abgeschlossene Informationseinheit sein Topics sollen klein genug sein um flexibel verwendet werden zu k nnen Andererseits d rfen sie nicht zu klein werden damit die Effizienz auf Auto ren und Leserseite nicht leidet Ein Topic sollte eine in sich geschlossene m glichst kontextunabh ngige Informationseinheit sein Wobei sich kon textunabh ngig hier auf andere Topics bezieht und nicht auf die zu beschreibende grafische Oberfl che Der m gliche Kontext wird durch Links auf weitere Topics hergestellt Einteilung in Klassen bedeutet Topics entsprechend ihres Inhalts nach bestimmten Kriterien in verschiedene Kategorien einzuteilen Eine Topic Klasse ist eine Menge von Topics der gleichen Art Zum Beispiel kann unterschieden werden ob der Inhalt eine Beschreibung oder eine Anleitung ist Dies entspricht im Wesentlichen den Informationsklassen beim Informa tionsdesign oder den Sequenzmustern des Funktionsdesigns In der Vergangenheit haben sich f r Online Hilfen folgende Informations oder Topic Klassen herausgebildet wie sie beispielsweise im Style Guide von Microsoft benannt werden e Konzept e Referenz e Prozedur e kontextsensitive Hilfe auf Dialog oder Elementebene und f r Meldun gen e Fachwort Wenn man sich diese Klassen genauer betrachtet wird deutlich dass Kon zept und Referenz sich auf die Oberklasse Beschreib
203. rden emp fiehlt sich ein anpassbares Layout 80 Umsetzung mit Flare 5 7 5 7 1 Umsetzung mit Flare In Flare gestalten Sie Ihr neues Layout mit Vorgabeseiten Stylesheets und der Skin In ein Topic k nnen Sie Bilder Filme oder Ton Sequenzen einf gen Vorgabeseiten Eine Vorgabeseite legt das generelle Aussehen der Hilfeseiten fest Hier k nnen Sie beispielsweise eine Kopf oder Fu zeile einf gen oder auch das Logo des Auftraggebers der Hilfe Eine Vorgabeseite muss den Hilfe seiten zugewiesen werden Sichtbar sind die Effekte der Vorgabeseite erst zum Generierungszeitpunkt Sie k nnen in einem Projekt mehrere Vorgabeseiten verwenden z B f r unterschiedliche Auftraggeber unterschiedliche Medien Online und Papier oder unterschiedliche Produkte die Sie in einem Projekt verwalten Proxies Speziell f r Vorgabeseiten wurden kleine Programme entwickelt die soge nannten Proxies Sie erzeugen zum Generierungszeitpunkt in jeder Hilfe seite der die Vorgabeseite zugewiesen wurde entsprechende Eintr ge Bestes Beispiel daf r ist der Body Proxy er steht stellvertretend f r den Inhalt einer Hilfeseite Zum Generierungszeitpunkt wird der Inhalt der Hilfe seite eingef gt Der Body Proxy definiert auch die Kopf und die Fu zeile Alles oberhalb des Body Proxy ist Kopfzeile alles unterhalb des Body Proxy ist Fu zeile Speziell f r Online Hilfen gibt es folgende Proxies e Breadcrumbs Proxy e Mini TOC
204. rdeon Elemente in DotNetHelp and WebHelp Optionen IT Inhaltsverzeichnis automatisch synchronisieren IT Topic Kommentare am Ende eines jeden Topics anzeigen nur WebHelp und WebHelp Plus u mi Bild 28 Neue Skin mit Voreinstellungen F r WebHelp Ausgaben k nnen Sie auch eine der vordefinierten Skins aus der Madcap Skin Galerie nutzen die Sie unter http madcapsoft ware com downloads utilities flareskingallery aspx herunterladen k nnen Skin bearbeiten Die lokale Symbolleiste im Skin Editor bietet f r jedes Hilfeformat eine Vor schau so dass Sie sich die Anderungen direkt ansehen k nnen Die Ein stellungen der ersten beiden Register Basis und Gr e gelten f r alle Hilfeformate Die Einstellungen des Registers Formate wirken sich nur auf Webhelp und Webhelp plus aus 91 Layout 5 7 4 Wie alles zusammenkommt die Zieldefinition Die Zieldefinition ist die Steuerdatei die festlegt welche Ausgabe generiert wird Sie k nnen Zieldefinitionen f r folgende Ausgabeformate erstellen e HTML Hilfe Endung chm e DotNet Hilfe e WebHelp Browser basierte Hilfe e Word Datei e FrameMaker Datei oder Buch Dabei k nnen Sie beliebig viele Zieldefinitionen f r ein Ausgabeformat erstellen beispielsweise f r Hilfen oder B cher f r unterschiedliche Ziel gruppen Eine Zieldefinition verbindet Layout Einstellungen und Inhalte mit dem Ausgabeformat z B e Vorgabeseite e Medienwahl im Stylesheet e Gloss
205. re unterst tzt das Browser basierte Hilfeformat Browser basierte Hilfen k nnen lokal auf den Rechnern der Nutzer ablau fen oder aber global im Netz liegen 18 Hilfeformate und Hilfefenster 5 MadCap Flare 3 1 i loj xj Datei Bearbeiten Ansicht Extras Fenster Hilfe E Topic A x D Hilfe Topic al a EI a Se Se x A Topic C1 2 e A Topic C2 MadCap Flare It Topic B 7 Topic D AM MadCap FlareTM is the most versatile Help authoring tool 7 MadCap Software Ge X d e EI Book B on the market In addition to generating an innovative new kind of cross browser cross platform Help MadCap Flare will generate a new help format designed specifically for NET application developers Microsoft s new help format for Windows Vista when released by Microsoft Microsoft HTML Help chm and printed documentation Tn addition to the groundbreaking new visual editor MadCap Flare is packed with features to make your job easier Customize your authoring environment Open 3 Fundstellen im Index E Inhaltsverzeichnis Tiel Ptad SQ Index 2 Suchen ee Favoriten Bild 8 Beispiel fur Browser basierte Hilfe Lokale Browser basierte Hilfe Lokale Browser basierte Hilfen sind plattform unabhangig und laufen lokal auf dem Rechner einer Nutzers Jeder Hersteller eines Hilfe Autorensy stems hat seine Variante der lokalen Browser basierten Hilfe im Programm die dann beispie
206. reich das aktuelle Format des XREF Tags Sie k nnen e Das Basis XREF Tag nutzen wie es ist e Eine eigene Formatklasse auf Basis des XREF Tags nutzen e Das eigene oder Basis XREF Tag mit Bearbeiten direkt im Dialog Querverweis Format bearbeiten bearbeiten e Mit Neu eine neue XREF Formatklasse anlegen Mit den weiteren Feldern im Dialog k nnen Sie das Verhalten des Links weiter festlegen e Bei Ziel Frame k nnen Sie einstellen ob das Ziel Topic im gleichen oder in einem anderen Fenster ge ffnet wird e Bei Bildschirm Tip k nnen Sie einen erkl renden Text Tooltip eingeben Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie t sich und der Link wird in das Topic eingef gt Speichern Sie das Topic mit dem Befehl Datei Speichern Text Popups Text Popups zeigen Erkl rungen in einem speziellen Textfenster hnlich den Tooltips an z B f r Fachw rter oder Abk rzungen 1 2 Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic das ein Text Popup erhal ten soll Markieren Sie im Topic den Text f r den Ausgangsanker Hotspot W hlen Sie den Befehl Einf gen Text Popup Der Dialog Text Popup einf gen ffnet sich Der markierte Text f r die sensitive Stelle steht schon im Feld Hotspot Text Tippen Sie im Feld Popup Text den Text ein der im Popup eingeblen det werden soll Klicken Sie auf OK um Ihre Einstellungen zu best tigen Der Dialog schlie
207. ren Liste l sen Liste umdrehen aus dem Kontextmen Auch einzelne Listen Elemente k nnen Sie ber die XML Tags manipulie ren 1 Klicken Sie mit der rechten Maustaste in der XML Strukturleiste auf das Tag eines Listenelements LI 2 Wahlen Sie den passenden Befehl Nach Oben Nach unten Nach Links aus dem Kontextmen Tabellen Zur Formatierung von Tabellen k nnen Sie eigene Tabellenformate anlegen und Ihren Tabellen zuweisen Tabellenformate werden in Tabellen Style sheets im Topic Explorer im Ordner Resources Stylesheets abgelegt 64 Umsetzung mit Flare Tabelle einf gen 1 2 on oa a Wechseln Sie in den Topic Explorer ffnen Sie mit einem Doppelklick das Topic in das Sie eine Tabelle einf gen wollen Positionieren Sie den Cursor im Topic an die Stelle an der Sie eine Tabelle einf gen wollen W hlen Sie den Befehl Tabelle Einf gen Tabelle Der Dialog Tabelle einf gen ffnet sich Geben Sie im Register Basis die Spaltenanzahl ein Geben Sie die Anzahl der Zeilen ein Geben Sie gegebenenfalls die Anzahl der Kopf und Fu zeilen ein Stellen Sie bei Auto Anpassen ein wie breit die Tabelle sein soll An Inhalte Die Spalten werden an ihrem Inhalt ausgerichtet An Fenster Die eingestellte Gr e des Fensters wird auf die Spalten aufgeteilt Feste Spaltenbreite Jede Spalte erh lt einen festen Wert f r ihre 9 10 11 Breite W hlen Sie die Ausrichtung der Tabel
208. richtigen Stelle Beides soll eine Online Hilfe bieten Die Online Hilfe selbst aber ist ein zus tzliches System in dem ein Nutzer sich erst orientieren und zurecht finden muss Wie also soll eine gute Online Hilfe aussehen Was ist sinnvoll und n tzlich f r den Leser Was erleichtert ihm die Orientierung und was hindert ihn daran Informationen schnell zu finden und aufzunehmen Wissenschaftler unterschiedlicher Fakult ten haben untersucht wie wir Informationen am Bildschirm erfassen aber auch wie wir uns dabei ablenken oder verwirren lassen Linguisten und speziell Computer Linguisten haben sich mit der Verst nd lichkeit von Text auseinander gesetzt Psychologen und P dagogen mit dem Verstehen von Text und dem Wissenserwerb Ergonomen und Kom munikationswissenschaftler mit der Pr sentation der Informationen Online Hilfen sind ein interdisziplin res Gebilde Dieses Buch tr gt die wichtigsten Grundlagen zur Erstellung von Online Hilfen zusammen Es will zeigen wie Online Hilfen optimiert erstellt werden k nnen und zwar optimiert f r die Leser Lesen am Bildschirm ist noch keine Kulturfertigkeit wie das Lesen von Papier Nat rlich haben wir uns mit der Verbreitung der Bildschirmarbeitspl tze und des Internets gewisserma Ben an das Lesen vom Bildschirm herangearbeitet Wir haben uns bei spielsweise Strategien antrainiert mit denen wir schneller in Texten am Bildschirm suchen Diese und weitere Strategien zu kennen und
209. rium f r ein gelungenes Layout Eine st ndige Neuorientierung ist f r die Lesbarkeit hinderlich Viele Wissenschaftler haben sich mit den Besonderheiten des Lesens und Verstehens von Texten vom Bildschirm aber auch mit einem unterst tzen den Layout auseinandergesetzt Gerade in den Anfangszeiten des Web wurden viele Usability Tests durchgef hrt die sich auf Online Hilfen ber tragen lassen Diese haben beispielsweise gezeigt dass Nutzer sich sehr leicht ablenken lassen von zu vielen unterschiedlichen Elementen auf einer Seite 72 Seitengestaltung 5 1 Seitengestaltung Ein Ma stab f r die Gestaltung einer Online Hilfe ist ihr Ausgabemedium der Computer Bildschirm Seine St rken und Schw chen in der Darstellung bestimmen die Gestaltung von Text und Grafik Im Vergleich zum Papier hat der Bildschirm eine vorgegebene Gr e und eine schlechtere Aufl sungs und Kontrastf higkeit Da die Bildschirme in der Regel breiter als hoch sind bietet sich das Querformat eher als Seitenformat an als das auf Papier verbreitete Hochformat Die passende Informationsmenge f r eine Hilfe Seite wird nicht nur vom Seitenformat bestimmt sondern auch vom Umgang der Nutzer mit einer Hilfe Usability Tests haben gezeigt dass Nutzer sich haupts chlich an der Bildschirmmitte orientieren und oft gar nicht merken dass die angezeigte Seite l nger ist und sich noch Informationen im nicht sichtbaren bl tterba ren Bereich befinden Glei
210. rmate werden in die Liste Formate f r neues Topic bertragen Klicken Sie auf Weiter Der n chste Dialog im Assistenten ffnet sich in dem Sie die Aufteilung der Ausgangsdatei in Topics abh ngig von der Menge steuern k nnen W hlen Sie die Option Leere Topics vermeiden Beim FrameMaker Import k nnen Sie noch festlegen wie mit Text und Bildern in veran kerten Rahmen umgegangen werden soll e Die Option Bilder f r verankerte Rahmen generieren erzeugt aus Text in verankerten Rahmen eigene Bilder 42 Erste Schritte 13 14 15 16 17 18 19 20 21 e Die Option Peserve Image Size erh lt im importierten Topic die Gr eneinstellung f r das Bild Das Bild selbst wird in der Original gr e in das Projekt importiert Klicken Sie auf Weiter Der Dialog Stylesheet ffnet sich in dem Sie einstellen ob Sie die Formate aus der Datei bernehmen wollen Beim Word Import empfiehlt es sich die Formate nicht beizubehalten und das vordefinierte Stylesheet zu bearbeiten Beim FrameMaker Import k nnen Sie mit Formatkonvertierung die Formate auch im Dialog Editor f r Formatimport vor der Konvertierung einzeln bear beiten Klicken Sie auf Weiter Im Dialog Absatzformate abbilden k nnen Sie festlegen in welche XHTML Absatzformate die Absatzformate der Ausgangsdatei beim Import konvertiert werden sollen W hlen Sie dazu zuerst das Word Format aus der Liste Word For mate und dan
211. rosoft aber seit ber zehn Jahren nur noch wartet und nicht mehr weiter entwickelt Obwohl es seit dieser Zeit von Microsoft immer wieder abgek ndigt wurde liegen noch viele Hilfen in diesem Format vor Die kontextsensitive Anbindung erfolgt ber die Winhelp API die in der Oberfl che des zu beschreibenden Pro dukts entsprechend angesteuert wird Das Winhelp Hilfefenster ist typischerweise ein Fenster mit zwei Anzeige bereichen einen f r die Symbolleiste und einen in dem alle Inhalte ange zeigt werden Quellformat sind eine oder mehrere Word Dateien 16 Hilfeformate und Hilfefenster 2 3 2 Hilfethemen WinHelp ie fei sicre Datei Bearbeiten Textmarke Optionen e Klicken Sie auf ein Buch und dann auf ffnen Oder klicken Sie auf eine Drucken andere Registerkarte Welcome to WinHelp 2 2 Wsicome to WinHelp 2000 The HTML Generation of Win Key Features of WinHelp 2000 WinHelp Extended with WinHelp 2000 This is WinHelp WinHelp Topic with Built in HTML Topic Graphic Files and Background Images Animated GIF files HTML Tables With Borders Java Applets Activex Controls Live World Wide Web Site Yahoo HTML tables with borders Live Web Site MS Technical Support Java Applets Technical Support Example local HTML ActiveX controls 2 HTML Popups Link to live World Wide Web sit Link to live World Wide Web sit Technical Support Drucken Abbrechen WinHelp 2000 extends the Window engine to provide full
212. rung f r ein Stahlwalz werk Dieses Kapitel erkl rt die zentralen Begriffe dieses Buchs und grenzt sie voneinander ab Um benutzerfreundliche Online Hilfen soll es in diesem Buch gehen Ist benutzerfreundlich auch gebrauchstauglich Was bedeu ten dann Ergonomie und oder Usability Sind Online Hilfen wirklich online Benutzerfreundlichkeit Usability amp Co Usability wird heute im deutschen Sprachgebrauch synonym f r Benutzer freundlichkeit Benutzungsfreundlichkeit Benutzbarkeit und Gebrauchs tauglichkeit verwendet Mittlerweile hat sich f r die Definition von Usability die Norm DIN EN ISO 9241 Ergonomische Anforderungen f r B rot tig keiten mit Bildschirmger ten mit ihren 17 Teilen durchgesetzt Teil 110 der DIN Norm definiert Usability als das Ausma in dem ein Pro dukt durch bestimmte Nutzer in einem bestimmten Nutzungskontext genutzt werden kann um bestimmte Ziele effektiv effizient und zufrieden stellend zu erreichen und meint damit dass Usability keine absolute Gr e ist Es muss immer auch ber cksichtigt werden f r wen zu wel chem Zweck und in welchem Kontext ein bestimmtes Produkt konzipiert wurde Der Nutzungskontext umfasst Faktoren die die Benutzerfreundlichkeit eines Produktes beeinflussen k nnen Dazu z hlen die Nutzer die Arbeits aufgabe die Arbeitsmittel und die Umgebung Nur selten kann man davon ausgehen dass alle Nutzer berwiegend ber gleiche Nutzerprofile hnli che Vork
213. rze bersicht ber die Produkt Funktionen e Produkt Anderungen gegen ber der Vorg ngerversion e Eine Beschreibung aller Oberfl chen Elemente z B Men s Befehle Schaltfl chen die f r die Nutzer direkt sichtbar und erreichbar sind 56 Fazit f r Online Hilfen e Eine Beschreibung aller Meldungen zu bekannten Problemen im Umgang mit dem Produkt in ausreichender Tiefe e Ausreichende Navigation wie z B Inhalts und Stichwortverzeichnis damit die Nutzer die angebotenen Informationen in der Online Hilfe fin den MN Eventuell eine Hilfe zur Online Hilfe wenn nicht schon vom Betriebs system gestellt wie z B von Windows oder wenn sich einzelne Funk tionen vom Defacto Standard unterscheiden e _Handlungsanleitungen die die Nutzer bei der Arbeit mit dem Produkt unterst tzen Sie sind problem und aufgabenorientiert es L sungsbeschreibungen FAQ f r die h ufigsten Probleme mit ihren Fehlerquellen Aus Ressourcenknappheit finden sich nicht immer alle Informationen in einer Online Hilfe Die letzten zwei Punkte aus dieser Liste k nnen sicher schon als K r verstanden werden Die ersten sechs Punkte sind allerdings die Mindestanforderung f r eine benutzerfreundliche Online Hilfe Informationen f r B cher In der Praxis werden aus Kostengr nden oft keine gedruckten Anleitungen Handb cher erstellt Alle Informationen m ssen deshalb in der Online Hilfe enthalten sein ohne R cksicht darauf ob sie
214. rzeichnis zuweisen Damit die Fachwortverzeichnisse in die Ausgabe bernommen werden m ssen Sie sie der Zieldefinition zuweisen Hierbei k nnen Sie f r eine Online Hilfe auch ausw hlen ob und wie die Fachw rter in den Topics behandelt werden sollen 1 Wechseln Sie in die Projektorganisation 2 ffnen Sie im Ordner Zieldefinitionen die passende Zieldefinition mit einem Doppelklick Die Zieldefinition ffnet sich 3 Stellen Sie im Register Glossar in der Liste Glossarbegriffe konver tieren ein wie Fachw rter behandelt werden sollen die Flare bei der Generierung der Ausgabe in den Topics findet Begriffe nicht konvertieren Die Fachw rter werden nicht konver tiert Diese Option eignet sich z B f r die Druckversion Nur markierte Begriffe Nur Fachw rter die Sie als Glossarbe konvertieren griff eingetragen haben werden ent sprechend der Eigenschaft Formatklasse konvertiert siehe Abschnitt Glossarbegriff Links auf Seite 131 Erstes Vorkommen eines Jedes erste Vorkommen eines Fach Begriffs konvertieren worts im Topic wird entsprechend der Eigenschaft Formatklasse konvertiert Alle Vorkommen eines Jedes Vorkommen eines Fachworts im Begriffs konvertieren Topic wird entsprechend der Eigen schaft Formatklasse konvertiert 124 Umsetzung mit Flare 6 6 4 4 Wahlen Sie gegebenenfalls eine Vorgabeseite f r das Fachwortver zeichnis aus 5 W hlen Sie in der Liste Glossar w hlen aus welche Fach
215. s Sie sich verlaufen oder verfahren werden Die Schnittstelle Stadt kann Ihre Orientierung nun unterst tzen oder sie behindern Die Stra enschilder k nnen auf den ersten Blick zu sehen oder eher versteckt sein Die Geb udenummerierung kann den Gepflogenheiten an Ihrem Heimatort entsprechen oder g nzlich anders organisiert sein Ein bahnstra en und Linksabbiege Regeln k nnen in Ihre geplante Richtung laufen oder Sie auf Umwege schicken Wichtige Geb ude k nnen ausge schildert sein oder auch nicht Sie werden unterschiedliche Wege und Strategien zur Orientierung auspro bieren Als letzte M glichkeit werden Sie nach dem Weg fragen Wahr scheinlich werden Sie dazu eher nach einer Touristen Information suchen und nicht nach einem Kaufhaus Wenn Sie eine Touristen Information fin den k nnen Sie immer noch entt uscht werden Sie m ssen lange anste hen die Fachkraft reichert die Wegbeschreibung mit der Stadtgeschichte an oder schickt Sie auf besonders sehenswerten Wegen um die halbe Stadt Je nach dem wie wichtig Ihr Termin ist werden Sie vielleicht sogar aufge ben und absagen Wenn Sie aber zur ck zu Ihrem Hotel wollen m ssen Sie durchhalten bis Sie Ihren Weg gefunden haben vii Diese kurze Geschichte zeigt dass man in unbekannten Umgebungen jederzeit an einen Punkt kommen kann an dem man nicht mehr weiter wei Dann ist nicht nur eine gute Navigation hilfreich sondern auch die passende Information an der
216. s Werk einschlie lich aller seiner Teile ist urheberrechtlich gesch tzt Jede Verwertung au erhalb der engen Grenzen des Urheberrechtsgesetzes ist ohne Zustimmung des Verlags unzul ssig und strafbar Das gilt insbesondere f r Vervielf ltigungen bersetzungen Mikroverfilmungen und die Einspeicherung und Verarbeitung in elektronischen Systemen Die Wiedergabe von Gebrauchsnamen Handelsnamen Warenbezeichnungen usw in diesem Werk berechtigt auch ohne besondere Kennzeichnung nicht zu der Annahme dass solche Namen im Sinne der Warenzeichen und Markenschutz Gesetzgebung als frei zu betrachten w ren und daher von jedermann benutzt werden d rften Umschlaggestaltung K nkelLopka Medienentwicklung Heidelberg Druck und buchbinderische Verarbeitung MercedesDruck Berlin Gedruckt auf s urefreiem und chlorfrei gebleichtem Papier Printed in Germany ISBN 978 3 8348 0424 2 Foreword Some would question the need for a new authoring tool in the documenta tion industry such as MadCap Flare To answer this question we need to look back at the beginnings of the industry In the early days of Microsoft Windows Microsoft developed a new docu mentation format for PC based documentation called WinHelp The Win Help format was a major breakthrough bringing rich software documentation to the PC desktop to support the new era of Microsoft Win dows applications However WinHelp was rather cryptic based on the RTF language and in the beginning
217. s zu importierende Topic keine XML Datei war ffnet sich die Abfrage ob es nach XML konvertiert werden soll Sie k nnen die Datei sofort konvertieren oder sp ter Wenn Sie sich f r einen sp teren Zeitpunkt entscheiden wird die Datei nach XML konver tiert wenn Sie sie das erste Mal ffnen Topic Eigenschaften Die Eigenschaften eines Topics k nnen Sie ber den Eigenschaftsdialog ndern Den Eigenschaftsdialog ffnen Sie wie folgt 1 2 Wechseln Sie in den Topic Explorer Klicken Sie mit der rechten Maustaste auf das Topic dessen Eigen schaftsdialog Sie ffnen wollen und w hlen Sie Eigenschaften aus dem Kontextmen Der Dialog Eigenschaften ffnet sich 61 Topics Die Eigenschaften eines Topics sind gegliedert in Basis Allgemeine Datei Eigenschaften Topic Eigenschaften Spezielle Eigenschaften des Topic Bedingter Text M gliche Bedingungen f r das Topic Bedingungen des Infor M gliche Bedingungen f r das Topic als mationsbausteins Informationsbaustein Sprache Verwendete Sprache im Topic SS Topic Tkel a O Topic Eigenschaf Standartisiert die erste Kopfzeile in Topic Topic Formatklasse e Bedingter Text Bedingungen des I Sprache Stylesheet Styles v ya Suchbar JV Integrieren Sie ein Thema bei der Erstellung der Yolltext Suchdatenbank Diese Eigenschaft ist lediglich f r Zieldefinitionen von DotNet Help WebHelp unc WebHelp Plus verf gbar Abbrechen Bild 23 Ei
218. sagen zur Zufriedenheit zu erhalten Zusammenfassend l sst sich sagen dass eine Online Hilfe benutzer freundlich ist wenn ein Nutzer seine Ziele zum Beispiel ein konkretes Pro blem zu l sen effektiv effizient und zufriedenstellend erreichen kann Je Benuizerfreundlichkeit Usability amp Co nach dem um was f r eine Online Hilfe es sich im einzelnen handelt m s sen nicht alle drei Kriterien gleich stark gewichtet sein Die Benutzerfreundlichkeit ist eng verbunden mit der Ergonomie Die DIN EN ISO 6385 2004 05 definiert Ergonomie als wissenschaftliche Disziplin und das systematische Studium die sich mit der Aufkl rung der Wechsel wirkungen zwischen menschlichen und anderen Elementen eines Systems befassen und der Berufszweig der die Theorie Prinzipien Daten und Methoden auf die System Gestaltung anwendet mit dem Ziel das Wohl befinden des Menschen und die Leistung des Gesamtsystems zu optimie ren W hrend man allgemein mit Ergonomie die Anpassung der Werkzeuge an den Bewegungs und Wahrnehmungsapparat des Menschen versteht z B K rperkr fte und Bewegungsr ume befasst sich die Software Ergonomie mit der Anpassung an die kognitiven und physischen F higkeiten bzw Eigenschaften des Menschen Ziel der Software Ergonomie ist die Anpas sung der Eigenschaften eines Dialogsystems an die psychischen Eigen schaften der damit arbeitenden Menschen Unzureichende Softwaregestaltung f hrt zu erh htem rger
219. schalten Um das Fenster wieder in den Editor zu integrieren ffnen Sie erneut das Kontextmen und w hlen Sie den Befehl Frei positionieren Ss Beispielprojekt flprj MadCap Flare 3 1 X Datei Bearbeiten Ansicht Einf gen Format Projekt Generieren Extras Tabelle Fenster Hilfe 21E3H9 8B EEXKB3x IST ET x verdana 14pt EB 7 DIE MI LA vele se z j SCHER D neuco A 3 E Speich Ctrl S F E Er o m 3 Si tS Stylesheet ee D O Inhalt Alle Dokuemente au er dieses Dokument schlie en 2 0 Contacting x Absatd Close Ctri F4 ger vor Information htm 9 5 Resources Andocken zii ER Topics ek H Automatisch ausblenden EN EQ Contacting _ Getting Started Using Frei positionieren oO Using sampl ih Introduction htm e Welcome htm This is a san en E C Whats new htm FictionSoft and atictional company called Megas oft Fictional r Software This project can be used to experiment with Flare or it can be used as a template to build a larger project Tip The Copyright below is implemented using the Flare Snippets feature To edit the copyright locate the snippet file Go to the Content Explorer and open the Resources folder There you will find a Snippets sub folder where all of the project snippets are stored Si Projektorganisation Topic Explorer gt Hilfe Suche Bild 17 Fen
220. schriftung Die passende und treffende Beschriftung der Benutzeroberfl che einer Software wie z B Titelzeile Labels f r Schaltfl chen Felder ist ein Teil eines Assistenz Systems zu dem auch eine Online Hilfe geh rt Je n her die Begriffe an der Begriffswelt der potentiellen Nutzer liegen desto einfa cher erfassbar wird die Software f r den Nutzer sein Je mehr die Beschrif tung und die Handlungsstr nge bekannte Aufgaben widerspiegeln desto eher findet sich der Nutzer mit der Software zurecht Die Beschriftung einer Software Oberfl che wird in sogenannten Res source Dateien erfasst und verwaltet das Format h ngt vom verwendeten Programmiersystem ab Tooltips Bubble Help Tooltips oder Bubble help bieten eine kurze Information zu einem Oberfla chen Element das beim Uberstreichen mit dem Mauszeiger angezeigt wird 11 Vom Input zum Output 2 2 3 2 2 4 Move To Bild 3 Beispiel f r Tooltip Auch die Texte f r die Tooltips werden in Ressource Dateien verwaltet Meldungen Der Begriff Meldungen fasst folgende Meldungstypen zusammen e Statusmeldungen sind alle Informationen in der Statusleiste oder in Fenstern ber den Zustand der Hard oder Software e R ckmeldungen sind Meldungen und Abfragen nach bestimmten rich tigen Eingaben oder Befehlen z B Sicherheitsabfragen oder Best ti gungen e Fehlermeldungen informieren Nutzer ber Fehler die das System
221. segeschwindigkeit bis zu 30 lang samer sein als von Papier Es findet kein genaues Lesen statt sondern eher ein Scannen wie es Jacob Nielsen nennt Das bedeutet dass auf der Suche nach relevanten Informationen das Auge sozusagen von Auf merker zu Aufmerker auf der Seite springt immer auf der Suche nach Ankerw rtern die zu der gesuchten Information f hren sollen Die Aufmerksamkeitspsychologie definiert das Scannen hnlich und unter scheidet zwei Aufmerksamkeitsarten die schwebende und die fokussierte Aufmerksamkeit Nutzer mit schwebender Aufmerksamkeit haben einen uneindeutigen Blick auf den Gesamtinhalt und scannen im Text nach den hervorstechendsten Stellen Dabei erfassen sie eine breite Menge an Infor mationen parallel etwa 50 des Inhalts eines Topics Ein Nutzer mit fokussierter Aufmerksamkeit nimmt nur die aktuell passen den Informationen wahr Alles St rende wird so weit wie m glich unter dr ckt oder ausgefiltert er skimmt ein Topic Die Verarbeitungskapazit t ist dabei im Vergleich zur schwebenden Aufmerksamkeit geringer und erfasst ca 30 des Gesamtinhaltes eines Topics Eine besonders abwechslungsreiche Pr sentation erfreut den ersten Lesertyp frustriert aber den zweiten Typ Der braucht eher ein gutes Stichwortverzeichnis oder die Volltextsuche Damit die Erwartungen der Nutzer gleichartige Informationen immer an der gleichen Stelle zu finden erf llt werden ist Konsistenz das wichtigste Krite
222. sehen sein Unmut kommt bei Nutzern auf wenn die kontextsensitive Hilfe irrelevante Informa tionen enth lt Oftmals ist es sinnvoll Optionen zu b ndeln und die Unter schiede in der Beschreibung herauszuarbeiten Dabei sollte die Beschreibung kurz und knapp sein Die kontextsensitive Hilfe auf Dialogebene beschreibt einen Dialog ein Fenster oder ein Register im Gesamten einschlie lich aller enthaltenen Elemente Sie beschreibt sowohl die einzelnen Elemente als auch deren Zusammenh nge und Abh ngigkeiten In Usability Tests hat sich gezeigt dass Nutzer nicht immer erkennen dass die Information schon zum Kontext passt da das Hilfefenster genauso aus sah wie bei der kontextfreien Hilfe Um Nutzern das Erkennen der kontext sensitiven Hilfe zu erleichtern sollte im Hilfefenster die Navigation ausgeblendet sein 159 Die kontextsensitive Anbindung 8 1 Rei verschlussprinzip Die Verkn pfung der Software mit der Hilfe funktioniert nach dem Rei ver schlussprinzip Die eine Seite des Rei verschlusses ist das Element in der grafischen Benutzeroberfl che die andere Seite ist das Topic das dieses Element beschreibt Als Rei verschluss fungieren entweder zwei Steuerdateien oder die URL des Topics je nach dem in welcher Programmier Umgebung und f r wel ches Zielsystem die Oberfl che entwickelt wurde Als Steuerdateien wer den dabei eine sogenannte Header Datei und eine Aliasdatei genutzt Header Datei Die Head
223. sensitiven Bereiche nicht erfassen Damit sind Image Maps un berwindbare Barrieren f r Menschen die Screen Reader benutzen Eleganter ist es ein Bild mit einer beschreibenden Seite zu verlinken Hier kann man dann auch ein Bild in einer anderen Gr e einbinden Sehbehinderte brauchen wichtige Bilder in kontrastreichen Farben Worte in Bildern wie beispielsweise Benennungen oder Zahlen m ssen in einer angemessenen Gr e dargestellt sein Tabellen hnlich wie bei Frames k nnen Screen Reader immer nur eine einzige Tabellenzelle erfassen Eine sinnvolle und systematische Anordnung der Zelleninhalte erleichtert das Lesen erheblich Tabellen sind f r einen Screen Reader gut strukturiert wenn die Tabellenzellen Zeile f r Zeile von links nach rechts gelesen werden k nnen und einen Sinn ergeben F r die Strukturierung des Layouts sollten Tabellen nicht verwendet wer den Sehbehinderte und blinde Nutzer erwarten strukturierte Informationen in einer Tabelle und profitieren nicht von einem tabellarischen Layout Tabellen sollten dar ber hinaus nicht zu umfangreich sein und in der Eigen schaft SUMMARY kurz zusammengefasst sein Links Wenn die Nutzer von Screen Readern oder Magnifiern wissen dass eine Seite viele Links hat folgen Sie dem ersten Link der einigerma en zur Information passt nach der sie suchen Je weniger Links auf einer Seite sind desto eher besteht die Chance dass ein Nutzer den richtigen Link auch findet
224. ser Mechanismus stellt einen Kompromiss dar zwischen den traditionellen Methoden der Volltext suche Auflistung der Suchergebnisse und der v llig freien Navigation in Hypertexten Hypertrails Im Gegensatz zu Lesepfaden die vorwiegend sehr einfache Verkn pfungs strukturen aufweisen sind Hypertrails Einschr nkungen der Hypertext Struktur die wesentlich komplexer sind Sie legen ber die Gesamtmenge der Topic Link Verkn pfung eine Teilstruktur die ein Thema hinsichtlich eines ganz bestimmten Aspektes strukturiert F r unterschiedliche Inhalte Zielgruppen und Aufgabenstellungen k nnen durch Hypertrails verschie dene aber dennoch strukturierte Sichten auf den Inhalt bereitgestellt wer den Mit Hypertrails k nnen multidimensionale Hypertexte aufgebaut werden bei denen sich die Informationen je nach Informationsbedarf unter schiedlich strukturieren lassen 103 Navigation 6 3 3 Filter Filter k nnen w hrend einer Hypertext Sitzung die eventuell sehr komplexe Topic Link Struktur auf aktuell interessierende Teil Strukturen einschr n ken Diese Filter k nnen z B als Suchanfrage wirksam werden Zeige alle Topics die Die Nutzer sehen dann im Browser nur die Filter relevanten Topics und Links und k nnen auch nur entlang dieser ausgew hlten Links navigieren Enth lt ein Hypertext typisierte Links dann k nnen Filter imple mentiert werden die nur bestimmte Link Typen anzeigen R ckw rtsgerichtete Orient
225. sinformation zu erschlie en Animationen sind dann sinnvoll wenn sie genau diese Information transportieren Bestimmte Infor mationen sind mit bewegten Bildern einfacher darzustellen als mit stati schen Bildern e berg nge Visualisierung verschiedener Zustands berg nge eines Systems z B abrupt oder stufenlos e Zeitverl ufe Visualisierung zeitbasierter Ph nomene e Mehrfachkodierung Visualisierung mehrerer Informationen auf glei chem Raum zum Beispiel durch Mouse over Effekte e T tigkeiten Visualisierung von nicht allt glichen Aufgaben Die Vielfalt dynamischer Darbietungen birgt allerding die Gefahr dass es zu einer Reiz berflutung kommt Dewegen sollten die Informationen die ber Bild und Sprache vermittelt werden sorgf ltig aufeinander abgestimmt sein In Online Hilfen kann gezielt eingesetzte Multimedia eine positiv moti vierende Wirkung haben Die technischen M glichkeiten k nnen aber auch dazu verf hren Medien mit zuviel dynamischen Elementen zu berladen und damit Hektik auszustrahlen Derart berfrachtete Online Hilfe lenkt vom eigentlichen Inhalt eher ab An dynamische Bilder stellen Usability Experten weitere Forderungen e Nutzer ber Gr e und Format einer Mediendatei informieren e Nutzer das Abspielen kontinuierlicher Mediendateien steuern lassen e Nutzer muss den Ton abschalten k nnen e Keine Abspielschleifen Formate F r die Bildschirmanzeige eignen sich nur spezielle Grafikformat
226. sogenannte Image Maps Bei einer Image Map werden Bereiche einer Grafik mit sensitiven Stellen versehen die dann zu der entsprechenden Erkl rung f hren Image Maps eignen sich beispielsweise als Wegweiser zu einem komplexen Produkt in einer kontextfreien Online Hilfe Auch Links zu anderen Medien wie beispielsweise einem Film oder einer Ton Sequenz sind inter hypertextuelle Links Extra hypertextuelle Links verbinden zwei Topics verschiedener Hyper texte Uber einen extra hypertextuellen Link kann z B e ein Topic einer anderen Online Hilfe aufgerufen werden e eine Web Seite aufgerufen werden e eine Datei ge ffnet werden z B PDF Auch bei diesen Links kann entweder der Inhalt des Hilfefensters gegen den neuen Inhalt ausgetauscht oder in einem Sekund r Fenster angezeigt werden Hypertext1 Hypertext2 Topic1 Lye Topic5 Be d Bild 32 Extra hypertextueller Link Sekund r Fenster haben den Vorteil dass die Nutzer alle Informationen am Bildschirm haben sie verlassen den Kontext des Ausgangsankers nicht Nachteil ist aber dass Sekund r Fenster genauso wie Popups rele vante Information des Ausgangs Topics berlagern k nnen und sich so der Vorteil aufhebt Au erdem hat man bei Usability Tests festgestellt dass sich Nutzer durch zu viele ge ffnete Fenster leicht verwirren lassen und sie auch nicht immer wissen wie sich das Popup oder Sekund r Fenster wie der schlie en l
227. sonderes Format Damit k nnen massive Barrieren f r Menschen mit Behinderungen errichtet werden da ihre assistiven Techno logien dann Auszeichnungen interpretieren und den Inhalt f r den Nutzer umsetzen die nichts mit dem Inhalt zu tun haben Nutzer setzen aus vielerlei Gr nden nicht immer die neuesten Versionen von Browsern und Programmen ein und oft werden einzelne Funktionen deaktiviert oder Plugins fehlen Die Gr nde sind dabei so vielf ltig wie die Nutzer Manche haben sich endlich an die komplexen Funktionen einer Software gew hnt andere haben mit M he pers nliche Einstellungen vor genommen Da l dt man sich nicht einfach schnell die neueste Version her unter Das Neueste und Beste l uft auch nicht auf jeder Hardware und unter jeder Betriebssystemversion Vielleicht h lt auch einfach Unkenntnis von einem Update ab Auch Sicherheits berlegungen spielen bei der Aktivierung von Plugins Skripten und Cookies eine wichtige Rolle Wenn man dar ber hinaus auf assistive Technologien angewiesen ist kann man auch nicht so ohne weiteres Software und Hardware wechseln Man che assistive Technologien laufen am besten mit bestimmten Versionen von bestimmten Browsern Und selbst wenn das Update des Browsers kostenlos ist passende Updates der assistiven Technologien sind nicht immer kostenfrei schnell genug verf gbar Manche Nutzer deaktivieren bestimmte Funktionen oder installieren Plugins nicht da gerade diese f r sie nicht nut
228. sondern eine ganze Topic Sequenz miteinander verkn pft Lesepfade haben sehr einfache Verkn pfungsmuster in der Regel sind sie linear aufgebaut Leser k nnen Lesepfade mit speziellen Schaltfl chen oder Befehlen aufru fen Innerhalb eines Lesepfads kann sich der Leser mit Vor oder Zur ck Schaltfl chen fortbewegen Dar ber hinaus sollte ein Lesepfad es den Lesern erlauben auch Links zu verfolgen die zu abseits liegenden Topics f hren Lesepfade sind keine Navigationshilfe im eigentlichen Sinn sondern machen die Navigation weitgehend berfl ssig Wie in traditionellen Texten gibt es bei Lesepfaden nur ein Vor und Zur ck ein linearer Weg durch einen nicht linearen Hypertext Obwohl Lesepfade das Orientierungspro blem beseitigen und Navigation berfl ssig machen bringen sie uns doch auf direktem Wege zur ck zu linearen Texten Wenn die L sung des Orien tierungsproblems darin liegt Linearit t zu schaffen dann stellt sich die Frage was vom nicht linearen Hypertext Konzept brigbleibt Individuelle und dynamisch erzeugte Pfade Neben Lesepfaden die vom Autor vordefiniert werden gibt es auch Pfade durch einen Hypertext die w hrend der Navigation angelegt werden In einer Datenbasis k nnen so die interessierenden Informationen gesam melt herausgefiltert assoziativ verkn pft und dauerhaft gespeichert wer den Pfade k nnen auch als eine Reaktion auf eine Suchanfrage der Nutzer vom System dynamisch erstellt werden Die
229. sst Links lassen sich auch unterscheiden hinsichtlich der Globalit t oder Loka lit t ihrer Ausgangs und Zielanker Ein globaler Anker bezeichnet ein gan zes Topic ein lokaler Anker eine bestimmte Region innerhalb eines Topics Lesezeichen Daraus ergeben sich vier m gliche Kombinationen von glo balen und lokalen Ausgangs oder Zielankern 107 Navigation Topic1 p Topic2 Topic Topic2 gt global global lokal lokal Topic1 Topic2 i a lokal global global lokal Bild 33 Globale und lokale Anker Lokale Zielanker lassen sich in einem Topic ber Lesezeichen Bookmark realisieren In den meisten F llen haben die Links einen lokalen Ausgangs und einen globalen Zielanker Diese Art der Verkn pfung ist man auch aus B chern gew hnt z B von Fu noten oder Verweisen auf nachfolgende oder vorhergehende Kapitel Die wichtigste Unterteilung die beliebig weiter differenziert werden kann ist die Unterteilung in referenzielle und typisierte Links Referenzielle Links Referenzielle Links oder auch assoziative Verkn pfungen sind die wesentli chen und typischen Verkn pfungen in Hypertexten Sie stellen Topics zueinander in Beziehung ohne dass die Art der Beziehung explizit spezifi ziert wird au er es besteht ein irgendwie gearteter Zusammenhang zwi schen den verlinkten Topics Aber auch referenziell
230. stellen Das RoboHelp Projekt wird nach Flare konvertiert und dort ge ffnet Zus tzlich zu den Dateien in einem neuen Projekt hat Flare folgende weitere Dateien beim Import ange legt Tabelle 6 Durch Import angelegte Dateien Datei Ort im Hilfeprojekt Topic Dateien Topic Explorer Content Bild Dateien Topic Explorer Resources Images Vorgabeseite Topic Explorer Resources MasterPages Sensitive Elemente Topic Explorer Resources CHMSupport FrameMaker oder Word Datei importieren Dieser Abschnitt beschreibt exemplarisch wie Sie vorhandene Inhalte in Flare einlesen k nnen Sowohl f r Word als auch f r FrameMaker Dateien gilt dass berfl s sige Inhalte vor dem Einlesen entfernt werden sollten Uberfl ssige Inhalte sind solche die sp ter mit Flare f r das Hilfesystem angelegt wer den oder die in einer Online Hilfe nicht mehr wichtig sind wie beispiels weise e Titelseite e _Inhaltsverzeichnis e Seitenzahlen e Fu Bzeilen e Kopfzeilen e Numerierung der berschriften e Bild und Tabellenunterschriften e Stichwortverzeichnis Wenn Sie Bilder in der Word oder FrameMaker Datei haben achten Sie darauf dass diese nicht per Referenz importiert sondern direkt in das Dokument einkopiert sind 41 Das Hilfe Autorensystem Flare Sie k nnen eine FrameMaker oder Word Datei sowohl in ein bestehendes Flare Projekt einlesen als auch mit dem Import ein neues Flare Proje
231. ster positionieren So k nnen Sie sich beispielsweise mehrere Topic Dateien nebeneinander anordnen und parallel bearbeiten 35 Das Hilfe Autorensystem Flare 3 5 Schaltfl chen zur Fenstersteuerung Sie k nnen auch alle anderen Fenster von Flare frei positionieren oder aus blenden Diese Fenster k nnen Sie ber folgende Schaltfl chen steuern Verschiebt das Fenster ffnet das Men zur Fenstersteuerung Vergr ert oder verkleinert das Fenster um 50 UO Blendet das Fenster aus und setzt daf r eine Schaltfl che in T den Randbereich des Hauptfensters von Flare Beim ber streichen dieser Fenster Schaltfl che wird das Fenster in seiner urspr nglichen Gr e eingeblendet Schlie t das Fenster Arbeitsumgebung einstellen Mit den Befehlen des Untermen s Fenster Einstellungen k nnen Sie die Einstellungen Ihrer Flare Arbeitsumgebung bearbeiten Flare Projekt Ein Flare Hilfeprojekt besteht aus mindestens folgenden Dateien e Projekt Datei Endung flpr e Dateien mit Hilfe Themen oder Topics Endung bim e Datei mit Inhaltsverzeichnis Endung fitoc im Projekt Name in der Ausgabe Toc xml e Datei mit Stichwortverzeichnis Name in der Ausgabe Index xml e Datei mit Layout Vorlage Endung Ces e Zieldefinition zur Steuerung der Ausgabe Endung fltar e Fur kontextsensitive Anbindung eine Header Datei Endung bi und eine Aliasdatei Endung flali f r die Zuordnung der Online Hilfe zu den Elemen
232. t Formatklassen f r Popups erweiter bare und ausklappbare Texte Wiederverwendbare Umfasst Formatklassen f r Informationsbau Inhalte steine Variablen und Proxies Generierte Inhalte Umfasst Formatklassen f r generierte Glos sare Inhalts und Stichwortverzeichnisse f r Druckversionen Steuerelemente Umfasst Formatklassen f r Schaltfl che oder Formulare in der Hilfe Sie k nnen in Ihrem Projekt beliebig viele Stylesheets anlegen und nutzen Sie k nnen aber auch ein Stylesheet f r unterschiedliche Medien nutzen Voreingestellt ist bei der Medienauswahl dass die Formatklassen f r beide Medien gelten Datentr ger voreingestellt Sie k nnen aber die Eigen schaften f r Papier Datentr ger print und Online Datentr ger non print unterschiedlich setzen Stylesheet importieren Ein bereits vorhandenes Stylesheet z B aus einem anderen Projekt k n nen Sie in Ihr aktuelles Projekt importieren Gehen Sie dazu folgenderma Ben vor 1 W hlen Sie den Befehl Projekt Neues Stylesheet Der Dialog Neues Stylesheet einf gen ffnet sich 2 Klicken Sie neben dem Feld Quelldatei auf die Schaltfl che mit den drei Punkten Der Dialog Offnen ffnet sich W hlen Sie im Dialog ffnen den Pfad und die Stylesheet Datei aus Klicken Sie auf ffnen Der Dialog schlie t sich und die ausgew hlte Stylesheet Datei wird in das Feld Quelldatei bernommen 84 Umsetzung mit Flare Geben Sie dem Styl
233. t direkt mit einem speziellen Oberfl chen Element einer Anwendung verkn pft ist beispielsweise Einleitung oder Konzeptinfor mation Laufweite Abstand der Buchstaben zueinander Wird der Abstand vergr ert spricht man von sperren wird dagegen verringert hei t das unter schneiden Man ver ndert die Laufweite aus Gestaltungs oder auch Platzgr nden leiste Bar Anzeigebereich in einem Fenster z B Symbolleiste Men leiste Lesbarkeit Sprachliche Gestaltung auch Semantik u a Wortwahl Satzbau eines Textes und ein Kriterium daf r wie einfach sich ein Text lesen verstehen und nachvollziehen l sst Lesepfad Browse Sequenz Sequentiell verkn pfte Topics zu einem bestimmten Thema in einer Online Hilfe Nutzer k nnen meist mit Schaltfl chen von einem Topic zum n chsten wechseln Leserlichkeit Ma f r die Lesegeschwindigkeit von Text Ein Text mit einer guten Leserlichkeit l sst sich schneller lesen als ein Text mit geringer Leser lichkeit Die Leserlichkeit h ngt mit der Gestaltung von Buchstaben Zeilen und Fl che direkt zusammen Typografie und ist ein Kriterium f r die Lesbarkeit eines Textes Lesezeichen Bookmark Einsprungspunkt auf einer Hilfeseite Link Hyperlink Sprung Verweis Sensitives Element das ein Verweis auf eine Zielstelle ist 181 Fachw rter Mausklick Eingabe mit der Maus Verb klicken Meldung Message Fehlermeldung Ausgaben des Produkts ber
234. te nicht genau bedienen k nnen e Sprach und Lernschwierigkeiten haben es Spracheingabe verwenden Nutzer bemerken beispielsweise h ufig einen unangek ndigter Fenster wechsel nicht Sie befinden sich dann pl tzlich nicht mehr auf einer Seite sondern in einem Popup ohne es zu merken Dies ist ein Problem f r Men schen die schlecht sehen blind sind oder kognitiv den automatischen Wechsel nicht nachvollziehen k nnen Bereits das ffnen eines Links in einem anderen Fenster Sekund r Fenster ohne Ank ndigung f hrt bei verschiedenen Nutzern zur Verwirrung Dann funktioniert die wichtige Funktion r ckw rts Bl ttern eines Browsers scheinbar pl tzlich nicht mehr Laufschriften und wechselnde Inhalte diktieren den Nutzern bestimmte Lesegeschwindigkeiten die sie aus verschiedensten Gr nden nicht errei chen Flackern und Blitzen durch Animationen k nnen bei empfindlichen Personen im Extremfall sogar epileptische Anf lle ausl sen Will man auf solche Effekte nicht verzichten sollte man den Nutzern unbedingt die M g lichkeit geben diese Animationen zu kontrollieren Wichtig f r die effektive Nutzbarkeit von Inhalten ist auch die F higkeit sich auf einer Seite oder in einer Online Hilfe zu orientieren Ein System in dem nicht navigiert werden kann weil es f r die Zugangstechnik ungeeig net ist oder auf Nutzer un bersichtlich und kompliziert wirkt versperrt den Weg zu allen weiteren Inhalten Mit Spezial Browsern k nne
235. ten oder Dialogen der grafischen Oberfl che Ein Flare Projekt kann mehr als ein Hilfeprojekt umfassen Sie k nnen in einem Flare Projekt beispielsweise mehrere Hilfen f r ein Produkt verwal ten oder die Hilfen und die Bedienungsanleitungen f r ein Produkt Das Flare Projekt bildet sozusagen den organisatorischen Rahmen und die Steuerm glichkeiten aus der Menge der Topics die richtigen f r die ange strebte Ausgabe zu filtern 36 Flare Projekt 3 5 1 3 5 2 3 5 3 Flare ist demnach nicht nur ein Hilfe Autorensystem sondern es bietet unter dem Stichwort Single Sourcing eine Vielzahl von Content Manage ment System CMS Funktionen an Das Ziel dieses Konzepts ist alle Inhalte in einer Quelle zu halten und in unterschiedlichen Ausgaben zusam menzustellen Zieldefinition Die Zieldefinition ist die zentrale Steuerdatei f r ein Ausgabeformat Alle Informationen die sp ter im Ausgabeformat zum Tragen kommen sollen m ssen mit der Zieldefinition verbunden sein siehe Abschnitt Wie alles zusammenkommt die Zieldefinition auf Seite 92 Eine Zieldefinition legt fest e Welches Ausgabeformat generiert wird Hilfeformat oder Druckver sion e Was in dieses Ausgabeformat generiert wird Inhalte bzw Topics e Wie dieses Ausgabeformat generiert wird Layout Eingabeformate Nicht jedes Hilfeprojekt beschreibt ein ganz neues Produkt und so ist es auch von Interesse bestehende Dokumente einlesen zu k nnen
236. ter mit dem Index Explorer Pr fen und erg nzen Sie das Inhaltsverzeichnis Generieren Sie die Online Hilfe und pr fen Sie das Ergebnis ndern Sie gegebenenfalls die Systemsprache und generieren Sie die Online Hilfe erneut Tastaturbelegung ndern F r kleine nderungen im Stichwort oder Inhaltsverzeichnis der Online Hilfe k nnen Sie die Tastaturbelegung auf die Zielsprache setzen Gehen Sie dazu wie folgt vor 1 W hlen Sie den Windows Befehl Start Einstellungen Systemsteue rung Regions und Sprachoptionen Der Dialog Regions und Sprachoptionen ffnet sich W hlen Sie im Register Sprachen die Schaltfl che Details Der Dialog Textdienste und Eingabesprachen ffnet sich Klicken Sie auf Hinzuf gen Der Dialog Eingabegebietsschema hin zuf gen ffnet sich W hlen Sie aus der Liste Tastaturlayout IME die passende Sprache Klicken Sie auf OK um Ihre Auswahl zu best tigen Der Dialog schlie t sich und die neue Tastaturbelegung wird in die Liste Instal lierte Dienste bernommen Klicken Sie auf OK um Ihre Auswahl zu best tigen Der Dialog Text dienste und Eingabesprachen schlie t sich Schlie en Sie den Dialog Regions und Sprachoptionen ebenfalls mit OK Die neue Tastaturbelegung finden Sie in der Task Leiste ber das Sprachsymbol in der Task Leiste k nnen Sie zwischen verschiede nen Tastaturbelegungen hin und herschalten und so Texte in einer Zielsprache eingeben 173 Fachw rter Das
237. ts Das Stylesheet legt die Absatz und Zeichenformate in Ihrem Hilfeprojekt fest Hier k nnen Sie beispielsweise die Standardschrift oder Farbe f r Ihre Absatzformate festlegen Ein Stylesheet muss den Hilfeseiten zugewiesen werden Sichtbar sind die Effekte der Absatzformate direkt in der Topic Datei Sie k nnen in einem Projekt mehrere Stylesheets verwenden z B f r unterschiedliche Auftraggeber unterschiedliche Medien Online und Papier oder unterschiedliche Produkte die Sie in einem Projekt verwalten Die Formatklassen sind unterschiedlichen Kategorien zugeordnet Uber diese Kategorien k nnen Sie die Sicht auf die Formatklassen einstellen Tabelle 9 Kategorien f r Formatklassen im Stylesheet Kategorie Bedeutung Topic Umfasst Formatklassen f r das gesamte Topic z B die HTML Klasse Absatz Umfasst Formatklassen f r Absatz z B der Standardabsatz P berschriften Umfasst Formatklassen f r berschriften z B die berschrift erster Ordnung H1 Zeichen Umfasst Formatklassen f r Zeichen z B fette Schrift oder dicktengleiche Schrift 83 Layout Tabelle 9 Kategorien f r Formatklassen im Stylesheet Kategorie Bedeutung Tabellen Umfasst Formatklassen f r Tabellen Listen Umfasst Formatklassen f r Listen z B num merierte oder nicht nummerierte Listen Verweise Umfasst Formatklassen f r aktive und besuchte Links Dynamische Effekte Umfass
238. tverzeichnis im Inhalt systema tisch suchen ber die Seitenangaben f r die einzelnen Stichw rter kann ein Leser gezielt auf bestimmte Textpassagen zugreifen ber ein Stichwortverzeichnis kann im Hypertext direkt auf die interessie renden Topics zugegriffen werden indem der entsprechende Eintrag ange klickt wird Das Stichwortverzeichnis bietet im Gegensatz zur Volltextsuche eine gerichtete Suche 101 Navigation 6 3 2 Allerdings darf man auch hierbei nicht vergessen dass die gerichtete Suche vom Autor gelenkt wird Begriffe die der Autor nicht ins Stichwort verzeichnis aufnimmt kann der Nutzer auch nicht finden Die Sprache des Autors muss mit der Sprache der Nutzer nicht zwangsl ufig bereinstim men Im Stichwortverzeichnis muss nicht jedes Topic vertreten sein Enthalten sollte es e Begriffe aus der Software Oberfl che e Begriffe aus dem Hilfesystem auch aus der Einf hrung den Sicher heitshinweisen und den anderen Anmerkungen Hinweisen e Permutierte Eintr ge also nicht nur Datei speichern sondern auch speichern Datei e Begriffe f r Einsteiger und fortgeschrittene Nutzer e Alltagssprachliche Begriffe die die Nutzer vermutlich verwenden e Synonyme die die Nutzer vermutlich verwenden z B Datei spei chern und Datei sichern Fachwortverzeichnis Jedes gute Fachbuch enth lt ein Fachwortverzeichnis Glossar Es liefert kurze Erkl rungen und Definitionen f
239. u Se Hilfe von Flare Ja unterst tzt 20 Hilfeformate und Hilfefenster Mac Hilfe X Mac OS Hilfe www apple com de Bild 9 Beispiel f r AppleHelp Server basierte Hilfeformate Server basierte Hilfeformate sind die Varianten der Browser basierten Hilfe die als Server Anwendung auf einem zentralen Rechner laufen Neue Funktionen in Tiger Informieren Sie sich ber die fantastischen neuen Funktionen Ihr Mac im berblick Intelligente Funktionen f r Arbeit und Spiel H ufig gestellte Fragen Herstellen einer Verbindung zum Internet Erinnern an Kennw rter Wechseln von Windows Infos ber Ihren Computer Weitere Themen Index Finden Sie gesuchte Themen schnell und einfach Wenn die Online Hilfe auf einem Server l uft k nnen zum einen mehrere Nutzer gleichzeitig auf die gleiche Fassung der Online Hilfe zugreifen Zum anderen k nnen die Inhalte leichter aktuell gehalten werden da nur eine Installation der Online Hilfe aktualisiert werden muss Folgende Hilfefor mate bieten eine Server basierte Variante an H JavaHelp 2 0 von Sun Microsystems OracleHelp for the Web von Oracle Inc WebHelp Pro von Adobe Inc WebHelp Plus von Madcap Software 21 Vom Input zum Output 2 3 4 E WidgetSoft s Digital Studio 5 x File Options lt gt A O D ales D Adding an instrumental si Editing a sound file C Importin
240. ufeinander bezieht Informationen sind in Informationsklassen aufgeteilt vgl Informationsarten in Information Mapping die funktionsorientierte Abschnitte enthalten Das Informationsdesign legt f nf Informationsklassen fest die inhaltlich gleiche Informationen mit derselben inneren Struktur beschreiben e Komponente e Objekt e Prozess e Vorgehensweise e Funktion Jede dieser Informationsklassen ist durch eine bestimmte Anzahl an Schl sselabschnitten in einer festgelegten Reihenfolge definiert Die Infor mationsklasse Vorgehensweise beispielsweise besteht aus den obligatori schen Schl sselabschnitten Titel und Vorgehensweise Optional k nnen zus tzlich die Abschnitte Voraussetzung Hinweis und Achtung eingef gt werden 52 Strukturierungsmethoden 4 2 4 Beim Informationsdesign werden zuerst Schl sselabschnitte auf Basis einer Analyse der vorhandenen Dokumente und der Anforderungen der Zielgruppe definiert Die einzelnen Abschnitte werden dann zu neuen ziel gruppenspezifischen Dokumenten zusammengefasst Danach werden die neu zusammengestellten Dokumente nach gemeinsamen inhaltlichen Merkmalen analysiert um sie einer Informationsklasse zuzuordnen Textsorten Unabh ngig ob linear oder vernetzt haben sich in technischen Dokumen ten zwei Textsorten herausgebildet die auch mit den beschriebenen Struk turierungsmethoden bereinstimmen e Beschreibung e Anleitung Beschreibung Beschreibende
241. ung zur ckf hren las sen und damit eine Unterklasse sind Die kontextsensitiven Topics lassen sich auf die Referenz zur ckf hren Prozedur ist nur ein anderer Name f r eine Anleitung Auch DITA kennt hnliche Topic Klassen DITA ist ein XML Standard f r Topic orientiertes strukturiertes Arbeiten 54 Fazit f r Online Hilfen 4 3 1 4 3 2 4 3 3 4 3 4 4 4 Konzept Topics Konzept Topics enthalten Einstiegs und berblicksinformationen wie bei spielsweise Funktions bersichten Prozessbeschreibungen oder Delta beschreibungen zur Vorg nger Version Konzept Topics enthalten Hinter grund Informationen die zum Verstehen der Prozeduren erforderlich sind Referenz Topics Referenz Topics sind quasi das Online Nachschlagewerk Sie beschreiben zum einen die grafische Benutzeroberfl che zum anderen beispielsweise Teile einer Programmiersprache oder schnittstelle Der Zweck des Refe renz Topics bestimmt den Einsatz von Text und Bildern Prozedur Topics Ein Prozedur Topic enth lt die Schritte die erforderlich sind um eine Auf gabe zu l sen oder ein Ziel zu erreichen Prozedur Topics sollten nur die notwendigen Handlungsschritte enthalten Sie dienen nicht dazu alle Infor mationen zu einer Aufgabe zu beschreiben Prozeduren sollten nach einem einheitlichen Schema aufgebaut sein Die Reihenfolge der einzelnen Handlungsschritte orientiert sich an der zeitli chen Abfolge Wenn sichtbar sollte zu jedem Handl
242. ungsschritt das Feed back des Produkts beschrieben sein z B Offnen eines Dialogs oder Meldung Zus tzliche Informationen alternative Wege oder verwandte Themen k n nen Leser ber Links oder Link B ndel finden siehe Kapitel Navigation auf Seite 97 Fachwort Topics Ein einfaches Beispiel f r ein Topic ist die Erkl rung eines Fachworts Wenn eine Fachworterkl rung als eigenst ndiges Topic organisiert ist kann es an allen Stellen an denen das Fachwort vorkommt wieder ver wendet werden Fazit f r Online Hilfen Eine Online Hilfe soll Nutzer bei der Arbeit mit einem Produkt z B der Software unterst tzen Sie soll Nutzern die Informationen bieten die sie zum schnellen und sicheren Durchf hren ihrer Aufgaben brauchen Auch wenn es in der Praxis oft anders aussieht kann eine Online Hilfe ein Handbuch nicht ersetzen Im Idealfall erg nzt eine Online Hilfe ein Hand buch um die Beschreibung der grafischen Oberfl che und um Handlungs anleitungen so dass sich die Informationen auf beiden Medien in sinnvoller 55 Topics 4 4 1 Weise berlappen Gleichzeitig bietet eine Online Hilfe durch die kontext sensitive Anbindung einen direkten Zugang zum Produkt Dokumentationsstruktur festlegen Zu den ersten Schritten hin zu einer Topic Aufteilung geh ren die Informati onsanalyse und die Entscheidung wie die Informationen erstellt und ver waltet werden sollen Dazu gibt es zwei unterschiedliche Vorgeh
243. unktion Ein Bitte hier klicken in mehrfacher Ausf hrung auch f r ein einfaches Symbol ist nicht hilfreich Vielmehr m ssen Alternativ texte f r Bilder e Die Funktion des Bildes erkl ren wenn es gleichzeitig ein Link ist e Das Bild knapp beschreiben damit der Nutzer die Wichtigkeit ein sch tzen kann Nicht zuletzt weil ihnen schon viele unn tze Bilder begegnet sind schal ten viele Screen Reader und Magnifier Nutzer die Bildanzeige aus Um eine erste Einsch tzung der Barrierefreiheit zu bekommen empfiehlt sich ein einfacher Test mit dem Browser In den Einstellungen von Standard Browsern kann man die Anzeige der Bilder ausschalten Wenn sich Seiten auch ohne Bilder ohne Informationsverlust lesen lassen k nnen diese auch blinde und sehbehinderte Menschen nutzen Manche Blinde verwenden den zeilenorientierten Lynx Browser der Bilder gar nicht erst l dt Aber auch die Microsoft Netscape und Opera Browser werden oft eingesetzt In allen F llen k nnen Bilder nur anhand des Alter 152 Fazit f r Online Hilfe 7 3 3 73 4 nativtextes gelesen werden Wenn dieser Alternativtext fehlt oder nicht aus sagekr ftig genug ist l sst sich schnell erkennen ob die Navigation auf der Seite schwierig oder gar unm glich wird Erg nzend zur allgemeinen Barriere Bild gibt es Image Maps die nur mit der Maus bedienbar sind Der Screen Reader erfasst zwar das Bild als sol ches kann aber die verschiedenen
244. ustern die selbst wieder aus einer begrenzten Anzahl funktionaler Einheiten bestehen Ein Informationspro dukt darf nur ganz bestimmte Sequenzmuster enthalten Funktionale Einheiten k nnen Zielangaben Voraussetzungen Handlungs aufforderungen und Ergebnisse sein aber auch Grundtext und Querver weis Das Funktionsdesign ist nicht nur eine Strukturierungsmethode sondern auch eine Schreibtechnik zu jeder funktionalen Einheit sind For mulierungs und Gestaltungsregeln festgelegt Welche funktionalen Einhei ten in welcher Reihenfolge auftreten d rfen ist in den Sequenzmustern definiert Das Sequenzmuster Handlungsanleitung beispielsweise ist so festgelegt dass es mit einer Zielangabe beginnen muss der optional die funktionale Einheit Voraussetzung und das Sequenzmuster Warnhinweis folgen k nnen Daran schlie t sich die funktionale Einheit Handlungsaufforde rung an der bei Bedarf die funktionale Einheit Resultat folgen kann Das bedeutet dass die funktionalen Einheiten in der Textstruktur vordefiniert sind die typischerweise hintereinander stehen Diese Strukturierungsmethode f rdert die Konsistenz beim Schreiben Auf der untersten Ebene des Funktionsdesigns sind zus tzlich Auszeichnungs elemente vorgesehen die einzelne W rter oder Phrasen markieren Informationsdesign Das Informationsdesign ist eine firmenspezifische Entwicklung die Infor mation Mapping und Funktionsdesign systematisch a
245. verzeichnisses e Geringe Gliederungstiefe e Eindeutige Formulierung der Eintr ge e Aufmerker sprachlich oder Symbole Aufmerker k nnen sprachlicher oder grafischer Art sein Die Leser sollten sich schon an den Eintr gen im Inhaltsverzeichnis orientieren k nnen wel che Topic Klasse sie erwartet Beispielsweise k nnen Topics mit Hand lungsanleitungen immer mit einem Verb enden oder beginnen um die Handlung zu verdeutlichen Datei speichern oder Speichern von Dateien Die Aufz hlung der Handlungsschritte 1 2 3 usw l sst sich auch mit einem entsprechenden Symbol verdeutlichen das im Inhaltsverzeichnis den entsprechenden Topics mit Handlungsanleitungen vorangestellt wird Eine besondere Art von Inhaltsverzeichnis sind die sogenannten Orientie rungspfade direkt im Topic beispielsweise als Pfad dargestellt Sie dienen dazu umfangreiche Hypertext Strukturen auf ein berschaubares Ma zu reduzieren und zeigen sowohl die nahe als auch die weitere Umgebung Im Amerikanischen werden Orientierungspfade als breadcrumbs bezeich net eine Metapher zur Kr melspur von H nsel und Gretel Hilfreich in einer umfangreichen Online Hilfe ist auch die Synchronisie rung der Topics mit dem Inhaltsverzeichnis Uber Links gefundene Topics werden dabei im Inhaltsverzeichnis markiert und verdeutlichen damit eben falls den n heren und weiteren Kontext in dem das Topic steht Stichwortverzeichnis In B chern kann ein Leser ber ein Stichwor
246. wenn Sie beispiels weise mehrere Sprachen in einem Flare Projekt verwalten Klicken Sie auf Weiter Der Dialog Projektvorlage w hlen ffnet sich W hlen Sie gegebenenfalls eine eigene Vorlage aus oder akzeptieren Sie die Voreinstellung und klicken auf Weiter Der Dialog Prim re Ziel definition w hlen ffnet sich W hlen Sie das Ausgabeformat das als Voreinstellung bei der Gene rierung dienen soll Klicken Sie auf Fertigstellen Das neue Flare Projekt wird angelegt mit folgenden Dateien Tabelle 5 Dateien im neuen Flare Projekt Datei Name Ort im Hilfeprojekt Topic Datei Topic htm Topic Explorer Content Stylesheet Styles css Topic Explorer Resources Stylesheets kontextsensiti MyAliasFile Projektorganisation Erweitert ve Anbindung MyHeaderFile h Bedingungen Default Projektorganisation Beding ter Text Kopien MyDestination Projektorganisation Kopier ziele Glossar MyGlossary Projektorganisation Glossare Skin Default Projektorganisation Skins 39 Das Hilfe Autorensystem Flare Tabelle 5 Dateien im neuen Flare Projekt Datei Name Ort im Hilfeprojekt Zieldefinition MyDotNetHelp Projektorganisation Zieldefi MyFramemaker nitionen MyHtmlhelp MyMsWord MyWenHelp MyWebHelpPlus Inhaltsver Master Haupt Projektorganisation Inhalts zeichnis verzeichnisse Variablen Set MyVariables Projektorganisation Varia blen Vorgangerprojekt i
247. wortver zeichnisse Sie in die Ausgabe aufnehmen wollen 6 Speichern Sie die Zieldefinition mit dem Befehl Datei Speichern Lesepfade Lesepfade werden in der generierten Online Hilfe abh ngig vom Hilfefor mat dargestellt HTMLHelp Letzter Eintrag im Inhaltsverzeichnis Durch diese Art der Umsetzung muss keine zus tzliche Bibliothek mit der Online Hilfe ausgeliefert werden WebHelp Eigene Register in der Navigation der Online Hilfe DotNetHelp Eigene Register in der Navigation der Online Hilfe Lesepfad anlegen 1 2 Wechseln Sie in die Projektorganisation W hlen Sie den Befehl Projekt Erweitert Neuer Lesepfad Der Dia log Lesepfad einf gen ffnet sich W hlen Sie gegebenenfalls eine andere Vorlage f r den Lesepfad aus Geben Sie dem Lesepfad einen Namen Klicken Sie auf Einf gen Der Dialog schlie t sich und es ffnet sich die Abfrage ob der Lesepfad mit der ausgew hlten Vorlage erstellt werden soll Best tigen Sie die Abfrage mit OK Der Dialog schlie t sich und Flare legt den neuen Lesepfad in der Projektorganisation im Ordner Erwei tert an Knotenzeichen B Die Datei mit dem Lesepfad hat die Endung flbrs Einen Lesepfad k nnen Sie genauso wie ein Inhaltsverzeichnis bearbeiten siehe Abschnitt Inhaltsverzeichnis bearbeiten auf Seite 118 125 Navigation Lesepfad f r Online Hilfe aktivieren Lesepfade geh ren nicht zur Grundausstattung eines Hilfefensters Deswe gen m ssen Sie
248. ystemen Im Kontext der Mensch Computer Interaktion L beck Schmidt R mhild 187 Literatur Kr mker Heidi 2007 Usability Stand der Forschung In J Hennig und M Tjarks Sobhani Hrsg Usability und technische Dokumentation L beck Schmidt R mhild Krug Steve 2002 Don t make me think Web Usability das intuitive Web Ubers aus dem Amerik von J rgen Dubau Bonn Mitp Verlag Lehrndorfer Anne 1999 Zielgruppengerechtes Schreiben In J Hennig und M Tjarks Sobhani Hrsg Verst ndlichkeit und Nutzungsfreundlichkeit von technischer Dokumentation L beck Schmidt R mhild Ley Martin 2005 Kontrollierte Textstrukturen Ein linguistischens Infor mationsmodell f r die technische Kommunikation Inaugural Dissertation Justus Liebieg Ubiversitat Gie en Mohs C Naumann A amp Kindsm ller M 2007 Mensch Technik Inter aktion intuitiv erwartungskonform oder vertraut in MMI Interaktiv Nr 13 Muthig J und Sch flein Armbruster R 2000 Funktionsdesign Eine universelle und flexible Standardisierungstechnik In W Kurz und B Wal lin Felkner Hrsg Praxishandbuch Technische Dokumentation Loseblatt werk Augsburg WEKA Nielsen Jacob 2001 Designing Web Usability Erfolg des Einfachen 2 berarb Auflage M nchen Markt Technik Pernice K amp Nielsen J 2001 Beyond ALT Text Making the Web Easy to Use for Users with Disabilities Norman Nielsen Group Frem
249. zbar sind Durch Nichtbeachtung von Standards berauben sich Designer und Autoren der M glichkeit formale Pr fprogramme einzusetzen die bei der Fehlersu 149 Barrierefreiheit 7 3 7 3 1 che sehr hilfreich sein k nnen Dazu bietet beispielsweise das W3C einen kostenfreien Validierungs Service an CSS http jigsaw w3 org css validator XHTML http validator w3 org Fazit fur Online Hilfe Das Gesetz gilt zwar f r das Internet aber einige innovative Softwareanbie ter haben auch jetzt schon das Ziel der barrierefreien Online Hilfe vor Augen Sie vermeiden Sonderl sungen f r behinderte Menschen und bie ten vielmehr eine L sung f r alle Nutzer gleicherma en an und das mit geringem Zusatzaufwand In Zeiten in denen die Menschen immer lter werden und eine lange Lebenszeit aktiv sind wollen auch sehbehinderte und blinde Menschen am Bildschirm Online Hilfen gut und gerne lesen Gerade Blinde und Geh r lose sind auf eine gut Hilfefunktion angewiesen Barrierefreie Informationstechnik sollte so gestaltet sein dass sie jeder nut zen kann beispielweise indem sie andere Ein und Ausgabeger te als Bild schirm und Maus bandbreitenbegrenzte Zug nge oder situative Einschr nkungen bei mobilen Anwendern unterst tzt Dies ist nur selten der Fall wie Jacob Nielsen mit Studien belegt Bei einem Vergleich zwi schen blinden stark sehbehinderten und sehenden Nutzern waren die sehenden Nutzer beim L sen einer Auf

Download Pdf Manuals

Related Search

1ad1281d8a264d55836aceb0028df981

Contents

Download Pdf Manuals

Related Search

Related Contents