%META:TOPICINFO{author="PeterThoeny" date="1044132468" format="1.0" version="1.37"}%
%TOC{depth="4"}%
%STARTINCLUDE%
---# TWiki Texte Formatieren

Um Texte in diesem Wiki zu formatieren, mssen sie kein HTML kennen (obwohl sie es verwenden knnen, wenn sie mchten). Die Wiki-Software verfgt ber eine eigene Syntax (auf engl. "Shorthand"), die leicht zu erlernen und behalten ist. Untenstehend finden sie eine tabellarische bersicht. Sie knnen diese Seite auch jederzeit als Popup-Fenster ffnen, wenn sie in der ==Bearbeitungsansicht== einer Seite auf [[Regeln zur Textformatierung]] (Dies hier ggf durch eigenen Seitennamen ersetzen!) am unteren Rand des Eingabefensters klicken.

#TWikiShorthand
---++ TWiki Editieren Kurzschrift

<table border="1" cellpadding="3" cellspacing="1" bgcolor="#000000">
<tr bgcolor="#ffffff">
<td>
 *Formatierungsbefehl:*
</td><td>
 *Beispiel: Sie schreiben:*
</td><td>
 *Sie bekommen:*
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Abschnitte:* %BR%
 Abschnitte werden durch Leerzeilen erzeugt.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
Erster Abschnitt

Zweiter Abschnitt
</pre>
</font></span>
</td><td valign="top">
Erster Abschnitt

Zweiter Abschnitt
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *berschriften:* %BR%
 Mindestens drei Bindestriche am Zeilenanfang, gefolgt von Plus-Zeichen und dem Text der berschrift. Ein Plus-Zeichen erzeugt eine berschrift erster Ordnung(sehr wichtig), zwei Plus-Zeichen eine berschrift zweiter Ordnung usw; maximal sechs Plus-Zeichen knnen verwendet werden. __Anmerkung:__ Ein Inhaltversverzeichnis kann mit der =%<nop>TOC%= Variable automatisch erzeugt werden, siehe TWikiVariables. Alle Text der berschrift nach =!!= ist von der TOC ausgeschlossen; zum Beispiel, Sie schreiben =---+!! Text= wenn Sie eine berschrift nicht in der TOC verzeichnen mchten.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
<nop>---++ Sushi

<nop>---+++ Maguro
</pre>
</font></span>
</td><td valign="top">
<h2 >Sushi</h2>

<h3 >Maguro</h3>
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Fettgedruckter Text:* %BR%
 Die Wrter erscheinen *fettgedruckt*, wenn sie in Sternchen =*= eingeschlossen werden .
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
*Fett*
</pre>
</font></span>
</td><td valign="top">
*Fett*
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Kursiver Text:* %BR%
 Wrter erscheinen _kursiv_, wenn sie in Unterstriche =_= eingeschlossen werden.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
_Kursiv_
</pre>
</font></span>
</td><td valign="top">
_Kursiv_
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Fett und kursiv:* %BR%
 Wrter sind  __fett kursiv_, wenn sie in doppelte Unterstriche =_= eingeschlossen werden.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
__Fett kursiv__
</pre>
</font></span>
</td><td valign="top">
__Fett kursiv__
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Schreibmaschinenschrift:* %BR%
 Wrter erscheinen in =Schreibmaschinenschrift=, wenn sie in Gleichheitszeichen =<nop>=<nop>= eingeschlossen sind.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
=Schreibmaschinenschrift=
</pre>
</font></span>
</td><td valign="top">
=Schreibmaschinenschrift=
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Fette Schreibmaschinenschrift:* %BR%
 Wrter erscheinen in ==fetter Schreibmaschinenschrift==, wenn sie in doppelten Gleichheitszeichen ==<nop>== eingeschlossen werden.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
