Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
Both sides previous revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Letzte Überarbeitung Both sides next revision | ||
wiki:guidelines [2012/10/08 01:30] mrenner [Syntax] |
wiki:guidelines [2013/04/17 14:18] mrenner |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
====== Guidelines ====== | ====== Guidelines ====== | ||
- | Auf diesem Artikel werden Guidelines definiert, die bei der Mitarbeit auf diesem Wiki beachtet werden sollten. Als Grundlage dienen die Guidelines von [[http://de.wikipedia.org/wiki/Wikipedia:Richtlinien | Wikipedia]]. | + | Im Folgenden werden Guidelines definiert, die bei der Mitarbeit auf diesem Wiki zu beachten sind. Als Grundlage dienen die [[wpde>Wikipedia:Richtlinien | Guidelines von Wikipedia]], die für dieses Wiki wie folgt erweitert werden: |
===== Grundprinzipien ===== | ===== Grundprinzipien ===== | ||
- | * Neutralität: Eigene Meinungen sollten vermieden werden. | + | * **Neutralität:** Eigene Meinungen sind zu vermeiden. |
- | * Urheberrechte beachten: Sofern fremde Inhalte genutzt werden, sind diese zu zitieren und die Quelle zu referenzieren. | + | * **Quellenangabe:** Sofern fremde Inhalte genutzt werden, sind diese zu zitieren und die Quelle zu referenzieren. Es dürfen keine Urheberrechte verletzt werden. |
- | * Die Sprache des Wikis ist Deutsch. | + | * **Anonymität:** Beispiele dürfen keine Inhalte dritter enthalten. So müssen IP-Adressen, Domains, E-Mail-Adressen e.t.c. unbedingt anonymisiert werden. |
+ | * Ein Artikel sollte ein möglichst **hohes Maß an Vollständigkeit** bezüglich des beschriebenen Themas aufweisen. Unvollständige Artikel sind an geeigneter Stelle mit FIXME (Syntax: %%FIXME%%) zu kennzeichnen. | ||
+ | * **Die Sprache** des Wikis ist Deutsch. | ||
- | ===== Inhalt ===== | + | ===== Inhaltliche Abgrenzung ===== |
Der Inhalt des Wikis umfasst | Der Inhalt des Wikis umfasst | ||
Zeile 17: | Zeile 19: | ||
* Themen der Wirtschaftsinformatik | * Themen der Wirtschaftsinformatik | ||
- | ===== Syntax ===== | ||
- | * Beim Einfügen von Code aus Programmiersprachen, Pfade zu Dateiverzeichnissen u.ä. sollte das [[ http://qbnz.com/highlighter/ | automatische Syntax-Highlighting ]] verwendet werden. Dazu ist der code in ''<nowiki><code DIE_VERWENDETE_PROGRAMMIERSPRACHE></nowiki>'' und ''<nowiki> </code> </nowiki>'' einzubetten, wie z.B. e.g. ''<nowiki><code html></nowiki>'' and ''<nowiki></code></nowiki>'': | + | ===== Erstellung von Artikeln ===== |
- | <code html> | + | * Vor dem Erstellen eines Artikels sollte geprüft werden, ob der gleiche oder ein ähnlicher Artikel bereits existiert. |
- | <html> | + | * Nicht erläuterte Fachbegriffe, die essentiell für das Verständnis des Artikels sind, sollten zu weiterführenden internen Artikeln oder zu einer Enzyklopädie, wie z.B. Wikipedia, verlinkt werden. |
- | <head> | + | |
- | <meta name="author" content="Wikimaster"> | + | |
- | </head> | + | |
- | <body> ... </body> | + | |
- | </html> | + | |
- | </code> | + | |
- | * Aufrufe auf in der Befehlszeile, die root-Rechte benötigen, sind mit einer Raute zu kennzeichnen: | + | |
+ | ===== Formatierung von Artikeln (Syntax) ===== | ||
+ | |||
+ | Eine vollständige Beschreibung der Syntax findet sich unter https://www.dokuwiki.org/wiki:syntax. Die im Folgenden gelisteten Bereiche sollte primär wie hier beschrieben syntaktisch umgesetzt werden. | ||
+ | |||
+ | |||
+ | ==== Leerzeilen in der Artikelsyntax ==== | ||
+ | |||
+ | In der Syntax ist nach einer Überschrift eine Leerzeile einzufügen und zwei Leerzeilen vor der nächsten Überschrift. Dies erleichtert die Lesbarkeit des Codes. | ||
+ | |||
+ | |||
+ | ==== Einfügen von Code ==== | ||
+ | |||
+ | Umfasst der Code nur eine oder wenige Zeilen oder für den Fall, dass Syntax-Highlighting die Lesbarkeit nicht unbedingt erleichtert, kann zum Einbinden des Codes zwei hintereinanderfolgende Leerzeichen genutzt werden. | ||
+ | |||
+ | Diesem Text gehen zwei Leerzeichen zuvor. | ||
+ | |||
+ | Beim Einfügen von Code aus Programmiersprachen, Pfade zu Dateiverzeichnissen u.ä. sollte das [[ http://qbnz.com/highlighter/ | automatische Syntax-Highlighting ]] verwendet werden: | ||
+ | |||
+ | <code VERWENDETE PROGRAMMIERSPRACHE> | ||
+ | ... der Quellcode ... | ||
+ | </code> | ||
+ | |||
+ | Eine Liste der derzeit unterstützten Programmiersprachen findet sich unter https://www.dokuwiki.org/wiki:syntax#syntax_highlighting. | ||
+ | |||
+ | |||
+ | ==== Aufrufe in der Befehlszeile ==== | ||
+ | |||
+ | Aufrufe in der Befehlszeile, die root-Rechte benötigen, sind mit einer Raute zu kennzeichnen: | ||
# passwd | # passwd | ||
+ | | ||
+ | |||
+ | ==== Links ==== | ||
+ | |||
+ | Links zu anderen Wikis (z.B. Wikipedia, wiki.ubuntuusers.de) oder auch anderen wichtigen Seiten können durch Inter-Wiki-Links erstellt werden, z.B: | ||
+ | [[wpde>Deutschland]] | ||
+ | | ||
+ | [[google>Wiba10]] | ||
+ | | ||
+ | [[uu>apt]] | ||
+ | |||
+ | erzeugt folgende Ausgabe: | ||
+ | |||
+ | [[wpde>Deutschland]] | ||
+ | |||
+ | [[google>Wiba10]] | ||
+ | |||
+ | [[uu>apt]] | ||
+ | |||
+ | |||
+ | ==== Taggen von Artikeln ==== | ||
+ | |||
+ | Alle Artikel sind in der letzten Zeile des Codes wie folgt zu taggen: | ||
+ | |||
+ | {{tag>tag1 tag2 tag3}} | ||
+ | |||
+ | Für das Taggen gelten folgende Konventionen: | ||
+ | * Jeder Artikel hat ein bis beliebig viele Tags. Die Anzahl der Tags ist themenabhängig, es sollte jedoch mehr als ein Tag benutzt werden. | ||
+ | * Tags treten nur im Singular auf. | ||
+ | * Themennahe Artikel sollten ähnliche Tags aufweisen. | ||
+ | |||
- | {{tag>guidelines syntax}} | + | {{tag>guidelines syntax konvention}} |
Bei Verwendung dieses Wikis erklären Sie sich mit dem Haftungsausschluss, Nutzungsbedingungen und der Datenschutzerklärung dieses Wikis einverstanden. Impressum.