Wiki Formatierung (Markdown)

Links

Redmine interne Links

Redmine ermöglicht Hyperlinks zwischen Ressourcen (Wiki-Seiten, Probleme, Dokumente, ...) von jedem Ort aus, an dem Textformatierungen verwendet werden.

Wiki Links:

Sie können auch auf Seiten des Wikis eines anderen Projekts verlinken (mithilfe der Projektkennung):

Wiki-Links werden rot angezeigt, wenn die Seite noch nicht vorhanden ist, z. B.: Nicht vorhandene Seite.

Links zu anderen Ressourcen:

Escaping:

Externe Links

URLs (http, https, ftp and ftps) werden automatisch in anklickbare Links umgewandelt:

URLs können auch anderen Text als den Link selbst verwenden:

Redmine web site

E-Mail Adressen

E-Mail Adressen werden automatisch in anklickbare Links umgewandelt:

Komplexere E-Mail-Anweisungen können zu einem E-Mail-Link hinzugefügt werden. Ein Standardthema, ein Standardtext und CC-Informationen können definiert werden. Beachten Sie, dass Leerzeichen in einem dieser Felder durch den Code %20 ersetzt werden müssen.

Textformatierung

Für Überschriften, Fettdruck, Tabellen, Listen unterstützt Redmine den Markdown-Syntax. Informationen zur Verwendung dieser Funktionen finden Sie unter http://daringfireball.net/projects/markdown/syntax, http://agea.github.io/tutorial.md/, http://stackoverflow.com/editing-help. Einige Beispiele sind unten aufgeführt, aber das System kann noch viel mehr. Für Konvertierungen siehe Pandoc. Der Redcarpet-Formatierer wird verwendet.

Akronyme

Wird von Markdown nicht unterstützt

Schriftarten


