Styleguide: Beschreibung der Oberfläche: Unterschied zwischen den Versionen

Aus Mauve System3 Handbuch
Zur Navigation springen Zur Suche springen
Zeile 22: Zeile 22:
  
 
=Einfache Darstellung=
 
=Einfache Darstellung=
 +
 +
Die Abbildung des Oberflächenelements wird als erstes Element eingetragen:
 +
 +
<code><nowiki>
 +
[[Bild:Abbildung.png|right]]
 +
</nowiki></code>
 +
 +
==Einleitendes Element==
 +
 +
Jeder Oberflächenartikel beginnt mit einem einleitenden Text. Dieser umfasst:
 +
* Eine Ein-Satz-Beschreibung der Funktion des Dialogs
 +
* Wie man zu diesem Dialog gelangt. Wird dazu der Menüpfad angegeben, so wird dieser fett formatiert, die einzelnen Menüebenen werden durch Schrägstricht getrennt, z.B.
 +
Hauptmenü/Menü1/Menü2.
 +
<code><nowiki>
 +
'''Hauptmenü/Menü1/Menü2'''
 +
</nowiki></code>
 +
* Wenn das Oberflächenelement nur zur Verfügung steht, wenn ein bestimmtes Modul freigeschaltet ist, muss das erwähnt werden. Dazu ist das Modul zu verlinken:
 +
<code><nowiki>
 +
Dieser Dialog steht nur zur Verfügung, wenn [[Modul]] freigeschaltet ist.
 +
</nowiki></code>
 +
 +
==Doku der einzelnen Oberflächenelemente==
 +
 +
Links neben den Abbildungen werden die einzelnen Oberflächenelemente als Aufzählungsliste dokumentiert, z.B:
 +
 +
* '''Groupbox''' Beschreibung der Funktion der Elemente in der GroupBox
 +
** '''Element eins''' Beschreibung der Funktion des ersten Elements
 +
** '''Element zwei''' Beschreibung der Funktion des zweiten Elements
 +
<code><nowiki>
 +
* '''Groupbox''' Beschreibung der Funktion der Elemente in der GroupBox
 +
</nowiki></code><br>
 +
<code><nowiki>
 +
** '''Element eins''' Beschreibung der Funktion des ersten Elements
 +
</nowiki></code><br>
 +
<code><nowiki>
 +
** '''Element zwei''' Beschreibung der Funktion des zweiten Elements
 +
</nowiki></code><br>
 +
 +
Beschrieben werden alle Oberflächenelemente, bis auf die Buttons ‚OK‘, ‚Abbrechen‘ und ‚Hilfe‘.
 +
Unterhalb der Beschreibung der Elemente einer einzelnen Abbildung muss um einen Überlauf des Bildes zu verhindern ein Trenner eingefügt werden:
 +
<br style="clear:both" />
 +
Fußzeilen
 +
Unterhalb des Artikels werden – abgetrennt durch eine Linie – Links angegeben:
 +
- Zu dem zugehörigen Modul
 +
- Falls von einem Prozess-Artikel auf diesen Artikel verlinkt wird der Link zu dem Prozessartikel, am besten ein Deeplink zu dem entsprechenden Abschnitt
 +
- Falls der Artikel die Beschreibung eines Unterdialogs ist, der Link zu der Beschreibung des übergeordneten Oberflächenelements
 +
- Falls der Artikel sich auf Fremdsoftware oder Hersteller bezieht ein externer Link zu dem Hersteller
 +
Beispiel:
 +
----
 +
:''Siehe auch
 +
:*''[[Link zum Modul]]
 +
:*''[externer Link]
 +
Des Weiteren müssen hier auch die Kategorien angegeben werden, z.B:
 +
[[Category:Module]]
 +
Einfache Darstellung: Übersichtsbeispiel
 +
[[Bild:Abbildung.png|right]]
 +
Dieses Element dient zur Demonstration des Hilfe-Beispiels.
 +
Sie erreichen diese Funktion über den Menüpunkt '''Hauptmenü/Menü1/Menü2'''.
 +
Dieser Dialog steht nur zur Verfügung, wenn [[Modul]] freigeschaltet ist.
 +
* '''Groupbox1''' Beschreibung der Funktion der Elemente in der GroupBox1
 +
** '''Element eins''' Beschreibung der Funktion des ersten Elements
 +
** '''Element zwei''' Beschreibung der Funktion des zweiten Elements
 +
* '''Groupbox2''' Beschreibung der Funktion der Elemente in der GroupBox2
 +
** '''Element eins''' Beschreibung der Funktion des ersten Elements
 +
** '''Element zwei''' Beschreibung der Funktion des zweiten Elements
 +
<br style="clear:both" />
 +
----
 +
:''Siehe auch
 +
:''[[Link zum Modul]]
 +
:''[externer Link]
 +
