View source for 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
{{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 ====
Liste der eingerichteten Redirects:
;02.11.2012:
* Germany/Stammtisch_Initiative --> OWASP_German_Chapter_Stammtisch_Initiative

== Seite ==
;<nowiki>__NOTOC__</nowiki>: Die Seiten haben i.d.R. kein Inhaltsverzeichnis (erstes Keyword in der Seite)
;<nowiki>[[Template:XXXX]]</nowiki>: optional, falls die Seite ein Template benutzt
;<nowiki>== Überschrift ==</nowiki>: keine Überschrift mit einem <code>=</code> verwenden, macht manchmal Probleme
;<nowiki>[[Germany|<top>]]</nowiki>: am Seitenende der Link zur Hauptseite
;<nowiki>[[Category:Germany]] ...</nowiki>: 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 <code><nowiki><br></nowiki></code> erlaubt. Weiter sind bei den Tabellen <code>style="..."</code>-Angaben notwendig.
;Links: Links <code><nowiki>[[ ... ]]</nowiki></code> sollten in <code><nowiki><u>[[ ... ]]</nowiki></u></code> eingeschlossen werden, damit sie immer <u>[[unterstrichen]]</u> sind (leider sind einige Voreingestellungen der Styles unglücklich).
: Für Verweise zu anderen wiki-Seiten bitte nur lokale Pfade verwenden, z.B. <code><nowiki>[[Germany/Website_How]]</nowiki></code>.
;Tabellen: Tabellen werden benutzt um:
# 2 Spalten für mehrsprachige Inhalte zu erzeugen
# bei Konferenzseiten für die Agenda
;Beispiel ''Sprach''-Tabelle:
  <nowiki>{| 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
 |}</nowiki>
: ab der 2ten Zeile keine <code>width=...</code> 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 <code><nowiki><br></nowiki></code> verwenden, um einen Umbruch/Absatz zu erzwingen.

== Kategorien ==
: Folgende Katgorien des OWASP mediawiki werden verwendet. Bitte bei neuen Seiten entsprechend eintragen.
* <code><nowiki>[[Category:Germany]]</nowiki></code>
* <code><nowiki>[[Category:German OWASP Day]]</nowiki></code>
* <code><nowiki>[[Category:Europe]]</nowiki></code>
* <code><nowiki>[[Category:OWASP_AppSec_Conference]]</nowiki></code>
* <code><nowiki>[[Category:OWASP Project]]</nowiki></code>
* <code><nowiki>[[Category:Download]]</nowiki></code>

Die Kategorie <code><nowiki>[[OWASP Chapter]]</nowiki></code> wird von mediawiki automatisch eingetragen.

== Bekannte Probleme ==
;<nowiki><headertabs /></nowiki>: 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!'''

;<nowiki>__TOC__</nowiki>: Eigentlich sollte es möglich sein mit <code><nowiki>{{TOC limit}}</nowiki></code> die Verzeichnistiefe im Inhaltsverzeichnis einzustellen, das funktioniert nicht (Stand: 11/2012).

;<nowiki>[[Category:name-it]]</nowiki>: Zu Category-Seiten des mediawiki kann nicht mit dem üblichen Link, z.B. <code><nowiki>[[Category:Germany]]</nowiki></code> verlinked werden, da diese Syntax den Category-Eintrag erzeugt. Hier muss datsächlich die volle URL stehen, z.B. <code><nowiki>[//www.owasp.org/index.php/Category:Germany Category:Germany]</nowiki></code>

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

;REDIRECT-Seite ändern: Neue Seite aufrufen, dann steht ganz oben unter der ersten (Seiten-)Überschrift z.B. <code>(Redirected from neue/Seite)</code>. Auf diesen Link klicken und dann die Seite editieren.