Referenční informace

Studijní publikace » Referenční informace

Syntaxe jazyka CML

Blokové značky

Význam značky	Začátek	Konec	Poznámka/příklad
Komentář	`<!--`	`-->`
Hlavička největší	`<H1>`	`</H1>`
Hlavička	`<b>`	`</b>`
Hlavička	`<b>`	`</b>`
Hlavička	`<H4>`	`</H4>`
Hlavička	`<H5>`	`</H5>`
Hlavička	`<H6>`	`</H6>`
Hlavička	`<H7>`	`</H7>`
Hlavička	`<H8>`	`</H8>`
Hlavička nejmenší	`<H9>`	`</H9>`
Hlavička téma	`<TEMA>`	`</TEMA>`	téma v požadavcích ke zkouškám apod.
standardní odstavec (plain)	`<P>`	`</P>`
záhlaví na levé straně	`<LHEAD>`	`</LHEAD>`
záhlaví na pravé straně	`<RHEAD>`	`</RHEAD>`
poznámka pod tabulkou	`<FTN>`	`</FTN>`	případný text pro uvození je třeba realizovat ručně, např.<^>*</^> a pod. pozor! <FTN></FTN> je bloková značka, tzn. nesmí v sobě obsahovat jinou blokovou značku (ani odstavec).

Zvláštní blokové značky

Význam značky	Syntaxe	Poznámka/příklad
titulek oboru
titulek studijniho plánu v daném oboru		ve výstupu se používá pouze první argument

Strukturní značky (seznamy a tabulky)

Seznamy

Význam značky	Začátek	Konec	Poznámka/příklad
označení studijního oboru	`<LI OBOR "Název" "c. odstavce v akt. stud. planu">`		příklad pro Mat Mgr.: `<LI OBOR "Matematické struktury" "4.1">` slouží k vysázení seznamu oborů vč. odkazu na začátku studijního plánu pro M, F, I a U
seznam bez pořadí	`<L TYPE="">`	`</L>`
seznam bez pořadí	`<L TYPE="-">`	`</L>`
seznam bez pořadí	`<L TYPE="o">`	`</L>`
seznam bez pořadí s vl. odrážkou	`<L TYPE="?">`	`</L>`
položka seznamu	`<LI>`
položka seznamu	`<LI "hlava">`		uvnitř `<L ..></L>` např. `<LI "a)">text ...`
položka seznamu (tučné záhlaví)	`<LIB "hlava">`		uvnitř `<L ..></L>` např. `<LIB "A.">text ...`

Skupiny

Význam značky	Začátek	Konec	Poznámka/příklad
řádek tab. bez učitele, s kreditem a dop. semestrem	`<SKUPINA "Kod skupiny" "nazev" "Typ">`		před kontrolou předmětů se rozbalí na tabulku předmětů, položka TYP určuje výslednou tabulku. Typ `LU` a `LUO` vyrobí tabulku s učiteli, typ `LUS` tabulku s doporučeným semestrem, typ `LNC` standardní tabulku bez sloupce pro kredity. Ostatní typy vygenerují standardní tabulku (`S`) s typem řádky stejným, jako je zadaný typ (tj. např. LN, LNR atd.).

Komise

