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 (`
` element.
+
+```md
Toto je kód
Stejně jako toto
+```
-
+Pro ještě hlubší odsazení můžete přidat další 4 mezery nebo další tab:
+```md
moje_pole.each do |i|
puts i
end
+```
-
+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:
-\`\`\`ruby
+```ruby
def neco
puts "Ahoj světe!"
end
-\`\`\`
+```
-
+Text výše nepotřebuje čtyřmezerové odsazení a parser navíc použije zvýraznění
+syntaxe pro zvolený jazyk.
-
-
+## Vodorovná čára (`
`)
+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
+
+```md
+
[Klikni na mě!](http://test.com/)
-
+
+
[Klikni na mě!](http://test.com/ "Odkaz na Test.com")
-
+
+
[Jdi na hudbu](/hudba/).
-
+
+
[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!"
-
+
-
+
+
[Toto][] je odkaz..
[toto]: http://totojelink.cz/
-
+
+```
-
-
+### 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 ](#podkapitola-h3-)
+```
+
+V případě obsahů se v každém případě jedná o nadstavbu, která nemusí všude
+fungovat stejně.
+
+## Obrázky
+
+```md
+
![Toto je atribut alt pro obrázek](http://imgur.com/myimage.jpg "Nepovinný titulek")
-
+
![Toto je atribut alt][mujobrazek]
[mujobrazek]: relativni/cesta/obrazek.jpg "a toto by byl titulek"
+```
-
-
+## Ostatní
+
+### Automatické odkazy
+
+```md
+
+
+je stejné jako
- je stejná jako
[http://stranka.cz/](http://stranka.cz/)
+```
-
+### Automatické odkazy z emailů
+```md
+```
-
+### 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
+
+```md
+
Váš počítač přestal pracovat? Zkuste
Ctrl+Alt+Del
+```
-
-
+### Tabulky
+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 |
-
+
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.
```
-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).
+## 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í 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).