# 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)
- 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.
- [[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")

- 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")

Escaping:

- Zabránit parsování Redmine odkazů, lze vložením vykřičníku před odkaz: !

### Externí odkazy

URL odkazy a emaily jsou automaticky zobrazeny jako klikací odkaz:

    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`

  Displays a list of child pages. With no argument, it displays the child pages of the current wiki page. Examples:

      {{child_pages}} -- can be used from a wiki page only
      {{child_pages(depth=2)}} -- display 2 levels nesting only

`include`

  Vloží Wiki stránku. Např.:

      {{include(Foo)}}

  or to include a page of a specific project wiki:

      {{include(projectname:Foo)}}

`collapse`

  Inserts of collapsed block of text. Example:

      {{collapse(View details...)
      This is a block of text that is collapsed by default.
      It can be expanded by clicking a link.
      }}

`thumbnail`

  Displays a clickable thumbnail of an attached image. Examples:

      {{thumbnail(image.png)}}
      {{thumbnail(image.png, size=300, title=Thumbnail)}}

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

Výchozí zvýrazňování kódu zavisí na CodeRay, což je rychlá zvýrazňovací knihovna napsaná v Ruby. Aktuálně podporuje jazyky C/C++, CSS, Delphi, Groovy, HTML, Java, Javascript, JSON, PHP, Python, RHTML, Ruby, Scheme, SQL, XML a YAML.

Kód můžete na stránce zvýraznit pomocí následující syntaxe:

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

Např.:

     1 # The Greeter class
     2 class Greeter
     3   def initialize(name)
     4     @name = name.capitalize
     5   end
     6
     7   def salute
     8     puts "Hello #{@name}!"
     9   end
    10 end