Germany/Website HowTo

From OWASP
Revision as of 17:03, 3 November 2012 by Achim (Talk | contribs)

Jump to: navigation, search

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

Contents

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

Template:TBD

Ausnahmen

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

REDIRECTs

02.11.2012
  • Germany/Stammtisch_Initiative --> OWASP_German_Chapter_Stammtisch_Initiative

Seite

__NOTOC__
Die Seiten haben i.d.R. kein Inhaltsverzeichnis (erstes Keyword in der Seite)
[[Template:XXXX]]
optional, falls die Seite ein Template benutzt
== Überschrift ==
Überschrift mit einem = verwenden, macht manchmal Probleme
[[Germany|<top>]]
am Seitenende der Link zur Hauptseite
[[Category:Germany]] ...
Kategorien angeben (am Seitenanfnag oder Seitenende)

Markup

Allgemein
In den Seiten soll kein HTML verwendet werden, sondern nur das mediawiki-spezifische Markup.
Ausnahmen
Manchmal ist <br> erlaubt. Weiter sind bei den Tabellen style="..."-Angaben notwendig.
Links
Links [[ ... ]]<nowiki></code> sollten in <code><nowiki><u>[[ ... ]]</u> eingeschlossen werden, damit sie immer unterstrichen sind (leider sind einige Voreingestellungen der Styles unglücklich).
Tabellen
Tebbelen werden benutzt um:
  1. 2 Spalten für Mehrsprachige Inhalte zu erzeugen
  2. bei Konferenzseiten für die Agenda
Beispiel Sprach-Tabelle
 {| width="100%" style="background-color:inherit;border-bottom:1px solid black;"
 | width="70%" style="vertical-align:top; padding-right:0.5em;" |
 Zeile 1, Spalte 1

 | width="30%" style="vertical-align:top; padding-left:0.5em;border-left:1px solid black;" |
 Zeile 1, Spalte 2
 ...
 |-
 | style="vertical-align:top; padding-right:0.5em;" |
 Zeile n, Spalte 1

 | style="vertical-align:top; padding-left:0.5em;border-left:1px solid black;" |
 Zeile n, Spalte 2
 |}
ab der 2ten Zeile keine width=... mehr angeben, erleichtert das Ändern.
An einer einfacheren Lösung wird gearbeitet ...
Sonstiges
Bitte auf Leerzeilen verzichten, da diese einen neuen Absatz erzeugen.

Kategorien

Folgende Katgorien des OWASP mediawiki werden verwendet. Bitte bei neuen Seiten entsprechend eintragen.
  • [[Category:Germany]]
  • [[Category:German OWASP Day]]
  • [[Category:Europe]]
  • [[Category:OWASP_AppSec_Conference]]
  • [[Category:OWASP Project]]
  • [[Category:Download]]

Die Kategorie [[OWASP Chapter]] wird von mediawiki automatisch eingetragen.

Bekannte Probleme

<headertabs />
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!
__TOC__
Eigentlich sollte es möglich sein mit {{TOC limit}} die Verzeichnistiefe im Inhaltsverzeichnis einzustellen, das funktioniert nicht (Stand: 11/2012).

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-Seite
neue Seite die den Redirect auslösen soll anlegen, dort steht dann:
 #REDIRECT [[pfad/alte/Seite]]