Project:Warming Up/Deutsch

Looking for an English version? Go to Warming Up/English.

... 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!
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...

 * ... create a new page?
 * Option: Suchen, falls die Seite nicht schon vorhanden ist, bietet das System ein freundliches "You can create this page"
 * 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


 * ... import a table from Excel? Mithilfe des Copy & Paste Excel-to-Wiki Converters kann man Excel-Tabellen einfach per Copy&Paste in Wiki-Code umwandeln lassen. Diesen Code dann wiederum per Copy&Paste in CoLab einfügen.


 * ... export a table to Excel? Alle Einträge markieren, neues Datenblatt in Excel öffnen und aus dem Menü "Edit -> Paste Special... -> Text" auswählen


 * ... 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. 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. Ein Link zu eDoc : Ein Link zu eDoc


 * ... create a new category page?
 * Fall: Durch die Kategorisierung einer Wikiseite mit einem neuen Begriff (z.B. ) wird automatisch eine leere Kategorienseite erstellt. Diese ist anschliessend sowohl in Special:Categories als auch über die entsprechende Artikelseite verlinkt.
 * 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.
 * 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

 * 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 unterdrückt und  auch auf Seiten mit weniger als drei Überschriften erzwungen werden.

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

Retrieving pages

 * Special:Search


 * Special:Recentchanges: 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
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
 * 1) nur bestimmte Dateitypen geladen werden können (z.B. gif, jpg, pdf, mmt) und
 * 2) 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
Let's start rocking!

Etikette and best practice
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 unter Editing policies.

Kooperatives Arbeiten: Diskussion & Kommentare
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 abzuschließen. Eine Signatur mit Nutzernamen und Zeitstempel wird automatisch eingefügt, wenn man einen Kommentar mit vier Tilden abschließt: ~. Das Resultat sieht so aus: --Tanja 08:53, 6 August 2008 (UTC)

Private Seiten
Tendenziell sind alle CoLab-Seiten von Beginn an öffentlich sichtbar und koennen von allen Nutzern bearbeitet und ergaenzt werden. Zur Vorbereitung kann man aber neuen Beiträge zunaechst unter seinem eigenen "Namenspace" anlegen, z.B. User:Sabine/Affiliations. Diese Seiten werden standardmässig 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
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
ACHTUNG: Das Ziel von CoLab ist die öffentliche Verbreitung von Informationen mit Bezug zur eScience-Thematik. Auch wenn in diesem Wiki Zugriffssrechte teilweise eingeschränkt werden können, bietet das verwendete PlugIn keinen vollständigen Schutz der Inhalte. Daher gilt: CoLab ist nicht der richtige Platz für interne/vertrauliche Dokumente. Weiterführende Infomationen finden sich unter http://www.mediawiki.org/wiki/Extension:Group_Based_Access_Control

Wie?: 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: &lt;accesscontrol&gt;Usergroupname,,&lt;/accesscontrol&gt;. Sollten mehrere Usergroups auf die Seite zugreifen, sieht das folgendermaßen aus: &lt;accesscontrol&gt;Usergroupname1,,Usergroupname2,,&lt;/accesscontrol&gt;

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

Diskussionsseiten zu einem Wiki-Artikel werden nicht automatisch mit-geschützt, d.h. auch Diskussionsseiten müssen explizit mit dem &lt;accesscontrol&gt; -Tag ausgezeichnet werden.

Nutzung von Variablen
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:

Externe Texteditor Tools
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

Weiterlesen
Eine PDF-Version der Slides zum CoLab Workshop, der anlässlich der Bibliothekstagung der Max-Planck-Institute von 2008 stattfand, kann heruntergeladen werden.