Difference between revisions of "Germany/Website HowTo"

Revision as of 08:48, 4 November 2012

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

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 ==

keine Ü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 [[ ... ]] sollten in <u>[[ ... ]]</u> 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. [[Germany/Website_How]].

Tabellen

Tabellen 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]]