In Arbeit...

Wir werden jetzt nicht den gesamten Content der eingebauten Hilfe hier reinkopieren. Also was soll hier rein? Diskussion und Planung am Ende: #DokumentPlanung

Wiki Help

Ein Destillat der Help-Seiten von http://moinmo.in plus eigenen Kommentaren und Erfahrungen.

Nachdem dort alle Help-Seiten in dieser Form benannt sind, http://moinmo.in/HelpOn, lassen sie sich alle über diesen Link auflisten. Ein wunderbares Feature.

Nur keine Angst vor dem Wiki. Wer bereits mit HTML in Berührung gekommen ist, hebt das mit Links. Für jemanden, der noch nie mit einer Auszeichnungssprache in Berührung gekommen ist, ist dies ein wunderbarer leichter Einstieg in dieses Gebiet.

GUI-Editor

Prinzipiell sollte das Erlernen der Wiki-Sprache angestrebt werden, da die Arbeitsweise im Text-Modus sicherlich die effektivste ist. Für Wiki-Neulinge ist es jedoch nicht schlecht mit dem GUI-Editor zu beginnen und erst die Feinheiten, die der GUI-Editor nicht anbietet, im Text-Modus zu erledigen. Im GUI-Modus lässt sich Wiki-Markup einfügen, somit kann man beides kombinieren, ohne permanent den Modus umschalten zu müssen.

Hier einer Auflistung der Dinge, die der GUI-Editor nicht anbietet:

• Link-Features (Link-Text, target="_blank",...) (die Link-Funktion ist sowieso überflüssig, siehe #HelpOnLinking)

Help On Linking

http://moinmo.in/HelpOnLinking

Einfache Links, z.B. ohne Link-Text, einfach in die Seite einfügen. Die werden vom Wiki automatisch erkannt.

Der GUI-Editor bietet lediglich die Möglichkeit einfache Links einzufügen, somit erscheint diese Funktion ziemlich sinnlos.

Für diverse Link-Features (Link-Text, target="_blank",...) muss der Link entsprechend ausgezeichnet werden. z.B.:

internal link with linktext: [[SomePage|some Page]]

external link with linktext: [[http://example.net/|example site]]

internal link to a section: [[SomePage#subsection|subsection of Some Page]] (siehe #HelpOnAnchors)

internal link to a section on the same page: [[#subsection]] (siehe #HelpOnAnchors)

Help On Anchors

http://moinmo.in/HelpOnLinking#Anchors

Zum Referenzieren auf eine bestimmte Stelle einer Seite, muss dort ein Anker mittels des Anchor-Makros gesetzt werden: <<Anchor(anchorname)>>

Link zu einem Anker auf der selben Wiki-Seite: [[#anchorname]] or [[#anchorname|label text]]

Link zu einem Anker auf einer anderen Wiki-Seite: [[PageName#anchorname]] or [[PageName#anchorname|label text]]

Das funktioniert auch für Webseiten ausserhalb des Wikis.

HelpOnHeadlines

http://moinmo.in/HelpOnHeadlines

Zwei Restriktionen bei Überschriften:

• Überschriften dürfen/können kein Wiki-Markup enthalten. Das betrifft die ganze Zeile, somit z.B. Anchors eine Zeile davor setzen (siehe #HelpOnAnchors).

• Ein Einzug bei Überschriften ist nicht möglich.

Dokument Planung und Diskussion

Wozu das hier?

• Ergänzung zur eingebauten Hilfe (Tips, Tricks, Bugs die nicht oder nicht so offensichtlich dokumentiert sind)
• Einstiegshürde minimieren (was zuerst in der Hilfe lesen, Super-Mega-Fast-Tutorial)

Strategie

• So wenig wie möglich Inhalte aus der internen Hilfe - So viel wie möglich auf die interne Hilfe referenzieren
• Vorzüge dieses Wiki's nahe bringen (@ Facebook-Klicksi-Klacksi-Generation - "viele viele bunte Smarties")

Inhalt

• Was zuerst in der Hilfe lesen (Beginner, Advanced, Expert)

• Super-Mega-Fast-Tutorial

• Tips, Tricks, Bugs
• Empfehlungen für die persönlichen Einstellungen
• Empfehlungen für Seiten-Layouts (Makros,...)
• Leitfaden zum kollaborativen Arbeiten