* **fett**
* *kursiv* 
* ***fett kursiv***
* <ins>unterstrichen</ins>
* <del>durchgestrichen</del>
* Plain <sup>hochgestellt</sup>
* Plain <sub>tiefgestellt</sub>
* `Schriftart monospace`
* normal **fett** *kursiv* normal;E=mc<sup>2</sup>
* normal<strong>fett</strong><em>kursiv</em>normal;E=mc<sup>2</sup>
* Escaping: \*\*fett\*\* \*kursiv\* \`inlinemono\`
* <pre>**Einige Linien**      Ein [Link](http://www.redmine.org)</pre>
* <pre>\*\*Einige Linien\*\*      Ein \[Link](http\://www\.redmine\.org)</pre>

Darstellung:

Hinweis: HTML-Tags müssen die inneren HTML-Tags verwenden dürfen (<strong>, <em>, <ins>, <del>, <sup>, <sub>).

Farben


* <span style="color:red">Rot</span> <span style="color:green">Grün</span> <span style="color:yellow">Gelb</span> <span style="color:#82B6E1">bläulich</span>
* <span style="color:red">Rot</span><span style="color:green">Grün</span><span style="color:yellow">Gelb</span><span style="color:#82B6E1">bläulich</span>
* <span style="background-color:lightgreen">Hellgrüner Hintergrund</span> <span style="background-color:yellow">Gelber Hintergrund</span>
* <span style="background-color:lightgreen">Hellgrüner Hintergrund</span><span style="background-color:yellow">Gelber Hintergrund</span>

Anzeige:

Hinweis: HTML-Tags müssen das innere HTML-Tag (<span>) verwenden dürfen.

Eingebettete Bilder

Wenn Sie ein Bild an Ihre Wiki-Seite angehängt haben, kann es unter Verwendung des Dateinamens im Inhalt angezeigt werden: ![](attached_image.png)

Zum jetzigen Zeitpunkt hat Markdown keine Syntax zum Festlegen der Abmessungen eines Bildes. Wenn dies für Sie wichtig ist, können Sie reguläre HTML-Tags <img> verwenden.

Hinweis: HTML-Tags müssen das HTML-Tag (<img>) verwenden dürfen.

Überschriften


# Hauptüberschrift

## Sekundäre Überschrift

### Tertiäre Überschrift

oder 

Hauptüberschrift
================

Sekundäre Überschrift
---------------------

Redmine weist jeder dieser Überschriften einen Anker zu, sodass Sie sie mit "#Hauptüberschrift", "#Sekundäre Überschrift" usw. verknüpfen können.

Absätze

Markdown unterstützt nicht die Ausrichtung eines Absatzes. Verwenden Sie bei Bedarf <div> -Tags.


Links ausgerichtet
<div style="padding-left:1em;">
left ident 1em
</div>

<div style="padding-left:2em;">
Linker Einzug 2em
sowie für folgende Zeilen
</div>

<div style="text-align:right;">
Rechts ausgerichtet
</div>

<div style="padding-right:3em;text-align:right;">
Rechter Einzug 3em
</div>

<div style="text-align:center;">
Dies ist ein zentrierter Absatz.
</div>

Anzeige:

Links ausgerichtet

Linker Einzug 1em

Linker Einzug 2em
sowie für folgende Zeilen

rechts ausgerichtet

Rechter Einzug 3em

Dies ist ein zentrierter Absatz.

Hinweis: HTML-Tags müssen das HTML-Tag (<div>) verwenden dürfen.

Horizontale Linie

----

Anzeige:

Vorformatierter Text

 <pre>**Dieser Text wird nicht fett angezeigt**</pre>

Anzeige:

 *Dieser Text wird nicht fett angezeigt*

Blockzitate

Sie können > am Anfang jeder Zeile verwenden und sie für verschachtelte Anführungszeichen stapeln:

>>Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
>>Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.
>Super!

Anzeige:

Rails ist ein Full-Stack-Framework für die Entwicklung datenbankgestützter Webanwendungen nach dem Model-View-Control-Muster.
Um live zu gehen, müssen Sie lediglich eine Datenbank und einen Webserver hinzufügen.

Super!

Ungeordnete Listen

* Punkt 1
* Punkt 2
  * Punkt 21 (Einrückung mit zwei Leerzeichen)
  * Punkt 22
* Punkt 3

Anzeige:

Geordnete Listen

# Punkt 1
# Punkt 2
# Punkt 3
  # Punkt 3.1 (Einrückung mit zwei Leerzeichen)
  # Punkt 3.2

Anzeige:

  1. Punkt 1
  2. Punkt 2
  3. Punkt 3
    1. Punkt 3.1
    2. Punkt 3.2

Beachten Sie, dass die tatsächlichen Zahlen, die Sie zum Markieren der Liste verwenden, keinen Einfluss auf die Ausgabe haben.

Tabellen

|BenutzerID (rechts ausgerichtet)|Name (Links ausgerichtet)|Gruppe (zentriert)|
|-------------------:|:----------------|:------------------:|
|2                   |John Smith       |                    |
|3                   |Dave Lopper      |A Team              |
|4                   |Robert Hill      |B Team              |

Anzeige(Alle multiplen Leerzeichen werden durch 1 Leerzeichen ersetzt):

BenutzerID (rechts ausgerichtet Name (links ausgerichtet Group (zentriert)
2 John Smith
3 Dave Lopper A Team
4 Robert Hill B Team

Inhaltsverzeichnis


{{toc}} => Links ausgerichtetes Inhaltsverzeichnis
{{>toc}} => Rechts ausgerichtetes Inhaltsverzeichnis

Bitte beachten Sie, dass das toc-Tag eine leere Zeile darüber und darunter und keinen anderen Text davor und danach benötigt.

Beispiel:


h1. Seitenüberschrift

h2. Ein Thema

{{toc}}

h2. Ein weiteres Thema

Fußnote

Eine Fußnote funktioniert sehr ähnlich wie ein Link im Referenzstil: Sie besteht aus einer Markierung neben dem Text, z. 

Dies ist ein Satz.[^1]
und einer Fußnotendefinition in einer separaten Zeile an einer beliebigen Stelle im Dokument, z. B. 
[^1]:Dies ist eine Fußnote.

Makros

Redmine enthält ein Makrosystem, mit dem Sie benutzerdefinierte Funktionen hinzufügen können, um dynamischen Inhalt in formatierten Text einzufügen. Sie können lernen, wie Sie Ihre eigenen Makros in Redmine Makros schreiben. Redmine enthält auch einige integrierte Makros:

hello_world

Beispiel Makro.

macro_list

Zeigt eine Liste aller verfügbaren Makros an, einschließlich einer Beschreibung, falls verfügbar.

child_pages

Zeigt eine Liste der untergeordneten Seiten an. Ohne Argument werden die untergeordneten Seiten der aktuellen Wiki-Seite angezeigt. Beispiele:


!{{child_pages}} -- kann nur von einer Wiki-Seite aus verwendet werden
!{{child_pages(depth=2)}} -- Nur Verschachtelung mit 2 Ebenen anzeigen
include

Inkludiert eine Wiki-Seite an die aktuelle Stelle. Beispiel:

!{{include(Foo)}}

oder um eine Seite eines bestimmten Projekt-Wikis einzubinden:

!{{include(projectname:Foo)}}
collapse

Einfügungen von reduzierten Textblöcken. Beispiel:

{{collapse(Siehe Details...)
Dies ist ein Textblock, der standardmäßig reduziert ist.
Sie kann durch Anklicken eines Links erweitert werden.}}
thumbnail

Zeigt eine anklickbare Miniaturansicht eines eingebetteten Bildes an. Beispiele:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}}
issue

Fügt einen Link zu einem Problem mit flexiblem Text ein. Beispiele:

{{issue(123)}}                              -- Aufgabe #123: Erweiterung der Makrofunktion
{{issue(123, project=true)}}                -- Andromeda - Aufgabe #123:Erweiterung der Makrofunktion
{{issue(123, tracker=false)}}               -- #123: Erweiterung der Makrofunktion
{{issue(123, subject=false, project=true)}} -- Andromeda - Aufgabe #123

Code-Hervorhebung

Die Standardcode-Hervorhebung basiert auf "Rouge": http: //rouge.jneen.net/, einer in reinem Ruby geschriebenen Syntax-Hervorhebungsbibliothek. Es unterstützt viele häufig verwendete Sprachen wie c, cpp (c++), csharp (c#, cs), css, diff (patch, udiff), go (golang), groovy, html, java, javascript (js), kotlin, objective_c (objc), perl (pl), php, python (py), r, ruby (rb), sass, scala, shell (bash, zsh, ksh, sh), sql, swift, xml and yaml (yml) , wobei die Namen in Klammern die Aliase sind.

Mit dieser Syntax können Sie Code in Ihrer Wiki-Seite hervorheben:


``` ruby

   Geben Sie hier Ihren Code ein.

```

Beispiel:

# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!"
  end
end