Germany/Website HowTo

Kleines HowTo zum Aufbau der wiki-Seiten für das OWASP German Chapter.

Struktur

 * Intro: Aufgrund immer häufiger auftretender Probleme mit Extensions/Plugins für mediawiki, wurde 2011 beschlossen die Seiten des German Chapter nach einer (klassischen) Verzeichnisstruktur aufzubauen. Insbeondere sollen alle vom German Chapter gepflegten Seiten dem Pfad Germany/andere-Seiten folgen (Ausnahmen siehe unten).

Aufbau

 * Stand 03.11.2012:
 * Germany/
 * Germany/Aktuelles
 * Germany/Konferenzen
 * Germany/Projekte
 * Germany/Chapter Meetings
 * Germany/Stammtisch_Initiative
 * Germany/press
 * German OWASP Day 2011
 * German OWASP Day 2012

Ausnahmen
Ausnahmen von dieser Struktur sind i.W. alte Seiten. Sie werden nach und nach umgestellt oder es wird ein #REDIRECT-Seite eingerichtet.

REDIRECTs
Liste der eingerichteten Redirects:
 * 02.11.2012:
 * Germany/Stammtisch_Initiative --> OWASP_German_Chapter_Stammtisch_Initiative

Seite

 * : Die Seiten haben i.d.R. kein Inhaltsverzeichnis (erstes Keyword in der Seite)
 * Template:XXXX : optional, falls die Seite ein Template benutzt
 * == Überschrift == : keine Überschrift mit einem  verwenden, macht manchmal Probleme
 * : am Seitenende der Link zur Hauptseite
 * ... : Kategorien angeben (am Seitenanfang oder Seitenende)

Markup

 * Allgemein: In den Seiten soll kein HTML verwendet werden, sondern nur das mediawiki-spezifische Markup.
 * Ausnahmen: Manchmal ist  erlaubt. Weiter sind bei den Tabellen  -Angaben notwendig.
 * Links: Links  sollten in   eingeschlossen werden, damit sie immer unterstrichen sind (leider sind einige Voreingestellungen der Styles unglücklich).
 * Für Verweise zu anderen wiki-Seiten bitte nur lokale Pfade verwenden, z.B..


 * Tabellen: Tabellen werden benutzt um:
 * 1) 2 Spalten für mehrsprachige Inhalte zu erzeugen
 * 2) bei Konferenzseiten für die Agenda
 * Beispiel Sprach-Tabelle:
 * ab der 2ten Zeile keine  mehr angeben, erleichtert das Ändern.
 * An einer einfacheren Lösung wird gearbeitet ...


 * Sonstiges: Bitte auf Leerzeilen verzichten, da diese einen neuen Absatz erzeugen. Umgekehrt: bitte Leerzeilen statt  verwenden, um einen Umbruch/Absatz zu erzwingen.

Kategorien

 * Folgende Katgorien des OWASP mediawiki werden verwendet. Bitte bei neuen Seiten entsprechend eintragen.



Die Kategorie  wird von mediawiki automatisch eingetragen.

Bekannte Probleme

 * : Die Extension kann nicht mit Sonderzeichen in Überschriften umgehen und sie überlagert die CSS-Einstellungen für Überschriften (die dann alle kleiner werden). Ausserdem ist zur Funktion JavaScript nötig und es funktioniert nicht in allen Browsern. Nicht verwenden!


 * : Eigentlich sollte es möglich sein mit  die Verzeichnistiefe im Inhaltsverzeichnis einzustellen, das funktioniert nicht (Stand: 11/2012).


 * : Zu Category-Seiten des mediawiki kann nicht mit dem üblichen Link, z.B.  verlinked werden, da diese Syntax den Category-Eintrag erzeugt. Hier muss datsächlich die volle URL stehen, z.B.

Tipps

 * Umbenennen: Um eine Seite umzubenennen gibt es nach Aufruf der Seite, oben rechts neben dem Edit-Button ein Pulldown mit Move, dort einfach den neuen Seitennamen eintragen, fertig.

#REDIRECT pfad/alte/Seite
 * REDIRECT-Seite einrichten: Neue Seite die den Redirect auslösen soll anlegen, dort steht dann:


 * REDIRECT-Seite ändern: Neue Seite aufrufen, dann steht ganz oben unter der ersten (Seiten-)Überschrift z.B. . Auf diesen Link klicken und dann die Seite editieren.