Význam značky	Začátek	Konec	Poznámka/příklad
komise z Parametrů	`<KOMISE "skupina" "komise-id" "nazev">`	`</KOMISE>`	Značka pro komisi z programu Parametry. Povinné jsou pouze položky `skupina` a `komise-id`. Položka `nazev` bude automaticky doplněna, ovšem ve výstupní sazbě není nikde použita.Komise reaguje na jazyk části, ve které se vykytuje. V anglické části publikace budou použity anglické varianty názvu komise a funkcí členů komisí.Komise se zadávají a upravují v programu Parametry. Jsou typicky členěny do skupin podle použití (RDSO, obhajoby PhD., Mgr. komise apod), v rámci skupiny jsou pak komise identifikovány svým kódem. Rozdělení do skupin, jejich označení a označení jednotlivých komisí není nijak omezeno, záleží jen na potřebách ostatních uživatelů komisí (typicky Studijní oddělení).Příklady (kódy skupin a komisí nemusí odpovídat konkrétnímu obsahu pro Vaši fakultu): `<komise "odp" "nk02" ""></komise> <komise "rdso" "nOR4-f2" ""></komise>`
komise doplněná o členy odjinud	`<KOMISE "skupina""komise-id" +"skupina:regularni vyraz" "nazev">`	`</KOMISE>`	Členové komise budou při překladu rozšířeni o členy jiné komise/komisí. Ve výstupu se objeví členové hlavní komise včetně svých funkcí a s nimi všichni členové z komisí určených výrazem `+"skupina:regularni vyraz"` bez funkcí, jaké zastávají ve svých vlastních komisích. Nově zobrazení členové jsou zpracováni tak, aby byl každý vytisknut nejvýše jednou.Výraz určující zdrojovou komisi obsahuje `skupinu`, ze které jsou komise vybrány `regulárním výrazem`. Ten může v nejjednodušší formě obsahovat pouze identifikátor jedné konkrétní komise, ze které se členové vezmou. V sofistikovanějších variantách lze takto konstruovat komise nadřazené oborovým komisím atd. Příklad: `<komise "or" "nOR4-f" +"rdso:^nor4-f" ""> </komise>` vytiskne komisi `NOR4-F` (fyzika) ze skupiny `OR` (oborové rady), doplněnou o obsah všech fyzikálních (výraz vybere komise začínající prefixem společným pro fyzikální komise) RDSO komisí (skupina `rdso`). Označení komisí a jejich skupin je plně v moci dané fakulty a může se lišit od tohoto příkladu. Pozn.: I rozšířenou komisi lze zmrazit pomocí `!`, viz následující položka.
zmrazená komise	`<!KOMISE "skupina""komise-id" "nazev">`	`</KOMISE>`	Zmrazená komise. Vykřičník zajistí, že při překladu nebude komiseaktualizována. Vhodné především pro dokončovací práce těsně před tiskem.
řádek komise	`<KL "funkce" "osoba" "pracoviště">`		řádek se členem/kou komise; není třeba vkládat, obsah komise je, s výjimkouzmrazených komisí, doplňován automaticky, tj. případné úpravy budou po dalším překladu ztraceny!

Tabulky povinností (předmětů)

