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:
- [[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)
- Uživatelé:
- user#2 (odkaz na uživatele s id 2)
- user:jsmith (odkaz na uživatele s loginem jsmith)
- @jsmith (odkaz na uživatele s loginem jsmith)
Escape sekvence:
- Zabránit parsování Redmine odkazů lze vložením vykřičníku před odkaz: !
Externí odkazy
URL (začínající: www, http, https, ftp, ftps, sftp a sftps) a e-mailové adresy jsou automaticky převedeny na klikací odkazy:
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 Markdown. Podívejte se na http://daringfireball.net/projects/markdown/syntax pro informace o využití těchto vlastností. Několik příkladů je uvedeno níže, ale Markdown 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
- ![](image_url) 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: ![](attached_image)
Nadpisy
# 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: 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 a yaml (yml) jazyky, jejichž jména jsou v závorkách jsou aliasy.
Kód můžete na stránce zvýraznit pomocí následující syntaxe (záleží na velikosti písma jazyku nebo aliasu):
~~~ ruby
Váš kód vložte zde.
~~~
Např:
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hello #{@name}!"
end
end