Formátování Wiki v Redminu

# Formátování 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)
- 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 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ý

### Vlož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 vložený obrázek pomocí jeho jména: !prilozeny_obrazek.png!

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

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

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

Např.:

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

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