Quelltext der Seite Styleguide: Beschreibung der Oberfläche

__TOC__

=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:

<code><nowiki>
[[Bild:IntrahandelsstatistikEinstellungenDialog.png|right]]
</nowiki></code>

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. 

<code><nowiki>
[[Bild:Abbildung.png|500px|right]]
</nowiki></code>

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:

<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.<br><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:<br><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'''.<br>
Unterhalb der Beschreibung der Elemente einer einzelnen Abbildung muss um einen Überlauf des Bildes zu verhindern ein Trenner eingefügt werden:
<code><nowiki>
<br style="clear:both" />
</nowiki></code>


==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:<br>
<code><nowiki>
----
</nowiki></code><br><code><nowiki>
:''Siehe auch
</nowiki></code><br><code><nowiki>
:*''[[Link zum Modul]]
</nowiki></code><br><code><nowiki>
:*''[externer Link]
</nowiki></code>

Des Weiteren müssen hier auch die Kategorien angegeben werden, z.B:
<code><nowiki>[[Category:Module]]</nowiki></code>


==Einfache Darstellung: Übersichtsbeispiel==

<code><nowiki>
[[Bild:Abbildung.png|right]]
</nowiki></code><br><code><nowiki>
Dieses Element dient zur Demonstration des Hilfe-Beispiels.
</nowiki></code><br><code><nowiki>
Sie erreichen diese Funktion über den Menüpunkt '''Hauptmenü/Menü1/Menü2'''.
</nowiki></code><br><code><nowiki>
Dieser Dialog steht nur zur Verfügung, wenn [[Modul]] freigeschaltet ist.
</nowiki></code><br><code><nowiki>
* '''Groupbox1''' Beschreibung der Funktion der Elemente in der GroupBox1
</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><code><nowiki>
* '''Groupbox2''' Beschreibung der Funktion der Elemente in der GroupBox2
</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><code><nowiki>
<br style="clear:both" />
</nowiki></code><br><code><nowiki>
----
</nowiki></code><br><code><nowiki>
:''Siehe auch
</nowiki></code><br><code><nowiki>
:''[[Link zum Modul]]
</nowiki></code><br><code><nowiki>
:''[externer Link]
</nowiki></code><br><code><nowiki>
[[Category:Module]]
</nowiki></code>


=Komplexes Layout: Dokumentation von Unterbereichen=

Besitzen Oberflächen deutlich abgetrennte Unterelemente (z.B. einzelne Tabs oder GroupBoxen) dann ist der Artikel entsprechend zu gliedern.<br><br> 
Dazu ist eine Table of Contents einzubauen. Die einzelnen Bereiche werden mit Unterüberschriften eingeleitet und entsprechend der [[Styleguide:_Beschreibung_der_Oberfläche#Einfache Darstellung|Einfachen Darstellung]] gegliedert.<br>
Beispiel:

<code><nowiki>
[[Bild:Uebersichtsbild.png|right|Bildtitel]]
</nowiki></code><br><code><nowiki>
__TOC__
</nowiki></code><br><code><nowiki>
=Einführung=
</nowiki></code><br><code><nowiki>
Einleitender Text wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Einleitendes_Element|Einfache Darstellung/Einleitendes Element]]<code><nowiki> beschrieben.
</nowiki></code><br><code><nowiki>
<br style="clear:both" />
</nowiki></code><br><br><code><nowiki>

=Bereich1=
</nowiki></code><br><code><nowiki>
[[Bild:Bereich1.png|right]
</nowiki></code><br><code><nowiki>
GGf. Modulhinweise (wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Einleitendes_Element|Einfache Darstellung/Einleitendes Element]]<code><nowiki> beschrieben)
</nowiki></code><br><code><nowiki>
Oberflächenelemente als Aufzählungsliste (wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Doku_der_einzelnen_Oberfl.C3.A4chenelemente|Einfache Darstellung/Doku der einzelnen Oberflächenelemente]]<code><nowiki> beschrieben)
</nowiki></code><br><code><nowiki>
<br style="clear:both" />
</nowiki></code><br><br><code><nowiki>

=Bereich2=
</nowiki></code><br><code><nowiki>
[[Bild:Bereich2.png|right]
</nowiki></code><br><code><nowiki>
GGf. Modulhinweise (wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Einleitendes_Element|Einfache Darstellung/Einleitendes Element]]<code><nowiki> beschrieben)
</nowiki></code><br><code><nowiki>
Oberflächenelemente als Aufzählungsliste  (wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Doku_der_einzelnen_Oberfl.C3.A4chenelemente|Einfache Darstellung/Doku der einzelnen Oberflächenelemente]]<code><nowiki> beschrieben)
</nowiki></code><br><code><nowiki>
<br style="clear:both" />
</nowiki></code><br><code><nowiki>

[…]
</nowiki></code><br><code><nowiki>
Fußzeile des Artikels (wie unter </nowiki></code>[[Styleguide:_Beschreibung_der_Oberfläche#Fu.C3.9Fzeilen|Einfache Darstellung/Fußzeilen]]<code><nowiki> beschrieben)
</nowiki></code>



Ausnahme: Sind die Unterbereiche alle gleichzeitig sichtbar (GroupBoxen) und ist die Maske insgesamt so klein, dass diese ohne Verkleinerung darstellbar ist, sollte die [[Styleguide:_Beschreibung_der_Oberfläche#Einfache Darstellung|einfache Darstellung]] gewählt werden (siehe oben).<br><br>
Wird der Artikel zu lang (z.B. bei der Beschreibung der einzelnen Tabs des Dialogs Globale Einstellungen), dann müssen die einzelnen Bereiche in eigene Artikel ausgelagert werden.<br> 
Die so erzeugten Artikel werden wie unter einfache Darstellung beschrieben formatiert.<br> 
Im Hauptartikel werden die Bereiche dann wie folgt dargestellt:<br>

<code><nowiki>
=Bereich1=
</nowiki></code><br><code><nowiki>
[[Bild:Bereich1.png|thumb]
</nowiki></code><br><code><nowiki>
Ein-Satz-Beschreibung der Funktion des Bereichs.
</nowiki></code><br><code><nowiki>
:''Hauptartikel: [[Bereich1]]
</nowiki></code><br><code><nowiki>
<br style="clear:both" />
</nowiki></code>


----
:''Siehe auch
:*''[[Styleguide für Handbucheinträge]]

[[Category:Handbuch Styleguide]]