Formatierung
Auch verfügbar in English, Française, Española, Polski, Русский, 简体中文
Siehe auch: Aktionen
Die Formatierung in WackoWiki unterscheidet sich leicht von anderen Wikis, ist aber sehr einfach und effektiv.
Du kannst mit der Formatierung im Sandkasten experimentieren.
Text in ""doppelten Anführungszeichen"" wird nicht formatiert (siehe Quelltext, auch für weitere Beispiele).
Im Quelltext | Wie es dargestellt wird |
1. Inhaltsverzeichnis
Detaillierte Beschreibung... |
2. Grundlegende Formatierungen
**fett** | fett |
//kursiv// | kursiv |
__unterstrichen__ | unterstrichen |
++klein++ | klein |
##code## | code |
--durchgestrichen-- | |
!!hinweis!! (auch als ''hinweis'', aber besser die erste Version benutzen). | hinweis |
!!(blue) hinweis blau!! | hinweis blau |
!!(green) hinweis grün!! | hinweis grün |
!!(red) hinweis rot!! | hinweis rot |
??hervorgehoben?? | hervorgehoben |
??(blue)hervorgehoben?? | hervorgehoben |
??(red)hervorgehoben?? | hervorgehoben |
??(green)hervorgehoben?? | hervorgehoben |
%%eingebetteter Code%% |
int main(int arc,char **argv) { printf("Hello, %s!\n", (argc>1) ? argv[1] : "World"); return 0; } |
Anmerkung: Durchgestrichen, wie auch alle Formatierungen in diesem Abschnitt darunter, sind mehrzeilig. Alle vorangehenden Formatierungen sind nicht mehrzeilig, weil es Absicht ist, das die Formatierung den Text nicht umbricht.
3. Ausrichtung
Die Ausrichtung erfolgt mit Hilfe einer so komplexen Struktur:
Standard |
links
|
%%(wacko wrapper=text wrapper_align=center) zentriert%% |
zentriert
|
%%(wacko wrapper=text wrapper_align=right) rechts%% |
rechts
|
%%(wacko wrapper=text wrapper_align=justify) Blocksatz%% |
Blocksatz
|
wrapper_align
kann center
, right
oder justify
sein.
4. Links
Als Zeichen-Markup für die Erstellung von Links können runde ((, ))
oder eckige [[, ]]
Klammern verwendet werden. Beide Zeichen sind gleichberechtigt. Eckige Klammern können nützlich sein, wenn der Text der Seite bereits einfache runde Klammern enthält, die möglicherweise irrtümlich als Markup angesehen werden.
4.1. Externe Links
((https://wackowiki.org WackoWiki)) | WackoWiki |
https://wackowiki.org automatisch hervorgehoben. | https://wackowiki.org |
PPR:OneMinuteWiki InterWiki Verlinkung | PPR:OneMinuteWiki |
mailto:adresse@example.com ((adresse@example.com)) E-Mail. | mailto:adresse@example.com adresse@example.com |
xmpp:adresse@example.com Jabber. | xmpp:adresse@example.com |
((https://example.com/archive.zip Archiv (zip) )) https://example.com/archive.zip | Archiv (zip) https://example.com/archive.zip |
4.2. Interne Links
((Cluster)) | Cluster |
((Cluster Verlinkung in Namensräumen)) | Verlinkung in Namensräumen |
https://wackowiki.org/wacko_logo.png Bild ohne Verweis. | |
((/Doc/Deutsch https://wackowiki.org/wacko_logo.png)) Bild mit Verweis. | |
((https://wackowiki.org/wacko_logo.png hier steht der Alternativtext)) Bild mit Alternativtext. | hier steht der Alternativtext |
{{anchor href="test"}} Anker innerhalb der Seite. |
|
((#test)) oder ((/HomePage#TOC_1)) Verweis zum Anker. | test oder /HomePage#TOC_1 |
\\Server\Freigabe Windows-Netzwerkfreigabe (falls vom Browser unterstützt) | \\Server\Freigabe |
Hinweise
- Für interne Links kann die relative oder absolute Adressierung verwendet werden.
- Bei aktivierten WikiLinks ist eine Auszeichnung von CamelCase-Wörtern mit eckigen Klammern nicht nötig, um einen Link zu markieren.
- Um zu verhindern, dass
SolcheKomischenWörter
als Link markiert werden, einfach eine Tilde (~
) davorsetzen. - Externe Links mit
http://
beginnen. - Interne Links sollten nicht mit der kompletten URL angegeben werden, da sie sonst als externe Links interpretiert werden.
- Wie setze ich einen Link zu einer lokalen Datei mit Leerzeichen im Datei bzw. Pfadnamen? (bspw.:
S:\Network Drive\File 1.txt
oder//server1\file name.txt
)Um lokale Dateien auf einem Server mit Leerzeichen wie diesen zu verlinken, verwendefile:///
und ändere alle umgekehrten Schrägstriche\
in Vorwärts-Schrägstriche/
. Darüber hinaus, ersetzte jedes Leerzeichen mit%20
, so das der Link dann wie folgt wird: "file://///server1/file%20name.txt
" Bei Problemen mit der Verlinkung von lokalen Dateien bei Firefox siehe: Lösung
- Um die Größe und Ausrichtung von Bildern aus externen Quellen zu ändern, kann man folgende Syntax verwenden:
((http://example.com/image.png width=500 align=center))
, verfügbare Parameterwidth
,height
undalign=[left, center, right]
.
5. Einbinden hochgeladener Dateien
|
|
5.1. Medien-Parameter
Parameter werden der Dateisyntax hinzugefügt, indem ein Fragezeichen ?
angehängt wird und zusätzliche Parameter durch hinzufügen eines kaufmännischen Und &
.
e.g. file:/lotus_flower.jpg?right&caption&400
- Verlinkung
-
direct
- zur Datei -
nolink
- zeigt nur das Bild -
linkonly
- zeigt nur den Link zur Datei -
meta
- zum filemeta-Handler (default)
-
- Ausrichtung
-
right
- rechts -
left
- links -
center
- zentriert
-
- Größenanpassung
-
400x300
- Breite × Höhe -
0x700
- Höhe -
600
- Breite
-
- Weitere
-
caption
- zeigt Bildunterschrift -
clear
- setzt Ausrichtung zurück
-
6. Überschriften
Seite "!/Überschriften" (ohne Eintrag im Inhaltsverzeichnis) einbinden | {{include page="!/Überschriften" notoc=1}} |
7. Listen
Eine Liste kann erstellt werden, indem eine neue Zeile entweder mit einem Tab oder zwei Leerzeichen beginnt. Danach folgt das Zeichen für den Listentyp (
*
bzw. -
, 1.
, A.
, a.
, oder i.
). Ohne Zeichen für einen Listentyp führt das doppelte Leerzeichen bzw. der Tab zu einer Einrückung.
erste Zeile nächste Zeile | erste Zeile
nächste Zeile
|
* einfache Liste * einfache Liste-2 |
|
1. nummerierte Liste 1. nummerierte Liste-2 2.#8 nummerierte Liste, mit Übergang |
|
A. mit Großbuchstaben A. mit Großbuchstaben-2 |
|
a. mit Kleinbuchstaben a. mit Kleinbuchstaben-2 |
|
i. Lateinische Ziffern i. Lateinische Ziffern-2 |
|
1. nummerierte Liste 2. eingerückte Liste * weiter eingerückte Liste 1. eingerückte Liste-2 1. nummerierte Liste-2 |
|
8. Zitate und Definitionen
<[ Zitat-Text | Zitat-Text |
(?Bezeichnung Irgendeine Definition?) | Bezeichnung |
(?Bezeichnung mit Leerzeichen == Irgendeine andere Definition?) | Bezeichnung mit Leerzeichen |
9. Fußnoten
Text, dann Fußnote[[*]] und zweite Fußnote[[**]] | Text, dann Fußnote* und zweite Fußnote** |
Text, dann numerische Fußnote[[*1]] und zweite Fußnote[[*2]] | Text, dann numerische Fußnote1 und zweite Fußnote2 |
[[#*]] Text für erste Fußnote[[#**]] Text für zweite Fußnote[[#1]] Text für numerische Fußnote[[#2]] Text für zweite numerische Fußnote | * Text für erste Fußnote ** Text für zweite Fußnote 1 Text für numerische Fußnote 2 Text für zweite numerische Fußnote |
auto-generierte Fußnoten [[^ Text der Fußnote hier]] | erstellt automatisch die Fußnoten am Ende der Seite, siehe Beispiel |
10. Zitierung
Um einen Text als Antwort oder Kommentar zu kennzeichnen, kann man die folgende Syntax verwenden:
Hallo! > Ja, das ist es. >> Bist du sicher? > Natürlich, ja! >> Wirklich? >>> Was nun? | Hallo! > Ja, das ist es. >> Bist du sicher? > Natürlich, ja! >> Wirklich? >>> Was nun? |
11. Tabellen
Tabelle mit Rand
#|
*| Überschrift 1 | Überschrift 2 | Überschrift 3 |*
|| Zelle 1-1 | Zelle 1-2 | Zelle 1-3 ||
|| Zelle 2-1 | Zelle 2-2 ||
|#
Überschrift 1 | Überschrift 2 | Überschrift 3 |
---|---|---|
Zelle 1-1 | Zelle 1-2 | Zelle 1-3 |
Zelle 2-1 | Zelle 2-2 |
Tabelle ohne Rand, 100% Breite
#||
|| Zelle 1-1 | Zelle 1-2 | Zelle 1-3 ||
|| Zelle 2-1 | Zelle 2-2 ||
||#
Zelle 1-1 | Zelle 1-2 | Zellel 1-3 |
Zelle 2-1 | Zelle 2-2 |
Anmerkung: Komplexe Tabellen können als Inline-HTML eingefügt werden.
12. Sonstiges
Text-Ausgabe "wie-es-ist" -- ignoriert Markup
Der Text sollte jeweils von einen Paar von doppelte Anführungszeichen eingeschlossen sein, e.g. ""test---new line""
.
Im Seitenquelltext dieser Seite finden sich zahlreiche Beispiele.
Darüber hinaus ist es möglich mit der Verwendung einer ~
(Tilde) sich jede Art vom Markup anzeigen zu lassen.
Tilde ignoriert Formatierungsregel: ~WikiWort | WikiWort |
Horizontale Linie:---- | |
Harter Umbruch:Test---neu Zeile | Test neue Zeile |
Erzwungene Leerzeile:---"" ""--- |
13. Inline-HTML
HTML-Ausgabe ohne Formatierung
Funktioniert nur wenn es der Admin erlaubt hat.
<# <input type="text"> #> | <# <input type="text"> #> Wenn Du hier <input type="text"> anstatt eines Eingabefeldes siehst, ist die Funktion nicht angeschaltet. ( allow_rawhtml in der Konfiguration muss auf 1 gesetzt sein. Achtung, bei offenen Wikis kann dies Missbrauch erlauben!). |
14. Sonderzeichen
Der im Wiki integrierte automatische Korrekturleser passt den gespeicherten Text automatisch an die Formatierungsnormen an und erspart den Autoren eine zu detaillierte Bearbeitung. Hier sind die Änderungen, die er macht:
HochgesetztE=mc^^2^^ | E=mc2 |
Tiefgesetzt vor und nach vv Leerzeichen einfügen. H vv2vv O | H2O |
Weitere | |
^F | °F |
^C | °C |
(p) | § |
(tm) | (tm) |
(c) | (c) |
(r) | (r) |
+- | +- |
~~ | ~ |
15. Makros
Mit Makros kann man einen Eintrag "unterzeichnen". Einfache Arbeitserleichterung für Tippfaule zum erstellen einer Signatur.
Namen einsetzen::::: | ThomasWolter |
Name und Datum:::@:: | ThomasWolter /08.10.2003 01:47/ |
Datum:::+:: | 08.10.2003 01:47 |
16. Quelltext und Syntax-Hervorhebung
Mit Textformatierern wurde WackoWiki um die Möglichkeit erweitert, Quellcode und Text verschieden formatiert darzustellen. Diese werden mit dem Syntax %%(Formatierer) text%%
aufgerufen.
Als Zeichen-Markup für Textformattierer können Prozentzeichen %%, %%
oder grave accents ``, ``
verwendet werden. Beide Zeichen sind gleichberechtigt. Grave accents können nützlich sein, wenn der Text der Seite bereits Prozentzeichen enthält, die möglicherweise irrtümlich als Markup angesehen werden.
Darüber hinaus erlaubt es einen Formattierer in einen Formatierer aufzurufen, z.B. ein CSS-Highlighter in einem Details-Formattierer.
WackoWiki enthält folgende Formatierer:
%%(wacko)Der Text, wie er ist. ((/HomePage))%% Dieses Format zeigt den Text so an, als ob er ohne Formatierer erstellt worden wäre. Praktisch für die Verwendung zusätzlicher Wrapper zum Text (Ausrichtung, Rahmen, usw. siehe unten.) | Der Text, wie er ist. /HomePage
| |||||||||
%%(php) PHP-Code%% |
Anmerkung: Damit die Farbhervorhebung funktioniert, muss der Quelltext innerhalb von | |||||||||
%%(comment) Kommentare werden nur im Quelltext angezeigt.%% | ||||||||||
%%(noautolinks) keine AutoLinks bei CamelCase-Wörtern%% | keine AutoLinks bei CamelCase-Wörtern
| |||||||||
%%(details title="Zusammenfassung" open=1) Details info. %% |
ZusammenfassungDas HTML-Details-Element (<details> ) erstellt ein Informationsfenster, in dem der Inhalt nur dann angezeigt wird, wenn das Fenster in einen "offenen" Zustand geschaltet wird. Eine Zusammenfassung oder Beschriftung kann mit dem <summary> -Element angegeben werden.
| |||||||||
%%(cl)zypper dup --no-recommends%% |
zypper dup --no-recommends | |||||||||
%%(chat [type="div|table"]) |
| |||||||||
%%(email) E-Mail%% |
Moin Leser>> Diese Umlaute saugen. >Sicher? Na klar! Thomas. | |||||||||
%%(sql) SQL-Code%% |
SELECT * | |||||||||
Es gibt auch Formatierer für (ini), (html), (css), (java) und (pascal). | ||||||||||
%%(html) HTML-Code%% |
<html> <a href="http://example.com">test</a> </html> | |||||||||
%%(ini) ini-Code%% |
[Wiki] BestEngine="WackoWiki" Version=6 | |||||||||
%%(css) CSS-Code%% |
body {margin: 0; padding: 5px;}
.class {background: url("http://example.com/");}
| |||||||||
%%(pascal) PASCAL-Code%% |
program megaprogramme; { comment } BEGIN if a = 15 then writeln('test'); END. | |||||||||
16.1. Infokasten
Typen: default , error , example , important , note , question , quote , success , warning title Titel des Kastensicon Symbol anzeigen, der Standardwert ist 1 | ||||||||||
%%(info type="note")
|
Ein Wiki ist eine Website, auf der Benutzer jede Seite mit einem Webbrowser hinzufügen, entfernen und bearbeiten können. Es ist für Menschen so außerordentlich einfach, schnell einzusteigen und Seiten zu überarbeiten, dass sich Wikis als das Werkzeug der Wahl für große Projekte mit mehreren Teilnehmern herausstellen.
| |||||||||
%%(info type="warning")
|
Wie bei jeder Software-Installation die über das Internet zugänglich ist, werden Fehler oder Probleme mit der Sicherheit durch Dritte ausgenutzt. Installiere WackoWiki nur, wenn du die Installation laufend auf dem aktuellen Stand hältst.
| |||||||||
16.2. PEAR Text HighlighterPEAR-Paket für die Syntaxhervorhebung
numbers Zeilennummerierungstyp: 1 -> ol, 2 -> Tabllestart lässt die Zeilennummern bei einer beliebigen Zahl beginnen, und nicht nur bei 1 Formatierer: abap , cpp , css , diff , dtd , html , java , javascript , perl , php , ruby , python , sh , sql , vbscript , xml . | ||||||||||
%%(hl css) CSS-Code%%
|
body {margin: 0; padding: 5px;} .class {background: url("http://example.com/");} | |||||||||
%%(hl javascript) Javascript-Code%%
|
var a = document.getElementById("test"); a.value = new Array(15, 31); function echo (msg) {alert(msg)}; | |||||||||
%%(hl php numbers=2) PHP-Code%%
|
| |||||||||
%%(hl xml) xml-Code%%
|
<config> <section name="test"> <var>Test</var> <val><![CDATA[..text...]]></val> </section> </config> | |||||||||
16.3. GeSHiGeSHi Code Highlighting - Generic Syntax Highlighter %%(geshi [Formatierer] numbers=1 start=35 lines=37) source%% | ||||||||||
%%(geshi css) CSS-Code%%
| Formatierer
highlight/geshi nicht gefunden | |||||||||
Wenn es Formatter highlight/geshi nicht gefunden anzeigt, wurde der GeSHi Formatierer nicht zu dieser Seite hinzugefügt. | ||||||||||
17. Wrapper um Formatierungen
Auch verfügbar in English, Français, Русский, 简体中文.
Zusätzlich ist es möglich für jeden Formatierer %%(Formatierer) Text%%
mit dem Parameter wrapper=
einen spezifischen Wrapper zuzuweisen.
%%(Formatierer
[wrapper="box | shade | page | text"]
[wrapper_align= "left | center | right | justify"]
[wrapper_title="Titel"]
[wrapper_type="default | error | example | important | note | question | quote | success | warning"]
[wrapper_width="pixel"]
[col=1 | 2 | 3 | 4 | 5]
[clear])
Text
%%
box | shade | page | text | |
---|---|---|---|---|
Typ | + | + | – | - |
Titel | + | + | – | - |
Ausrichtung | + | –1 | –2 | + |
Clear | + | + | – | – |
Breite | + | –1 | + | –3 |
Spalten | – | + | – | + |
Rahmen | + | + | – | – |
Automatischer Zeilenumbruch | + | + | + | – |
1 Diese Option ist nicht sinnvoll, da die Breite des Blocks immer gleich der Breite der Seite ist.
2 Nur links.
3 Wenn die meisten Zeilenumbrüche nicht gesetzt sind, wird die Blockbreite auf ca. 90% der Seitenbreite festgelegt.
Grammatik = [Formatierer | WRAP Formatierer | OPTION Wrapper-Formatierer | Text]
Formatierer [ cl | comment | css | email | hl * | html | info | ini | java | pascal | php | sql | wacko ]
Wrappertypen: box
, shade
, page
und text
TEXT = alles, frei.
17.1. box
| |
%%(css wrapper="box" wrapper_align="left" wrapper_width=300) .d { font-size: 70% }%% |
Der Rahmentyp |
17.2. shade
shade — wie box jedoch ohne Ausrichtung. |
.d2 { font-size: 70% }
|
17.3. text
text ermöglicht es die Ausrichtung des Textblock festzulegen. wrapper_align= kann left (links), center (zentriert), right (rechtsbündig) oder justify (Blocksatz) sein. |
zentriert
|
17.4. page
page ermöglicht es die Breite eines Textblocks festzulegen. Ohne die Angabe zur Breite wird der Basis-Wert von 800px verwendet. |
dieser Text kann nicht breiter als 200 Pixel sein
|
17.5. Beispiel
Der Typ box fügt einen Kasten in den fließenden Seitentext ein.wrapper_align= kann center (zentriert), left (links), right (rechtsbündig) sein. Ohne die Verwendung von wrapper_align= wird die Box rechtsbündig angeordnet. |
|