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:

Seite
Generelle Informationen zur wiki-Syntax innerhalb der Seiten.
 * : 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 nur einem  verwenden, macht manchmal Probleme
 * : am Seitenende der Link zur Hauptseite (Germany)
 *  : am Seitenende der Link zur Elternseite
 * ... : 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.

Back Links
Am Ende jeder Seite Links zur Startseite einrichten. Der Text steht in . Damit eine kleiner Abstand entsteht, 2 Leerzeilen einfügen, dann eine Trennlinies. Beispiel:  sieht dann so aus: 



Bekannte Probleme

 * : Die Extension kann nicht mit Sonderzeichen in Überschriften umgehen (geht seit Q1/2014 teilweise) 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 folgende Syntax verwendet werden

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.