WikiHowTo: Unterschied zwischen den Versionen
Flow (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Sdk (Diskussion | Beiträge) |
||
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
Im April 2022 hatten wir einen Wikathon veranstaltet. | Im April 2022 hatten wir einen Wikathon veranstaltet um die grundlegende Neugestaltung unseres Wikis zu starten. Die Richtung steht und es ist noch viel zu tun: | ||
Wir lösen den Namensraum UUGRN: auf. Die darin enthaltenen Seiten sind alt und sollen entweder "migriert" werden, das heißt das Präfix entfernen wir und bringen die Seiten | === Deprecation des Namensraums "UUGRN:" === | ||
Wir lösen den Namensraum UUGRN: auf. Die darin enthaltenen Seiten sind alt und sollen entweder "migriert" werden, das heißt das Präfix entfernen wir und bringen die Seiten auf den aktuellen Stand, verlinken sie an passender Stelle etc. Veraltete Seiten wollen wir löschen. | |||
[[Tmp:Wiki-Migration/%C3%9Cbersicht_vorliegender_Seiten|Übersicht vorliegender Seiten]] | [[Tmp:Wiki-Migration/%C3%9Cbersicht_vorliegender_Seiten|Übersicht vorliegender Seiten]] | ||
=== Organisation und Deduplication === | |||
Jede variable Information, soll nur einmal gepflegt werden müssen. Daher ist es wichtig auf Primärquellen zu verlinken, statt information zu duplizieren. Z.b. stehen die Daten für Stammtisch und Fixme auf https://stammtisch.uugrn.org und https://fixme.uugrn.org und nur dort werden sie aktualisiert. | |||
=== Standard Seiten und Kategorien === | |||
Kategorien sind Seiten mit Unterseiten. Die Folgende Struktur soll eingehalten werden: | |||
'''Recht statische Seiten (selten geändert):''' | |||
* /Hauptseite - Die Hauptseite soll einfach und verständlich bleiben. | |||
* /Geschichte - Chronologischer Ablauf von Vereinsaktivitäten | |||
* /Artwork - Hier kommen Grafiken zur Wiederverwendung rein | |||
* /Verein - Detailierte Beschreibung des Vereins und Vereinszwecks | |||
* /Raum - Vorstellung der FIXME Location | |||
* /Hygienekonzept - Corona Hygienekonzept | |||
* /Archiv/... - Platz für alte Dokumente, die historischen Wert haben. | |||
'''Arbeitsseiten (häufig geändert):''' | |||
* /Veranstaltungen/<YYYY-MM-DD_Veranstaltung> - Seiten für Veranstaltungen. | |||
* /Wissen/<Artikel> - HowTos und Erklärungen | |||
* /Dienste/<Dienst> - Dienste die die UUGRN betreibt | |||
* /Maschinenraum/<Domain> - Technische Dokumentation von Diensten | |||
* /FIXME/Themen - Hier planen wir welche Themen wir im FIXME behandeln | |||
* /FIXME/Themen/Protokoll_<YYYY-MM-DD> - Hier können Protokolle angelegt werden falls die eine Zeile in /FIXME/Themen nicht ausreicht. | |||
Die Hierarchie soll möglichst kurz gestaltet sein. Wir wollen also '''nicht''' /Wissen/OS/Debian/Bash/HowToPrompt. Sondern eher /Wissen/Eigener_Prompt_in_Bash. | |||
'''Farben''' | |||
Damit das Wiki nicht zum bunten Obstsalad wird, haben wir uns entschieden bei der Gestaltung von Wikielementen die Theme Farben zu verwenden. | |||
* Rot: #b32424 | |||
* Blau: #2A4B8D | |||
* Grün: #2A4B8D | |||
Infoboxen mit diesen Farben könnt ihr von der Hauptseite kopieren. | |||
=== Wiki Features === | |||
MediaWiki ist eine mächtige Wiki Software. Leider erschwert die Nutzung all dieser Features die Mitarbeit von allen, die sich weniger gut auskennen. Darum dokumentieren wir hier einige Mediawiki Features die über die Dinge, die in https://www.mediawiki.org/wiki/Help:Formatting beschrieben sind hinaus gehen. | |||
'''<nowiki>Page Includes</nowiki>''' | |||
Der Seiteninhalt von Seite A, kann in Seite B eingebunden werden. Dazu schreibt man auf Seite A: | |||
<pre><nowiki> | |||
{{:Seite/B}} | |||
</nowiki></pre> | |||
Standardmäßig wird die komplette Seite/B an dieser Stelle eingefügt. Möchte man nur einen Teil von Seite/B zur anzeigen, kann man Teile von seite B über <nowiki><noinclude></nowiki> auf Seite/B ausklammern. | |||
<pre><nowiki> | |||
<noinclude> | |||
Dieser Teil wird nicht angezeigt. | |||
</noinclude> | |||
Dieser Teil wird angezeigt | |||
</nowiki></pre> | |||
'''TOC position, oder ausblenden''' | |||
Werden mehrere Überschriften verwendet, blendet MediaWiki sein TOC (Table Of Contents) ein. Die Position dieses TOC kann mit <nowiki>__TOC__</nowiki> bestimmt werden. Möchte man gar kein TOC haben, schreibt man <nowiki>__NOTOC__</nowiki> irgendwo auf die Seite (überlicherweise ganz oben). |
Aktuelle Version vom 11. Januar 2023, 16:25 Uhr
Im April 2022 hatten wir einen Wikathon veranstaltet um die grundlegende Neugestaltung unseres Wikis zu starten. Die Richtung steht und es ist noch viel zu tun:
Deprecation des Namensraums "UUGRN:"[Bearbeiten]
Wir lösen den Namensraum UUGRN: auf. Die darin enthaltenen Seiten sind alt und sollen entweder "migriert" werden, das heißt das Präfix entfernen wir und bringen die Seiten auf den aktuellen Stand, verlinken sie an passender Stelle etc. Veraltete Seiten wollen wir löschen.
Organisation und Deduplication[Bearbeiten]
Jede variable Information, soll nur einmal gepflegt werden müssen. Daher ist es wichtig auf Primärquellen zu verlinken, statt information zu duplizieren. Z.b. stehen die Daten für Stammtisch und Fixme auf https://stammtisch.uugrn.org und https://fixme.uugrn.org und nur dort werden sie aktualisiert.
Standard Seiten und Kategorien[Bearbeiten]
Kategorien sind Seiten mit Unterseiten. Die Folgende Struktur soll eingehalten werden:
Recht statische Seiten (selten geändert):
- /Hauptseite - Die Hauptseite soll einfach und verständlich bleiben.
- /Geschichte - Chronologischer Ablauf von Vereinsaktivitäten
- /Artwork - Hier kommen Grafiken zur Wiederverwendung rein
- /Verein - Detailierte Beschreibung des Vereins und Vereinszwecks
- /Raum - Vorstellung der FIXME Location
- /Hygienekonzept - Corona Hygienekonzept
- /Archiv/... - Platz für alte Dokumente, die historischen Wert haben.
Arbeitsseiten (häufig geändert):
- /Veranstaltungen/<YYYY-MM-DD_Veranstaltung> - Seiten für Veranstaltungen.
- /Wissen/<Artikel> - HowTos und Erklärungen
- /Dienste/<Dienst> - Dienste die die UUGRN betreibt
- /Maschinenraum/<Domain> - Technische Dokumentation von Diensten
- /FIXME/Themen - Hier planen wir welche Themen wir im FIXME behandeln
- /FIXME/Themen/Protokoll_<YYYY-MM-DD> - Hier können Protokolle angelegt werden falls die eine Zeile in /FIXME/Themen nicht ausreicht.
Die Hierarchie soll möglichst kurz gestaltet sein. Wir wollen also nicht /Wissen/OS/Debian/Bash/HowToPrompt. Sondern eher /Wissen/Eigener_Prompt_in_Bash.
Farben
Damit das Wiki nicht zum bunten Obstsalad wird, haben wir uns entschieden bei der Gestaltung von Wikielementen die Theme Farben zu verwenden.
- Rot: #b32424
- Blau: #2A4B8D
- Grün: #2A4B8D
Infoboxen mit diesen Farben könnt ihr von der Hauptseite kopieren.
Wiki Features[Bearbeiten]
MediaWiki ist eine mächtige Wiki Software. Leider erschwert die Nutzung all dieser Features die Mitarbeit von allen, die sich weniger gut auskennen. Darum dokumentieren wir hier einige Mediawiki Features die über die Dinge, die in https://www.mediawiki.org/wiki/Help:Formatting beschrieben sind hinaus gehen.
Page Includes
Der Seiteninhalt von Seite A, kann in Seite B eingebunden werden. Dazu schreibt man auf Seite A:
{{:Seite/B}}
Standardmäßig wird die komplette Seite/B an dieser Stelle eingefügt. Möchte man nur einen Teil von Seite/B zur anzeigen, kann man Teile von seite B über <noinclude> auf Seite/B ausklammern.
<noinclude> Dieser Teil wird nicht angezeigt. </noinclude> Dieser Teil wird angezeigt
TOC position, oder ausblenden
Werden mehrere Überschriften verwendet, blendet MediaWiki sein TOC (Table Of Contents) ein. Die Position dieses TOC kann mit __TOC__ bestimmt werden. Möchte man gar kein TOC haben, schreibt man __NOTOC__ irgendwo auf die Seite (überlicherweise ganz oben).