Formátování Wiki v Redminu

# Syntaxe Wiki

## 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" na aktuální stránce: #č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 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*_
    * +podtržený+
    * -přeškrtnutý-

Zobrazí:

- tučný
- kurzíva
- tučná kurzíva
- podtržený
- přeškrtnutý

### Vnořené obrázky

- !image_url! zobrazí obrázek z odkazu (syntaxe textile)
- !>image_url! obrázek zarovnaný napravo
- 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: !prilozeny_obrazek.png!
- Soubory s obrázky mohou být vloženy přímo pomocí Ctrl-c/Command-v.
- Soubory s obrázy mohou být přímo přetaženy do textového pole. Budou nahrány a vloženy.

### Nadpisy

    h1. Nadpis 1. úrovně

    h2. Nadpis 2. úrovně

    h3. 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

    p>. zarovnaný doprava
    p=. zarovnaný na střed

Toto je odstavec zarovnaný na střed.

### Citace

Začněte odstavec s bq.

    bq. 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

    ---

## Makra

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ém v Ruby. Rouge podporuje mnoho běžný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 z závorkách jsou aliasy. Podívejte se, prosím, na seznam jazyků podporovaný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):

    <pre><code class="ruby">
      Zde vložte Váš kód.
    </code></pre>

Např.:

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

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