Formátování Wiki (Markdown)

Odkazy

Odkazy Redmine

Redmine umožňuje hypertextové odkazy mezi jednotlivými zdroji (úkoly, revize, wiki stránky...) kdekoli, kde je použito Wiki formátování.

• Odkaz na úkol: #124 (zobrazí #124, odkaz je přeškrtnutý, jestliže je úkol uzavřen)
• Odkaz na poznámku k úkolu: #124-6, nebo #124#note-6

Odkazy Wiki:

• [[Příručka]] zobrazí odkaz na stránku nazvanou "Příručka": Příručka.
• [[Příručka#čtěte-více]] Vás přenese ke kotvě "čtěte-více". Nadpisy mají automaticky přiřazené kotvy, na které se můžete odkazovat: Příručka.
• [[Příručka|Uživatelský manuál]] zobrazí odkaz na tu samou stránku, ale s jiným textem: Uživatelský manuál.

Můžete se také odkazovat na Wiki stránky jiného projektu:

Můžete se také odkazovat na Wiki stránky jiného projektu:

• [[projekt_test:Nějaká stránka]] zobrazí odkaz na stránku s názvem "Nějaká stránka" na Wiki projektu projekt_test.
• [[projekt_test:]] zobrazí odkaz na hlavní Wiki stránku projektu projekt_test.

Odkazy na Wiki stránky jsou zobrazeny červeně v případě, že odkazovaná stránka dosud neexistuje, např.: Neexistující stránka.

Odkazy na další zdroje:

• Dokumenty:
  • document#17 (odkaz na dokument s ID 17)
  • document:Úvod (odkaz na dokument s názvem "Úvod")
  • document:"Nějaký dokument" (Uvozovky se mohou použít v případě, že název obsahuje mezery.)
  • projekt_test:document:"Nějaký dokument" (odkaz na dokument s názvem "Nějaký dokument" v jiném projektu "projekt_test")
• Verze:
  • version#3 (odkaz na verzi s ID 3)
  • version:1.0.0 odkaz na verzi s názvem "1.0.0")
  • version:"1.0 beta 2"
  • projekt_test:version:1.0.0 (odkaz na verzi "1.0.0" jiného projektu "projekt_test")
• Přílohy:
  • attachment:soubor.zip (odkaz na přílohu aktuálního objektu s názvem soubor.zip)
  • Aktuálně mohou být odkazovány pouze přílohy aktuálního objektu (u úkolu mohou být odkazy pouze na přílohy danného úkolu).
• Revize:
  • r758 (odkaz na revizi)
  • commit:c6f4d0fd (odkaz na revizi s nečíselným označním revize)
  • svn1|r758 (odkaz na revizi určitého repozitáře, pro projekty s více repozitáři)
  • commit:hg|c6f4d0fd (odkaz na revizi s nečíselným označním revize určitého repozitáře, pro projekty s více repozitáři)
  • projekt_test:r758 (odkaz na revizi jiného projektu)
  • projekt_test:commit:c6f4d0fd (odkaz na revizi s nečíselným označním revize jiného projektu)
• Soubory repositáře:
  • source:some/file (odkaz na soubor umístěný v /some/file respozitáře projektu)
  • source:some/file@52 (odkaz na revizi souboru č. 52)
  • source:some/file#L120 (odkaz na 120. řádek souboru)
  • source:some/file@52#L120 (odkaz na 120. řádek revize souboru č. 52)
  • source:"some file@52#L120" (použijte uvozovky, když URL obsahuje mezery)
  • export:some/file (vynutit stažení souboru)
  • source:svn1|some/file (odkaz na soubor určitého repozitáře, pro projekty s více repositáři)
  • projekt_test:source:some/file (odkaz na soubor umístěný v /some/file repositáře projektu "projekt_test")
  • projekt_test:export:some/file (vynutit stažení souboru umístěného v /some/file repositáře projektu "projekt_test")
• Diskuzní fóra:
  • forum#1 (odkaz na fórum s id 1
  • forum:Support (odkaz na fórum pojmenované Support)
  • forum:"Technical Support" (Použij dvojté uvozovkym jestliže název fóra obsahuje mezery.)
• Příspěvky diskuzního fóra:
  • message#1218 (odkaz na příspěvek s ID 1218)
• Projekty:
  • project#3 (odkaz na projekt s ID 3)
  • project:projekt_test (odkaz na projekt pojmenovaný "projekt_test")
  • project:"projekt test" (odkaz na projekt pojmenovaný "projekt test")
• Novinky:
  • news#2 (odkaz na novinku id 2)
  • news:Greetings (odkaz na novinku "Greetings")
  • news:"First Release" (použij dvojté uvozovky, jestliže název novinky obsahuje mezery)

Escaping:

• Zabránit parsování Redmine odkazů, lze vložením vykřičníku před odkaz: !

Externí odkazy

URL odkazy a emaily jsou automaticky zobrazeny jako klikací odkaz:

http://www.redmine.org, someone@foo.bar

zobrazí: http://www.redmine.org, someone@foo.bar

Jestliže chcete zobrazit určitý text místo URL, můžete použít standardní syntaxi textile:

"Webová stránka Redmine":http://www.redmine.org

zobrazí: Webová stránka Redmine

<

Formátování textu

Pro nadpisy, tučný text, tabulky a seznamy, Redmine podporuje syntaxi Textile. Podívejte se na http://en.wikipedia.org/wiki/Textile_(markup_language) pro informace o využití těchto vlastností. Několik příkladů je uvedeno níže, ale Textile toho dokáže mnohem víc.

Styly písma

* **tučný**
* *kurzíva*
* ***tučná kurzíva***
* ~~přeškrtnutý~~

Zobrazí:

• tučný
• kurzíva
• tučná kurzíva
• přeškrtnutý

Vložené obrázky

•  zobrazí obrázek z odkazu (syntaxe markdown)
• Jestliže máte obrázek přiložený k Wiki stránce, může být zobrazen jako vložený obrázek pomocí jeho jména: 

Headings

# Nadpis 1. úrovně
## Nadpis 2. úrovně
### Nadpis 3. úrovně

Redmine přiřadí kotvu ke každému nadpisu, takže se na ně lze odkazovat pomocí "#Nadpis", "#Podnadpis" atd.

Odstavce

Začněte odstavec s >

> Rails je framework pro vývoj webových aplikací podle modelu Model-View-Control.
Vše, co je potřeba, je databázový a webový server.

Zobrazí:

Rails je framework pro vývoj webových aplikací podle modelu Model-View-Control.
Vše, co je potřeba, je databázový a webový server.

Obsah

{{toc}} => obsah zarovnaný doleva
{{>toc}} => obsah zarovnaný doprava

Vodorovná čára

---

Macros

Redmine obsahuje následující vestavěná makra:

hello_world

Jednoduché makro.

macro_list

Zobrazí seznam všech dostupných maker, včetně jejich popisu, existuje-li.

child_pages

Zobrazí seznam dětských stránek. Bez parametrů zobrazí dětské stránky aktuální wiki stránky. Např.:

{{child_pages}} -- lze použít pouze z wiki stránky
{{child_pages(depth=2)}} -- zobrazí dětské stránky pouze do 2. úrovně

include

Vloží Wiki stránku. Např.:

{{include(Foo)}}

or to include a page of a specific project wiki:

{{include(projectname:Foo)}}

collapse

Vloží sbalený blok textu. Např.:

{{collapse(Zobrazit detaily...)
Toto je blok textu, který je sbalený.
Pro rozbalení klikněte na odkaz.
}}

thumbnail

Zobrazí klikací náhled obrázku. Např.:

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

Zvýrazňování kódu

Výchozí zvýrazňování kódu zavisí na CodeRay, což je rychlá zvýrazňovací knihovna napsaná v Ruby. Aktuálně podporuje jazyky C/C++, CSS, Delphi, Groovy, HTML, Java, Javascript, JSON, PHP, Python, RHTML, Ruby, Scheme, SQL, XML a YAML.

Kód můžete na stránce zvýraznit pomocí následující syntaxe:

~~~ ruby
  Váš kód vložte zde.
~~~

Např:

 1 # The Greeter class
 2 class Greeter
 3   def initialize(name)
 4     @name = name.capitalize
 5   end
 6
 7   def salute
 8     puts "Hello #{@name}!"
 9   end
10 end