Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- miradlo:hilfe:faq [2010/09/07 12:38]
roland
+++ miradlo:hilfe:faq [2015/01/04 15:25] (aktuell)
ute aktualisiert nach update
@@ Zeile 2: / Zeile 2: @@
 Hier gibt's Antworten auf die häufigsten Fragen, die immer mal wieder auftauchen...
-====== Wie lege ich eine neue Seite an? ======
+===== Wie lege ich eine neue Seite an? =====
-Unter [[http://www.dokuwiki.org/de:pagename|Seite anlegen]] ist dies schön beschrieben.\\
+Wichtig sind die Begriffe **Namensraum**  und **Subkategorie**. Der **Namensraum** ist der Bereich, der z.B. in der **Box miradlo** in der Navigation des miradlo-Wikis angezeigt wird. Die **Subkategorie** ist ein weiterer Unterpunkt, z.B. unter miradlo:
-Wichtig ist der Begriff NAMENSRAUM der Beispielsweise die Box miradlo auf diesem Wiki ist.\\
+  * [[miradlo:anleitungen:inhaltsverzeichnis|Anleitungen Inhaltsverzeichnis]]
-Weiterhin ist der Begriff SUBKATEGORIE wichtig. Eine SUBKATEGORIE ist zum Beispiel hier bei miradlo das Inhaltsverzeichnis.
+  * [[miradlo:hilfe:inhaltsverzeichnis|Hilfeseiten : Inhaltsverzeichnis]]
-Wenn wir in die SUBKATEGORIE Inhaltsverzeichnis eine weitere Seite einfügen wollen, dann können wir diese beiden Schritte ausführen:\\
+Jede Unterkategorie hat in unserem Wiki ein I**nhaltsverzeichnis**, welches die vorhandenen Unterseiten auflistet.
-**NAMENSRAUM:SUBKATEGORIE:NEUE_SEITE im Suchfeld (oben links) eingeben**\\
-Es erscheint das Ergebnis der Suche bei dem keine Treffer angezeigt werden, da die Seite ja noch nicht existiert.\\
+==== Seite in einem Namensraum neu anlegen ====
-Oberhalb des Suchfeldes erscheint der Link **Seite anlegen**. Hiermit kann nun NEUE_SEITE angelegt werden.
+Neue Seiten können in einem **Namensraum** angelegt werden, z.B. im Namensraum miradlo:
-====== Wie lege ich einen neuen Sidebar Eintrag an? ======
+  * [[miradlo:kontakt|Sie möchten auch ein Wiki?]]
-Dieses Wiki verwendet ein Theme das es erlaubt auf der linken Seite Themenbereiche in einzelnen Gruppen anzuzeigen. Falls Sie das Wiki aufrufen ohne angemeldet zu sein, wird Ihnen nur die öffentlich zugänglichen Bereiche angezeigt.
+  * im Suchfeld (oben links) eingeben:
-Falls Sie als Administrator angemeldet sind, können Sie weitere Gruppierungen in der Sidebar eintragen.
+     * **namensraum:neue_seite**
-Gehen Sie wie folgt vor:
+  * in der Adresszeile des Browsers innerhalb der Kategorie:
-  * Legen Sie einen neuen Namensraum und einen Sidebar  an. **<NAMENSRAUM>:sidebar** z.B. miradlokit:sidebar. Beachten Sie, ein **~~NOCACHE~~** einzufügen, damit die Sidebar nicht gecachet wird immer aktualisiert wird.
+     * http://wiki.miradlo.de/miradlo/neue_seite
-  * Wählen Sie den Menüpunkt **Admin** aus
-  * Die Berechtigungen werden als Baum auf der linken Seite dargestellt. Wählen Sie den betroffenen Menüeintrag **group:<NAMENSRAUM>:sidebar** z.B. group:miradlokit:sidebar
+==== Seite bearbeiten / löschen ====
-  * Vergeben Sie Rechte für Anwender.
+Auf jeder Seite befindet sich in der oberen linken Ecke ein Knopf **Diese Seite bearbeiten**. Aktiviert diesen Knopf um in den Editiermodus der Seite zu gelangen.\\
+Um eine Seite zu löschen muss man lediglich mit Hilfe des Editiermodus die Inhalte entfernen und abspeichern.
+  - Seite welche gelöscht werden soll auswählen
+  - In den Editiermodus wechseln (Button **Diese Seite bearbeiten**)
+  - Den gesamten Inhalt löschen (der Cursor muss an erster Stelle stehen und kein Inhalt darf vorhanden sein. "**kein Inhalt**" heißt auch kein Leerzeichen und kein leerer Absatz)
+  - Seite speichern (Button **Speichern**)
+==== roter Link in einer Seite ====
+Ein "roter Link" bedeutet, dass die Seite zu der verlinkt wird, nicht existiert. Entweder die **Seite wurde verschoben** und ist jetzt an anderer Stelle (die Suche hilft dann weiter) oder die **Seite existiert nicht**.
+Klickt man auf den Link so zeigt auch das Wiki die Meldung:"**Dieses Thema existiert noch nicht**.
+  * Seite wurde verschoben: Link anpassen
+  * Seite existiert nicht: Seite neu anlegen
+==== Seiten umbenennen oder verschieben ====
+Seiten umbenennen oder verschieben [[http://wiki.miradlo.de/miradlo/hilfe/faq?do=admin&page=pagemove |im miradlo-Wiki ]] Wir setzen das Plugin pagemove von dokuwiki ein, damit klappt verschieben und umbenennen meist problemlos. Der Vorteil des Plugins ist, dass die Links zu der verschobenen Seite erhalten bleiben, das Plugin versucht alle wiki-internen Links zu finden und anzupassen.
+==== Wie kopiere ich ganze Wiki-Seiten? ====
+Manchmal kommt es vor, dass man den Inhalt einer ganzen Seite mit allen Überschriften kopieren und in eine neue Seite einfügen will.\\
+  * Wechseln zu der zu kopierenden Seite
+  * Oben links den Link **diese Seite bearbeiten** wählen
+  * der Editor (ein Bearbeitungsfenster) öffnet sich, der gesamte Inhalt der Seite ist so zugänglich
+  * Inhalt kopieren und in die neue angelegte Seite einfügen
+==== Kann ich ein Inhaltsverzeichnis für längere Seiten haben? ====
+dokuwiki erstellt automatisch ein Inhaltsverzeichnis, sobald es **mehrere Überschriften** oberer Ebene gibt.
+==== Inhaltsverzeichnis aktualisieren ====
+Falls sich ein Verzeichnis nicht von selbst aktualisiert nachdem man eine Seite in diesem Bereich neu hinzugefügt, umbenannt oder gelöscht hat, dann fehlt wohl <code>~~NOCACHE~~</code> im Inhalt. Diverse Plugins für automatische Einträge sind installiert, siehe:
+  * Liste der hier genutzten Plugins: [[miradlo:hilfe:dokuwikiplugins|dokuwiki-Plugins ::: Hilfe]]
+===== Namensraum (namespace) löschen =====
+dokuwiki löscht den namespace, sobald die letzte Seite gelöscht wurde.
+Beim Ändern verschluckt sich dokuwiki manchmal, falls noch ein Rest rumliegt:
+  * falls in der Übersicht von indexmenu oder nspages Seiten auftauchen, die rot verlinkt, also nicht existierend sind, gibt es meist zwei Ursachen:
+  * im Medienbaum liegt noch ein Bild
+  * dokuwiki hat nicht kapiert, dass es nichts mehr gibt, dann:
+     * Namensraum z.B: miradlo_intern:komponenten:zu_loeschender_namensraum
+     * Seite anlegen: miradlo_intern:komponenten:zu_loeschender_namensraum:inhaltsverzeichnis (bei uns die Defaultseite für einen Namensraum)
+     * Seite wieder löschen
+  * bisher ließ sich mit diesen beiden Möglichkeiten jeder Namensraum löschen
+===== Subkategorie neu anlegen =====
+Eine neue **Subkategorie** wird ebenso angelegt, z.B. im Namensraum miradlo:
+  * die Subkategorie hilfe mit der Startseite Inhaltsverzeichnis [[miradlo:hilfe:inhaltsverzeichnis|miradlo:hilfe:inhaltsverzeichnis]]
+  * im Suchfeld (oben links) eingeben:
+     * **namensraum:subkategorie:neue_seite**
+  * in der Adresszeile des Browsers innerhalb der Kategorie:
+     * http://wiki.miradlo.de/miradlo/neue_subkategorie
+===== Wie lege ich einen neuen Sidebar-Eintrag (Navigation) an? =====
+Dieses Wiki verwendet ein Theme das es erlaubt auf der linken Seite Themenbereiche in einzelnen Gruppen anzuzeigen. Falls das Wiki aufgerufen wird ohne angemeldet zu sein, werden nur die öffentlich zugänglichen Bereiche angezeigt. Falls man als Administrator angemeldet ist, kann man weitere Gruppierungen in die Sidebar eintragen.
+So geht's:
+  * neuen Namensraum und eine Sidebar anlegen
+     * **<namensraum>:sidebar** z.B. miradlokit:sidebar
+     * ein **_~~_NOCACHE_~~_** (ohne die Unterstriche) einfügen, damit die Sidebar immer aktualisiert wird.
+  * Menüpunkt **Admin** wählen
+     * Berechtigungen werden als Baum auf der linken Seite dargestellt
+     * Menüeintrag **group:<NAMENSRAUM>:sidebar** wählen z.B. group:miradlokit:sidebar
+     * Rechte für Anwender, bzw. Gruppen vergeben
+===== Bilder und Dateien einfügen =====
+  * Wie füge ich hier Bilder und Dateien ein? Steht in der [[:miradlo/hilfe/syntax#bilder_und_andere_dateien | Syntax unter Bilder und Dateien]]
+===== Formatierungen =====
+Ausführliche Hinweise zu Formatierungen stehen unter: [[:miradlo/hilfe/syntax#texte | Syntax Texte]]
+==== Wie kann ich Zeilenumbrüche erstellen? ====
+Im Fließtext möchte man an bestimmten Stellen einen Zeilenumbruch einfügen. Dies kann man durch das anhängen von zwei Backslashs, also <html>\\</html> erreichen.\\
+Bei Auflistungen kann man ebenfalls Zeilenumbrüche einfügen. Beispiel:
+  * Auflistung \\ Beschreibung zu dieser Auflistung.
+Dies wurde mit folgender Syntax erreicht: <html>* Auflistung \\ Beschreibung zu dieser Auflistung</html>\\
+Wichtig ist hierbei, dass der Text in einer Zeile steht, ansonsten wird umgebrochen und die Einrückung nicht verwendet.
-===== Seite in einem Namensraum neu anlegen =====
-Namensräume sind in unserem Wiki als Kategorien bzw. Navigationspunkte zu verstehen. In dem folgenden Beispiel wird gezeigt, wie man  für den Namensraum **Hilfe** eine Seite anlegen kann.
-==== Namensraum wählen ====
-Öffne den Navigationspunkt **Hilfe** in der Haupt-Navigationleiste.
-  * Bild
-==== Seite bearbeiten ====
-Auf dieser Seite befindet sich in der oberen linken Ecke ein Knopf **Diese Seite bearbeiten**. Aktiviert diesen Knopf um in den Editiermodus der Seite zu gelangen.
-  * Bild
 ==== Verlinkung einfügen ====
-Im Editiermodus ist die Syntax eines Wikis zu erkennen. Nicht erschrecken, beim zweiten mal hinschauen ist es garnicht mehr so kompliziert. Dort findest ihr also u.a. sowas:
+Im Editiermodus ist die Syntax eines Wikis zu erkennen. Nicht erschrecken, beim zweiten mal hinschauen ist es nicht mehr so kompliziert. Dort findet ihr also u.a. sowas:
 \\
 **<nowiki>
@@ Zeile 43: / Zeile 104: @@
 [[hilfe:Seite löschen]]\\
 </nowiki>**
-Durch die oben aufgeführten "Tags" erzeugt ihr also einen Link, der zum Namensraum **Hilfe** gehört. Durch die zwei  **<nowiki>\\</nowiki>** wird einfach nur ein Zeilenumbruch erzeugt.
+Durch die oben aufgeführten "Tags" erzeugt ihr einen Link, der zum Namensraum **Hilfe** gehört. Durch die zwei  **<nowiki>\\</nowiki>** wird einfach nur ein Zeilenumbruch erzeugt.
 Fügt also nun auf dieser Seite auch die passende Syntax für eure neue Seite ein.
 Also:
@@ Zeile 52: / Zeile 113: @@
 Auf der Seite erscheint nun, ein in der Farbe Rot hinterlegter Link.
-==== Seite anlegen ====
+==== Mailadresse verlinken ====
-Ein "roter Link" bedeutet, dass die Seite zu der Verlinkt wird, nicht existiert.
+Mailadresse verlinken: so sieht es aus: <name@domain.tld> so geht's: \\
-Klickt man auf den Link so zeigt auch das Wiki die Meldung:"**Dieses Thema existiert noch nicht**.
+**<nowiki>
-  * Bild
+<name@domain.tld>
-Klickt nun auf den Button **Seite anlegen**, um wie der Name schon sagt, diese Seite anzulegen.
+</nowiki>**
-Daraufhin gelangt man wieder in einen Editiermodus und kann somit seine Inhalte verfassen und abspeichern.
+===== Quellcode oder ähnliches wird nicht richtig angezeigt? =====
-====== Wie kopiere ich ganze Wiki Seiten? ======
-Manchmal kommt es vor, dass man den Inhalt einer ganzen Seite mit allen Überschriften kopieren und in eine neue Seite einfügen will.\\
-  * Wechseln Sie zu der zu kopierenden Seite
-  * Oben Links oder ganz unten Links befindet sich jeweils ein Link mit dem Namen **diese Seite bearbeiten**. Diesen drücken.
-  * Es erscheint ein Bearbeitungsfenster in dem der gesamte Inhalt der Seite vorhanden ist.
-  * Kopieren Sie diesen Inhalt und fügen Sie ihn in Ihrer neuen Seite ein.
-====== Seiten umbenennen oder verschieben ======
-Seiten umbenennen oder verschieben [[http://wiki.miradlo.de/miradlo/hilfe/faq?do=admin&page=pagemove |im miradlo-Wiki ]] Wir setzen das Plugin pagemove von dokuwiki ein, damit klappt verschieben und umbenennen problemlos.
-====== Seite löschen ======
-Um eine Seite zu löschen muss man lediglich mit Hilfe des Editiermodus die Inhalte entfernen und abspeichern.
-  - Seite welche gelöscht werden soll auswählen
-  - In den Editiermodus wechseln (Button **Diese Seite bearbeiten**)
-  - Den gesamten Inhalt löschen (der Cursor muss an erster Stelle stehen und kein Inhalt darf vorhanden sein. "**kein Inhalt**" heißt auch kein Leerzeichen und kein leerer Absatz)
-  - Seite speichern (Button **Speichern**)
-====== Wie kann ich Zeilenumbrüche erstellen? ======
-Im Fließtext möchte man an bestimmten Stellen einen Zeilenumbruch einfügen. Dies kann man durch das anhängen von zwei Backslashs, also <html>\\</html> erreichen.\\
-Bei Auflistungen kann man ebenfalls Zeilenumbrüche einfügen. Beispiel:
-  * Auflistung \\ Beschreibung zu dieser Auflistung.
-Dies wurde mit folgender Syntax erreicht: <html>* Auflistung \\ Beschreibung zu dieser Auflistung</html>\\
-Wichtig ist hierbei, dass der Text in einer Zeile steht, ansonsten wird umgebrochen und die Einrückung nicht verwendet.
-====== Kann ich auch ein Inhaltsverzeichnis für längere Seiten haben? ======
-dokuwiki erstellt automatisch ein Inhaltsverzeichnis, sobald es mehrere Überschriften oberer Ebene gibt.
-====== Bilder und Dateien einfügen ======
-  * Wie füge ich hier Bilder und Dateien ein? Steht in der [[:miradlo/hilfe/syntax#bilder_und_andere_dateien | Syntax unter Bilder und Dateien]]
-====== Inhaltsverzeichnis aktualisieren ======
-Falls sich ein Verzeichnis nicht von selbst aktualisiert nachdem man eine Seite in diesem Bereich neu hinzugefügt, umbenannt oder gelöscht hat, dann fehlt wohl <code>~~NOCACHE~~</code> im Inhalt. Das Plugin    [[http://www.dokuwiki.org/plugin:nspages#installation|nspages für ~~NOCACHE~~ ]] ist installiert.
-====== Quellcode oder ähnliches wird nicht richtig angezeigt? ======
 Um Quelltext oder Formatierungshinweise die im dokuwiki interpretiert werden anzeigen zu lassen muss der Code zwischen code-Elementen stehen:\\
 <code>
 <code>Hier steht Quellcode drin</code>
 </code>
-====== Wie mache ich so eine Box? Hervorhebung ======
+===== Wie mache ich so eine Box? (Hervorhebung) =====
 <box round | Wie mache ich so eine Box?>
 So eine schicke Hervorhebung wäre toll...
@@ Zeile 103: / Zeile 136: @@
 auch so  eine schicke Hervorhebung wäre toll...
 </box></code>
-====== Wie erstelle ich eine Definitionsliste ======
+Weitere Formatierungsvariationen:
+   * round — runde Ecken
+   * blue — blaue Box (bei unserem Theme auch die Boxfarbe, wenn es keine anderen Angaben gibt
+   * red — rote Box
+   * green — grüne Box
+   * orange — orangefarbene Box
+   * left — links ausgerichtet, statt zentriert wie per default
+   * right — rechts ausgerichtet, statt zentriert wie per default
+   * weitere Konfigurationsmöglichkeiten, siehe Plugindoku: http://www.dokuwiki.org/plugin:box
+===== Wie mache ich eine Taskbox? (Hervorhebung) =====
+<task>
+TITLE: ein Test-Task
+PRIORITY: High
+ESTIMATE: 42h
+PROGRESS: 10%
+ASSIGNED: ute
+DESCRIPTION: irgendwas zum testen...
+TO DO
+-  You can have newlines in this part.
+- Description must be the last item.
+</task>
+<nowiki><task>
+TITLE: ein Test-Task
+PRIORITY: High
+ESTIMATE: 42h
+PROGRESS: 10%
+ASSIGNED: ute
+DESCRIPTION: irgendwas zum testen...
+TO DO
+-  You can have newlines in this part.
+- Description must be the last item.
+</nowiki>
+===== Wie erstelle ich eine Definitionsliste? =====
 Das Plugin hierfür ist eingebaut, mit zwei Leerzeichen und einem Semikolon wird dt erzeugt, mit zwei Leerzeichen und Doppelpunkt dann dd
   ; dt also defintion term
@@ Zeile 110: / Zeile 177: @@
   ; dt noch ein also defintion term
   : dd auch der mit definition 1
 Die Formatierung wie es aussieht ist natürlich immer vom CSS abhängig...
-====== Gibt es noch eine weitere Hilfeseiten? ======
-Ja, das [[inhaltsverzeichnis| Inhaltsverzeichnis]] der Kategorie Hilfe zeigt welche weiteren Seiten existieren.
+===== Gibt es noch weitere Hilfeseiten? =====
+Ja, das [[inhaltsverzeichnis| Inhaltsverzeichnis]] der Kategorie Hilfe zeigt welche weiteren Seiten hier im miradlo-wiki existieren.
+  * auf dokuwiki gibt's auch eine FAQ: http://www.dokuwiki.org/de:faq
+  * die Einstiegseite zur Doku auf dokuwiki hilft ebenfalls weiter: http://www.dokuwiki.org/de:dokuwiki