Formátování Wiki v Redminu

# 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 úkol včetně fronty a předmětu: ##124 (zobrazí Bug #124: Hromadná změna nezmění kategorii úkolů)
- Odkaz na poznámku k úkolu: #124-6 nebo #124#note-6
- Odkaz na poznámku k úkolu v tom samém úkole: #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.
- [[#čtěte více]] odkaz na kotvu "čtěte-více" aktuální stránky: čtěte více
- [[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ý

### Vnoř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 vnořený obrázek pomocí jeho jména: ![](attached_image)
- Obrázky ze schránky mohou být vloženy přímo pomocí Ctrl-v/Command-v.
- Soubory s obrázky mohou být přímo přetaženy do textového pole. Budou nahrány a vloženy.

### 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)}}

`issue`

  Vloží odkaz na úkol s volitelným textem. Např.:

      {{issue(123)}}                              -- Issue #123: Rozšířené možnosti maker
      {{issue(123, project=true)}}                -- Andromeda - Issue #123: Rozšířené možnosti maker
      {{issue(123, tracker=false)}}               -- #123: Rozšířené možnosti maker
      {{issue(123, subject=false, project=true)}} -- Andromeda - Úkol #123

## Zvýrazňování kódu

Výchozí zvýrazňování kódu závisí na Rouge, zvýrazňovači kódu napsanému v Ruby. Rouge podporuje mnoho běžně používaných jazyků, jako jsou 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) - jména v závorkách jsou aliasy. Podívejte se, prosím, na seznam jazyků poporovaných zvýrazňovačem kódu Redmine.

Kód můžete na stránce zvýraznit pomocí následující syntaxe (záleží na velikosti písma jazyku nebo aliasu):

    ``` ruby
      Zde vložte Váš kód.
    ```

Např:

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

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