Deutsch#

Wenn du herausgefunden hast, wie der Editor funktioniert, solltest du WikiEtikette lesen, damit du versteht, wie du deine neu erworbenen Fähigkeiten einsetzen kannst.....

Kurzübersicht

---- = erstellt ein horizontales Lineal. Extra'-' werden ignoriert.
\\ = einen Zeilenumbruch erzwingen

[link] = erstellt einen Hyperlink zu einer internen Wiki-Seite namens'Link'.
[dies ist auch ein Link] = erstellt einen Hyperlink zu einer internen WikiPage namens
Das ist auch der'ThisIsAlsoALink'.
[click here|link] = erstellt einen Hyperlink zu einer internen WikiPage namens
Link', sondern zeigt den Text'Klicken Sie hier' an, um die
Benutzer anstelle von'Link'.
[1] = Verweist auf eine Fußnote mit der Nummer 1.
[#1] = Markiert die Fußnote Nummer 1.
[link] = erzeugt Text '[link]''.

!head = kleine Überschrift mit Text 'head'.
!!!head = mittlere Überschrift mit Text 'head'.
!!!!!heading = große Überschrift mit Text 'heading'.

''Text'' = druckt'Text' kursiv.
__text__ = druckt'Text' in Fettdruck.
{{text

= druckt'Text' in monospaced Schriftart.

• text = erzeugt ein gegliedertes Listenelement mit'text'.

1. text = erzeugt ein nummeriertes Listenelement mit'text'.

}}}

Text schreiben#

Du musst nichts über die Wiki-Textformatierungsregeln wissen, um das Wiki zu verwenden. Schreibe einfach normalen Text und verwende dann eine leere Zeile, um einen Absatz zu erhalten. Es ist wie beim Schreiben einer E-Mail.

Du kannst diese Seite jederzeit bearbeiten (siehe linke Seitenleiste) oder einfach deren Quelltext anzeigen lassen, um zu sehen, wie die verschiedenen Effekte auf dieser Seite verwendet werden.

Hyperlinks#

