Project

General

Profile

Actions
History

DeUser Guide » DeRedmineTextFormatting »

DeRedmineTextFormattingMarkdown » History » Revision 7

« Previous | Revision 7/9 (diff) | Next »
C S, 2021-04-16 10:57

Übersetzung der Rev. 27

Markdown Formatierung

Unten wird die Markdown Formatierung beschrieben. Informationen zur Textile-Formatierung finden Sie unter Textile Formatierung.
Derzeit sind HTML-Tags standardmäßig nicht zulässig. Siehe #15520 und #20497 für Details. Weitere Einschränkungen der aktuellen Markdown-Formatierung finden Sie unter #16373 und #21443.

Verweise (Links)

Redmine interne Verweise

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

Wiki Links:

  • [[Guide]] Zeigt einen Link zu der genannten Seite 'Guide': Guide an
  • [[Guide#Unterthema]] führt zum Anker "Unterthema". Überschriften erhalten automatisch Anker, damit Sie auf sie verweisen können: Guide
  • [[Guide|Handbuch]] Zeigt einen Link zu derselben Seite an, jedoch mit anderem Text: Handbuch
  • [[Guide#User-guide|Handbuch]] Zeigt einen Link zur Kopfzeile auf derselben Seite mit anderem Text an: Handbuch

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

  • [[sandbox:some page]] Zeigt einen Link zu der genannten Seite 'some page' des Sandbox Wikis
  • [[sandbox:]] Zeigt einen Link zur Hauptseite des Sandbox-Wikis an

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

Links zu anderen Ressourcen:

  • Tickets:
    • #124 (Link zu einem Ticket: zeigt #124, Der Linktext ist durchgestrichen, wenn das Ticket geschlossen ist)
    • #124-6, oder #124#note-6 (Link zu einer Ticket-Notiz: zeigt #124-6, oder #124#note-6)
  • Dokumente:
    • document#17 (Link zum Dokument mit der ID 17)
    • document:Hallo (Link zum Dokument mit dem Titel "Hallo")
    • document:"Ein Dokument" (doppelte Anführungszeichen können verwendet werden, wenn der Dokumenttitel Leerzeichen enthält)
    • sandbox:document:"Ein Dokument" (Link zu einem Dokument mit dem Titel "Ein Dokument" in der Projektkennung "sandbox")
  • Versionen:
    • version#3 (Link zur Version mit der ID 3)
    • version:1.0.0 (Link zur Version mit dem Namen "1.0.0")
    • version:"1.0 beta 2" (doppelte Anführungszeichen können verwendet werden, wenn der Versionsname Leerzeichen enthält)
    • sandbox:version:1.0.0 (Link zur Version "1.0.0" in der Projektkennung "sandbox")
  • Anhänge:
    • attachment:file.zip (Link zum Anhang des aktuellen Objekts mit dem Namen file.zip)
    • attachment:"file name.zip" (doppelte Anführungszeichen können verwendet werden, wenn der Dateiname Sonderzeichen enthält)
    • Derzeit können nur auf Anhänge des aktuellen Objekts verwiesen werden (innerhalb eines Tickets können Sie nur auf dessen Anhänge verweisen).
  • Änderungssätze:
    • r758 (Link zu einem Änderungssatz mit der Anzeige r758)
    • commit:c6f4d0fd (Link zu einem Änderungssatz mit einem nicht numerischen Hash)
    • svn1|r758 (Link zu einem Änderungssatz eines bestimmten Repositorys für Projekte mit mehreren Repositorys)
    • commit:hg|c6f4d0fd (Link zu einem Änderungssatz mit einem nicht numerischen Hash eines bestimmten Repositorys)
    • sandbox:r758 (Link zu einem Änderungssatz eines anderen Projekts)
    • sandbox:commit:c6f4d0fd (Verknüpfung mit einem Änderungssatz mit einem nicht numerischen Hash einer anderen Projektkennung)
  • Repository-Dateien:
    • source:some/file (Link zu der Datei unter /some/file im Repository des Projekts)
    • source:"some file" (Link zur Datei mit Sonderzeichen im Pfad)
    • source:some/file@52 (Link zur 52. Revision der Datei)
    • source:some/file@master (Link zu der Datei im Zweig master)
    • source:some/file#L120 (Link zu Zeile 120 der Datei)
    • source:some/file@52#L120 (Link zu Zeile 120 der Datei in der Revision 52)
    • source:repo_identifier|some/file (Link zu einer Datei eines bestimmten Repositorys für Projekte mit mehreren Repositorys)
    • sandbox:source:some/file (Link zu der Datei in der Projektkennung "sandbox")
    • sandbox:source:repo_identifier|some/file (Verknüpfung mit der Datei eines bestimmten Repositorys in der Projektkennung mit Sonderzeichen im Pfad "sandbox")
    • export:some/file (Erzwingen des Downloads der Datei)
  • Foren:
    • forum#2 (Link zum Forum mit der ID 2)
    • forum:Discussion (Link zum Forum mit dem Namen "Discussion")
    • forum:"Help and more" (doppelte Anführungszeichen können verwendet werden, wenn der Forenname Leerzeichen enthält)
  • Forumsnachrichten:
    • message#1218 (Link zur Nachricht mit der ID 1218)
  • Neuigkeiten (News)
    • news#1 (Link zum Newseintrag mit der ID 1)
    • news:Greetings (Link zum Newseintrag mit dem Namen "Greetings")
    • news:"eCookbook first release !" (doppelte Anführungszeichen können verwendet werden, wenn der Name des Eintrags Leerzeichen enthält)
  • Projekte:
    • project#3 (Link zum Projekt mit der ID 3)
    • project:someproject (Link zum Projekt mit dem Namen "someproject")
    • project:"Multiple words project" (doppelte Anführungszeichen können verwendet werden, wenn der Name des Projektes Leerzeichen enthält)
  • Benutzer:
    • Thomas Lecavelier (Link zum Benutzer mit der ID 2)
    • user:jsmith (Link zum Benutzer mit dem Loginnamen: jsmith")
    • @jsmith (Link zum Benutzer mit dem Loginnamen: "jsmith")

Escaping:

  • Sie können verhindern, dass Redmine-Links analysiert werden, indem Sie ihnen ein Ausrufezeichen voranstellen: !

Externe Verweise

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

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

  • [Redmine Webseite](http://www.redmine.org) -- Externer Link mit anderem Text: Redmine Webseite
  • [![Redmine Webseite](http://www.redmine.org/attachments/7069/Redmine_logo.png)](http://www.redmine.org) -- Externes Bild mit einem Titel, der auf eine URL verweist:

Redmine web site

E-Mail Adressen

E-Mail Adressen werden automatisch in anklickbare Links umgewandelt:

  • jemand@foo.bar -- Link zu einer Email Addresse:
  • [Email jemand](mailto:jemand@foo.bar) -- Email link mit anderem Text: Email

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.

  • [Email an Webmaster und Admin](mailto:webmaster@foo.bar?cc=admin@foo.bar) -- Email an den Webmaster und als CC an den Admin: Email an Webmaster und Admin
  • [Email an Support für Hilfe](mailto:support@foo.bar?subject=Webseiten%20Hilfe) -- Email Link mit dem Titel "Webseiten Hilfe": Email an Support für Hilfe
  • [Email an Support für Hilfe](mailto:support@foo.bar?subject=Webseiten%20Hilfe&body=Mein%20Problem%20ist%20) -- Email Link mit dem Titel "Webseiten Hilfe" und Standardtext im Nachrichtenbereich: Email an Support für Hilfe

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.

Akronym

Wird von Markdown nicht unterstützt

Schriftart

* **fett** __fett__
* *kursiv* _kursiv_
* ***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:

  • fett
  • kursiv
  • fett kursiv
  • unterstrichen
  • durchgestrichen
  • Normal hochgestellt
  • Normal tiefgestellt
  • Schriftart Monospace
  • Normal fett kursiv normal;E=mc 2
  • Normalfettkursivnormal;E=mc2
  • Escaping: **fett** _kursiv_ `inlinemono` 
  • Einige Linien      Ein Link
  • **Einige Linien**      Ein [Link](http://www.redmine.org)

Hinweis: HTML-Tags müssen die HTML-Tags verwenden dürfen (<strong>, <em>, <ins>, <del>, <sup>, <sub>). Siehe #15520-16 und #15520-17 für Details.

Color

* <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>

displays:

  • Rot Grün Gelb Bläulich
  • RotGrünGelbBläulich
  • Hellgründer Hintergrund Gelber Hintergrund
  • Hellgrüner HintergrundGelber Hintergrund

Hinweis: HTML-Tags müssen das HTML-Tag (<span>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details.
Genauer gesagt müssen Sie redmine patchen, wie in diesem Beitrag erläutert.

Eingebettete Bilder

  • ![](image_url) Zeigt ein Bild an, das sich unter image_url befindet (Textile Syntax)
  • ![alt text](image_url "Bildtitel") Zeigt ein Bild mit einem Alt/Titel-Attribut an
  • [![](image_url)](URL) Zeigt ein Bild von image_url mit hinzugefügter Link-URL an

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.

  • <img style="float:right" src="URL"/>
  • <img style="width:100%" src="attached_image.png"/>

Hinweis: HTML-Tags müssen das HTML-Tag (<img>) verwenden dürfen. Siehe #15520-16 und #15520-17 für Details.

Ü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. Siehe #15520-16 und #15520-17 für Details.

Horizontale Linie

----

Anzeige:

Vorformatierter Text

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

Anzeige:

 *Dieser Text wird nicht fett angezeigt*

Block Zitate

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:

  • Punkt 1
  • Punkt 2
    • Punkt 21
    • Punkt 22
  • Punkt 3

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. 
[^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
Sample macro.
macro_list
Displays a list of all available macros, including description if available.
child_pages
Displays a list of child pages. With no argument, it displays the child pages of the current wiki page. Examples:

{{child_pages}} -- can be used from a wiki page only
{{child_pages(depth=2)}} -- display 2 levels nesting only
{{child_pages(Foo)}} -- lists all children of page Foo
{{child_pages(Foo, parent=1)}} -- same as above with a link to page Foo
include
Includes a wiki page. Examples:

{{include(Foo)}}
{{include(projectname:Foo)}} -- to include a page of a specific project wiki
collapse
Inserts of collapsed block of text. Examples:

{{collapse
This is a block of text that is collapsed by default.
It can be expanded by clicking a link.
}}

{{collapse(View details...)
With custom link text.
}}
thumbnail
Displays a clickable thumbnail of an attached image.
Default size is 200 pixels. Examples:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}} -- with custom title and size
issue
Displays an issue link including additional information. Examples:

{{issue(123)}}                              -- Issue #123: Enhance macro capabilities
{{issue(123, project=true)}}                -- Andromeda - Issue #123: Enhance macro capabilities
{{issue(123, tracker=false)}}               -- #123: Enhance macro capabilities
{{issue(123, subject=false, project=true)}} -- Andromeda - Issue #123
sample_macro
Sample macro

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. Die vollständige Liste der unterstützten Sprachen finden Sie unter RedmineCodeHighlightingLanguages.

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

``` ruby
Geben Sie hier Ihren Code ein.
```

Example:

# Die große Klasse
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

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

Updated by C S over 3 years ago · 7 revisions