WackoWiki: Formatierung

https://wackowiki.org/doc     Version: 83 (06.01.2023 18:46)

Formatierung

Auch verfügbar in English[link1], Française[link2], Española[link3], Polski[link4], Русский[link5], 简体中文[link6]

Siehe auch: Aktionen[link7]

Die Formatierung in WackoWiki[link8] unterscheidet sich leicht von anderen Wikis, ist aber sehr einfach und effektiv.

Du kannst mit der Formatierung im Sandkasten[link9] experimentieren.
Text in ""doppelten Anführungszeichen"" wird nicht formatiert (siehe Quelltext, auch für weitere Beispiele).

Im Quelltext Wie es dargestellt wird

1. Inhaltsverzeichnis


{{toc numerate=1}}

Detaillierte Beschreibung...[link10]

2. Grundlegende Formatierungen

**fett**
fett
//kursiv//
kursiv
__unterstrichen__
unterstrichen
++klein++
klein
##code##
code
--durchgestrichen--
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[link11]
https://wackowiki.org automatisch hervorgehoben.
https://wackowiki.org
PPR:OneMinuteWiki
InterWiki Verlinkung[link12]
PPR:OneMinuteWiki[link13]
mailto:adresse@example.com
((adresse@example.com))
E-Mail.
mailto:adresse@example.com
adresse@example.com[link14]
xmpp:adresse@example.com
Jabber.
xmpp:adresse@example.com
((https://example.com/archive.zip Archiv (zip) ))
https://example.com/archive.zip
Archiv (zip)[link15]
https://example.com/archive.zip

4.2. Interne Links

((Cluster))
Cluster[link16]
((Cluster Verlinkung in Namensräumen))
Verlinkung in Namensräumen[link16]
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[link17]
((https://wackowiki.org/wacko_logo.png hier steht der Alternativtext))
Bild mit Alternativtext.
hier steht der Alternativtext[link18]
{{anchor href="test"}}
Anker innerhalb der Seite.

((#test)) oder ((/HomePage#TOC_1))
Verweis zum Anker.
test oder /HomePage#TOC_1[link19]
\\Server\Freigabe
Windows-Netzwerkfreigabe (falls vom Browser unterstützt)
\\Server\Freigabe

Hinweise

  1. Für interne Links kann die relative oder absolute Adressierung[link16] verwendet werden.
  2. Bei aktivierten WikiLinks[link20] ist eine Auszeichnung von CamelCase[link20]-Wörtern mit eckigen Klammern nicht nötig, um einen Link zu markieren.
  3. Um zu verhindern, dass SolcheKomischenWörter als Link markiert werden, einfach eine Tilde (~) davorsetzen.
  4. Externe Links mit http:// beginnen.
  5. Interne Links sollten nicht mit der kompletten URL angegeben werden, da sie sonst als externe Links interpretiert werden.
  6. 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, verwende file:/// 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[link21]
  7. 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 Parameter width, height und align=[left, center, right].

5. Einbinden hochgeladener Dateien

file:/mammut_mascot.jpg
prüft nur auf globale Datei
file:mammut_mascot.jpg
prüft nach lokaler Datei welche an die Seite angehängt wurde
file:/Subpage/archive.zip
absoluter Pfad für lokale Datei, notwendig für lokale Dateien, die in eine andere Seite eingebunden werden sollen
Datei muss bereits hochgeladen sein.

Detaillierte Beschreibung...[link22]
mammut mascot

file:/Subpage/archive.zip[link23]

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
Lotus Flower
Shinobazu Pond at Ueno Park at Ueno, Taito-ku in Tokyo
(Source:: Yoshikazu TAKADA /Some rights reserved)

6. Überschriften


== Haupt-Überschrift ==
-> h1

(2) Haupt-Überschrift


=== Grosse Überschrift ==
-> h2

(3) Grosse Überschrift

==== Mittelgrosse Überschrift ==
-> h3

(4) Mittelgrosse Überschrift

===== Kleinere Überschrift ==
-> h4

(5) Kleinere Überschrift

====== Kleine Überschrift ==
-> h5
(6) Kleine Überschrift

======= Kleinste Überschrift ==
-> h6
(7) Kleinste Überschrift

Anmerkung: Rechts von der Überschrift muß nicht die gleiche Anzahl von "=" Zeichen stehen, es genügen zwei "=" Zeichen.
Die == Haupt-Überschrift == wird normalerweise mit dem Seitentitel gesetzt und ist standardmäßig nicht im Inhaltsverzeichnis enthalten.

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	

  • einfache Liste
  • einfache Liste-2
  1. nummerierte Liste
  1. nummerierte Liste-2
  2.#8 nummerierte Liste, mit Übergang	

  1. nummerierte Liste
  2. nummerierte Liste-2
  3. nummerierte Liste, mit Übergang
  A. mit Großbuchstaben
  A. mit Großbuchstaben-2	

  1. mit Großbuchstaben
  2. mit Großbuchstaben-2
  a. mit Kleinbuchstaben
  a. mit Kleinbuchstaben-2	

  1. mit Kleinbuchstaben
  2. mit Kleinbuchstaben-2
  i. Lateinische Ziffern
  i. Lateinische Ziffern-2	

  1. Lateinische Ziffern
  2. Lateinische Ziffern-2
  1. nummerierte Liste
    2. eingerückte Liste
      * weiter eingerückte Liste
    1. eingerückte Liste-2    
  1. nummerierte Liste-2	

  1. nummerierte Liste
    1. eingerückte Liste
      • weiter eingerückte Liste
    2. eingerückte Liste-2
  2. nummerierte Liste-2

8. Zitate und Definitionen

<[ Zitat-Text
(blockquote) ]>

Zitat-Text
(blockquote)

(?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[link24]

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!

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[link25] 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[link26]
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:
Hochgesetzt
E=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[link27]
Name und Datum:
::@::

ThomasWolter[link27] /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[link28]:

%%(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[link29]

%%(php) PHP-Code%%
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;

Anmerkung: Damit die Farbhervorhebung funktioniert, muss der Quelltext innerhalb von <?php ?> stehen.


%%(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. %%
Zusammenfassung Das 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"])
chat log
%%

Mike Hi altogether.
12:04
Alice Did you check out the link https://example.com/
12:05
Pete I did't read your message.
The images
you drawn
are awesome!
12:10

%%(email) E-Mail%%
Moin
Leser>> Diese Umlaute saugen.
>Sicher?

Na klar!

Thomas.	

%%(sql) SQL-Code%%
SELECT * 
FROM sometable
WHERE a = '12' AND b = 2
ORDER BY c DESC --Comment;


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

%%(info type="note" title="Hinweis" icon=0) Inhalt... %%


Typen: default, error, example, important, note, question, quote, success, warning
title Titel des Kastens
icon Symbol anzeigen, der Standardwert ist 1

%%(info type="note")
Inhalt...
%%

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")
Inhalt...
%%

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 Highlighter

PEAR-Paket für die Syntaxhervorhebung


%%(hl [Formatierer] numbers=1 start=2) code example %%


numbers Zeilennummerierungstyp: 1 -> ol, 2 -> Tablle
start 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%%
1
2
3
4
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;


%%(hl xml) xml-Code%%
<config>
<section name="test">
  <var>Test</var>
  <val><![CDATA[..text...]]></val>
</section>
</config>

16.3. GeSHi

GeSHi Code Highlighting[link30] - Generic Syntax Highlighter


%%(geshi [Formatierer] numbers=1 start=35 lines=37) source%%

%%(geshi css) CSS-Code%%
Formatter highlight/geshi not found

Wenn es Formatter highlight/geshi nicht gefunden anzeigt, wurde der GeSHi Formatierer[link30] nicht zu dieser Seite hinzugefügt.

17. Wrapper um Formatierungen

Auch verfügbar in English[link31], Français[link32], Русский[link33], 简体中文[link34].


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 box formt einen Kasten der vom übrigen Seitentext umschlossen wird. Dieser Text umschließt den Kasten der für dieses Beispiel CSS-Code enthält. Die Box kann auch rechts eingefügt werden, mit wrapper_align=right.

17.2. shade

%%(css wrapper="shade") .d2 { font-size: 70% }%%


shade — wie box jedoch ohne Ausrichtung.
 .d2 { font-size: 70% } 	

17.3. text

%%(wacko wrapper="text" wrapper_align="center") zentriert %%


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

%%(wacko wrapper="page" wrapper_width=200) dieser Text kann nicht breiter als 200 Pixel sein%%


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

%%(wacko wrapper="box" wrapper_type="quote" wrapper_width=300 wrapper_title="Kasten")
«Jeden Tag erinnere ich mich hundert Mal daran, dass mein inneres und äußeres Leben von der Arbeit anderer, lebender und bereits verstorbener Menschen abhängt und dass ich mich bemühen muss, im gleichen Maße zu geben,
wie ich empfangen habe und immer noch empfange.» – ++Albert Einstein++
%%


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.



zurück zur Übersicht[link17]