Dokumentácia

Úvod

Vitajte v ghostwriter! Táto stručná referenčná príručka poskytuje príklady písania v Markdown, formáte na značkovanie čistého textu, ktorý vytvoril John Gruber. Ďalšie informácie nájdete na webovej stránke Johna Grubera na http://www.daringfireball.net.

ghostwriter má vstavanú podporu pre procesor cmark-gfm. Dokáže však tiež automaticky detegovať procesory Pandoc, MultiMarkdown alebo cmark. Jednoducho nainštalujte ktorýkoľvek z týchto procesorov a uistite sa, že ich umiestnenia inštalácie sú pridané do premennej prostredia PATH vášho systému. ghostwriter automaticky deteguje ich inštaláciu pri spustení a podľa toho vám poskytne živý náhľad HTML a možnosti exportu.

Nadpisy

# Level 1 Heading
## Level 2 Heading ##
###### Level 6 Heading

Level 1 Heading
===============
some text

Level 2 Heading
---------------
some more text

Odseky

This is a paragraph.
This is another line in the same paragraph using a manual line break.

This is a new paragraph.

Riadkové formátovanie

Kurzívu alebo dokonca tučné písmo môžete vytvoriť dvoma spôsobmi. Prvým je obklopenie textu hviezdičkami (*), druhým podčiarkovníkmi (_).

This is *italics* with asterisks.
This is _italics_ with underscores.

This is **bold** with asterisks.
This is __bold__ with underscores.

Môžete tiež vytvoriť tučnú kurzívu ich kombinovaním, napríklad takto:

This is ***bold italics*** with asterisks.
This is **_bold italics_** mixing.
This is another *__bold italics__*.
etc.

Odkazy

Môžete odkazovať na rôzne webové stránky:

Click [here](http://url.com "Title") to visit a website.

Môžete tiež použiť referenčné odkazy:

[This][id] is a reference link which is defined below.

[id]: http://url.com "Title"

Obrázky

Obrázky môžete vložiť nasledovne:

![alternate text](./image.jpg "Title")

Môžete tiež použiť rovnakú syntax ako pri referenčných odkazoch:

![alternate text][id] for a reference defined below.

[id]: ./image.jpg "Title"

Zoznamy

Môžete použiť zoradené zoznamy:

1. Item one.
2. Item two.
3. Item three.

Alebo môžete použiť nezoradené zoznamy:

* Item one.
+ Item two.
- Item three.

Môžete ich kombinovať s vnorenými zoznamami:

1. Item one.
    * Subitem one.
    * Subitem two.
2. Item two.
    - Subitem one.
    - Subitem two.
3. Item three.
    1. Subitem three.

Bloky kódu

Môžete odsadiť štyrmi alebo viacerými medzerami alebo tabulátorom na vytvorenie bloku kódu:

This is a normal paragraph, followed by a code block.
    
    for (int i = 0; i < 10; i++) {
        System.out.println("i = " + i);
    }
    
The above will be displayed as a preformatted block of code.

V niektorých konvertoroch Markdown, ako sú Pandoc alebo GitHub, môžete použiť spätné apostrofy GitHub-Flavored Markdown na ohraničenie blokov kódu namiesto odsadenia bloku, napríklad takto:

```
for (int i = 0; i < 10; i++) {
    System.out.println("i = " + i);
}
```

Vyššie uvedené bude rovnako zobrazené ako predformátovaný blok kódu.

Riadkový kód

Môžete použiť spätné apostrofy uprostred odseku na ohraničenie kódu, ako pri tejto značke `<html>`. Doslovné spätné apostrofy môžete použiť pomocou viac ako jedného spätného apostrofu, ako v tomto príklade: `` `escaped backtick` ``.

Blokové citácie

Môžete použiť lomené zátvorky v štýle e-mailu na ohraničenie blokových citácií nasledovne:

> This is a block quote.
>
>> This is a nested block quote.

Vodorovné čiary

Použite tri alebo viac pomlčiek (-), podčiarkovníkov (_) alebo hviezdičiek (*) na vytvorenie vodorovných čiar, napríklad takto:

---

***
___

Medzi jednotlivými znakmi môžete mať dokonca medzery:

- - -

Rozšírenia Markdown

Niektoré procesory Markdown pridávajú syntax pre tabuľky, poznámky pod čiarou a podobne na rozšírenie pôvodnej špecifikácie Markdown od Johna Grubera. Nižšie je príklad použitia poznámky pod čiarou pre Pandoc, MultiMarkdown a ďalšie procesory, ktoré podporujú toto rozšírenie:

Here is the body text that has a footnote.[^footnoteid]

[^footnoteid]:  Here is the footnote text.

Nižšie je ukážka tabuľky Pandoc:

Column One     Column Two
----------     ----------
Row Text 1     Row Text 2
Row Text 1     Row Text 2

Table:  Pandoc sample table.

Nižšie je ukážka tabuľky cmark-gfm alebo MultiMarkdown:

Column One | Column Two
---------- | ----------
Row Text 1 | Row Text 2
Row Text 1 | Row Text 2

Existuje ešte viac syntaxí tabuliek, ktoré tieto procesory Markdown podporujú. Existuje tiež mnoho ďalších rozšírení. Ďalšie informácie o týchto procesoroch nájdete na nasledujúcich webových stránkach:

Pôvodnú špecifikáciu Markdown od Johna Grubera nájdete na http://daringfireball.net/projects/markdown/.

Skratky

ghostwriter podporuje nasledujúce skratky na úpravu Markdown:

Ctrl+B
Použije tučné (silné) formátovanie.
Ctrl+I
Použije kurzívu (zvýraznenie).
Ctrl+K
Použije formátovanie prečiarknutím.
Ctrl+/
Vloží HTML komentár na pozíciu kurzora, ak nie je vybraný žiadny text, alebo zmení vybraný text na HTML komentár.
Tab
Odsadí vybrané riadky textu.
Shift+Tab
Zruší odsadenie vybraných riadkov textu.
Shift+Enter
Vloží zalomenie riadku v štýle Markdown.
Ctrl+Enter
Vloží zalomenie riadku ako zvyčajne, ale aktuálne odsadenie nebude zachované. Inými slovami, ak píšete na odsadenom riadku a stlačíte Ctrl+Enter, na nový riadok nebude pridané žiadne odsadenie. Všimnite si, že modifikátor Ctrl je možné kombinovať s modifikátorom Shift na vytvorenie neodsadeného riadku aj zalomenia riadku v štýle Markdown.
Ctrl+.
Zmení aktuálny riadok alebo vybrané riadky na blokovú citáciu.
Ctrl+,
Odstráni akékoľvek formátovanie blokovej citácie z aktuálneho riadku alebo vybraných riadkov textu.
Ctrl+8
Zmení aktuálny riadok alebo vybrané riadky na odrážkový zoznam so značkou *. Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  List item one.
  List item two.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na odrážkový zoznam nasledovne:

  * List item one.
  * List item two.
Ctrl+Shift+-
Zmení aktuálny riadok alebo vybrané riadky na odrážkový zoznam so značkou -. Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  List item one.
  List item two.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na odrážkový zoznam nasledovne:

  - List item one.
  - List item two.
Ctrl+Shift+=
Stlačením Ctrl a Shift so znakom = sa aktuálny riadok alebo vybrané riadky zmenia na odrážkový zoznam so značkou +. Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  List item one.
  List item two.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na odrážkový zoznam nasledovne:

  + List item one.
  + List item two.
Ctrl+1
Zmení aktuálny riadok alebo vybrané riadky na číslovaný zoznam so značkou .. Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  List item one.
  List item two.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na číslovaný zoznam nasledovne:

  1. List item one.
  2. List item two.
Ctrl+0
Zmení aktuálny riadok alebo vybrané riadky na číslovaný zoznam so značkou ). Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  List item one.
  List item two.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na číslovaný zoznam nasledovne:

  1) List item one.
  2) List item two.
