Toto neni nahrada w3c.org nebo vycerpavajici popis vsech moznosti, ale obecne shrnuticko :)


1. Obecne DTD
-------------
DTD je obyc TXT soubor s priponou DTD.

Deklaruje elementy, atributy a parametricke entity.

Uplne obecne se DTD sklada ze zaznamu o formatu:

<!KEYWORD .....>

KEYWORD znaci to, co se v DTD ma definovat, pricemz telo (...) je pak ruznorode.


1.0 Elementy
------------
Deklarace elementu ma formu:

<!ELEMENT jmeno OBSAH>

Na poradi definice elementu nezalezi, neni nutne resit tedy nejake dopredne
deklarace a podobne

1.0.1. Prazdny element
----------------------
Pokud element nema nic obsahovat, jako napriklad <br/> nebo <image></image> tak
je na miste OBSAHu uvedeno "EMPTY". Pozor na to, ze 'mezery' jsou obsah - tedy
<br> </br> MUZE byt chybne (viz [2])

Priklad:

    <!ELEMENT image        EMPTY>
    <!ELEMENT br           EMPTY>
    <!ELEMENT newpara      EMPTY>
    <!ELEMENT newline      EMPTY>

1.0.2. Model popisujici obsah
-----------------------------
Model je defacto predpis obsahu elementu. Musi se uzavrit to kulatych (zavorek). Obsah je
slozen z:

    jmena elementu      - dany element je na danem miste povolen/vyzadovan
    #PCDATA             - zastupce pro 'text' (text nejsou elementy ale jen 'text')
    volby               - symbol pipe | 
                        - ma tvar: A | B a rika, "A nebo B"
    spojeni             - carka , 
                        - ma tvar: A , B a rika "A nasledovanym B"
    ()                  - vnorena skupina, rekurze
    + ? *               - opakovani
                            ?   0 nebo 1
                            *   0 a vic (0,1,2,3,...)
                            +   1 a vic (1,2,3,...)
                          lze pouzit jako pro element "element+, element2*" tak pro celou
                          supinu "(a | b)+ , c , d?"

