Das Wbk-Wiki ist ein Wiki für Lehrer*innen des WbK-Köln.

Arbeiten mit dem Wiki

Ziel dieser Seite:
Diese Übersicht sammelt grundlegende Formatierungshinweise und Beispiele für die Arbeit im MediaWiki. Sie soll helfen, Seiten übersichtlich, einheitlich und gut wartbar zu gestalten.

Grundprinzipien für Wikiartikel

  • Aktuelle Informationen stehen möglichst weit oben.
  • Ältere oder abgeschlossene Inhalte gehören in Abschnitte wie Historie oder Archiv.
  • Ein Artikel beginnt mit einer kurzen Einleitung: Thema, Zweck und aktueller Stand.
  • Überschriften sollten klar und sparsam eingesetzt werden.
  • Tabellen und Listen nur verwenden, wenn sie wirklich Übersicht schaffen.
  • Wichtige Quellen, Dokumente und verwandte Wiki-Seiten am Ende verlinken.
  • Kategorien stehen ganz unten auf der Seite.

Quelltext-Modus verwenden

Wichtig:
MediaWiki-Code sollte im Quelltext-Modus eingefügt werden, nicht in eine Zelle oder in den visuellen Editor. Sonst können Tabellen oder Links falsch dargestellt werden.

Das Wichtigste zuerst

In etwa 95 % der Fälle genügen diese Schritte:
  1. Öffne den vorhandenen Wikiartikel und klicke oben rechts auf „Bearbeiten“.
  2. Ergänze den gewünschten Text oder füge eine Datei hinzu.
  3. Prüfe die Vorschau und speichere anschließend die Änderungen.

Die wichtigsten Befehle:

  • Überschrift: == Beispielüberschrift ==
  • Listenpunkt: * Beispiel
  • Interner Link: [[Beispielartikel]]

Datei hinzufügen

  1. Ziehe die Datei auf die Fläche mit der Aufschrift „Datei(en) hier ablegen“.
  2. Wähle „Diese Datei hochladen“. Die Datei befindet sich nun auf dem Server, erscheint aber noch nicht automatisch im Artikel.
  3. Wähle nach dem Hochladen:
    • „Als Bild einfügen“, wenn die Datei als Bild angezeigt werden soll.
    • „Als Link einfügen“, wenn es sich um eine PDF-Datei, ein Textdokument oder eine andere Datei handelt.
  4. Im Quelltext steht anschließend beispielsweise:
    [[:File:test.txt]]
  5. Ersetze :File: durch Media::
    [[Media:test.txt]]
  6. Prüfe die Vorschau und speichere die Seite.

Überschriften

== Hauptüberschrift ==

=== Unterüberschrift ===

==== Weitere Unterüberschrift ====

Links

Interne Links

[[UCS]]
[[Technik:UCS]]
[[Zentralabitur:Zugang]]

Interne Links mit anderem Linktext

[[UCS|Informationen zum UCS-System]]

Sprung zu einem Abschnitt

