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)
- 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
- Link to an issue note within the same issue: #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)
- Images in your computer's clipboard can be pasted directly using Ctrl-v or Command-v (note that Internet Explorer is not supported).
- Image files can be dragged onto the text area in order to be uploaded and embedded.

### 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`

  Inserts a link to an issue with flexible text. Examples:

      {{issue(123)}}                              -- Issue #123: Enhance macro capabilities
      {{issue(123, project=true)}}                -- Andromeda - Issue #123:Enhance macro capabilities
      {{issue(123, tracker=false)}}               -- #123: Enhance macro capabilities
      {{issue(123, subject=false, project=true)}} -- Andromeda - Issue #123

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

Default code highlighting relies on Rouge, a pure Ruby code highlighter. Rouge 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 - the names inside parentheses are aliases. Please refer to the list of languages supported by Redmine code highlighter.

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