From b9e9f9bcbd9209a735bb08081c98dfbcf7edc32a Mon Sep 17 00:00:00 2001 From: tomas-hartman <44980733+tomas-hartman@users.noreply.github.com> Date: Wed, 17 Nov 2021 00:56:42 +0100 Subject: [markdown/cs-cz] Improve translation language style and add subchapter on table of contents (#4271) * refactor: improve stylistic quality of the translation and add minor chapters * fix: limit to 80 chars per line * fix (lang): fix some typos Co-authored-by: Tomas Hartman --- cs-cz/markdown.html.markdown | 336 ++++++++++++++++++++++++++++++------------- 1 file changed, 239 insertions(+), 97 deletions(-) (limited to 'cs-cz/markdown.html.markdown') 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 (`
`)](#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 + +``` + +## Nadpisy + +HTML elementy `

` až `

` vytvoříte jednoduše tak, že nadpisu předsadíte +takový počet křížků (#), jaký odpovídá úrovni nadpisu. ```md - - - - - - # Toto je

## Toto je

### Toto je

#### Toto je

##### Toto je

###### Toto je
+``` + +Markdown obsahuje ještě dva další způsoby, jak vytvořit h1 a h2: - +```md Toto je h1 ========== Toto je h2 ---------- +``` + +## Jednoduché stylování textu - - +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 také přeškrtnutí: -~~Tento text je prošktrnutý.~~ +```md +~~Tento text je přeškrtlý.~~ +``` - +## 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. +``` - +Pokud byste chtěli vložit HTML element `
`, 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
! +Nad tímto odstavcem je
! +``` - +### 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: + +```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é seznamy se dělají pomocí číslice a `.`. +```md 1. Položka jedna 2. Položka dvě 3. Položka tři - + 1. Položka jedna 1. Položka dvě 1. Položka tři - - + +``` +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 +``` - +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 +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á `` 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. +``` - +## 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). -- cgit v1.2.3