Význam značky	Začátek	Konec	Poznámka/příklad
tabulka std.	`<TBL TYPE="S">`	`</TBL>`
tabulka std. bez kreditů	`<TBL TYPE="SC">`	`</TBL>`
tabulka s okruhem	`<TBL TYPE="C">`	`</TBL>`
tabulka s učiteli	`<TBL TYPE="U">`	`</TBL>`	navíc jsou v tabulce spojené rozsahy předmětu dohromady a extra sloupec pro kredit
tabulka s učiteli	`<TBL TYPE="US">`	`</TBL>`	... jako tabulka s učitelem, ale bez učitele a se sloupečkem na dop. semestr
řádek std. tabulky	`<LN "Name" "Comment" "ZS" "LS" "KOD" e="ebody">`		doporučený předmět, další možnosti viz. níže
řádek std. tabulky bez zobrazených kreditů	`<LNC "Name" "Comment" "ZS" "LS" "KOD" e="ebody">`		doporučený předmět, další možnosti viz. níže
řádek tab. s okruhem	`<LN "Name" "Comment" "OKRUH" "ZS" "LS" "KOD" e="ebody">`		doporučený předmět, další možnosti viz. níže
řádek tab. s učitelem	`<LU "Name" "Comment" "ucitel" "kredit" "rozsah" "semestr" "Kod">`		doporučený předmět, další možnosti viz. níže
řádek volitelného předm. (tab. s učitelem)	`<LUO "Name" "Comment" "ucitel" "kredit" "rozsah" "semestr" "Kod">`		volitelný předmět
řádek tab. bez učitele, s kreditem a dop. semestrem	`<LU "Name" "Comment" "kredit" "rozsah" "dop. semestr" "Kod">`		doporučený předmět
řádek tabulky volitelného předmětu	`<LNO "Name" "Comment" "ZS" "LS" "KOD" e="ebody">`		obdobně existuje i pro tabulku s okruhem, s okruhem a dop. rokem studia a tabulku bez zobrazených kreditů (`<LNOC...>`)
řádek tabulky povinného předmětu	`<LNR "Name" "Comment" "ZS" "LS" "KOD" e="ebody">`		obdobně existuje i pro tabulku s okruhem, s okruhem a dop. rokem studia a tabulku bez zobrazených kreditů (`<LNRC...>`)
textový řádek vložený do tabulky	`<LN "Text">` `<LNR "Text">` `<LNO "Text">` `<LU "Text">` `<LUO "Text">` `<LNH "Text">`		vložení textového předělu do tabulky předmětů, všechny varianty jsou ekvivalentní, `LUO` resp. `LNO` sází text skloněně, `LNR` sází text tučně a `LNH` tučně skolněně (slanted, vhodné pro výrazné předěly v kombinaci se značkou `LHR`)
horizontální linka vložená do tabuly předmětů	`<LHR>`		vloží do tabulky předmětů horizontální linku, vhodné především v kombinaci s `LNH`
tabulka textová	`<TBL TYPE="1-9">`	`</TBL>`	obecná tabulka s daným počtem sloupců, využívat jen v krajním případě
řádek txt. tab.	`<LL "text" "text" ... "text">`

Genericé tabulky povinností

Kromě předdefinovaných tabulek předmětů jsou k dispozici pro speciální účely tabulky generické. Ty jsou určeny hlavně pro atypické potřeby. K dispozic je 10 různých typů generických tabulek číslovaných 0 až 9. U řádků generických tabulek se zkoumá jen kód předmětu a jeho název, ostatní pole se automaticky nijak nezpracovávají. Podobně jako standardních tabulek jsou i u generických tabulek k dispozici řádky tučné, skloněné a normální. Aktuální tvar tabulky a počet dalších sloupců je plně pod kontrolou fakulty pomocí úprav příslušných šablon. Vzhled tabulky (záhlaví, šířky sloupců atp.) je definován v tex.cml, zpracování jednotlivých řádek i samotných tabulek do výstupního tvaru je definováno v cml2tex.tab a v cml2htm.tab.

Význam značky	Začátek	Konec	Poznámka/příklad
generická tabulka, n∈0..9	`<TBL TYPE="Gn">`	`</TBL>`
řádek generické tab.	`<LGn "kod" "nazev" "sloupec1" "sloupec2" ...>`		doporučený předmět, n∈0..9 ve shodě se značkou pro začátek tabulky
řádek generické tab.	`<LGnR "kod" "nazev" "sloupec1" "sloupec2" ...>`		povinný předmět, n∈0..9 ve shodě se značkou pro začátek tabulky
řádek generické tab.	`<LGnO "kod" "nazev" "sloupec1" "sloupec2" ...>`		volitelný předmět, n∈0..9 ve shodě se značkou pro začátek tabulky

Příklad pro n=1:

&lt;TBL TYPE="G1"&gt;
&lt;LG1R "NMUM802" "Fyzika I~(mechanika a~molekulová fyzika)" "30/P+C" "32" "---" "---" &gt;
&lt;LG1O "NMUM803" "Fyzika I~(mechanika a~molekulová fyzika)" "---" "---" "35/P+C" "50" &gt;
&lt;LG1O "NMUM805" "Fyzika I~(mechanika a~molekulová fyzika)" "---" "---" "25/P+C" "36" &gt;
&lt;LG1 "NTIN060" "Fyzika I~(mechanika a~molekulová fyzika)" "40/P+C" "40" "---" "---"&gt;
&lt;LHR&gt;
&lt;LG1 "" "Celkem" "80" "90" "90" "140"&gt;
&lt;/TBL&gt;