[[Gremien#Organigramm_und_Besetzung]]

Externe Links

[https://www.wbkkoeln.de/ucs Seite zum UCS-System am WBK Köln]

E-Mail-Links

[mailto:beispiel@wbkkoeln.de beispiel@wbkkoeln.de]

Weiterleitungen

Eine Weiterleitung besteht nur aus einer Zeile:

#WEITERLEITUNG [[Technik:UCS]]

Weiterleitung auf einen Abschnitt:

#WEITERLEITUNG [[Gremien#Organigramm_und_Besetzung]]

Dateien und Medien

PDF oder Datei verlinken

[[Media:Dateiname.pdf]]

Datei mit lesbarem Linktext

[[Media:Dateiname.pdf|Beschreibung der Datei]]

Beispiel

[[Media:2024-07-09 - Merkblatt Umsetzung CanG.pdf|Merkblatt zur Umsetzung des Cannabisgesetzes]]

Tabellen

Empfehlung:
Für stabile MediaWiki-Tabellen jede Zelle in eine eigene Zeile setzen. Das ist beim Kopieren robuster als Tabellen mit vielen || in einer Zeile.

Robuste Grundform

{| class="wikitable sortable" style="width:100%;"
! Nachname
! Vorname
! Kürzel
! Mailadresse
|-
| Bartel
| Gordon
| Ba
| [mailto:bartel@abendgymnasium-koeln.de bartel@abendgymnasium-koeln.de]
|-
| Braun
| Bianca
| BB
| [mailto:braun@abendgymnasium-koeln.de braun@abendgymnasium-koeln.de]
|}

Kompakte Tabellenform

{| class="wikitable sortable" style="width:100%;"
! Jahr !! Datei
|-
| 2024 || [[Media:Beispiel.pdf|Beispieldatei]]
|-
| 2025 || [[Media:Beispiel-2025.pdf|Beispieldatei 2025]]
|}

Rechtsbündige Zahlen in Tabellen

| style="text-align:right;" | 17
| style="text-align:right;" | 34,0 %

Hinweiskästen

Vorlage: Infofenster

{{Infofenster
| text = Kurzer Hinweistext
}}

Infofenster mit Titel

{{Infofenster
| titel = Hinweis
| text = Dieser Hinweis ist besonders wichtig.
}}

Allgemeine Box

{{Box
| titel = Überschrift
| farbe = #1f3f5b
| hintergrund = #f3f7fa
| inhalt =
Inhalt der Box.
}}

Wichtiger Hinweis

{{Box
| titel = Hinweis
| farbe = #9b1c31
| hintergrund = #fff6f7
| inhalt =
Wichtiger Hinweistext.
}}

Vorlage: Öffentlichkeitsprinzip

Die Vorlage kann ohne Link verwendet werden:

{{Öffentlichkeitsprinzip}}

Oder mit Link:

{{Öffentlichkeitsprinzip
| link = https://www.wbkkoeln.de/ucs
| linktext = www.wbkkoeln.de/ucs
| beschreibung = Seite zum UCS-System am WBK Köln
}}

Beispiel für die Vorlage selbst:

<includeonly>
{{Infofenster
| titel = {{{icon|🌐}}} Öffentlichkeitsprinzip
| text =
'''{{{icon|🌐}}} Prinzip: So viel wie möglich öffentlich:'''<br>
Wenn es nicht unvereinbar mit den Daten ist, sollen Dinge, die zur Schule gehören, lieber öffentlich zugänglich sein als in Logineo oder im Wiki versteckt.

{{#if: {{{link|}}} |
<br>🔗 Hier: {{{beschreibung|weiterführende Seite}}}:<br>
[{{{link}}} {{{linktext|{{{link}}}}}}]
}}
}}
</includeonly>

<noinclude>
== Verwendung ==

<pre>
{{Öffentlichkeitsprinzip}}
</pre>

<pre>
{{Öffentlichkeitsprinzip
| link = https://www.wbkkoeln.de/ucs
| linktext = www.wbkkoeln.de/ucs
| beschreibung = Seite zum UCS-System am WBK Köln
}}
</pre>

[[Kategorie:Vorlagen]]
</noinclude>
Hinweis:
Wenn {{#if: ...}} nicht funktioniert, fehlt möglicherweise die MediaWiki-Erweiterung ParserFunctions.

Vorlage: Ansprechpartner

Wenn eine Seite fachlich betreut wird, kann am Ende eine Ansprechpartner-Vorlage stehen:

{{Ansprechpartner
| Name oder Funktion der zuständigen Person(en)
}}

Beispiel:

{{Ansprechpartner
| Beratungsteam
}}

Hervorgehobene Zugangsdaten

Für sensible oder besonders wichtige Informationen kann ein HTML-Kasten genutzt werden:

<div style="
border: 2px solid #b00020;
border-left: 10px solid #b00020;
background-color: #fff4f4;
padding: 1em;
margin: 1em 0;
border-radius: 6px;
font-size: 105%;
">

'''🔐 Zugangsdaten'''<br>
''gültig seit 03/2026''

{| class="wikitable" style="width:60%; margin-top:1em;"
! Angabe
! Wert
|-
| '''Schulnummer'''
| <code>123456</code>
|-
| '''Schulzugang'''
| <code>BeispielPasswort</code>
|}

</div>

Listen

Ungeordnete Liste

* erster Punkt
* zweiter Punkt
* dritter Punkt

Nummerierte Liste

# erster Schritt
# zweiter Schritt
# dritter Schritt

Kategorien

Kategorien stehen am Ende einer Seite. Doppelte Kategorien sollten vermieden werden.

[[Kategorie:Abitur]]
[[Kategorie:Prüfungen]]
[[Kategorie:Material]]

Typischer Seitenaufbau

== Thema der Seite ==

Kurze Einleitung: Worum geht es? Wofür ist die Seite gedacht? Was ist aktuell wichtig?

== Aktueller Stand ==

Die wichtigsten aktuellen Informationen.

== Vorgehen / Nutzung ==

# Schritt 1
# Schritt 2
# Schritt 3

== Materialien ==

{| class="wikitable sortable" style="width:100%;"
! Dokument
! Inhalt
|-
| [[Media:Datei.pdf|Dateiname]]
| kurze Beschreibung
|}

== Hinweise ==

{{Infofenster
| text = Kurzer Hinweis.
}}

== Siehe auch ==

* [[UCS]]
* [[Zentralabitur:Zugang]]

== Archiv / Historie ==

Ältere Informationen, Beschlüsse oder Materialien.

[[Kategorie:Beispiel]]

Cache und Aktualisierung

Wenn Änderungen an Vorlagen oder Seiten nicht sofort sichtbar werden:

  • Zielseite mit ?action=purge aufrufen.
  • Seite einmal ohne Änderung speichern, sogenannter Null-Edit.
  • Vorlagenseite ebenfalls einmal neu speichern.
  • Browser mit Strg + F5 hart neu laden.
https://deinwiki.de/wiki/Seitentitel?action=purge

Gestaltungshinweise

  • Tabellen nur dann einsetzen, wenn sie Übersicht schaffen.
  • Bei langen Artikeln lieber wenige klare Hauptüberschriften verwenden.
  • Materialien nach Themen oder Jahren ordnen.
  • Interne Links bevorzugen, wenn es passende Wiki-Seiten gibt.
  • Öffentliche Informationen möglichst öffentlich verlinken.
  • Archiviertes Material nicht unnötig löschen, sondern geordnet ablegen.
  • Sensible Daten nur in geeigneten geschützten Bereichen verwenden.

Ansprechpartner-Vorlage

Wenn eine Seite fachlich betreut wird, kann die Ansprechpartner-Vorlage am Ende der Seite eingefügt werden.

{{Vorlage:Ansprechpartner|Dummy ist Ansprechpartner}}

Beispiel:

{{Vorlage:Ansprechpartner|Beratungsteam}}
Hinweis:
Die Vorlage zeigt an, wer die Seite fachlich im Blick behält. Änderungen und Ergänzungen durch andere bleiben grundsätzlich möglich.

Für Fortgeschrittene: gestaltete Kästen

Für stärker gestaltete Inhaltsboxen kann die Vorlage Kastendesign1 genutzt werden.

{{Kastendesign1|
BORDER = #B88A00|
BACKGROUND = #FFF0C2|
BREITE = 100%|
BILD = Abend am Gymnasium.png|
ÜBERSCHRIFT = Wie lege ich ein neues Stichwort an?|
INHALT= 
# Legt eine neue Seite an, indem ihr sie hier unter dem entsprechenden Buchstaben als Stichwort in eckigen Klammern eintragt, 
z.B. '''Bearbeiten bei "S" und dann [[Stichwort]] in eckigen Klammern in eine neue Zeile'''. # Nach dem Abspeichern klickt ihr auf das Stichwort. Es sollte rot sein, wenn die Seite noch nicht angelegt wurde. # Fügt folgenden Befehl ein: '''{{ers:Vorlage:AGLeerseite}}''' und speichert die Seite ab. Damit ist die Grundstruktur für die Seite angelegt, zum Beispiel mit den Bereichen Konzept, Material und Links. }}

Parameter der Vorlage

Parameter Bedeutung
BORDER Farbe des Rahmens
BACKGROUND Hintergrundfarbe des Kastens
BREITE Breite des Kastens, zum Beispiel 100%
BILD Bilddatei, die im Kasten angezeigt wird
ÜBERSCHRIFT Titel des Kastens
INHALT Text, Listen oder Links im Kasten
Wichtig:
Bei Vorlagen, die auf einer Wikiseite nur als Beispiel angezeigt werden sollen, müssen geschweifte Klammern oft mit <nowiki> geschützt werden. Sonst versucht MediaWiki, die Vorlage direkt auszuführen.

Kurze Merkliste

Aufgabe Syntax
Interner Link [[UCS]]
Interner Link mit Text [[UCS|UCS-System]]
Externer Link [https://www.wbkkoeln.de/ucs UCS-System]
Datei verlinken [[Media:Datei.pdf|Beschreibung]]
E-Mail verlinken [mailto:name@example.org name@example.org]
Weiterleitung #WEITERLEITUNG [[Zielseite]]
Kategorie [[Kategorie:Name]]
Hinweisbox {{Infofenster | text = Hinweis}}