Ctrl+T
Zmení aktuálny riadok alebo vybrané riadky na položku zoznamu úloh GitHub-Flavored Markdown. Napríklad, ak ste vybrali text v nasledujúcich riadkoch:
  Important thing to do.
  Another important thing to do.

Stlačením tejto klávesovej skratky sa vybrané riadky zmenia na zoznam úloh nasledovne:

  - [ ] Important thing to do.
  - [ ] Another important thing to do.
Ctrl+D
Keď je aktuálny riadok textu položkou zoznamu úloh GitHub-Flavored Markdown, stlačením tejto klávesovej skratky prepnete stav dokončenia úlohy, pričom sa do zaškrtávacieho políčka vloží x, ak je úloha dokončená, alebo sa x odstráni, ak je nedokončená. Napríklad:
  - [ ] This is an incomplete task.
  - [x] This task as done!
Párované znaky
Keď je vybraný text v rámci jedného riadku, stlačením ktoréhokoľvek z vyššie uvedených znakov sa vybraný text obalí týmto znakom a jeho zodpovedajúcim uzatváracím znakom. Napríklad, ak vyberiete slovo dog a potom zadáte znak (, slovo dog sa uzavrie do zátvoriek a stane sa (dog). Nižšie je tabuľka zobrazujúca zadaný znak a zodpovedajúci uzatvárací znak:

Otvára saZatváranie
""
''
()
[]
{}
**
__
``
<>

Ak chcete povoliť automatické párovanie znakov počas písania, zaškrtnite "Automaticky párovať znaky počas písania" na karte Editor v dialógovom okne Nastavenia, ktoré je dostupné z panela ponuky pod voľbou `Settings->Preferences...`. Môžete tiež prispôsobiť, ktoré znaky sa párujú, výberom tlačidla "Prispôsobiť párované znaky...".
Presúvanie súborov obrázkov
Alternatívou k výberu možnosti Edit->Insert Image... z panela ponuky je presunúť ľubovoľný súbor obrázku z vášho súborového systému do okna editora. Aplikácia vloží riadkový text obrázku s cestou k súboru obrázku relatívnou k umiestneniu aktuálne otvoreného dokumentu, alebo plnú cestu, ak je dokument bez názvu. Napríklad:

  ![](../../relative/path/to/your/file.png)

alebo ak je dokument bez názvu:

  ![](file:///full/path/to/your/file.png)