Wiki-Seite anlegen: Unterschied zwischen den Versionen

Aus schokokeks.org Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Category:Schokokeks]]
[[Category:Schokokeks]]
[[Category:MediaWiki]]
[[Category:MediaWiki]]
Das Team von schokokeks.org hat stets das Ziel, dem Benutzer seine Arbeit mit und auf dem Server zu vereinfachen. Dennoch gibt es gelegentlich die Notwendigkeit für Dokumentation und Hilfestellung. Hier in diesem Wiki werden die Texte sowohl von den Administratoren geschrieben, können aber auch von jedem Benutzer bearbeitet und ergänzt werden.
Auch neue Inhalte dürfen gerne angelegt werden.


==Vorbereitungen==
Zunächst ist es wichtig, dass der Benutzer einen Wiki-Account besitzt und eingeloggt ist. Das ist wichtig, um Änderungen besser nachvollziehen zu können.


==Namen aussuchen==
== Anmeldung am Wiki ==
Die Wahl des Namens für einen neuen Artikel ist ausgesprochen wichtig. Angenommen Sie möchten über die Ruby-Bibliothek xmpp4r schreiben, so wäre der korrekte Name - ganze einfach - xmpp4r. In dem Fall ist der Namen eindeutig und zukünftige Konflikte mit  gleichnamigen Anleitungen können ausgeschlossen werden. Es gibt aber auch Ausnahmen. Der Name ''Key-Login'' ist nicht eindeutig genug für einen Artikel über das Authentifizierungverfahren via Public Key mit SSH. Hier sollte der Seitenname ''Key-Login (OpenSSH)'' heißen.
Um Änderungen am Wiki vorzunehmen muss man sich Anmelden. Am Kopf jeder Seite befindet sich ein Link zur [[Spezial:Userlogin|Anmelde-Seite]]. Das Anlegen von Benutzerkonten haben wir aufgrund des hohen Spam-Aufkommen deaktiviert. Wenn Sie ein Benutzerkonto anlegen möchten wenden Sie sich bitte an einen der Administratoren.


==Regeln==
Wenn Sie ein Konto registrieren, benutzen Sie bitte Ihren System-Benutzernamen oder Ihren vollen Namen, damit wir die Benutzer identifizieren können. Wir behalten uns vor, Namen die wir nicht zuordnen können zu löschen.
* Die Anleitungen sollten so weit wie möglich in der dritten Person von einem Benutzer sprechen. Der Begriff »Benutzer« ist dabei dem Begriff »Kunde« vorzuziehen.
 
* Der Benutzer sollte mit »Sie« angesprochen werden
== Name eines Artikels ==
Die Wahl des Namens für einen neuen Artikel ist ausgesprochen wichtig. Angenommen Sie möchten über die Ruby-Bibliothek xmpp4r schreiben, so wäre der korrekte Name - ganz einfach - xmpp4r. In dem Fall ist der Namen eindeutig und zukünftige Konflikte mit  gleichnamigen Anleitungen können ausgeschlossen werden. Es gibt aber auch Ausnahmen. Der Name ''Key-Login'' ist nicht eindeutig genug für einen Artikel über das Authentifizierungverfahren via Public Key mit SSH. Hier sollte der Seitenname ''Key-Login (OpenSSH)'' heißen.
 
== Stil-Richtlinien ==
Die wichtigste Regel zu Beginn:
* Eine Hilfe-Seite ist besser als keine Hilfe-Seite, egal in welchen Stil sie verfasst ist.
Dennoch freuen wir uns, wenn Sie beim Schreiben gleich auf folgende Punkte achten:
* Die Anleitungen sollten so weit wie möglich in der dritten Person von einem Benutzer sprechen. Der Begriff ''Benutzer'' ist dabei dem Begriff ''Kunde'' vorzuziehen.
* Der Benutzer sollte mit ''Sie'' angesprochen werden
* Bei der männlichen Form ist das weibliche Pendant immer mitgemeint. Bitte kein Binnenmajuskel oder Ähnliches.
* Bei der männlichen Form ist das weibliche Pendant immer mitgemeint. Bitte kein Binnenmajuskel oder Ähnliches.
* Versuchen Sie, so einfach wie möglich zu erklären. Vermeiden Sie »Tech-Speek«
* Versuchen Sie, so einfach wie möglich zu erklären. Vermeiden Sie ''Tech-Speek''.
* Verwenden Sie deutsche Begriffe, sofern diese gebräuchlich sind. Also nicht ''Mutterbrett'' statt ''Motherboard'' aber ''aktualisieren'' statt ''updaten''.
* Schreiben Sie in ganzen Sätzen mit möglichst korrekter, deutscher Grammatik.


==Templates==
== Wiki-Vorlagen ==
Für die Vereinfachung von komplexen Markup-Konstrukten stehen einige Templates zu Verfügung
Für die Vereinfachung von komplexen Layout-Konstrukten stehen einige Wiki-Vorlagen zu Verfügung.
===[[Vorlage:AlertBox]]===
 
=== Achtung-Feld ([[Vorlage:AlertBox|AlertBox]]) ===
Diese Vorlage sollte für wichtige Hinweise in der Anleitung genutzt werden.
Diese Vorlage sollte für wichtige Hinweise in der Anleitung genutzt werden.
====Verwendung====
==== Verwendung ====
<pre><nowiki>{{AlertBox
<nowiki>{{AlertBox
|title=<titel>
|title=<titel>
|content=<text>
|content=<text>
}}</nowiki></pre>
}}</nowiki>
====Aussehen====
==== Aussehen ====
{{AlertBox
{{AlertBox
|title=<titel>
|title=<titel>
|content=<text>
|content=<text>
}}
}}
===[[Vorlage:Box]]===
 