Formátovací značky

Význam značky	Začátek	Konec	Poznámka/příklad
horní index	`<^>`	`</^>`
dolní index	`<_>`	`</_>`
tučné písmo	`<B>`	`</B>`
kurzíva	`<I>`	`</I>`
centrovaně	`<C>`	`</C>`
matematické vzorce	`<M>`	`</M>`

Hypertextové značky

Význam značky	Začátek	Konec	Poznámka/příklad
souborové přesměrování	`<FILE "name" "title">`	`</FILE>`	má smysl především v HTML výstupu, ve kterém usnadňuje rozdělení na jednotlivé stránky
hypertextový odkaz	`<LINK>`	`</LINK>`	určeno pro odkazy na místa dostupné na internetu (HTML stránky, ftp apod.); v PDF i HTML výstupu je odkaz vyprodukován jako aktivní. Obsah odkazu je zvládá kromě běžných ASCII znaků též ~, #, %, &, @, = a ?, tj. vše běžně se vyskytující v URL. Příklad:`http://www.cui.cz/`
odkaz na předmět (název a kód)	`<S "kod" "nazev">`		kontroluje se proti databázi předmětů, slouží pro použití v textu, tabulky předmětů mají vlastní značky! Pozn.: odkaz na předmět je z technických důvodů omezen na max. jeden na řádku, proto se při kontrole do zdrojového kódu vloží konec řádku, kde je to třeba. Toto nemá žádný vliv na členění výstupu.
cíl pro odkaz z www	`<NAME "nazev">`		Na místě značky se ve výstupu vytvoří cíl použitelný pro odkazování z jiných WWW stránek. V HTML výstupu lze použít běžnou kotvu (`stranka.htm#nazev`), odkaz do PDF souboru se pak konstruuje jako `soubor.pdf?#nazev`

Speciální znaky

Význam značky	Syntaxe	Poznámka/příklad
Nový řádek uvnitř odstavce	`<BR>`
Pevná mezera	`~`
"m-dash"	`---`
"n-dash"	`--`
znak &, #	`\&, \#`
znak Q, Z, N, R, C	`\Q, \Z, ...`
znak lambda, pi, alfa ...	`\lambda, \pi, \alpha, \beta, \gamma, \Pi, \chi, \ch`
vekt. soucin	`\times, \otimes`
kaligraf. znak	`<CAL> </CAL>`
uvozovky	`,, ... ''`
vlnka (~)	`\~`

Dělení slov

Význam značky	Syntaxe	Poznámka/příklad
Doporučené dělení lokálně	`<->`	doporučení rozdělení slova na daném místě, např. `bio<->lo<->gicky`, v HTML výstupu se nijak neprojevuje
Doporučení dělení globálně	`<HYPHEN></HYPHEN>`	mezerami oddělený seznam slov s doporučeným dělením, je třeba vyjmenovat všechny tvary slov; velká/malá písmena nehrají roli; značku lze použít opakovaně s aditivním výsledkem (stejné slovo ale bude platit pouze v poslední uvedené variantě), příklad: `<HYPHEN>bio-lo-gi-cký nebio-lo-gi-ckých bio-lo-gi-ckých bio-lo-gi-cká bio-lo-gi-cké</HYPHEN>`

Speciální značky

Význam značky	Syntaxe	Poznámka/příklad
Zvl.TeX příkaz	`<TEX "id">`	Značka používaná pro ruční doladění textu před odesláním do tisku. Tyto značky je možno v textu ignorovat. Položka `id` je číselný identifikátor TeXové sekvence, za kterou je nahrazen.

poslední změna: 15.02.2023