Práca s Quarto
Základný syntax Markdown
Text
Medzery
Dávaj pozor na medzery.
Aj keď sa medzery vo väčšine prípadov ignorujú, niekedy dávajú markdownu signály, ako postupovať.
Ako zvyk sa snaž všetko zarovnávať naľavo, najmä keď píšeš nový odsek.
Inými slovami, nie je potrebné odsadzovať základný text v Quarto dokumente (.qmd) (v skutočnosti to môže spôsobiť, že text bude vyzerať čudne).
Kurzíva a tučné písmo
- Kurzíva sa robí ako
*Kurzíva*alebo_Kurzíva_ - Tučné písmo sa robí ako
**Tučné**alebo__Tučné__ - Tučné a kurzíva sa robí ako
***takto***,___Tučné a kurzíva___
Inline kód
Inline kódsa vytvára spätnými apostrofmi ako`Inline kód`
Dolný a horný index
Dolný2 a horný2 index sa vytvárajú ako Dolný~2~ alebo horný^2^
Prečiarknutie
Prečiarknutý textsa robí~~Prečiarknutý text~~
Špeciálne znaky
- Niektoré znaky majú v Markdowne osobitný význam (napr. formátujú text). Preto, ak chceš vložiť tieto znaky ako súčasť textu (ide o *, _ alebo \), pridaj pred ne opačné lomítko \ nasledovne:
\*,\_,\\
Endash (–), emdash (—)
- -- a --- sa robí pomocou \- \-\- a \-\-\-
Citáty
Robí sa to takto:
Na začiatok riadku vlož > a citát bude vyzerať takto,
teda Tvoj kód vyzerá:
> Na začiatok riadku ...
Nadpisy
Nadpisy sekcií sa vytvárajú pomocou # v narastúcom počte, napríklad:
- # Nadpis prvej úrovne, čo je kód
# Nadpis prvej úrovne - ## Nadpis druhej úrovne, čo je kód
## Nadpis druhej úrovne - ### A tak ďalej
Zoznamy
Nečíslovaný zoznam vytvoríš, keď riadok začneš * alebo -:
- Položka 1
- Položka 2
Číslovaný zoznam sa robí začatím riadku číslom.
Všimni si, že čísla môžeš „popliesť“ a Markdown aj tak správne zoradí poradie vo výstupe:
- Položka 1
- Položka 2
Podzoznam vytvoríš odsadením hodnôt (minimálne štyri medzery alebo tabulátor):
- Položka 1
- Položka 2
- Položka 3
- Položka 3a
- Položka 3b
Zalamovanie riadkov
Oficiálny spôsob Markdown na zalomenie riadku je ukončenie riadku viac ako dvomi medzerami.
Roses are red.
Violets are blue.
Toto sa zobrazí na rovnakom riadku vo výstupe, pretože sme nepridali medzery po „red“.
Roses are red.
Violets are blue.
Toto sa zobrazí so zalomením riadku, pretože som pridal medzery po „red“.
Existuje alternatíva ukončenia riadku spätným lomítkom, čo tiež vytvorí zalomenie:
Roses are red.
Violets are blue.
s kódom:
Roses are red.\
Violets are blue.
Ak chceš vytvoriť nový odsek, vlož prázdny riadok.
Tento riadok začína vlastný odsek.
Hyperlinky
- Toto je hypertextový odkaz vytvorený tak, že text, ktorý chceš zmeniť na klikateľný odkaz, napíšeš do
[hranatých zátvoriek]a hneď za ne dáš(odkaz-v-zátvorkách). Kód:[Toto je hypertextový odkaz](https://www.google.com)
Poznámka na konci dokumentu
toto je 1 dosiahneme textom toto je ^[moja poznámka]
Komentáre
Ak chceš písať komentáre v texte, ktoré nebudú vo výstupe, použi rovnakú syntax ako v HTML. Teda: <!– toto nebude vo výstupe –>.
<!-- Komentáre sú veľmi užitočné! --> ale slúžia len na dokumentovanie autorom textu. Bežný čitateľ ich nevidí.
Matematika
Syntax na písanie matematiky je prevzatý z LaTeXu. Ak chceš napísať výraz, ktorý sa zobrazí v texte, uzavri ho do znakov dolára. - Toto: $A = \pi*r^{2}$ sa stane: \(A = \pi*r^{2}\)
Ak chceš napísať výraz, ktorý sa zobrazí ako blok, uzavri ho do dvoch znakov dolára.
Napr. $$A = \pi*r^{2}$$ nvygeneruje vzorec v osobitnom riadku \[A = \pi*r^{2}\]
Quarto podporuje aj číslovanie rovníc a krížové odkazy. V tomto úvodnom cvičení sa však obmedzíme na nečíslované rovnice.
Tabuľky
V Quarto existuje jednoduchý spôsob rýchleho písania tabuliek, kde stĺpce sa nenerujú na základe znaku | a riadky hlavičky na základe pomlčky -
Tak napríklad:
| Kraj | Mesto | Teplota |
|---|---|---|
| TT | Trnava | 10 |
| PO | Poprad | -2 |
| NI | Komárno | 0 |
je tvorený kódom
| Kraj | Mesto | Teplota |
|------|:-------:|--------:|
| TT | Trnava | 10 |
| PO | Poprad | -2 |
| NI | Komárno | 0 |
V tabuľke sme si pomocou dvojbodiek : vynútili zarovnávanie obsahu stĺpcov v smere umiestnenia dvojbody (doprava alebo doľava) alebo v prípade stĺpca Mesto sme si vynútili centrovanie obsahu.
Vkladanie obrázkov
Kód: !\[My caption](path/to/image.png)
Hypertextové odkazy
Ak chceme do textu umiestniť hypertextovú referenciu, urobíme to napr. nasledovne:
Kód: [RPubs Example](http://rpubs.com/jasonL/LandL)
sa javí ako RPubs Example
alebo odkaz na Google scholar: Google scholar
Citácie a práca s literatúrou
Existuje elegantný spôsob, ako do dokumentu zahrnúť odbornú literatúru: zdroje uložíme do súboru BibTeX a v texte použijeme ich citačné kľúče. Ukážeme si to na dvoch prácach W. Briana Arthura z priloženého súboru literatura.bib.
Nastavenie bibliografie
Súbor literatura.bib uložíme do podpriečinka literatura vedľa dokumentu .qmd. Do YAML hlavičky pridáme:
bibliography: literatura/literatura.bib
link-citations: trueCitácia ako súčasť vety
Arthur (2021) vysvetľuje základy komplexnej ekonómie.
Zápis v zdrojovom dokumente:
@arthur2021foundations vysvetľuje základy komplexnej ekonómie.Citácia v zátvorke
Širší pohľad na túto problematiku poskytuje práca Complexity economics (Arthur 2013).
Zápis v zdrojovom dokumente:
Širší pohľad na túto problematiku poskytuje práca *Complexity economics*
[@arthur2013complexity].Viac zdrojov v jednej citácii
Komplexná ekonómia skúma ekonomiku ako vyvíjajúci sa systém vzájomne pôsobiacich aktérov (Arthur 2021, 2013).
Zápis viacerých zdrojov oddeľuje citačné kľúče bodkočiarkou:
[@arthur2021foundations; @arthur2013complexity]Zoznam citovaných zdrojov sa pri vytvorení výstupu doplní automaticky. Blok ::: {#refs} označuje miesto, kam sa vloží bibliografia; druhý riadok ::: tento blok uzatvára. Ziivotne poistenie Gerber (2013)
Literatúra
Poznámky pod čiarou
moja poznámka↩︎