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)
- Link to an issue including tracker name and subject: ##124 (displays Bug #124: bulk edit doesn't change the category or fixed version properties)
- 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.
- [[#further-reading]] link to the anchor "further-reading" of the current page: #further-reading
- [[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
Default code highlightment relies on Rouge, a syntax highlighting library written in pure Ruby. It supports many commonly used languages such as 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) languages, where the names inside parentheses are aliases. Please refer to https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages for the full list of supported languages.
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ř:
# The Greeter class
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hello #{@name}!"
end
end