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. It currently supports c, clojure, cpp (c++, cplusplus), css, delphi (pascal), diff (patch), erb (eruby, rhtml), go, groovy, haml, html (xhtml), java, javascript (ecmascript, ecma_script, java_script, js), json, lua, php, python, ruby (irb), sass, sql, taskpaper, text (plain, plaintext), xml and yaml (yml) languages, where the names inside parentheses are aliases.

Kód můžete na stránce zvýraznit pomocí následující syntaxe (note that the language name or alias is case-insensitive):

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

Např:

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

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