Project:Warming Up/Deutsch

... zum Start ein kleines Video zur Einführung in wikis.

Wikis eigenen sich wunderbar, um Informationen auf eine schnelle Weise im WWW verfügbar zu machen und eine verteilte Editierung dieser Information zu ermöglichen. Einzelne Projekte in der MPDL (und den entsprechenden Vorgänger-Einrichtungen) benutzen schon seit geraumer Zeit Wiki-Software, z.B. um

Informationen zu strukturieren, archivieren und auszutauschen
gemeinsam an Dokumenten zu arbeiten und einen Diskussionsstand festzuhalten
Dokumentationen zu Schnittstellen oder Programmen zu erstellen
Aufgabenlisten zu verwalten
Prozesse aufzusetzen und zu verfolgen

Hands On![edit]

MediaWiki ist die Software, die sich hinter dem Wikipedia-Projekt befindet. Im Rahmen dieses Projektes wurden eine ganze Reihe von Tutorials, Hilfetexten und Policies entwickelt, die sich unter http://de.wikipedia.org/wiki/Wikipedia:Hilfe finden. Die Funktionalität der Wiki-Software kann durch Plug-Ins erweitert werden.

How to...[edit]

... create a new page?
1. Option: Suchen, falls die Seite nicht schon vorhanden ist, bietet das System ein freundliches "You can create this page"
2. Option: Einen internen Wiki-Link auf einer Seite aufnehmen

... format a page? Die MediaWiki Syntax dient zur Formatierung der Texte auf einer Wiki-Seite. Die Sandbox ist ein prima Platz, um diese Syntax auszuprobieren.

... write in colored letters? Eine zusätzliche nützliche Formatierung ist das Schreiben in Farbe. Den zu färbenden Text umschließt man mit einem -Tag. Das sieht auf der Bearbeiten-Seite so aus: grüner Text und erscheint im Artikel dann als grüner Text. Möglich sind auch andere Farben, z.B. Magenta (color="magenta"), Gelb (color="yellow") oder Lila (color="purple"). Blau und rot sollte man besser nicht verwenden, da diese Farben standardmäßig für mit bzw. ohne Inhalt hinterlegte Links verwendet werden. Der Farbgestaltung sind ansonsten kaum Grenzen gesetzt, man kann z.B. auch mit Hexadezimal-Farbdefinitionen arbeiten, etwa mit der Farbe FF6600 (color="#FF6600").

... make a table? Anleitung, s. http://de.wikipedia.org/wiki/Hilfe:Tabellen

... solve an "edit conflict"? Die verteilte Bearbeitung von Dokumenten führt dazu, dass manchmal vielleicht zwei Personen an derselben Seite arbeiten. Falls man versucht, eine Seite zu speichern, die zwischenzeitlich von jemand anders bearbeitet worden ist, weisst das System einen darauf hin

... link to a wiki page? Indem man den Namen der Wiki-Seite in doppelte eckige Klammern setzt, z.B. [[Sandbox]]. Falls man dem Link einen "sprechenden Titel" geben moechte, wird dieser einfach nach einem senkrechten Strich ergänzt, z.B. [[Sandbox|Ein Link zur Sandbox]]: Ein Link zur Sandbox