Pro model plati nasledujici pravila:

    1. v ramci jedne skupiny se nesmi pouzit zaroven , a |
        a | b | c   - platne
        a , b , c   - platne
        x | y , z   - chyba - ze zapisu nevyliva, co je presne mysleno. Je treba prepsat na
                       "(x | y) , z" nebo "x | (y , z)" dle toho co ma autor na mysli

    2. pokud se v modelu vyskytuje #PCDATA musi mit model uzity pouze konektor volby (|)
       a cela skupina musi byt opakovatelna - napriklad: (#PCDATA | elem | elem2)*
       Jinak ne pouziti PCDATA neplatne

    3. validatory nezkoumaji dopredu - zapis: "a | (a,b)" neni platny, protoze valdiator
       nemuze u elementy 'a' rozhodnout, jesli pujde prvni nebo druhou cestou. Musel by
       se podivat na nasledujici tag. To nedelaji. Pozor tedy na nejednoznacny zapis

Priklad:

  <elem>
    <meno>name</meno>
    <popis>prvni</popis>
    <image/>
    <popis>prvni</popis>
    <popis>prvni</popis>
    <footer>dodadek<footer>
  <elem>

  <!ELEMENT elem    (meno, (popis | image)*, footer)>
  <!ELEMENT image   EMPTY>
  <!ELEMENT popis   (#PCDATA)>
  <!ELEMENT footer  (#PCDATA)>

Priklad II:

    stranka, povinny nadpis, potom nasleduje alespon jeden odstavec a footer. Odstavec
    obsahuje text, obrazek nebo odkaz.

    <!ELEMENT stranka   (nadpis, odstavec+, footer>
    <!ELEMENT nadpis    (#PCDATA)>
    <!ELEMENT footer    (#PCDATA)>
    <!ELEMENT odstavec  (#PCDATA | obrazek | odkaz)*>
    <!ELEMENT odkaz     (#PCDATA)>
    <!ELEMENT obrazek   EMPTY>

1.1. Atributy
-------------
Kazdy element muze mit atributy. Obecna forma zapisu atributu je:

<!ATTLIST element atribut  typ flag>

<!ATTLIST element atribut  typ flag
                  atribut2 typ flag
                  atribut3 typ flag>

ATTLIST muze byt specifikovano vicekrat pro stejny element, visledkem je 'soucet' vsech
deklarovanych atributu. Pokud se definuje stejny atribut ve vice deklaraci, prednost
ma prvni, ale toto radsi nepozuivat. Mezery mezi jednotlivimy atributy (EOL) nejsou nutne,
ale je to dobry zvyk je dodrzovat - zapis je mnohem prehlednejsi.

'typ' specifikuje co dany atrobut muze obsahovat. Nejdulezitejsi je:

    CDATA           - char data, tedy proste 'text'
    NMTOKEN         - 'id' zname z CBS, tedy napr: abc, 123abc a podobne.
    (a | b | ...)   - jedna z voleb (zde tedy "a" nebo "b")

'flag' urcuje chovani atributu

    #REQUIRED       - atribut se MUSI uvest
    #IMPLIED        - atribut je VOLITELNY
    "value"         - atribut se nemusi uvest a pokud se neuvede, pouzije se "value"
                      pro volajici aplikaci je to to same, jako kdyby se atribut UVEDL
    #FIXED"val"     - atribut nejde menit a ma vzdy hodnotu "val"

Priklad:


<!ENTITY % odkaz    "barva NMTOKEN #IMPLIED">
<!ATTLIST change    ref     CDATA #REQUIRED
                    version CDATA #FIXED"1.0"
                    pozadi  CDATA "cervene"
                    %odkaz;>


Definuje atributy pro element 'change':

    ref     - vyzadovany, textova hodnota
    version - nejde napsat ani zmenit, ale pro volajici aplikaci se vse tvari, jako
              kdyby user napsal version="1.0" do deklarace elementu
              tento zapis je cas od casu uzitecny
    pozadi  - volitelny, pokud se neuvede, tak je to jako kdyby user napsal pozadi="cervene"
              do deklarace elementu
    barva   - volitelny, NMTOKEN hodnota


1.2. Entity
-----------
V ramci DTD lze definvoat entity, ktere jdou pozuit v XML nebo DTD

1.2.1. Entity pro XML
---------------------
Entity se v XML zapisuji pomoci &jmeno; To je odkaz na entitu a je nahrazen prislusnym
obsahem. Nektere entity jsou preddefinovane:

    &lt;    <
    &gt;    >
    &apos;  '
    &quote; "

DTD muze definovat casto pozuviane fraze, nebo netisknutelne znaky - napriklad &copy; pro
(c) symbol. Pozor na to, ze aplikace NEMI zda-li text byl napsat nebo popsan odkazem na
entitu. Nelze tedy v XML cokolvi vyvozovat z toho, ze neco bylo napsano entitou.

V DTD se entita definuje:

<!ENTITY nazev "telo">

Priklad:

    <!ENTITY orcave "Orcave (TM)">

    v XML se pak pouzije v ramci textu:

    <xml>
        ..... a spolecnost &orcave; ... se zabyva...
    </xml>

Entity se mohou pozuivat i v atributech. Pokud entita obsahuje elementy, je tento
obsah vyhodnocen jako TEXT - nikoliv jako elementy.

Eneity se mohou pouzit u atributu obrazky, ala:

    <img ref="&hlavni_obrazek;"/>

1.2.2. Entity v DTD
-------------------
Entity v DTD funguji stejne jako v XML, jen s tim rozdilem, ze se pozuviaji v DTD.
Nejsou odkazovat v XML, jsou tedy platne jen pro DTD. Rika se jim "parametrove entity".
Pouzivaji se ke zjednoduseni zapisu - napriklad casti modelu.

Zapis: <!ENTITY % nazev "obsah">

V ramci DTD nejdou pozuivt mist jmen atributu a podobne. Zaroven je nutno pamatovat 
na to, ze pri odkazovani muzou vniknout chyby:

    <!ENTITY % stranka "b | br">

    <!ELEMENT page (header, %stranka; , footer>

    po rozbaleni dostavame: "header, b | br , footer" coz je chyba. Entity v ramci DTD
    tedy pozuzivat s rozumem.

Okolo entity se pri rozbaleni davaji mezery, takze nelze pouzit neco ve stypu:

    <!ENTITY % model "odsta">
    <!ELEMENT neco (%model;vec)>

    Po rozbaleni vnikne: "<!ELEMENT neco (odsta vec)>" coz je chybne

Entity se pozuivaji hlavne pro osetreni zapisu u custom DTD v Xdocu.


1. X-DOC relevantni DTD
-----------------------
Aby DTD dobre fungovalo pro X-doc je vhodne ho psat 'rucne' aby bylo jednoduche, musi
icludovat hlavni DTD a minimalne definovat 'docpage' element.

Minimalni DTD tedy vypada takto:

<!--                                   -->
<!--    DTD for X-doc system           -->
<!--                                   -->
<!--    Plain text page                -->


<!-- include Xdoc DTD -->
<!ENTITY % inc SYSTEM "./Xdoc.dtd">
%inc;

<!-- docpage -->
<!ELEMENT docpage (%docpage.begin; , (%docpage.plain;)* , %docpage.end;)>


Bylo by vhodne dodrzet i komentare a formatovani. DTD editovat NEPROPORCIONALNIM fontem :)
[courier, fixed sys,...]

Samozrejmne je mozne a doporucene pozuivat co nejvice existujiich elemenntu
v ramci custom DTD - napriklad '<text>'. Definovat co nejmene vlastnich.


1.1 docpage element
-------------------
Docpage element musi byt definovat kazdym DTD. Musi se v tomto pripade pouzit nasledujici
entity:

docpage.begin       - zacatek stranky - VYZADOVANO
docpage.plain       - 'telo' bezne stranky, elementy spojene | operatorem bez opakovani
docpage.end         - konec stranky - VYZADOVANO

Priklad

    <!ELEMENT docpage (%docpage.begin; , (%docpage.plain;)* , %docpage.end;)>

    pomoci , se spojili elementy do clanku, 'plain' text je mozno opakovat. Musely
    se uvest zavorky, protoze docpage.plain obsahuje pouze elementy ala "a | b | c"
    to protoze nektere stranky obohacuji pouze pouzitelne elementy, ale neomezuji
    standardni

1.2. Vlastni elementy
---------------------
Pokud se pouzivaji vlastni elementy, na tkere je mozne se odkazat, potom se u nich
musi uvest jako atribut "common.attr", ktery specifikuje 'id'. Pozuivase je o 'top'
aliasu pripadne datove struktury, napriklad

    <funkce>
        <parametr...
        <parametr...
        <navratova_hodnota....>
    </funkce>

by tento atribut obsahovala jen 'funknce'. Tedy:

<!ELEMENT funkce       (parametr+,navratova_hodnota)>
<!ATTLIST funkce       %common.attr;>

Pozor na kolizi jmen se STD dtd a pripadnimy rozsirenimi v budoucnu. Cili, je vhodne
se vyvarovat generlanim elementum ala 'table' a podobne. Pokud se dokumentaty maji
prekladat, je vhodne nazvy elementy/atributu volit anglicke. Pokud budou dokumenty
jen v CZ, je to jedno.


1.3. Text
---------
Jestlize je potreba definvoat element, obsahujici 'text' - ve smyslu dokumentace (to je
znaky, obrazek, link, ...) je mozno pouzit element <text>, ale zaroven je mozno pouzit
'common.text' entitu.

Priklad:

    <smernice>
      <autor....
      <nazev...
      <popis>
        <text>
          Text s obrazkama, odstavecma, ...
        </text>
      </popis>
    </smernice>

    <!ELEMENT popis (text)>


    Toto reseni je zbytecne na psani, takze je mozne vytvorit nasledujici:
    <smernice>
      <autor....
      <nazev...
      <popis>
        Text s obrazkama, odstavecma, ...
      </popis>
    </smernice>

    <!ELEMENT popis %common.text;>

common.text je jiz KOMPLETNI definice - to jest opakovatelna skupina moznych elementu 
"(#PCDATA | a | b | c)*"


2. Nevyznamne mezery
--------------------
Mezeri jsou v XML dost velky problem... Existuje tisic a jedna cest jak je resit - std nebo
nestd. Nic neni ale univerzalni :/

Obecne plati pouze normalizace mezer, to jest, jeden a vice blich znaku (enter, mezer, tab)
je konvertovano prave na JEDNU mezeru.

Priklad:

    <odstavec>
        Text
    </odtavec>

Je text v odstavci " Text " nebo "Text " nebo " Text" nebo jen "Text" ?

    <br>
    </br>

Je <br> platny ? Cili - je mezi elementy <br> a </br> bili znak nebo neni ?

    <nadpis>
      <kapitola>
      ...

    <!ELEMENT nadpis (kapitola, ....)>

    Je tato cast XML validni ?

Obecne lze pouze spolehat na jednu vec: pokud je to nutne pro validaci, tak
parser muze (a bude) ignorovat bile znaky mezi elementama. Jinak by sel XML
dokument dost obtizne formatovat kvuly citelnosti zdroje. Cili - <br> i tento
pripad budou vaidni.