summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--cs-cz/markdown.html.markdown336
1 files changed, 239 insertions, 97 deletions
diff --git a/cs-cz/markdown.html.markdown b/cs-cz/markdown.html.markdown
index 35becf94..c01d25a6 100644
--- a/cs-cz/markdown.html.markdown
+++ b/cs-cz/markdown.html.markdown
@@ -5,44 +5,86 @@ contributors:
- ["Dan Turkel", "http://danturkel.com/"]
translators:
- ["Michal Martinek", "https://github.com/MichalMartinek"]
+ - ["Tomáš Hartman", "https://github.com/tomas-hartman"]
filename: markdown-cz.md
lang: cs-cz
---
-Markdown byl vytvořen Johnem Gruberem v roce 2004. Je zamýšlen jako lehce čitelná
-a psatelná syntaxe, která je jednoduše převeditelná do HTML (a dnes i do mnoha
-dalších formátů)
+Markdown byl vytvořen Johnem Gruberem v roce 2004 jako značkovací jazyk, který
+lze snadno číst a psát a který je možné jednoduše převést do HTML (a dnes i do
+mnoha dalších formátů).
+
+Implementace markdownu se v různých parserech (syntaktických analyzátorech,
+které markdown dále zpracovávají) mírně odlišuje. V této příručce se snažíme
+upozorňovat, kdy se jedná o obecnou vlastnost markdownu a kdy se jedná o
+specifickou vlastnost daného parseru.
+
+## Obsah
+
+- [Obsah](#obsah)
+- [HTML Elementy](#html-elementy)
+- [Nadpisy](#nadpisy)
+- [Jednoduché stylování textu](#jednoduché-stylování-textu)
+- [Odstavce](#odstavce)
+ - [Blokové citace](#blokové-citace)
+- [Seznamy](#seznamy)
+- [Bloky kódu](#bloky-kódu)
+- [Vodorovná čára (`<hr />`)](#vodorovná-čára-hr-)
+- [Odkazy](#odkazy)
+ - [Obsahy](#obsahy)
+- [Obrázky](#obrázky)
+- [Ostatní](#ostatní)
+ - [Automatické odkazy](#automatické-odkazy)
+ - [Automatické odkazy z emailů](#automatické-odkazy-z-emailů)
+ - [Escapování znaků](#escapování-znaků)
+ - [Klávesové zkratky](#klávesové-zkratky)
+ - [Tabulky](#tabulky)
+- [Markdownlint](#markdownlint)
+
+## HTML Elementy
+
+Markdown je nadstavba HTML. To znamená, že každý HTML kód je zároveň validním
+kódem v Markdownu.
+
+```md
+<!-- To znamená, že v Markdownu můžeme používat HTML elementy jako například
+komentáře, které nebudou ovlivněny parserem Markdownu. Na druhou stranu to také
+znamená, že pokud ve svém Markdown kódu vytvoříte HTML element, už v rámci
+tohoto elementu nelze použít Markdown.
+
+Markdown využívá i tato stránka, a tak by tento text, kdyby nebyl obalen v bloku
+kódu (viz níže), jako validní HTML komentář vůbec nebyl vidět. -->
+```
+
+## Nadpisy
+
+HTML elementy `<h1>` až `<h6>` vytvoříte jednoduše tak, že nadpisu předsadíte
+takový počet křížků (#), jaký odpovídá úrovni nadpisu.
```md
-<!-- Markdown je nadstavba nad HTML, takže jakýkoliv kód HTML je validní
-Markdown, to znamená, že můžeme používat HTML elementy, třeba jako komentář, a
-nebudou ovlivněny parserem Markdownu. Avšak, pokud vytvoříte HTML element v
-Markdownu, tak nemůžete používat syntaxi Markdownu uvnitř tohoto elementu. -->
-
-<!-- Markdown se také mírně liší v jednotlivých interpretacích parseru. Tento
-návod vás bude upozorňovat, které vlastnosti jsou obecné a které specifické pro
-konkrétní parser. -->
-
-<!-- Nadpisy -->
-<!-- Můžete vytvořit HTML elementy <h1> až <h6> jednoduše tak, že text předsadíte
-počtem křížků (#), podle toho jaké úrovně to má být nadpis -->
# Toto je <h1>
## Toto je <h2>
### Toto je <h3>
#### Toto je <h4>
##### Toto je <h5>
###### Toto je <h6>
+```
+
+Markdown obsahuje ještě dva další způsoby, jak vytvořit h1 a h2:
-<!-- Markdown obsahuje taky dvě další cesty, jak udělat h1 a h2 -->
+```md
Toto je h1
==========
Toto je h2
----------
+```
+
+## Jednoduché stylování textu
-<!-- Jednoduché stylování textu -->
-<!-- Pomocí markdownu můžete text jednoduše označit jako kurzívu či tučný -->
+Pomocí markdownu můžete text jednoduše označit jako kurzívu či tučný text.
+```md
*Tento text je kurzívou;*
_Stejně jako tento._
@@ -50,47 +92,62 @@ _Stejně jako tento._
__Stejně jako tento.__
***Tento text je obojí***
-**_Jako tento!_**
-*__A tento!__*
+**_Tak jako tento!_**
+*__Nebo tento!__*
+```
-<!-- Ve verzi Markdownu od GitHubu, máme k dispozici taky prošktrnutí: -->
+Ve verzi Markdownu od GitHubu máme k dispozici také přeškrtnutí:
-~~Tento text je prošktrnutý.~~
+```md
+~~Tento text je přeškrtlý.~~
+```
-<!-- Odstavce jsou jedna nebo více řádek textu, oddělených jednou nebo více prázdnými řádky. -->
+## Odstavce
-Toto je odstavec. Píši odstavec, není to zábava?
+Odstavce tvoří jeden nebo více řádků textu, oddělených jedním nebo více
+prázdnými řádky.
-Teď jsem v odstavci 2.
-Jsem pořád v odstavci 2!
+```md
+Toto je odstavec. Zde jsem napsal odstavec a je to bezva!
+Teď jsem v odstavci 2.
+A tady jsem pořád v odstavci 2!
-Toto je odstavec 3.
+Ale tady už je odstavec 3.
+```
-<!-- Chtěli jste někdy vložit znak <br /> tag? Můžete napsat na konec odstavce
-dvě nebo více mezer a potom začít nový odstavec. -->
+Pokud byste chtěli vložit HTML element `<br />`, můžete na konec odstavce napsat
+dvě nebo více mezer a potom začít nový odstavec.
+```md
Tento odstavec končí dvěma mezerami.
-Nad tímto odstavcem je <br />!
+Nad tímto odstavcem je <br />!
+```
-<!-- Blokové citace se dělají jednoduše pomocí znaku >. -->
+### Blokové citace
+Blokové citace se dělají jednoduše uvozením řádku znakem >.
+
+```md
> Toto je bloková citace. Můžete dokonce
-> manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky jakkoliv dlouhé, ať se zarovnají sami.
-> Nedělá to rozdíl, dokud začínáte vždy znakem >.
+> manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky
+> jakkoli dlouhé, ať se zarovnají samy.
+> Je to jedno, pokud vždy začinají symbolem `>`.
-> Můžu použít více než jednu
->> odsazení?
-> Jak je to úhledné, že?
+> Použít můžu i více než jednu úroveň
+>> odsazení.
+> Co vy na to?
+```
-<!-- Seznamy -->
-<!-- Nečíslovaný seznam můžete jednoduše udělat pomocí hvězdiček, plusů, nebo
- pomlček -->
+## Seznamy
+Nečíslovaný seznam můžete jednoduše udělat pomocí hvězdiček, plusů nebo pomlček:
+
+```md
* Položka
* Položka
-* Jinná položka
+* Jiná položka
nebo
@@ -103,158 +160,243 @@ nebo
- Položka
- Položka
- Další položka
+```
-<!-- Číslovaný seznam se dělají pomocí čísla a . -->
+Číslované seznamy se dělají pomocí číslice a `.`.
+```md
1. Položka jedna
2. Položka dvě
3. Položka tři
-<!-- Nemusíte dokonce psát čísla správně a markdown je zobrazi správně,
- ale nemusí to být vždy dobrý nápad -->
+<!-- Čísla ani nemusíte psát popořadě. Markdown je umí zobrazit správně, jenom
+je třeba vždy překontrolovat, že číslování funguje správně. -->
1. Položka jedna
1. Položka dvě
1. Položka tři
-<!-- (Toto zobrazí to samě, jako příklad nadtím.) -->
-<!-- Můžete také tvořit podseznamy -->
+<!-- (Toto zobrazí to samě, jako příklad nad tím.) -->
+```
+Můžete také tvořit podseznamy:
+
+```md
1. Položka jedna
2. Položka dvě
3. Položka tři
- * Podpoložka
- * Podpoložka
+ - Podpoložka
+ - Podpoložka
4. Položka čtyři
+```
-<!-- Existují i zašktávací seznamy. Toto vytvoří HTML checkboxy. -->
+Vytvořit lze i zaškrtávací seznamy. Takto lze vytvořit seznam s HTML checkboxy.
+(Boxy níže bez 'x' jsou nezašktrnuté checkboxy.)
-Boxy níže bez 'x' jsou nezašktrnuté checkboxy.
-- [ ] První úkol
-- [ ] Druhý úkol
+```md
+- [ ] První úkol, který je třeba dokončit
+- [ ] Druhý úkol na dodělání
Tento box bude zašktrnutý
- [x] Tento úkol byl dokončen
+```
-<!-- Bloky ködu -->
-<!-- Můžete označit kód bloku (který používá <code> element) odsazením pomocí 4
- mezer, nebo tabu -->
+## Bloky kódu
+Bloky kódu můžete označit tak, že řádek odsadíte čtyřmi mezerami nebo pomocí
+tabu. Pro interpretaci kódu parser používá `<code>` element.
+
+```md
Toto je kód
Stejně jako toto
+```
-<!-- Můžete dokonce přidat další 4 mezery nebo tab pro další odsazení -->
+Pro ještě hlubší odsazení můžete přidat další 4 mezery nebo další tab:
+```md
moje_pole.each do |i|
puts i
end
+```
-<!-- Kód na řádku může být označen pomocí zpětných apostrofů ` -->
+Jednořádkový kód můžete zabalit do dvou zpětných apostrofů (`) tak, jako
+kdybyste text normálně stylovali:
-Jan nevědel, jak se dělá `go_to()` funkce!
+```md
+Honza neměl tušení, co dělá funkce `go_to()`!
+```
-<!-- V Markdownu od GitHubu , můžete použít speciální syntaxi pro kód -->
+V Markdownu od GitHubu, můžete použít speciální syntaxi pro kód:
-\`\`\`ruby <!-- vyjma zpětných lomítek, jenom ```ruby ! -->
+<pre><code class="highlight">&#x60;&#x60;&#x60;ruby
def neco
puts "Ahoj světe!"
end
-\`\`\` <!-- zde taky, žádné zpětná lomítka, pouze ``` -->
+&#x60;&#x60;&#x60;</code></pre>
-<!-- Text výše nepotřebuje odsazení a navíc GitHub použije zvýraznění označeného
- jazyka. -->
+Text výše nepotřebuje čtyřmezerové odsazení a parser navíc použije zvýraznění
+syntaxe pro zvolený jazyk.
-<!-- Horizontální čára (<hr />) -->
-<!-- Horizontální čára se jednoduše přidá pomocí 3 nebo více hvězdiček nebo pomlček
-s nebo bez mezer. -->
+## Vodorovná čára (`<hr />`)
+Vodorovnou oddělovací čáru lze snadno přidat pomocí 3 nebo více hvězdiček (nebo
+pomlček), a to buď s mezerami mezi jednotlivými znaky, nebo bez nich.
+
+```md
***
---
- - -
****************
+```
-<!-- Odkazy -->
-<!-- Jedna z nejlepších věcí na Markdownu je, jak jednoduše se dělají odkazy.
-Dejte text, který chcete zobrazit, do [] následovaný url v závorkách () a je to. -->
+## Odkazy
+
+```md
+<!-- Jedna z nejlepších vlastností Markdownu je, jak snadno lze s jeho pomocí
+vytvářet odkazy. Text odkazu, který chcete zobrazit vložte do [] a hned za něj
+v kulatých závorkách () připojte url adresu. -->
[Klikni na mě!](http://test.com/)
-<!-- Můžete také přidat jméno linku pomocí uvozovek -->
+
+<!-- V uvozovkách za url můžete přidat název odkazu -->
[Klikni na mě!](http://test.com/ "Odkaz na Test.com")
-<!-- Relativní cesty fungují taky -->
+
+<!-- Relativní cesty fungují také -->
[Jdi na hudbu](/hudba/).
-<!-- Markdown taktéž podporuje reference odkazů. -->
+
+<!-- Markdown taktéž podporuje referenční odkazy -->
[Klikni na tento odkaz][link1] pro více informací!
-[Taky zkontrolujte tento odkaz][neco], když chcete.
+[Taky zkontrolujte tento odkaz][neco], jestli tedy chcete.
[link1]: http://test.com/ "Cool!"
[neco]: http://neco.czz/ "Dobře!"
-<!-- Titulek může být v apostrofech nebo závorkách, nebo vyjmutý úplně. Reference
- může být kdekoliv ve vašem dokumentu a identifikátor může být jakýkoliv, dokud
- je unikátní.-->
+<!-- Titulek v tomto případě může být v jednoduchých uvozovkách, závorkách, nebo
+zcela vynechaný. Reference může být kdekoliv ve vašem dokumentu a identifikátory
+mohou být jakékoli, pokud jsou unikátní. -->
-<!-- Také existuje "implicitní pojmenování", které použije text jako id -->
+
+<!-- V markdownu existuje rovněž "implicitní pojmenování", které použije text
+odkazu jako své id -->
[Toto][] je odkaz..
[toto]: http://totojelink.cz/
-<!-- Ale toto není zrovna běžné užívané. -->
+<!-- Ale tento způsob se obvykle nepoužívá. -->
+```
+
+### Obsahy
+
+Kombinace seznamů, odkazů a nadpisů využívají také některé parsery pro
+generování obsahu Markdown souborů. Jako identifikátory slouží jména nadpisů
+psané malými písmeny, které jsou uvozené křížkem (`#`). Víceslovné nadpisy
+bývají propojeny pomlčkou (`-`), která někdy nahrazuje i speciální znaky. Jiné
+speciální znaky mohou být vynechány.
+
+```md
+- [Nadpis](#nadpis)
+- [Víceslovný text](#víceslovný-text)
+- [Odstavce](#odstavce)
+ - [Podkapitola <h3 />](#podkapitola-h3-)
+```
+
+V případě obsahů se v každém případě jedná o nadstavbu, která nemusí všude
+fungovat stejně.
+
+## Obrázky
-<!-- Obrázky -->
-<!-- Obrázky se dělají stejně jako odkazy, ale s vykřičníkem na začátku -->
+```md
+<!-- Obrázky se vytváří stejně jako odkazy, ale s vykřičníkem na začátku -->
![Toto je atribut alt pro obrázek](http://imgur.com/myimage.jpg "Nepovinný titulek")
-<!-- Reference fungují, jak bychom čekali-->
+<!-- Reference fungují tak, jak bychom čekali -->
![Toto je atribut alt][mujobrazek]
[mujobrazek]: relativni/cesta/obrazek.jpg "a toto by byl titulek"
+```
+
+## Ostatní
-<!-- Ostatní -->
-<!-- Automatické odkazy -->
+### Automatické odkazy
+
+```md
+<http://stranka.cz/>
+
+je stejné jako
-<http://stranka.cz/> je stejná jako
[http://stranka.cz/](http://stranka.cz/)
+```
-<!-- Automatické odkazy pro emaily-->
+### Automatické odkazy z emailů
+```md
<jmeno@prijmeni.cz>
+```
-<!-- Escapování znaků -->
+### Escapování znaků
-Chci napsat *tento text obklopený hvězdičkami*, ale nechci aby to bylo kurzívou, tak udělám: \*tento text obklopený hvězdičkami\*.
+```md
+Chci napsat *tento text obklopený hvězdičkami*, ale protože nechci, aby to bylo
+kurzívou, tak hvězdičky vyescapuji `\`: \*tento text bude obklopený hvězdičkami\*.
+```
-<!-- Klávesové zkratky -->
-<!-- V Markdownu od GitHubu, můžete použít tag <kbd> k reprezentování klaves na počítači -->
+### Klávesové zkratky
+
+```md
+<!-- V Markdownu od GitHubu můžete použít tag <kbd> k označení klaves na
+počítači -->
Váš počítač přestal pracovat? Zkuste
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
+```
+
+### Tabulky
-<!-- Tabulky -->
-<!-- Tabulky jsou povolené pouze v Markdownu od GitHubu a jsou trochu podivně,
- ale když je opravdu chcete: -->
+Tabulky lze využít pouze v Markdownu od GitHubu a jejich syntax je trošku
+zvláštní. Kdybyste je chtěli použít, vytváří se takto:
+```md
| Sloupec1 | Sloupec2 | Sloupec3 |
| :----------- | :------: | ------------: |
| Vlevo zarovn.| Na střed | Vpravo zarovn.|
| blah | blah | blah |
-<!-- nebo, to jde i taky: -->
+<!-- nebo je jde taky zapsat takto: -->
Sloupec 1 | Sloupec2 | Sloupec3
:-- | :-: | --:
-Ohh toto je tak ošklivé | radši to | nedělejte
+Že se to nedá číst? | No tak to takhle | radši nedělejte.
+```
-<!-- Konec -->
+## Markdownlint
-```
+Pro usnadnění práce s Markdownem a s cílem sjednotit styl psaní jeho kódu vznikl
+nástroj `Markdownlint`. Tento nástroj je dostupný i jako plugin pro některé
+editory kódu (IDE) a lze jej použít jako nástroj pro vytváření a ověřování
+validity a čitelnosti Markdownu kódu.
+
+---
+
+> _Pozn. překladatele:_ Tento text vznikl jako překlad původního článku, který
+> vznikl v roce 2013, který byl po obsahové stránce naposledy editován v roce
+> 2015 a kombinace původního českého překladu z roku 2015. Některé informace v
+> tomto článku, zejména ty, týkající se specifických vlastnostní parserů
+> markdownu tak již dnes mohou být zasrtaralé.
+>
+> Za účelem aktualizace tohoto článku jsem přidal kapitoly o
+> [generování obsahů](#obsahy), které mj. využívá i tento článek a o
+> [Markdownlintu](#markdownlint).
+
+---
-Pro více informací, prozkoumejte oficiální článek o syntaxi od Johna Grubera
- [zde](http://daringfireball.net/projects/markdown/syntax) a skvělý tahák od Adama Pritcharda [zde](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
+Pro více informací doporučujeme oficiální článek o syntaxi od Johna Grubera
+ [zde](http://daringfireball.net/projects/markdown/syntax) a skvělý tahák od
+ Adama Pritcharda [zde](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).