iskm/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-01-14 13:15:59 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

[markdown/cs-cz] Improve translation language style and add subchapter on table of contents (#4271)

Browse Source 
* 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 <tomash@xcroco.com>
This commit is contained in:
tomas-hartman 2021-11-17 00:56:42 +01:00 committed by GitHub
parent e6f3c19425
commit b9e9f9bcbd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 238 additions and 96 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

334
cs-cz/markdown.html.markdown
View File

@ -5,44 +5,86 @@ contributors:
- ["Dan Turkel", "http://danturkel.com/"] - ["Dan Turkel", "http://danturkel.com/"]
translators: translators:
- ["Michal Martinek", "https://github.com/MichalMartinek"] - ["Michal Martinek", "https://github.com/MichalMartinek"]
- ["Tomáš Hartman", "https://github.com/tomas-hartman"]
filename: markdown-cz.md filename: markdown-cz.md
lang: cs-cz lang: cs-cz
--- ---
Markdown byl vytvořen Johnem Gruberem v roce 2004. Je zamýšlen jako lehce čitelná Markdown byl vytvořen Johnem Gruberem v roce 2004 jako značkovací jazyk, který
a psatelná syntaxe, která je jednoduše převeditelná do HTML (a dnes i do mnoha lze snadno číst a psát a který je možné jednoduše převést do HTML (a dnes i do
dalších formátů) 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 ```md
<!-- Markdown je nadstavba nad HTML, takže jakýkoliv kód HTML je validní <!-- To znamená, že v Markdownu můžeme používat HTML elementy jako například
Markdown, to znamená, že můžeme používat HTML elementy, třeba jako komentář, a komentáře, které nebudou ovlivněny parserem Markdownu. Na druhou stranu to také
nebudou ovlivněny parserem Markdownu. Avšak, pokud vytvoříte HTML element v znamená, že pokud ve svém Markdown kódu vytvoříte HTML element, už v rámci
Markdownu, tak nemůžete používat syntaxi Markdownu uvnitř tohoto elementu. --> tohoto elementu nelze použít Markdown.
<!-- Markdown se také mírně liší v jednotlivých interpretacích parseru. Tento Markdown využívá i tato stránka, a tak by tento text, kdyby nebyl obalen v bloku
návod vás bude upozorňovat, které vlastnosti jsou obecné a které specifické pro kódu (viz níže), jako validní HTML komentář vůbec nebyl vidět. -->
konkrétní parser. --> ```
<!-- Nadpisy --> ## 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 --> 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
# Toto je <h1> # Toto je <h1>
## Toto je <h2> ## Toto je <h2>
### Toto je <h3> ### Toto je <h3>
#### Toto je <h4> #### Toto je <h4>
##### Toto je <h5> ##### Toto je <h5>
###### Toto je <h6> ###### Toto je <h6>
```
<!-- Markdown obsahuje taky dvě další cesty, jak udělat h1 a h2 --> Markdown obsahuje ještě dva další způsoby, jak vytvořit h1 a h2:
```md
Toto je h1 Toto je h1
========== ==========
Toto je h2 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;* *Tento text je kurzívou;*
_Stejně jako tento._ _Stejně jako tento._
@ -50,47 +92,62 @@ _Stejně jako tento._
__Stejně jako tento.__ __Stejně jako tento.__
***Tento text je obojí*** ***Tento text je obojí***
**_Jako tento!_** **_Tak jako tento!_**
*__A 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.
```md
Toto je odstavec. Zde jsem napsal odstavec a je to bezva!
Teď jsem v odstavci 2. Teď jsem v odstavci 2.
Jsem pořád v odstavci 2! A tady jsem pořád v odstavci 2!
Ale tady už je odstavec 3.
```
Toto je odstavec 3. 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.
<!-- 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. -->
```md
Tento odstavec končí dvěma mezerami. 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 > 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. > manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky
> Nedělá to rozdíl, dokud začínáte vždy znakem >. > jakkoli dlouhé, ať se zarovnají samy.
> Je to jedno, pokud vždy začinají symbolem `>`.
> Můžu použít více než jednu > Použít můžu i více než jednu úroveň
>> odsazení? >> odsazení.
> Jak je to úhledné, že? > Co vy na to?
```
<!-- Seznamy --> ## Seznamy
<!-- Nečíslovaný seznam můžete jednoduše udělat pomocí hvězdiček, plusů, nebo
pomlček -->
Nečíslovaný seznam můžete jednoduše udělat pomocí hvězdiček, plusů nebo pomlček:
```md
* Položka * Položka
* Položka * Položka
* Jinná položka * Jiná položka
nebo nebo
@ -103,158 +160,243 @@ nebo
- Položka - Položka
- Položka - Položka
- Další 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 1. Položka jedna
2. Položka dvě 2. Položka dvě
3. Položka tři 3. Položka tři
<!-- Nemusíte dokonce psát čísla správně a markdown je zobrazi správně, <!-- Čísla ani nemusíte psát popořadě. Markdown je umí zobrazit správně, jenom
ale nemusí to být vždy dobrý nápad --> je třeba vždy překontrolovat, že číslování funguje správně. -->
1. Položka jedna 1. Položka jedna
1. Položka dvě 1. Položka dvě
1. Položka tři 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 1. Položka jedna
2. Položka dvě 2. Položka dvě
3. Položka tři 3. Položka tři
* Podpoložka - Podpoložka
* Podpoložka - Podpoložka
4. Položka čtyři 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. ```md
- [ ] První úkol - [ ] První úkol, který je třeba dokončit
- [ ] Druhý úkol - [ ] Druhý úkol na dodělání
Tento box bude zašktrnutý Tento box bude zašktrnutý
- [x] Tento úkol byl dokončen - [x] Tento úkol byl dokončen
```
<!-- Bloky ködu --> ## 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 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 Toto je kód
Stejně jako toto 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| moje_pole.each do |i|
puts i puts i
end 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 def neco
puts "Ahoj světe!" puts "Ahoj světe!"
end 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 Text výše nepotřebuje čtyřmezerové odsazení a parser navíc použije zvýraznění
jazyka. --> syntaxe pro zvolený jazyk.
<!-- Horizontální čára (<hr />) --> ## Vodorovná čá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. -->
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 --> ## 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. --> ```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/) [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") [Klikni na mě!](http://test.com/ "Odkaz na Test.com")
<!-- Relativní cesty fungují taky -->
<!-- Relativní cesty fungují také -->
[Jdi na hudbu](/hudba/). [Jdi na hudbu](/hudba/).
<!-- Markdown taktéž podporuje reference odkazů. -->
<!-- Markdown taktéž podporuje referenční odkazy -->
[Klikni na tento odkaz][link1] pro více informací! [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!" [link1]: http://test.com/ "Cool!"
[neco]: http://neco.czz/ "Dobře!" [neco]: http://neco.czz/ "Dobře!"
<!-- Titulek může být v apostrofech nebo závorkách, nebo vyjmutý úplně. Reference <!-- Titulek v tomto případě může být v jednoduchých uvozovkách, závorkách, nebo
může být kdekoliv ve vašem dokumentu a identifikátor může být jakýkoliv, dokud zcela vynechaný. Reference může být kdekoliv ve vašem dokumentu a identifikátory
je unikátní.--> 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][] je odkaz..
[toto]: http://totojelink.cz/ [toto]: http://totojelink.cz/
<!-- Ale toto není zrovna běžné užívané. --> <!-- Ale tento způsob se obvykle nepoužívá. -->
```
<!-- Obrázky --> ### Obsahy
<!-- Obrázky se dělají stejně jako odkazy, ale s vykřičníkem na začátku -->
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
```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") ![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] ![Toto je atribut alt][mujobrazek]
[mujobrazek]: relativni/cesta/obrazek.jpg "a toto by byl titulek" [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/) [http://stranka.cz/](http://stranka.cz/)
```
<!-- Automatické odkazy pro emaily--> ### Automatické odkazy z emailů
```md
<jmeno@prijmeni.cz> <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 --> ### Klávesové zkratky
<!-- V Markdownu od GitHubu, můžete použít tag <kbd> k reprezentování klaves na počítači -->
```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 Váš počítač přestal pracovat? Zkuste
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> <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 | | Sloupec1 | Sloupec2 | Sloupec3 |
| :----------- | :------: | ------------: | | :----------- | :------: | ------------: |
| Vlevo zarovn.| Na střed | Vpravo zarovn.| | Vlevo zarovn.| Na střed | Vpravo zarovn.|
| blah | blah | blah | | blah | blah | blah |
<!-- nebo, to jde i taky: --> <!-- nebo je jde taky zapsat takto: -->
Sloupec 1 | Sloupec2 | Sloupec3 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 -->
``` ```
Pro více informací, prozkoumejte oficiální článek o syntaxi od Johna Grubera ## Markdownlint
[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 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).