==Fette Schreibmaschinenschrift==
</pre>
</font></span>
</td><td valign="top">
==Fette Schreibmaschinenschrift==
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 __Anmerkung:__ Achten Sie darauf, dass zwischen den =* _ = <nop>==<nop>= Zeichen und dem Text keien Leerzeichen sind!
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
_Dies funktioniert_,
_dies nicht _
</pre>
</font></span>
</td><td valign="top">
_Dies funktioniert_,
_dies nicht _
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Vorformatierter Text:* %BR%
 Umschliessen Sie Programmcode und anderen vorformatierten Text mit =&lt;verbatim&gt;= and =&lt;/verbatim&gt;= tags. %BR% __Anmerkung:__ Benutzen Sie =&lt;pre&gt;= und =&lt;/pre&gt;= Tags stattdessen, wenn Sie mchten, dass HTML interpretiert wird. %BR% __Anmerkung:__ Jeder Tag muss in einer eigenen Zeile stehen.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
&lt;verbatim&gt;
class CatAnimal {
  void purr() {
	 &lt;code here&gt;
  }
}
&lt;/verbatim&gt;
</pre>
</font></span>
</td><td valign="top">
<verbatim>
class CatAnimal {
  void purr() {
	 <code here>
  }
}
</verbatim>
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Trennzeichen:* %BR%
 Mindestens drei Striche am Anfang einer Zeile.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
-------
</pre>
</font></span>
</td><td valign="top">
-------
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Stichpunktliste:* %BR%
 Drei Leerzeichen und ein Sternchen.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
	* Stichpunktliste
</pre>
</font></span>
</td><td valign="top">
	* Stichpunktliste
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Verschachtelte Liste:* %BR%
 Sechs, neu, ... Leerzeichen und ein Sternzeichen.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
		* verschachtelte Liste
</pre>
</font></span>
</td><td valign="top">
		* verschachtelte Liste
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Sortierte Liste:* %BR%
 Drei Leerzeichen und eine Nummer.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
	1 Sushi
	1 Dim Sum
</pre>
</font></span>
</td><td valign="top">
	1 Sushi
	1 Dim Sum
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Definitionsliste:* %BR%
 Drei Leerzeichen, der Begriff, ein Doppelpunkt, gefolgt von der Definition.%BR%
__Anmerkung:__ Begriffe mit Leerzeichen sind nicht untersttzt. Wenn Sie einen Begriff mit mehreren Wrtern haben, trennen Sie die Wrter mit Strichen oder mit dem =&amp;nbsp;= non-breaking-space Entity.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
	Sushi: Japan
	Dim&amp;nbsp;Sum: S.F.
</pre>
</font></span>
</td><td valign="top">
	Sushi: Japan
	Dim&nbsp;Sum: S.F.
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Tabelle:* %BR%
 Die Zellen werden von senkrechten Strichen(|) umgeschlossen.%BR%
__Anmerkung:__ =| <nop>*fett*<nop> |= Zellen werden als Spaltenpfe formatiert.  %BR%
__Anmerkung:__ =|.gleicher	|= Abstand(in Leerzeichen) zu den  -Markierungen bedeutet. dass der Inhalt zentriert wird. %BR%
__Anmerkung:__ =|	  rechtslastige |= Zellen bedeuten,dass der Inhalt rechtsbndig dargestellt wird. %BR%
__Anmerkung:__ =| 2 Spalten ||= umfassende Zellen werden als ebensolche wiedergegeben. %BR%
__Anmerkung:__ Falls Sie in einer Zelle einen Zeilenumbruch erzwingen wollen(wenn Sie eine lange Zeile haben und die Lesbarkeit verbessern wollen), dann knnen Sie den Zelleninhalt ber mehrere Zeilen verteilen, indem Sie an das Ende jeder Zeile ein='\'= (Backslash) setzen.  %BR%
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
| *L* | *C* | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| multi span |||
| A4 | next | next |
</pre>
</font></span>
</td><td valign="top">
| *L* | *C* | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| multi span |||
| A4 | next | next |
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *<nop>WikiWord Links:* %BR%
 <nop>GrossgeschriebneZusammengesetzteWrter (oder WikiWords) werden automatisch als Link dargestellt. %BR%
  __Anmerkung:__ Wenn Sie eine Seite in einem anderen %WIKITOOLNAME% Bereich verlinken wollen, schreiben Sie =Bereichsname.DokumentName=.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
WebNotify

Know.ReadmeFirst
</pre>
</font></span>
</td><td valign="top">
WebNotify