... link to an external pages? Einfach die URL in den Text kopieren. Auch für externe Links kann man einen beliebigen Titel vergeben, z.B. [http://edoc.mpg.de Ein Link zu eDoc]: Ein Link zu eDoc

... create a new category page?
1. Fall: Durch die Kategorisierung einer Wikiseite mit einem neuen Begriff (z.B. [[Category:Test]]) wird automatisch eine leere Kategorienseite erstellt. Diese ist anschliessend sowohl in Special:Categories als auch über die entsprechende Artikelseite verlinkt.
2. Fall: Irgendeine Kategorie aufrufen; in der URL stehenden Kategoriennamen durch neuen gewünschten Namen ersetzen. Wenn es die Kategorie-Seite noch nicht gibt, bietet das System an, die Kategorien-Seite neu zu erstellen.
3. Fall: Eine bereits bestehende Seite soll zur Kategorien-Seite (neue Kategorie) werden: Kategorie anlegen wie oben beschrieben. Inhalt der bestehenden Seite mit copy&paste einfügen. Alte Seite löschen. Wer einen besseren Weg kennt, bitte gerne ergänzen.

... link to a category page? Indem man den Namen der Kategorie durch das Präfix ":Category" ergänzt und den kompletten Text in eckige Klammern setzt, z.B. [[:Category:ArticleContent]].

... include an image? Zuerst ueber die Funktion "Upload file" in der linken Navigationsleiste unter "toolbox" auswählen. Anschliessend kann man das Bild mit dem Tag [[Image:File.png|alternativer Text]] einfügen. Mit [[Image:File.png|frame|center|alternativer Text]] kann Ansicht und Positionierung der Bilder bestimmt werden, s. Anleitung.

Organizing Pages[edit]

Inhaltsverzeichnis für eine Seite: Das Inhaltsverzeichnis zu Beginn einer Seite wird automatisch erstellt, sobald für einen Artikel mehr als 3 Überschriften definiert sind. Überschriften werden in der Wiki-Syntax mit "=", "==" bzw. "===" ausgezeichnet. Die Anzeige des Inhaltsverzeichnisses kann mit dem Tag __NOTOC__ unterdrückt und __TOC__ auch auf Seiten mit weniger als drei Überschriften erzwungen werden.

References: Im CoLab wurde das Cite-Template installiert, um das Zitieren von Informationsquellen zu erleichtern. Die Zitat bzw. Querverweise werden im Text durch ein <ref...>-Tag ausgezeichnet und können dann an einer beliebigen Stelle formatiert ausgegeben werden, z.B.

[...]
Digital Library Federation."<ref name="mets standard">http://www.loc.gov/standards/mets - METS homepage</ref> 
[...]
==References==
<references />

Sidebar: Die Navigationselemente auf der linken Bildschirmseite wird auch "Side Bar" genannt. Das Aussehen und die Struktur dieser Navigation wird durch eine spezielle wiki-Seite ("MediaWiki:Sidebar") bestimmt. Diese Seite ist nicht durch alle Nutzer, sondern lediglich durch den "WikiSysop" editierbar. Weiterführende Informationen finden sich unter http://www.mediawiki.org/wiki/Manual:Sidebar

Special:Categories: Wiki-Seiten können mit beliebig vielen Begriffen ausgezeichnet ("getaggt") werden. Diese Kategorien bieten später einen alternativen Einstieg zu den Inhalten.
- Neue Kategorien können erstellt werden, indem man folgenden Zeichenfolge ans Ende einer Wiki-Seite kopiert: [[Category:Name_der_Kategorie]]
- Die Zuordnung einer Seite zu einer Kategorie erfolgt, wenn folgende Zeichenfolge ans Ende der Wiki-Seite geschrieben wird: [[Category:Name_der_Kategorie]]
- Neue Unterkategorien können erstellt werden, indem man auf der Seite der Unterkategorie die übergeordnete Kategorie auswählt, s.
- Da eine Kategorie nicht über die standard Suchfunktion gefunden werden kann, empfiehlt es sich manchmal, zu einer Kategorieseite noch eine entsprechende Wiki Seite zu erstellen, die dann den Content der Kategorie beschreibt. Diese Seite wird ebenfalls mit der entsprechenden Kategorie getagt. Damit sie allerdings nicht in der Menge der Artikel einer Kategorie untergeht, kann sie durch folgenden Befehl an den Anfang der Artikelliste gestellt werden: [[Category:Name_der_Kategorie| ]] (siehe Kategorie PubMan).
- Weiterführende Informationen Hilfe zu Kategorien, zum Kategorien-Browser

Portals: The english wikipedia specifies: "The idea of a portal is to help readers and/or editors navigate their way through Wikipedia topic areas through pages similar to the Main Page. In essence, portals are useful entry-points to Wikipedia content." Example portals give a very short definition, point to selected articles/images, list relevant categories, etc., see http://en.wikipedia.org/wiki/Portal:Computer_security.

Retrieving pages[edit]

Special:Search

Special:Recent Changes: Auf dieser "Spezialseite" finden sich die neuesten Änderungen im Wiki. Dies ist sehr hilfreich, um sich über Updates zu informieren

Special:Categories: Über die Kategorien-Auswahl können Wiki-Seiten beliebig vielen inhaltlichen Aspekten zugeordnet werden. Diese stehen dem Nutzer anschließend als eigenständige Einstiegspunkte zur Verfügung und stellen die Informationen unter dem inhaltlichen Aspekt zur Verfügung, z.B.

Working with files[edit]

Grundsätzlich ermöglicht diese Mediawiki Installation das Hochladen von Dateien, um diese den CoLab Nutzern verfügbar zu machen, s. Special:Imagelist. Dabei sollte man beachten, dass

nur bestimmte Dateitypen geladen werden können (z.B. gif, jpg, pdf, mmt) und
die maximale Dateigröße im System konfiguriert ist (derzeit 20 MB)

Insgesamt ist diese Wiki-Installation nicht als Fileserver gedacht, es sollten daher nur Dokumente geladen werden, die für die Illustration eines speziellen CoLab-Artikels benötigt werden und nicht in anderen Zusammenhängen relevant sind. Ausführlichere Dokumente (z.B. Protokolle, Reports, Präsentation, etc.) sollten auf einem anderen Server abgelegt und verlinkt werden.

MPDL Nutzer: Interne Dokumente gehören möglichst unter Versionskontrolle, z.B. in die Subversion-Installation auf dem Server zim01.gwdg.de. Die Inhalte auf diesem Server sind zwar generell password geschützt, aber es wurde ein Tag "public" eingerichtet und das zugehoerige Verzeichnis https://zim01.gwdg.de/repos/smc/tags/public/ für anonyme Nutzer geöffnet (Lese-Zugriff).

Falls Ihr Dokumente frei verfügbar machen wollte, müssen diese dem Tag "public" zugeordnet werden, dies geschieht mittels des SVN Copy Befehls. Im TortoiseSVN heisst der Befehl "Copy(Branch/Tag)".

Erweiterte Techniken und Tools[edit]

Let's start rocking!

Etikette and best practice[edit]

Beim Aufbau einer "Community" sollten die grundlegenden Regeln und Prinzipien festgelegt (und dokumentiert) werden, nach denen die Gruppe arbeiten möchte (s. Wikipedia-Richtlinien). Für das CoLab wurden zunächst nur wenige Regeln festgelegt, um auch künftigen Entwicklungen und Erfahrungen Raum zu lassen. Diese finden sich auf der CoLab Startseite.

Kooperatives Arbeiten: Diskussion & Kommentare[edit]

Wikis wurden erfunden, um Internet-Nutzern ein einfaches Instrument an die Hand zu geben, mit dem sie gemeinsam Informationen erstellen und pflegen koennen. Wiki-Seiten "gehoeren" daher haeufig nicht EINEM Autoren, sondern sind das Ergebnis einer Gruppe von Beitragenden. Informationen, die von anderen Nutzern lediglich konsumiert und nicht ergaenzt werden sollen, sind im CoLab schlecht aufgehoben!

Diskussions-Seite: Für jede Wiki-Seite wird automatisch eine zusätzliche Diskussions-Seite angelegt. Dabei handelt es sich um eine "Meta-Seite", auf der Informationen zum Artikel abgelegt werden können, z.B. "Wir bräuchten noch einen Absatz zum Thema...", "Es sollten noch mehr Beispiele ergänzt werden...". Die Diskussionsseite ist über den entsprechenden "Reiter" oben rechts von jeder Artikel-Seite erreichbar, s. http://de.wikipedia.org/wiki/Wikipedia:Diskussionsseiten

Kommentare: Es ist ziemlich schwierig, einen Artikel so zu kommentieren, dass der eigentliche Inhalt verständlich bleibt und die Anmerkungen den einzelnen Nutzern zugeordnet werden können. Die WikiMedia-Anleitung empfiehlt, Kommentare durch Doppelpunkte einzurücken und mit einer Signatur/Unterschrift abzuschliessen.

Private Seiten[edit]

Tendenziell sind alle CoLab-Seiten von Beginn an oeffentlich sichtbar und koennen von allen Nutzern bearbeitet und ergaenzt werden. Zur Vorbereitung kann man aber neuen Beitraege zunaechst unter seinem eigenen "Namenspace" anlegen, z.B. User:Sabine/Affiliations. Diese Seiten werden standardmaessig nicht mitgesucht oder auf der Special:All_Pages-Seite angezeigt. Sobald die Seiten für ein breites Publikum von Interesse sind, kann man sie dann in den Main-Namespace verschieben (s.o.)

Blocken von IPs/Accounts[edit]

Der Wiki Administrator (WikiSysop) sieht bei allen Nutzern eine zusätzlichen Option "Block". Über diese Funktion kann ein Nutzer bzw. eine IP-Adresse für die Bearbeitung von Seiten geblockt werden. Dies kann laut der CoLab

In Wikipedia gibt es eine Gruppe von "Administratoren", die auch die Möglichkeit haben Nutzer blocken dürfen, s. http://en.wikipedia.org/wiki/Wikipedia:Guide_to_administrator_intervention_against_vandalism.

Lese-Zugriff für eine Seite beschränken[edit]

Dafür muss zuerst eine Usergroup erstellt werden (eine Seite mit dem Namen "Usergroup:Usergroupname"), in der alle zugehörigen Personen mit ihren CoLab Account aufgelistet werden. Dabei ist zu beachten, dass sobald eine Usergoup erstellt wurde, diese von keinem User außer dem Administrator mehr gelesen bzw. editiert werden kann. Existiert die Usergroup, wird folgende Syntax in die erste Zeile der zu beschränkenden Seite eingefügt: <accesscontrol>Usergroupname,,</accesscontrol>. Sollten mehrere Usergroups auf die Seite zugreifen, sieht das folgendermaßen aus: <accesscontrol>Usergroupname1,,Usergroupname2,,</accesscontrol>

Seiten mit eingeschränkten Zugriffsrechten sollten einen entprechenden Hinweis tragen, z.B. '''Restricted Access''' , z.B. Faces Schedule

Diskussion des PlugIns: http://www.mediawiki.org/wiki/Extension:Group_Based_Access_Control

Read-Only-Zugriff für eine Seite[edit]

Soll einer Usergroup nur ein Lese-, aber kein Schreibzugriff für eine Seite gewährt werden, geht man zunächst genauso vor wie unter Lesezugriff für eine Seite beschränken beschrieben. Beim Festlegen der Zugriffsrechte im Artikel ergänzt man dann einfach ein (ro) für "read only" am Ende des Usergroupnames: <accesscontrol>Usergroupname1(ro),,Usergroupname2,,</accesscontrol>. In diesem Beispielfall hat die Usergroup1 nur Leserechte, die Usergroup2 sowohl Schreib-, als auch Leserechte.

Calender[edit]

Der Calender verwendet im Hintergrund das Categories-Tool. Sobald eine Seite einer speziellen Datums-Kategorie (z.B. "2007/07/03") zugeordnet ist, wird diese auf der Spezialseite Special:Events gelistet.

Nutzung von Variablen[edit]

Die Wikimedia-Software stellt eine Reihe von Systemvariablen zur Verfügung, die im Wiki-Code verwendet werden können, s. http://de.wikipedia.org/wiki/Hilfe:Variablen. Beispiele:

was	wie	so siehts aus...
number of articles	{{NUMBEROFARTICLES:R}}	2303
number of pages	{{NUMBEROFPAGES:R}	6477
current time	{{CURRENTTIME}}	20:29

Externe Texteditor Tools[edit]

Für lange Artikel macht es Sinn externe Editoren zu verwenden. Ab Version 2.3 kann OpenOffice Wiki Markup ausgeben. Für ältere Versionen ist ein Plugin erhältlich:

http://wiki.services.openoffice.org/wiki/Odt2Wiki

Für Word gibt es ein Makro:

http://edutechwiki.unige.ch/en/Word2MediaWikiPlus_Demo