Der Link kann auch eine externe URL sein, die mit http:, ftp:, mailto:, mailto:, https: oder news: beginnt, in diesem Fall zeigt der Link auf eine externe Quelle. Um beispielsweise auf die Homepage von OKIT zu verweisen, verwende [https://www.okit.de/], das wird dann zu https://www.okit.de/ oder [OKIT-Homepage|https://www.okit.de/], das wird zu OKIT-Homepage.

Um eine neue Seite hinzuzufügen, erstelle einfach einen Link von woanders auf diese Seite. Schließlich ist es nicht sinnvoll, eine Seite zu haben, wenn man nicht darauf zugreifen kann! Du siehst dann ein kleines Fragezeichen hinter dem Seitennamen, wenn du zu dieser Seite zurückkehrst. Dann klicke darauf und du hast eine neue Seite erstellt!

Es ist erlaubt, fast jede Art von Zeichen innerhalb eines WikiName zu verwenden, solange es sich um Buchstaben oder Zahlen handelt.

Fußnoten#

Dies ist eine spezielle Art von Hyperlink. Indem man nichts als eine Zahl im Inneren verwendet erstellst du einen Verweis auf eine Fußnote. Diser Link [1] erzeugt eine Fußnote wie [1]. Um die eigentliche Fußnote zu schreiben, setzt du einfach eine [#1] voran. Die Fussnote kann überall auf der Seite platziert werden. Gewöhnlich geschieht das am Ende der Seite oder zumindest des Absatzes.

Du kannst auch eine benannte Fußnote erstellen, ganz so, als ob du einen normalen Hyperlink machen würdest.

Dieser Link bezieht sich beispielsweise auf die gleiche Fußnote [Fußnote Nummer 1] wie die obige Fußnote, aber dieser Link bezieht sich auf eine andere Fußnote [2].

InterWiki Links#

Du kannst auch Links zwischen verschiedenen Wikis erstellen, ohne die URL zu kennen. Benutze einfach einen Link in der Form [Wiki:WikiPage] und JSPWiki wird einen Link für dich erstellen. Dieser Link verweist beispielsweise auf dieJSPWiki TextFormatting rules. Auf der Seite SystemInfo findest du weitere Informationen darüber, welche Wiki-Links verfügbar sind.

Wenn ein InterWiki-Link nicht unterstützt wird, erhalten Sie eine Benachrichtigung auf der Seite, wenn Sie speichern Ihre Seite.

Bilder hinzufügen#

Aus Sicherheitsgründen ist das Hochladen von Bildern nicht überall erlaubt, aber du kannst Bilder einbetten, indem du das Bild an einer Stelle im Internet ablegst und darauf verlinkst. Dies ist zum Beispiel ein [PNG]-Bild: .

Wenn du einen Linktext angibst ([dieser hier|http://example.com/example.png]), wird er zu einem Linktext.

Die Liste der akzeptierten Bildtypen hängt vom Wiki ab. Siehe SystemInfo für eine Liste der verschiedenen erlaubten Bildtypen.

Aufgezählte Listen#

Verwenden Sie ein Sternchen (*) in der ersten Spalte, um Listen mit Aufzählungszeichen zu erstellen. Verwenden Sie mehr Sterne für eine tiefere Einrückung. Zum Beispiel:

* Eins \\ eineinhalb
* Zwei
* Drei
** Three.One

erstellt

• Eins
  eineinhalb
• Zwei
• Drei
  • Drei.Eins.

Nummerierte Listen#

Wie bei gegliederten Listen, aber verwenden Sie einen Hash (#) anstelle des Sternchens. So wie hier:

# Eins
# Zwei
# Drei
## Drei.Eins.

erstellt

1. Eins
2. Zwei
3. Drei
   1. Drei.Eins.

Wenn Sie das Listenelement in mehrere Zeilen schreiben möchten, fügen Sie einfach ein oder mehrere Leerzeichen in die nächste Zeile ein und die Zeile wird automatisch in die Datei vorheriger Punkt. Wenn das kompliziert klingt, bearbeiten Sie diese Seite zum Beispiel unten.

• Dies ist eine einzeilige Position.
• Dies ist eigentlich eine mehrzeilige Position. Wir setzen den zweiten Satz auf einer Linie auf einer eigenen Linie fort. Wir können genauso gut eine dritte Linie machen, während wir dabei sind..... Beachten Sie jedoch, dass alle diese Sätze in einem einzigen Element enthalten sind!
• Die dritte Zeile ist wieder ein einzeiliger Artikel für Ihre Bequemlichkeit.

Definitionslisten und Kommentare#

Eine einfache Möglichkeit, Definitionslisten zu erstellen, ist die Verwendung des ';:' -Konstuktes:

Konstrukt

Etwas, mit dem man etwas macht.

Eine weitere nützliche Verwendung für den ';:' ist, dass man damit den Text anderer Leute kurz kommentieren kann, indem man einen leeren Begriff in der Definition hat, so wie hier:

;:''Kommentieren Sie hier.''

Was als eine Art

Kommentieren Sie hier.

Texteffekte

Du kannst fetten Text oder kursiven Text verwenden, indem du zwei Unterstriche (_) und zwei einfache Anführungszeichen (') verwendest. Wenn du auf einem Windows-Computer arbeitest, stelle sicher, dass du das richtige Anführungszeichen verwendest, da es eines gibt, das gleich aussieht, aber nicht ist.

Vorformatierter Text#

Wenn du vorformatierten Text (wie Code) hinzufügen möchtest, verwende einfach drei aufeinanderfolgende Klammern ({), um einen Block zu öffnen, und drei aufeinanderfolgende Klammern (}), um einen Block zu schließen.

Tabellen#

Du kannst einfache Tabellen mit Hilfe des Pipe-Zeichens ('|') erstellen. Verwende Doppel-Pipe, um eine Überschrift-Zelle in einer Tabelle zu beginnen. Einzelne Pipes erzeugen normale Zellen in der Tabelle.

Zum Beispiel:

|| Rubrik 1 || Rubrik 2
| "Schluckauf" | Bar \\ foo
| [Hauptseite] | [Sandkasten]

ergibt die folgende Tabelle. Beachte, wie Links auch innerhalb von Tabellen verwenden werden können.

Rubrik 1	Rubrik 2
"Schluckauf"	Bar foo
Hauptseite	Sandkasten

CSS-Stile#

Obwohl nicht im Einklang mit dem keep it simple Prinzip, können CSS-Stile inline für besondere Anlässe verwendet werden, wenn sie wirklich einen Teil einer Seite hervorheben müssen.

Konflikte#

Wenn jemand zufällig die gleiche Seite wie du zur gleichen Zeit bearbeitet, verhindert JSPWiki, dass du Änderungen vornehmen kannst und zeigt stattdessen eine Konfliktseite an. Tut mir leid, das zu sagen, aber der erste, der Änderungen vornimmt, gewinnt...

Ein Warnhinweis: Wenn du über die Zurück-Schaltfläche deines Browsers auf die Bearbeitungsseite gehst, erhältst du mit ziemlicher Sicherheit einen Konflikt. Dies liegt daran, dass der Browser denkt, dass er eine frühere Kopie der Seite noch bearbeitet.

Löschen von Seiten#

Das ist nicht möglich. Du kannst natürlich alle Links zu dieser Seite entfernen, was die Seite unzugänglich macht. Oder du kannst dem Administrator eine E-Mail schreiben und er wird die Seite entfernen.

In manchen Wikis gibt es Löschmich-Seiten. Der Administrator schaut dann gelegentlich auf die Löschemich-Seite und bearbeitet die Liste dort. Es reicht dann einen Link auf die [Löschmich]-Seite zu legen, damit die zu löschende Seite dort in der Liste auftaucht.

Neue Seiten hinzufügen#

Erstellen einfach einen Link, der mit Hilfe von WikiName auf eine neue (nicht vorhandene) Seite verweist.

Klicke auf den neuen Link, der nun ein Fragezeichen (?) als Suffix haben sollte. Du erhältst dann einen Editor für die neue Seite.

Einfügen von Variablen#

Es gibt viele mögliche Variablen, die Sie auf einer Seite einfügen können. Die Grundform ist:

[{$variablename}],

wobei variablename der Name der Variable ist, die du einfügen möchtest. Beachte, dass Variablennamen nicht zwischen Groß- und Kleinschreibung unterscheiden, d.h. "pagename" ist identisch mit "paGeNamE" und "PageName".

Die Liste der verfügbaren Variablen findest du unter WikiVariables.

Plugins einfügen#

Die grundlegende Beschwörung zum Einfügen eines Plugins sieht so aus:

[{INSERT <plugin class> WHERE param1=value, param2=value, ...}]

Weitere Informationen findest du unter JSPWikiPlugins.

English#

When you've figured out how the editor works, then you should read WikiEtiquette so that you would know how to use your newly acquired skills...

Quick reference#

----       = Make a horizontal ruler. Extra '-' is ignored.
\\         = force a line break

[link]     = creates a hyperlink to an internal WikiPage called 'Link'.
[this is also a link] = creates a hyperlink to an internal WikiPage called
'ThisIsAlsoALink'.
[click here|link] = creates a hyperlink to an internal WikiPage called
'Link', but displays the text 'click here' to the
user instead of 'Link'.
[1]        = Makes a reference to a footnote numbered 1.
[#1]       = Marks the footnote number 1.
[[link]    = creates text '[link]'.

!heading   = small heading with text 'heading'
!!heading  = medium heading with text 'heading'
!!!heading = large heading with text 'heading'

''text''   = prints 'text' in italic.
__text__   = prints 'text' in bold.
{{text}}   = prints 'text' in monospaced font.

* text     = makes a bulleted list item with 'text'
# text     = makes a numbered list item with 'text'

Writing text#

You don't need to know anything about the Wiki text formatting rules to use Wiki. Just write normal text, and then use an empty line to mark a paragraph. It's just like writing an email.

You can always Edit this page (look at the left sidebar) to see how the different effects on this page are used.

Hyperlinks#

The link can also be a direct URL starting with http:, ftp:, mailto:, https:, or news:, in which case the link points to an external entity. For example, to point at the java.sun.com home page, use [http://java.sun.com], which becomes http://java.sun.com/ or [Java home page|http://java.sun.com], which becomes Java home page.

To add a new page you just create a link to it from somewhere else. After all, there isn't much point in having a page if you can't access it! You'll then see a small question mark after the page name when you return to that page. Then click on it and you have created a new page!

It's allowed to use almost any kind of characters inside a WikiName, as long as they are letters or numbers.

Footnotes#

These are a special kind of hyperlink. By using nothing but a number inside a hyperlink you create a reference to a footnote, like this [1], which creates a footnote[1]. To make the actual footnote, you just put a [#1] where you want that footnote to point at. Look below to find the footnote.

You can also make a named footnote, just as if you were doing a normal hyperlink. For example, this refers to the same footnote[Footnote number 1] as the footnote above, but this refers to another footnote[2].

InterWiki links#

You can also do links between different Wikis without knowing the URL. Just use a link in the form [Wiki:WikiPage] and JSPWiki will create a link for you. For example, this link points to the JSPWiki TextFormatting rules. Check the SystemInfo page for more information on which Wiki links are available.

If an InterWiki link is not supported, you'll get a notification of it on the page when you save your page.

Adding pictures#

For security reasons uploading images is not permitted, but you can embed any image in the wiki code by putting the image available somewhere on the web in one of the allowed formats, and then just linking to it. For example, this is an inlined PNG image: .

If you specify a link text ([this one here|http://example.com/example.png]) it becomes the ALT text for those who either can't or don't want to view images.

The list of accepted image types depends on the Wiki. See the SystemInfo page for a list of the different image types.

Bulleted lists#

Use an asterisk (*) in the first column to make bulleted lists. Use more asterisks for deeper indentation. For example:

* One
* Two
* Three
** Three.One

creates

• One
• Two
• Three
  • Three.One

Numbered lists#

Just like with bulleted lists, but use a hash (#) instead of the asterisk. Like this:

# One
# Two
# Three
## Three.One

creates

1. One
2. Two
3. Three
   1. Three.One

If you want to write the list item on multiple lines, just add one or more spaces on the next line and the line will be automatically added to the previous item. If this sounds complicated, edit this page for an example, below.

• This is a single-line item.
• This is actually a multi-line item. We continue the second sentence on a line on a line of its own. We might as well do a third line while we're at it... Notice, however, as all these sentences get put inside a single item!
• The third line is again a single-line item for your convinience.

Text effects#

You may use bold text or italic text, by using two underscores (_) and two single quotes ('), respectively. If you're on a Windows computer, make sure that you are using the correct quote sign, as there is one that looks the same, but really isn't.

Preformatted text#

If you want to add preformatted text (like code) just use three consecutive braces ({) to open a block, and three consecutive braces (}) to close a block. Edit this page for an example.

Tables#

You can do simple tables by using using pipe signs ('|'). Use double pipe signs to start the heading of a table, and single pipe signs to then write the rows of the table. End with a line that is not a table.

For example:

|| Heading 1 || Heading 2
| ''Gobble'' | Bar
| [Main]     | [SandBox]

gives you the following table. Note how you can use links also inside tables.

Heading 1	Heading 2
Gobble	Bar
Main	SandBox

Conflicts#

If someone happens to edit the same page as you at the same time, JSPWiki will prevent you from doing changes and show a conflict page instead. Sorry to say, but the first one to make changes wins...

A word of warning: If you use the Back button of your browser to go into the Edit page, you will almost certainly get a conflict. This is because the browser thinks its still editing an earlier copy of the page.

Deleting pages#

This is not possible. You can, of course, remove all the links to that page, which makes it inaccesible. Or you can email the administrator, and I'll remove the page.

Adding new pages#

Create a link that points to a new (not existing) page using its WikiName. Click that new link, which should now have a question mark (?) suffix and you will get an editor for the new page. -- Asser

Inserting plugins#

The basic incantation to insert a plugin looks like this:

[{INSERT <plugin class> WHERE param1=value, param2=value, ...}]

There is more information in JSPWikiPlugins.

---

[#1] Here's the footnote I mentioned.

[The other footnote] The other footnote. Note how it's name is different?