Redmine Wiki-Formatierung (CommonMark Markdown (GitHub Flavored))detailliert
Links
Redmine interne Links
Redmine erlaubt Hyperlinks zwischen Ressourcen (Tickets, Änderungssätze, Wiki-Seiten...) überall dort, wo Wiki-Formatierung verwendet wird.
- Link zu einem Ticket: #124 (zeigt
#124, Link ist durchgestrichen, wenn das Ticket geschlossen ist)
- Link zu einem Ticket mit Name und Betreff des Trackers: ##124 (zeigt Fehler #124: Die Massenbearbeitung ändert nicht die Eigenschaften der Kategorie oder der festen Versionseigenschaften)
- Link zu einer Ticketnotiz: #124-6, oder #124#note-6
- Link zu einer Ticketnotiz innerhalb des selben Tickets: #note-6
Wiki-Links:
- [[Anleitung]] zeigt einen Link zur Seite mit dem Namen „Anleitung“ an: Anleitung
- [[Leitfaden#Unterpunkt]] führt Sie zum Anker "Unterpunkt". Überschriften bekommen automatisch Anker zugewiesen, damit Sie darauf verweisen können: Leitfaden Leitfaden
- [[#Unterpunkt]]Link zum Anker "Unterpunkt" der aktuellen Seite: #Unterpunkt
- [[Anleitung|Benutzerhandbuch]] zeigt einen Link zu derselben Seite, aber mit einem anderen Text: Benutzerhandbuch
Sie können auch auf Seiten eines anderen Projekt-Wikis verlinken:
- [[sandbox:Eine Seite]] zeigt einen Link zu der Seite namens 'Eine Seite' des Sandbox-Wikis an
- [[sandbox:]] zeigt einen Link zur Hauptseite des Sandbox-Wikis an
Wiki-Links werden rot angezeigt, wenn die Seite noch nicht existiert, zB: Nicht vorhandene Seite.
Links zu anderen Ressourcen:
- Dokumente:
- document#17 (Link zum Dokument mit der ID 17)
- document:Willkommen (Link zum Dokument mit dem Titel "Willkommen")
- 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 einem anderen Projekt "Sandbox")
- Versionen:
- version#3 (ink 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 die Version Leerzeichen enthält)
- sandbox:version:1.0.0 (Link zu Version „1.0.0“ im Projekt „Sandbox“)
- Anhänge:
- attachment:file.zip (Link zum Anhang des aktuellen Objekts mit dem Namen file.zip)
- Im Moment können nur Anhänge des aktuellen Objekts referenziert werden (wenn Sie sich in einem Problem befinden, können nur Anhänge dieses Problems referenziert werden).
- Änderungssätze:
- r758 (Link zu einem Changeset)
- commit:c6f4d0fd (Link zu einem Changeset mit einem nicht numerischen Hash)
- svn1|r758 (Link zu einem Changeset eines bestimmten Repositorys, für Projekte mit mehreren Repositorys)
- commit:hg|c6f4d0fd (Link zu einem Changeset mit einem nicht numerischen Hash eines bestimmten Repositorys)
- sandbox:r758 (Link zu einem Changeset eines anderen Projekts)
- sandbox:commit:c6f4d0fd (Link zu einem Changeset mit einem nicht numerischen Hash eines anderen Projekts)
- Repository-Dateien:
- source:some/file (Link zu der Datei, die sich unter /some/file im Repository des Projekts befindet)
- source:some/file@52 (Link zur Revision 52 der Datei)
- source:some/file#L120 (Link zur Revision 52 der Datei)
- source:some/file@52#L120 (Link zu Zeile 120 der Revision 52 der Datei)
- source:"some file@52#L120" (verwenden Sie doppelte Anführungszeichen, wenn die URL Leerzeichen enthält)
- export:some/file (Download der Datei erzwingen)
- source:svn1|some/file (Link zu einer Datei eines bestimmten Repositorys, für Projekte mit mehreren Repositorys)
- sandbox:source:some/file (Link zu der Datei, die sich unter /some/file im Repository des Projekts „Sandbox“ befindet)
- sandbox:export:some/file (Download der Datei erzwingen)
- Foren:
- forum#1 (Link zum Forum mit der ID 1)
- forum:Support (Link zum Forum namens Support)
- forum:"Technischer Support" (verwenden Sie doppelte Anführungszeichen, wenn der Forumsname Leerzeichen enthält)
- Forumsnachrichten:
- message#1218 (Link zur Nachricht mit der ID 1218)
- Projekte:
- project#3 (Link zu Projekt mit ID 3)
- project:Projekt (Link zu Projekt mit Namen oder Slug von „Projekt“)
- project:"Ein Projekt" (verwenden Sie doppelte Anführungszeichen für Projektnamen mit Leerzeichen)
- Nachrichten:
- news#2 (lLink zur Nachricht mit der ID 2)
- news:Willkommen (Link zum Nachrichtenartikel namens „Willkommen“)
- news:"Erste Neuigkeiten" (verwenden Sie doppelte Anführungszeichen, wenn der Name der Nachricht Leerzeichen enthält)
- Benutzer:
- user#2 (Link zu Benutzer mit ID 2)
- user:jsmith (Link zu Benutzer mit Login jsmith)
- @jsmith (Link zu Benutzer mit Login jsmith)
Link Unterdrückung:
- Sie können verhindern, dass Redmine-Links geparst werden, indem Sie ihnen ein Ausrufezeichen voranstellen: !
Externe Links
URLs (beginnend mit: www, http, https, ftp, ftps, sftp und sftps) und E-Mail-Adressen werden automatisch in anklickbare Links umgewandelt:
http://www.redmine.org, someone@foo.bar
Anzeige: http://www.redmine.org, someone@foo.bar
Wenn Sie anstelle der URL einen bestimmten Text anzeigen möchten, können Sie die Standard-Markdown-Syntax verwenden:
[Redmine Webseite](http://www.redmine.org)
Anzeige: Redmine Webseite
Textformatierung
Für Dinge wie Überschriften, Fettdruck, Tabellen, Listen unterstützt Redmine die Markdown-Syntax. Informationen zur Verwendung dieser Funktionen http://daringfireball.net/projects/markdown/syntax for information on using any of these features. Ein paar Beispiele sind unten enthalten, aber die Engine unterstützt noch viel mehr Funktionen.
Schriftstil
* **Fett gedruckt**
* *kursiv*
* ***Fett Kursiv***
* ~~durchgestrichen~~
Display:
- Fett gedruckt
- kursiv
- Fett Kursiv
durchgestrichen
Eingebettete Bilder
- ![](image_url) zeigt ein Bild an, das sich unter image_url befindet (Markdown-Syntax)
- Wenn Sie ein Bild an Ihre Wiki-Seite angehängt haben, kann es mit seinem Dateinamen inline angezeigt werden: ![](attached_image)
- Bilder aus der Zwischenablage Ihres Computers können direkt mit Strg-v oder cmd-v eingefügt werden (beachten Sie, dass ältere Browser inklusive aller Versionen des "Internet Explorer" nicht unterstützt werden)
- Bilddateien können zum Hochladen und Einbetten auf den Textbereich gezogen werden.
Überschriften
# Überschrift
## Untertitel
### untergeordneter Untertitel
Redmine weist jeder dieser Überschriften einen Anker zu, sodass Sie mit „#Überschrift“, „#Untertitel“ usw. darauf verlinken können.
Blockzitat
Beginnen Sie den Absatz mit >
> Rails ist ein Full-Stack-Framework zur 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.
Anzeige:
Rails ist ein Full-Stack-Framework zur 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.
Inhaltsverzeichnis
{{toc}} => linksbündiges Inhaltsverzeichnis
{{>toc}} => rechtsbündiges Inhaltsverzeichnis
Horizontale Linie
---
Anzeige
Makros
Redmine hat folgende, eingebauten Makros:
hello_world
Beispielmakro
macro_list
Zeigt eine Liste aller verfügbaren Makros an, einschließlich Beschreibung, falls verfügbar.
child_pages
Zeigt eine Liste der untergeordneten Seiten an. Ohne Argument zeigt es die untergeordneten Seiten der aktuellen Wiki-Seite an. Beispiele:
{{child_pages}} -- kann nur von einer Wiki-Seite aus verwendet werden
{{child_pages(depth=2)}} -- nur Verschachtelung mit 2 Ebenen anzeigen
include
Fügt eine Wiki-Seite hinzu. Beispiel:
{{include(Foo)}}
oder um eine Seite eines bestimmten Projekt-Wikis einzufügen:
{{include(projectname:Foo)}}
collapse
Einfügung von reduzierten Textblöcken. Beispiel:
{{collapse(Details anzeigen...)
Dies ist ein Textblock, der standardmäßig reduziert ist.
Es kann durch Klicken auf einen Link erweitert werden.
}}
thumbnail
Zeigt eine anklickbare Miniaturansicht eines angehängten Bildes an. Beispiele:
{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}}
issue
Fügt einen Link zu einem Ticket mit flexiblem Text ein. Beispiele:
{{issue(123)}} -- Fehler #123: Makrofunktionen verbessern
{{issue(123, project=true)}} -- Andromeda – Fehler #123: Makrofähigkeiten verbessern
{{issue(123, tracker=false)}} -- #123: Makrofähigkeiten verbessern
{{issue(123, subject=false, project=true)}} -- Andromeda - Fehler #123
Code-Hervorhebung
Die standardmäßige Code-Hervorhebung basiert auf Rouge, einem reinen Ruby-Code-Highlighter. Rouge 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 und yaml (yml) - die Namen in Klammern sind Aliase. Bitte beachten Sie die Liste der Sprachen, die vom Redmine-Code-Highlighter unterstützt werden.
Sie können Code an jeder Stelle hervorheben, die Wiki-Formatierung mit dieser Syntax unterstützt (beachten Sie, dass beim Sprachnamen oder Alias die Groß-/Kleinschreibung nicht beachtet wird):
``` ruby
Geben Sie hier Ihren Code ein.
```
Beispiel:
# Die Greeter-Klasse
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hallo #{@name}!"
end
end
Roh HTML
Sie können rohes HTML für komplexere Formatierungsaufgaben verwenden, z.B. komplexe Tabellen mit Zellen, die sich über mehrere Zeilen oder Spalten erstrecken:
<table width="50%">
<tr><td rowspan="2">Zwei Reihen</td><td>foo</td></tr>
<tr><td>bar</td></tr>
<tr><td align="center" colspan="2">bar</td></tr>
</table>
Ausgabe: