Syntaxe
*******

--> "Podrobný popis syntaxe":syntax-podrobne


Nástroj Texy vznikl proto, aby nezkušeným uživatelům umožnil snadno editovat obsah webových stránek. Proto je i syntaxe maximálně intuitivní. Záměrem je, aby text v čisté (nezformátované) formě byl přehledný a jeho formát tušitelný.

Dnes Texy výborně slouží i zkušeným znalcům jazyka HTML. Dovoluje volně kombinovat Texy zápis s HTML značkami. Zkušení uživatelé se tedy nemusí učit nový meta-jazyk a plně využít svých znalostí. Texy jim pouze zjednodušuje práci.

Prvotní logikou syntaxe je **žádnou syntaxi nepoužívat**. Jen psát čistý text. Vkládání rozšířených informací, jako třeba CSS třídy nebo odkazy, nenaruší tok textu. A zapíší se způsobem, který snadno pochopí i netechnicky založení uživatelé.


Odstavce textu .[#paragraph]
============================

Za odstavec se považuje jeden nebo více bezprostředně za sebou následujících řádků textu. Odstavečky jsou od sebe oddělené prázdným řádkem.

/--code texy
První odstavec lorem ipsum dolor sit amet.

Druhý odstavec, který tvoří jeden řádek.
A druhý řádek textu. Texy je spojí.
\--

Zalomení řádku v odstavci docílíte vložením jedné mezery vlevo:

/--code texy
Kdoví jestli
 jestli jsou na měsíci vůbec nějaký stopy
 a proč kope kolem sebe kdo se topí
 jakej sval to Zemí otáčí
\--


Titulky .[#heading]
===================

Titulky je možné zapsat hned dvěma způsoby: **podtržením** nebo **předsazením**.

Každý titulek má svůj stupeň. V případě **podtržení** o důležitosti titulku rozhoduje podtrhávací znak. Od nejvyšší po nejnižší jsou to tyto: `#` `*` `=` `-`

/--code texy
Hlavní titulek
**************


Podtitulek
==========
\--

U titulků zapsaných **předsazením** určuje úroveň počet předsazených znaků. A ty mohou být `#` nebo `=`

Platí: čím více znaků, tím důležitější titulek (minimum jsou dva znaky, maximum sedm).

/--code texy
=== Hlavní titulek ===

## Podtitulek
\--

Jak vidíte v případě podtitulku, znaky vpravo je možné vynechat.


Horizontální čáry .[#horizline]
===============================

Texy zná tyto způsoby zápisu:


/--code texy
------------

********
\--


Vypnutí Texy .[#disable-texy]
=============================

Klíčové slovo `html` nebo `text` ovlivňuje, jestli obsah bude chápán jako HTML (včetně značek), nebo prostý text.

/--code texy
  /---html
    <em>příklad</em>: **this is not strong**
  \---


  /---text
    <em>příklad</em>: **this is not strong**
  \---
\--

Pro inline vypnutí Texy je možné použít dvojitý apostrof `''` a obalit s ním část textu, který nemá být Texy zpracováván.

/--code texy
   Příklad: ''**this is not strong**''
\--


Citace .[#blockquote]
=====================

Citace jsou odsazené, podobně jako v emailech, znakem `>`

/--code texy
> This is a blockquote with two paragraphs.
>
> 640 K should be enough for everyone
\--


Odkazy .[#link]
===============

Odkazy se zapisují tak, že odkazující text uzavřete do uvozovek a následujete dvojtečkou a URL. Texy se snaží inteligentně odhadnout konec URL. Můžete mu i pomoci tím, že URI uzavřete do hranatých závorek. Část `http://` není povinná.

Jako odkaz je možné vkládat i emaily, Texy je transformuje do podoby, která by měla zmást spamboty.

/--code texy
Look at homepage:[https://texy.info].

Do you know "La Trine":https://www.latrine.cz?

"Write me":me@example.com

\--


Obrázky .[#image]
=================

Zapisují se mezi hranaté závorky s hvězdičkou:

/--code texy
[* image.gif .(alternativní text) *]
\--


V textových odstavcích je často třeba zvolit, má-li být obrázek zarovnán k levému nebo pravému kraji. Toho docílíte pomocí znaku `<` a `>` použitého před pravou závorkou:

/--code texy
[* image.gif <] Left-aligned image. Lorem ipsum ...

[* image.gif >] Right-aligned image. Curabitur quam ...
\--


Obrázek s popiskou
------------------

Za obrázkem uveďte tři hvězdičky a následuje popiska:


/--code texy
[* image.gif *] *** Toto je *popiska* pod obrázkem
\--


Fráze .[#phrase]
================

Asi nejpoužívanější syntax v Texy. Téměř ve všech případech se používá zdvojený znak.

/--code texy
//kurzíva//

**tučné**

x^2 + y^3
\--


/--div .[output]
//kurzíva//

**tučné**

x^2 + y^3
\--


Texy lze i dočasně vypnout - obsah nebude formátován a zobrazí se doslovně:

/--code texy
Odstraňte ''<br />'' a entitu ''&ndash''
\--


Přímé HTML .[#html]
===================

Texy není náhrada za HTML. Nehledá ani alternativní způsoby zápisu HTML. Cílem je zjednodušit psaní obsahu. Pokud se Vám zdá jednodušší zapsat některou strukturu přímo v HTML, můžete tak učinit. HTML značky jsou plně podporované.

/--code texy
This <strong class=info>is strong</strong> text.
<br> This is not.
\--


Seznamy .[#list]
================

Odrážkové seznamy zapisujeme pomocí `*` `+` nebo `-`. Musí být zapsán hned na začátku řádku a za ním musí následovat mezera.

/--code texy
-   Red
-   Green
-   Blue
\--


Číslované seznamy
-----------------

Texy zná těchto pět způsobů zápisu (první dva jsou ekvivalentní):

/--code texy
1)  Učit se
2)  Učit se
3)  Učit se

a)  Dlouhý
b)  Široký
c)  Krátkozraký

A)  DOS
B)  Windows
C)  Linux

I)  Yesterday
II)  Today
III)  Tomorrow
\--


Vnořené seznamy
---------------

/--code texy
a)  Bird
  I)  Bird
    -   Red
    -   Green
    -   Blue
  II)  McHale
  III)  Parish
b)  McHale
c)  Parish
      1)  Bird
      2)  McHale
      3)  Parish
\--


Definiční seznam
----------------

Koncert "Divokej Bill":www.divokybill.cz:
    - termín: 9. 12. 2004
    - místo: Hala Vodová, Brno
    - Cena: 260 Kč

/--code texy
Koncert Divokej Bill:
    - termín: 9. 12. 2004
    - místo: Hala Vodová, Brno
    - Cena: 260 Kč
\--


Modifikátory .[#modifier]
=========================

Nejsilnější zbraň Texy. Lze použít tyto druhy modifikátorů:

- (titulek) popisné, přidají objektu titulek (nebo alternativní text obrázkům)
- `[class1 class2 #id]` určující třídu a / nebo ID prvku
- {class:blue} přímý zápis stylu
- {target:_blank} nebo přímý zápis HTML atributů
- horizontální zarovnání:
  - doleva <
  - doprava >
  - vycentrovaný <>
  - do bloku =

- vertikální zarovnání: (jen u tabulek)
  - nahoru ^
  - na střed -
  - dolů _

Modifikátory se zapisují spojitě (bez mezer) a **musí jim předcházet tečka**. Takže třeba `.(popis)[left]` nastavuje atribut title na `popis` a třídu na `left`.

**Modifikátory je vždy zapisují zcela doprava**.

Příklad použití modifikátoru na odstavci textu:

/--code texy
Vycentrováno modifikátorem  .<>

Obarveno modifikátorem .{color:blue; lang: cs}
\--

/--code html
<p style="text-align:center">Vycentrováno modifikátorem</p>

<p style="color:blue" lang="cs">Obarveno modifikátorem</p>
\--


Typografie .[#typography]
=========================

Sem patří všechny úpravy a náhrady textu, které upravují jeho vzhled v souladu s typografickými pravidly a podobně:

/--code texy
- "české" 'typografické' uvozovky
- pomlčka vs. spojovník: 10-15 vs. česko-slovenský
- pomlčka: jedna -- dvě
- typografický křížek u rozměrů 10 x 20
- šipky <- a -> a <-> ;
- tři tečky...
- zachování HTML entit &amp;
- náhrady(TM) nebo(R) za příslušné entity(C)
\--

/--div .[output]
- "české" 'typografické' uvozovky
- pomlčka vs. spojovník: 10-15 vs. česko-slovenský
- pomlčka: jedna -- dvě
- typografický křížek u rozměrů 10 x 20
- šipky <- a -> a <-> ;
- tři tečky...
- zachování HTML entit &amp;
- náhrady(TM) nebo(R) za příslušné (C)entity
\--

práce s mezerami:

/--code texy
- vkládání nezalomitelných mezer za jednopísmenné předložky (v autě u okna)
- nedělitelné mezery u telefonních čísel +420 776 552 046
\--

/--code html
vkládání nezalomitelných mezer za jednopísmenné předložky (v&nbsp;autě u&nbsp;okna)

nedělitelné mezery u&nbsp;telefonních čísel +420&nbsp;776&nbsp;552&nbsp;046
\--

*Poznámka: Nahrazování se obvykle řídí dalšími pravidly, které určují, kdy
symbol nahradit a kdy ne. Například šipka `->` nemůže být na konci řádku atd. Proto nebuďte překvapeni, když v některých případech Texy náhradu neprovede.*


Zkratky, akronymy .[#acronym]
-----------------------------

Používá se zápisu s dvojitou kulatou závorkou:

/--code texy
jednoslovné: NATO((North Atlantic Treaty Organisation))

víceslovné: "et al."((a další))
\--


Klikatelné webové adresy
------------------------

Automatický převod webových adres a emailů do klikatelné formy

/--code texy
další informace na www.texy.info a také ...
\--

/--div .[output]
další informace na www.texy.info a také ...
\--


Rozdělení velmi dlouhých slov .[#longwords]
===========================================

Velmi zajímavá a důležitá funkce Texy. Dlouhá slova mohou narušit vzhled stránky, proto je vhodné prohlížeči naznačit, kde je může zalomit. Texy tyto místa hledá s přihlédnutím k národním zvyklostem, tedy slovo rozděluje podle slabik:

/--code texy
nejneobhospodařovávatelnějšími
\--

/--code html
nejneobhospoda&shy;řovávatelnější&shy;mi</p
\--

*Poznámka: limit délky slova je volitelný*


Tabulky .[#table]
=================

Příklad jednoduché tabulky, sloupce se oddělují znakem `|`

/--code texy
| first col | second col | third col
| Adam      | Eva        | Franta
\--

A výsledek je:

| first col | second col | third col
| Adam      | Eva        | Franta


Hlavičku tabulky můžeme definovat tímto zápisem:

/--code texy
|-----------------------------
| First Name | Last Name | Age
|----------------------------
| Jesus      | Christ    | 33
| Cecilie    | Svobodova | 74
\--

|-----------------------------
| First Name | Last Name | Age
|----------------------------
| Jesus      | Christ    | 33
| Cecilie    | Svobodova | 74


Sloučení sloupců
----------------

všimněte si zdvojeného ||

/--code texy
| Name                  || Age
|----------------------------
| Jesus      | Christ    | 33
\--

| Name                  || Age
|----------------------------
| Jesus      | Christ    | 33


Sloučení řádků
--------------

Všimněte si znaku `^` symbolizujícího směr nahoru:


/--code texy
| First Name | Last Name | Age
|----------------------------
| Bill                  || 50
|                       ^| 52
| Jim        | Beam      | 70
\--

| First Name | Last Name | Age
|----------------------------
| Bill                  || 50
|                       ^| 52
| Jim        | Beam      | 70