Know.ReadmeFirst
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
#SquareBrackets
 *Erzwungene Links:* %BR%
 Sie knnen einen Link "erzwingen", indem sie Text in doppelte eckige Klammern einschlieen.
 %BR% __Anmerkung:__ Der Text innerhalb der Klammern darf auch Leerzeichen enthalten; der Seitenname wird dann automatisch durch weglassen der Leerzeichen und Groschreibung der einzelnen Wrter gebildet. Zum Beispiel: =[<nop>[Regeln zur Textformatierung]]= zeigt auf die Seite RegelnZurTextformatierung. Wenn sie auf Seiten in einem anderen Netz verweisen wollen, mssen sie wieder einen neuen =Bereich.= voranstellen.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
[[wiki syntax]]

[[%MAINWEB%.TWiki users]]
</pre>
</font></span>
</td><td valign="top">
[[wiki syntax]]

[[%MAINWEB%.TWiki users]]
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Deskriptive Links:* %BR%
 Wenn Sie erreichen wollen, dass Linktext und Linkzil unterschiedlich sind, dann benutzen Sie folgende Konstruktion: =[<nop>[Linkziel][Linktext]]=. Das Linkziel kann sowohl intern (z.B. WikiSyntax) als auch extern (z.B. http://TWiki.org/) sein.
 %BR% __Anmerkung:__ Die gleiche __erzwungene Links__ Regeln beantragen die internen Linksziele.
 %BR% __Anmerkung:__ Fr die externen Linkziele brauchen Sie nur ein Leerzeichen zu benutzen statt =][= um die Link URL von dem beschreibenden Text zu trennen.
 %BR% __Anmerkung:__ Ankernamen knnen eingefgt werden, wie =[<nop>[WebHome#MeinAnker][Zu meiner Startseite]]= und =[<nop>[http://gnu.org/#Action][GNU Action]]=.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
[[WikiSyntax][syntax]]

[[http://gnu.org][GNU]]

[[http://xml.org XML]]
</pre>
</font></span>
</td><td valign="top">
[[WikiSyntax][syntax]]

[[http://gnu.org][GNU]]

[[http://xml.org XML]]
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Anker(Sprungadresse):* %BR%
 Sie knnen innerhalb eines  %WIKITOOLNAME% Dokuments eine Sprungadresse (sog. Anker) definieren und auf den verweisen. Um einen Anker zu __definieren__  =#AnkerName= am Zeilenanfang. Der Name des Ankers muss ein WikiWord sein. Um auf einen Anker zu verweisen, benutzen Sie die  =[<nop>[MeinDokument#MeinAnker]]= Syntax. Wenn der Link innerhalb derselben Seite ist, knnen Sie den Dokumentnamen auch weglassen.You can omit the topic name if you want to link within the same topic.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
[[WebHome#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here
</pre>
</font></span>
</td><td valign="top">
[[WebHome#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Einen Link verhindern:* %BR%
 Wenn Sie nicht wnschen, dass ein WikiWord verlinkt wird, dann stellen Sie ihm ein =&lt;nop&gt;= Tag voran.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
&lt;nop&gt;SunOS
</pre>
</font></span>
</td><td valign="top">
<nop>SunOS
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
 *Einen Link abschalten:* %BR%
 Sie knnen das automatische Verlinken von WikiWords verhindern,  wenn Sie diese mit =&lt;noautolink&gt;= und =&lt;/noautolink&gt;= Tags umschliessen.
 %BR% __Anmerkung:__ Jedes Tag muss in einer eigenen Zeile stehen.
 %BR% __Anmerkung:__ Dies funktioniert auch mit TWiki Tabellen, aber nur, wenn zwischen dem Tabellenende und dem =&lt;/noautolink&gt;= Tag eine Leerzeile steht (bekannte Ausgabe von dem TablePlugin).
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<verbatim>
 <noautolink>
 RedHat &
 SuSE
 </noautolink>
</verbatim>
</font></span>
</td><td valign="top">
 <noautolink>
 RedHat &
 SuSE
 </noautolink>
</td>
</tr>
<tr bgcolor="#ffffff">
<td valign="top">
*Mailto: Links:* %BR%
Um schnere 'mailto:' Links zu erhalten, knnen Sie die folgende Syntax verwenden =[<nop>[mailto:user@domain descriptive text]]=.
</td><td valign="top">
<span style='background : #FFFFCC;'><font color="#990000">
<pre>
[[mailto:a@z.com Mail]]

[[mailto:?subject=Hi Hi]]
</pre>
</font></span>
</td><td valign="top">
[[mailto:a@z.com Mail]]

[[mailto:?subject=Hi Hi]]
</td>
</tr>
</table>

---++ HTML benutzen

Sie knnen fast alle  HTML- Tags problemlos benutzen -es gibt jedoch einige Aspekte, die Sie dabei beachten sollten.

---+++ HTML und TWiki Usability

	* Auf den Kooperationsseiten, empfiehlt es sich, die [[#TWikiShorthand][TWiki shorthand]] statt HTML zu benutzen,- tda sie einfacher und vor allem bersichterlicher is.
	* %X% *Anmerkung:* TWiki ist so kontruiert, dass sie soweit wie mglich auf verschiedenen Browsern und Betriebssytemen funktionieren soll.  HTML-Tags, die nicht zu HTML 3.2 kompatibel sind, schrnken dies unter Umstnden ein.

---+++ TWiki HTML Anzeige

	* Zur Ansicht wird die TWiki-Syntax im Quelltext nach XHTML 1.0 gewandelt. Um die ganze Marked-up Seite zu kopieren, lesen Sie einfache den Quelltext in Ihrem Browser und speichern Sie den Inhalt.
		* %T% Wenn Sie HTML hufig speichern mssen, lesen Sie vielleicht TWiki:Plugins/GenHTMLAddon - es erzeugt " ein Verzeichnis mit bertragenen Versionen von einer Serie von TWiki Seiten mit allen angehngten Files."
	* %X% *Anmerkung:* Die ffnenden und schlieenden spitzen Klammern (==&lt;...&gt;==) eines HTML-Tags __mssen sich in derselben Zeile befinden__, sonst funktioniert der Befehl nicht.
		* Dies erlaut es Ihnen, einzelne ffnende oder schliessende Spitzen Klammern einzugeben, ohne die HTML-Notierung (=&amp;lt;=) dafr benutzen zu mssen, z.B ==a > b==
		* %T% If you're pasting in preformatted HTML text and notice problems, check the file in a text processor with no text wrap. Also, save without hard line breaks on text wrap, in your HTML editing program.

---++ Hyperlinks

 Was bei TWiki besonder ist, dass Sie  Links erzeugen knnen, ohne irgendwelche besonderen Befehle zu benutzen, indem Sie WikiWords. Neue TWiki Verlinkenregeln sind eine einfache Erweiterung von der Syntax, die eine Art von flexiblen Optionen liefert.

---+++ Interne Links

	* GoodStyle ist ein WikiWord, die auf das <nop>GoodStyle Dokument in dem aktuellen %WIKITOOLNAME% Bereich verweist.

	* NotExistingYet ist ein Dokument, das zu erstellen ist. Sie knnen es erzeugen, indem Sie auf das *?* klicken. (Sie knnen auf es klicken, aber danach *Lschen* - sonst funktioniert dieses Beispiel nicht mehr!)

---+++ Externe Links

	* =http://...=, =https://...=, =ftp://...=, =gopher://...=, =news://...=, =file://...=, =telnet://...=
	  und =mailto:...@...= werden automatisch als Verweis dargestellt.

	* Email-addresses in der Form =name@domain.com= ebenfalls.

	* =[<nop>[Square bracket rules]]= lsst Sie [[#SquareBrackets][non-WikiWord links]] leicht erzeugen.
		* Wollen Sie einen externen Link mit einem beschreibendem Text versehen, dann verwenden Sie folgende Konstruktion: Aus =[<nop>[http://yahoo.com Yahoo home page]]= wird  [[http://yahoo.com/ Yahoo home page]].


---++ TWiki Variablen

Variablen werden stets von Prozentzeichen =%= eingeschlossen und bei Abruf der Seite evaluiert.

	* =%<nop>TOC%= : Generiert automatisch ein  Inhaltsverzeichnis(basierend auf den berschriften) am Anfang der Seite.

	* =%<nop>WEB%= : Der aktuelle Bereich, ist <b>%WEB%</b>.

	* =%<nop>TOPIC%= : Der Name des akteullen Dokuments, ist <b>%TOPIC%</b>.

	* =%<nop>ATTACHURL%= : Die URL fr Attachments des aktuellen Dokuments. Beispiel: Wenn Sie eine Datei an ein Dokument anhngen, dann knnen Sie mit =<b>%<nop>ATTACHURL%/image.gif</b>= darauf verweisen.

	* =%<nop>INCLUDE{"SomeTopic"}%= : Eine sog."Server side include", fgt automatisch irgendein Dokument ein. Der aktuelle %WIKITOOLNAME% Bereich ist der Rckstellungsbereich. Beispiel: =<b>%<nop>INCLUDE{"%TWIKIWEB%.SiteMap"}%</b>=

	* =%<nop>SEARCH{"sushi"}%= : Fgt automatisch die Suchergebnisse nach "sushi" in die Seite ein.

	* TWikiPreferences definiert  site-wide Variablen. u.a:
		* *Zeilenumbruch:* Schreiben Sie =<span style='background : #FFFFCC;'><font color="#990000">%<nop>BR%</font></span>= um eine neue Zeile zu beginnen.
		* *Farbiger Text:* Schreiben Sie: =<span style='background : #FFFFCC;'><font color="#990000"> %<nop>RED% Red %<nop>ENDCOLOR% and %<nop>BLUE% blue %<nop>ENDCOLOR% colors</font></span>= to get: %RED% Red %ENDCOLOR% imd %BLUE% blue %ENDCOLOR% colors.
		* *Documentation Graphics:* Schreiben Sie: =<span style='background : #FFFFCC;'><font color="#990000"> %<nop>H% Help, %<nop>T% Tip, %<nop>X% Alert</font></span>= und Sie erhalten: %H% Help, %T% Tip, %X% Alert. For more info see TWikiDocGraphics.

	* Es gibt mehrere Variablen, siehe *[[TWikiVariables]]*.


---++ <nop>TWikiPlugin Formatierungserweiterungen

Die Funktionalitt dieser TWiki-Software kann durch sogennante Plugins erweitert werden.

Vorhandene Plugins befinden sich in [[http://twiki.org/cgi-bin/view/Plugins][Plugins]] web on TWiki.org. Zurzeit ermglichte Plugins auf der TWiki Installation, sind sortiert nach =%<nop>PLUGINDESCRIPTIONS%=:

%PLUGINDESCRIPTIONS%

berprfen Sie die aktuellen Plugin-Status und Einstellungen fr diese Seite in TWikiPreferences.


---++ Hufige Fehler

TWiki Formatierungsregeln sind wirklich einfach zu benutzen und schnell zu schreiben. Aber es gibt noch Sachen, was Sie beachten mssen. Die folgenden Fragen sind aus TextFormattingFAQ:

	* *Frage:* Text in spitzen Klammern =&lt;filename&gt;= wird nicht angezeigt. Wie kann ich das ndern?
		* *Antwort:* Die ='&lt;'= und ='&gt;'= Zeichen haben eine spezielle Bedeutung in HTML, mit ihnen werden sogenannten HTML-Tags(Formatierungsbefehle) definiert. Sie mssen sie umgehen(engl.' escape'), deshalb schreiben Sie ='&amp;lt;'= anstelle von ='&lt;'=, und ='&amp;gt;'= anstelle von ='&gt;'=. <br /> Beispiel: Schreiben Sie  ='prog &amp;lt;filename&amp;gt;'= um ='prog &lt;filename&gt;'= zu erhalten.

	* *Frage:* Warum wird das ='&'= Zeichen manchmal nicht angezeigt?
		* *Antwort:* Das ='&'= Zeichen hat eine besondere Bedeutung in HTML, es ist das Startzeichen fr sogenannte" character entities", bspw.ist ='&amp;copy;'= das =&copy;= Copyright-Zeichen. Um ='&'= darzustellen mssen Sie es umgehen(engl.escape):Schreiben Sie ='&amp;'= ,anstelle von ='&'=. <br />Beispiel: Schreiben Sie ='This &amp;amp; that'=, um ='This &amp; that'= zu erhalten.

-- Main.MikeMannix - 02 Dec 2001 <br />
-- Main.PeterThoeny - 01 Feb 2003
