summaryrefslogtreecommitdiff
path: root/Wiki/Tipps_und_Tricks_zum_Wiki.mdwn
blob: 7d40a6ea4c8c91f2c6f03f5196d2f869e30b53a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
Hier wird eine lose, zusammenhanglose Auflistung von verschiedenen Tipps rund ums Wiki aufgeführt. Es soll quasi als Nachschlagewerk bzw. Schnellübersicht dienen.

[[!toc startlevel=2 levels=2]]

## Gibt es keinen Robot für das Wiki?

Noch nicht :) Wer einen für ikiwiki kennt, bitte sofort mitteilen. Dann kann man sich den ja auf unsere Verhältnisse zusammenstutzen.

Da es aber in jedem Wiki ab einer Größe von mehreren Hundert Seiten auch (langweilige und langwierige) Routineaufgaben gibt, wäre ein Robot eine gute Idee. Für Mediawiki gibt es bereits zahlreiche Robots.
Standardaufgaben, bei denen ein Robot sinnvolle Unterstützung liefern kann sind z.B. automatisches Tagging, Rechtschreibkontrolle, Kategorisierung, automatische Verlinkung von Schlagworten mit vorhandenen Seiten, Ändern/Vereinheitlichung der Formatierung (z.B. bei Listboxen etc.), automatisisiert Gendermainstreaming betreiben, also "man" durch "man/frau" ersetzen, usw.

Oft macht der Roboteinsatz allerdings nur interaktiv Sinn. Es ist aber viel einfacher "J" und "N" zu tippen, als die Änderungen von Hand durchzuführen ;)

Ausserdem Hand aufs Herz: Wir sind doch ein Makerspace! Da *muss* doch alleine schon aus Geek-Gründen ein Robot her, oder?

## Das Hochladen von Bildern funktioniert nicht

Eine Zeit lang hat der Upload nicht funktioniert. Vielleicht könnte dies wieder passieren.<br/>
In diesem Fall kann es Sinn machen, die Daten als base64-kodierten Text zu erstellen und dann als Inline-Grafik einzubinden...

Bitte aber nur wohldosiert betreiben, irgendjemand muss die inliner dann wieder korrigieren...

## Auflistung zählt falsch

Nein, das Wiki zählt richtig. Deine Markup-Formatierung ist falsch.

Wenn eine Zahl von einem Punkt gefolgt wird, führt dies (egal welche Zahl dasteht !) zu einer nummerierten Auflistung (ordered list). Will man das nicht, z.B. wenn 3. auf 1. folgen soll, dann muss man den Punkt "escapen", also einen Backslash davor setzen.

Beispiel herkömmliche Nummerierung:

1. Es kommt erstens
1. anders
1. und 3. als man denkt

Oder mit Backslash escapet (dann muss aber ein Absatz durch HTML <BR/\> erzwungen werden, eine Einrückung erfolgt dann aber nicht):

1\. Manchmal will<br/>
3\. man keine aufsteigende<br/>
29\. Nummerierung<br/>

## Warum führen aller Verlinkungen auf die englische Wikipedia?

Die Direktive \[[!wikipedia  xyz]] führt auf die englische Wikipedia (siehe [[shortcuts]]).

Für die deutsche Wikipedia habe ich \[[!wikipediade  xyz]] erstellt. Wenn wir einen Robot haben, dann kann man das gerne irgendwann mal global ändern, natürlich mit automatischer Anpassung des Artikelnamens...

## Das Inhaltsverzeichnis ist falsch

Mit \[[!toc]] wird in der Preview das vollständige Inhaltsverzeichnis angezeigt. Irgendwo in der Konfig ist aber wohl eingestellt, dass nach dem Abspeichern nur noch Level 1 dargestellt wird.

Abhilfe schafft Angabe von Parameteren z.B. \[[!toc  levels=2]].

## Addons auf Vorhandensein überprüfen

Bei den Helpfiles zu den Dirktiven fehlt noch die automatische Feststellung, ob das Plugin überhaupt aktiviert ist. Das sollte bei jedem Helptext oben ergänzt werden und wäre auch eine gute Idee, direkt bei ikiwiki als Verbesserungsvorschlag beizusteuern.

    \[[!if test="enabled(Name_der_Direktive)"
        then="In diesem Wiki ist die Direktive: Name_der_Direktive **aktiviert**."
        else="In diesem Wiki ist die Direktive: Name_der_Direktive **nicht aktiv**. ; falls dies gewünscht wird, den Admin benachrichtigen."]]

Vielleicht bastel ich auch noch ein template daraus. Mal sehen.

## Das Wiki zeigt bestimmte Direktiven in der Vorschau nicht an

Nur in der Vorschau (Preview). Entweder ist das ein Bug im ikiwiki oder die Seitencompilation ist in der Vorschau überfordert. Wenn die Seite gespeichert wird, dann wird die Direktive auch angezeigt. Ist halt etwas blöd zum Testen.

## Andere Seitenüberschriften einbinden

Mit \[[!map]] wird eine dynamische Übersicht über andere Seiten eingebunden. Mit Parameter show=title werden dann nur die Überschriften als Link-Liste angezeigt, man kann dann auf die Seiten klicken.

Beispiel: Alle Inventarartikel anzeigen<br/>
\[[!map pages="Inventar/InvNr* and !\*.\*" show=title]]

## Andere Seiten komplett einbinden (including)

Mit \[[!inlne]] kann man auch komplette Seiten einbinden. Dann ist der Parameter raw=yes entscheidend.

Beispiel: <br/>
\[[!inline  pages="Vereinskram/Ueberblick_verschaffen" raw="yes"]]</pre>

## Alert-Box hinzufügen

Mithilfe der class alert:<br/>
&lt;div class=&quot;alert alert-info&quot;&gt;Text&lt;/div&gt;<br/>
Im Text dürfen ikiwiki-Links benutzt werden, jegliche andere Formatierung muss in plain-HTML erfolgen.

## Tabellen aus CSV-Dateien

Das ikiwiki kann csv-Dateien sofort als Tabelle ausgeben. Daher sollten alle (größeren) Tabellen am besten als CSV vorliegen. Siehe z.B. unsere [[/Material/Elektronik/Preisliste/]]

## Tabellen formatieren

Mithilfe der class table:<br/>
\[\[\!table  class="table table-hover table-nonfluid" data="""

## Wiederholende Formatierungen, Vorlagen, templates

Dafür gibt es ähnlich der Mediawiki-Vorlagen sogenannte templates. Es würde Sinn machen, sich hier ein bisschen einzuarbeiten. Gerade beim [[Inventar]] und anderen Kategorien wiederholt sich die Dateistruktur.

Siehe auch:

* [[/ikiwiki/directive/template/]]
* [[/ikiwiki/directive/templatebody/]]
* [[templates]]