[[Category:Module]]
 +
  
 
=Komplexes Layout: Dokumentation von Unterbereichen=
 
=Komplexes Layout: Dokumentation von Unterbereichen=

Version vom 27. Februar 2012, 14:11 Uhr

Allgemeines

Zu jeder Maske wird ein Hilfe-Artikel erstellt, in dem die Oberfläche beschrieben wird.

Die Oberfläche wird abgebildet, und nicht nur beschrieben. Dabei wird – wann immer möglich – Originalgröße verwendet. Die Abbildungen werden auf der rechten Seite angezeigt, z.B:

[[Bild:IntrahandelsstatistikEinstellungenDialog.png|right]]

Sollte die Abbildung zu groß sein und muss diese deshalb verkleinert dargestellt werden, dann wird neben der allgemeinen Beschreibung der Oberfläche diese verkleinerte Ansicht dargestellt. Als sinnvolle Größe hat sich hier 500px ergeben, also z.B.

[[Bild:Abbildung.png|500px|right]]

Die einzelnen logischen Bereiche dieser komplexen Oberfläche werden dann einzeln behandelt, dabei sind Ausschnittsbilder in Originalgröße anzuzeigen.


Einfache Darstellung

Die Abbildung des Oberflächenelements wird als erstes Element eingetragen:

[[Bild:Abbildung.png|right]]

Einleitendes Element

Jeder Oberflächenartikel beginnt mit einem einleitenden Text. Dieser umfasst:

  • Eine Ein-Satz-Beschreibung der Funktion des Dialogs
  • Wie man zu diesem Dialog gelangt. Wird dazu der Menüpfad angegeben, so wird dieser fett formatiert, die einzelnen Menüebenen werden durch Schrägstricht getrennt, z.B.

Hauptmenü/Menü1/Menü2. '''Hauptmenü/Menü1/Menü2'''

  • Wenn das Oberflächenelement nur zur Verfügung steht, wenn ein bestimmtes Modul freigeschaltet ist, muss das erwähnt werden. Dazu ist das Modul zu verlinken:

Dieser Dialog steht nur zur Verfügung, wenn [[Modul]] freigeschaltet ist.

Doku der einzelnen Oberflächenelemente

Links neben den Abbildungen werden die einzelnen Oberflächenelemente als Aufzählungsliste dokumentiert, z.B:

  • Groupbox Beschreibung der Funktion der Elemente in der GroupBox
    • Element eins Beschreibung der Funktion des ersten Elements
    • Element zwei Beschreibung der Funktion des zweiten Elements

* '''Groupbox''' Beschreibung der Funktion der Elemente in der GroupBox
** '''Element eins''' Beschreibung der Funktion des ersten Elements
** '''Element zwei''' Beschreibung der Funktion des zweiten Elements

Beschrieben werden alle Oberflächenelemente, bis auf die Buttons ‚OK‘, ‚Abbrechen‘ und ‚Hilfe‘. Unterhalb der Beschreibung der Elemente einer einzelnen Abbildung muss um einen Überlauf des Bildes zu verhindern ein Trenner eingefügt werden:
Fußzeilen Unterhalb des Artikels werden – abgetrennt durch eine Linie – Links angegeben: - Zu dem zugehörigen Modul - Falls von einem Prozess-Artikel auf diesen Artikel verlinkt wird der Link zu dem Prozessartikel, am besten ein Deeplink zu dem entsprechenden Abschnitt - Falls der Artikel die Beschreibung eines Unterdialogs ist, der Link zu der Beschreibung des übergeordneten Oberflächenelements - Falls der Artikel sich auf Fremdsoftware oder Hersteller bezieht ein externer Link zu dem Hersteller Beispiel:

Siehe auch

Des Weiteren müssen hier auch die Kategorien angegeben werden, z.B: Einfache Darstellung: Übersichtsbeispiel

Datei:Abbildung.png

Dieses Element dient zur Demonstration des Hilfe-Beispiels. Sie erreichen diese Funktion über den Menüpunkt Hauptmenü/Menü1/Menü2. Dieser Dialog steht nur zur Verfügung, wenn Modul freigeschaltet ist.

  • Groupbox1 Beschreibung der Funktion der Elemente in der GroupBox1
    • Element eins Beschreibung der Funktion des ersten Elements
    • Element zwei Beschreibung der Funktion des zweiten Elements
  • Groupbox2 Beschreibung der Funktion der Elemente in der GroupBox2
    • Element eins Beschreibung der Funktion des ersten Elements
    • Element zwei Beschreibung der Funktion des zweiten Elements


Siehe auch
Link zum Modul
[externer Link]


Komplexes Layout: Dokumentation von Unterbereichen

Siehe auch
Abgerufen von „https://handbuch.mauve.de/index.php?title=Styleguide:_Beschreibung_der_Oberfläche&oldid=10054“