Diese Vorlage darf für einfach Boxen verwendet werden, wo sie dem Autor passgenau erscheinen.
=== Hinweis-Feld ([[Vorlage:Box|Box]]) ===
====Verwendung====
Diese Vorlage darf für einfach Boxen verwendet werden, wo sie dem Autor passend erscheinen.
<pre><nowiki>{{Box
==== Verwendung ====
|title=<titel>
<nowiki>{{Box
|content=<text>
|title=<titel>
|image=Category-Help.png
|content=<text>
}}</nowiki></pre>
|image=Category-Help.png
====Aussehen====
}}</nowiki>
==== Aussehen ====
{{Box
{{Box
|title=<titel>
|title=<titel>
Zeile 43: Zeile 55:
}}
}}


==Syntax==
== Wiki-Syntax ==
Ständig aktualisiert wird die [http://de.wikipedia.org/wiki/Hilfe:Bearbeitungshilfe Bearbeitungshilfe der Wikipedia].
Es gibt noch sehr viele weitere Möglichkeiten, Wiki-Texte zu formatieren. Eine Umfassende Hilfestellung gibt die [http://de.wikipedia.org/wiki/Hilfe:Bearbeitungshilfe Bearbeitungshilfe der Wikipedia], die auf der selben Wiki-Technologie aufbaut.

Aktuelle Version vom 2. Juli 2014, 12:27 Uhr

Das Team von schokokeks.org hat stets das Ziel, dem Benutzer seine Arbeit mit und auf dem Server zu vereinfachen. Dennoch gibt es gelegentlich die Notwendigkeit für Dokumentation und Hilfestellung. Hier in diesem Wiki werden die Texte sowohl von den Administratoren geschrieben, können aber auch von jedem Benutzer bearbeitet und ergänzt werden. Auch neue Inhalte dürfen gerne angelegt werden.


Anmeldung am Wiki

Um Änderungen am Wiki vorzunehmen muss man sich Anmelden. Am Kopf jeder Seite befindet sich ein Link zur Anmelde-Seite. Das Anlegen von Benutzerkonten haben wir aufgrund des hohen Spam-Aufkommen deaktiviert. Wenn Sie ein Benutzerkonto anlegen möchten wenden Sie sich bitte an einen der Administratoren.

Wenn Sie ein Konto registrieren, benutzen Sie bitte Ihren System-Benutzernamen oder Ihren vollen Namen, damit wir die Benutzer identifizieren können. Wir behalten uns vor, Namen die wir nicht zuordnen können zu löschen.

Name eines Artikels

Die Wahl des Namens für einen neuen Artikel ist ausgesprochen wichtig. Angenommen Sie möchten über die Ruby-Bibliothek xmpp4r schreiben, so wäre der korrekte Name - ganz einfach - xmpp4r. In dem Fall ist der Namen eindeutig und zukünftige Konflikte mit gleichnamigen Anleitungen können ausgeschlossen werden. Es gibt aber auch Ausnahmen. Der Name Key-Login ist nicht eindeutig genug für einen Artikel über das Authentifizierungverfahren via Public Key mit SSH. Hier sollte der Seitenname Key-Login (OpenSSH) heißen.

Stil-Richtlinien

Die wichtigste Regel zu Beginn:

  • Eine Hilfe-Seite ist besser als keine Hilfe-Seite, egal in welchen Stil sie verfasst ist.

Dennoch freuen wir uns, wenn Sie beim Schreiben gleich auf folgende Punkte achten:

  • Die Anleitungen sollten so weit wie möglich in der dritten Person von einem Benutzer sprechen. Der Begriff Benutzer ist dabei dem Begriff Kunde vorzuziehen.
  • Der Benutzer sollte mit Sie angesprochen werden
  • Bei der männlichen Form ist das weibliche Pendant immer mitgemeint. Bitte kein Binnenmajuskel oder Ähnliches.
  • Versuchen Sie, so einfach wie möglich zu erklären. Vermeiden Sie Tech-Speek.
  • Verwenden Sie deutsche Begriffe, sofern diese gebräuchlich sind. Also nicht Mutterbrett statt Motherboard aber aktualisieren statt updaten.
  • Schreiben Sie in ganzen Sätzen mit möglichst korrekter, deutscher Grammatik.

Wiki-Vorlagen

Für die Vereinfachung von komplexen Layout-Konstrukten stehen einige Wiki-Vorlagen zu Verfügung.

Achtung-Feld (AlertBox)

Diese Vorlage sollte für wichtige Hinweise in der Anleitung genutzt werden.

Verwendung

{{AlertBox
 |title=<titel>
 |content=<text>
 }}

Aussehen

<titel>

<text>


Hinweis-Feld (Box)

Diese Vorlage darf für einfach Boxen verwendet werden, wo sie dem Autor passend erscheinen.

Verwendung

{{Box
 |title=<titel>
 |content=<text>
 |image=Category-Help.png
 }}

Aussehen

<titel>

<text>

Wiki-Syntax

Es gibt noch sehr viele weitere Möglichkeiten, Wiki-Texte zu formatieren. Eine Umfassende Hilfestellung gibt die Bearbeitungshilfe der Wikipedia, die auf der selben Wiki-Technologie aufbaut.