|
luyzette
EliteHackers Diamond
Inregistrat: acum 16 ani
Postari: 117
|
|
1. Notiuni de baza
Scopul ghidului XML
Sintaxa ghidului XML este simplificata dar expresiva, deci este simplu de învatat dar pune la dispozitie toate facilitatile necesare scrierii de documentatie web. Numarul de tag-uri este redus la minimum -- doar ceea ce este necesar. Acest lucru face usoara transformarea ghidului în alte formate, cum ar fi DocBook XML/SGML sau HTML, gata de publicare.
Scopul este de a simplifica procedura de creare si transformare a documentelor ghid XML.
Alte Resurse
Daca planificati sa scrieti documentatie Gentoo sau doriti sa testati Ghidul XML, va rugam sa cititi Sfaturi si Trucuri pentru Documentatie ce contine sfaturi si diverse trucuri utile creatorilor de documentatie Gentoo.
Puteti sa aruncati o privire si asupra sursei XML a acestui document, în timp ce-l consultati.
2. Ghidul XML
Structura de baza
Haideti sa pornim învatarea sintaxei GhidXML. Vom porni cu tag-urile initiale (antet) folosite în documentele GhidXML:
Cod 2.1: Partea antet a unui document GhidXML
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header$ -->
<guide link="/doc/ro/ghid.xml" lang="ro">
<title>Ghid Documentatie Gentoo</title>
<author title="Author">
<mail E-mail Tau</mail>
</author>
<abstract>
Acest ghid ne arata cum sa scriem documentatie folosind noua sintaxa
simplificata Gentoo GhidXML. Aceasta sintaxa este formatul oficial pentru
documentatia Gentoo si chiar acest document a fost creat folosind
GhidXML.
</abstract>
<!-- Continutul acestui document este sub licenta CC-BY-SA -->
<!-- Detalii la -->
<license/>
<version>1.0</version>
<date>2004-12-25</date>
În prima linie observam tag-ul necesar identificarii documentului XML si a schemei DTD. Linia <!-- $Header$ --> va fi automat modificata de sistemul server CVS si ajuta la urmarirea reviziilor. Imediat dupa, este un tag <guide> -- întregul ghid este cuprins în perechea <guide> </guide>. Atributul link este obligatoriu si ar trebui sa contina calea absoluta la document relativ la calea radacina unde se afla documentele chiar daca functioneaza si specificând doar numele fisierului. Scopul lui principal este de a genera o legatura "versiune printabila" la documentul dumneavoastra. Daca veti folosi o valoare incorecta, legatura "versiune printabila" nu va functiona sau va indica un alt document. Documentele traduse trebuie sa specifice calea completa, pentru ca este utilizata, de asemenea, pentru a verifica daca exista un document original mai recent. Atributul lang ar trebui folosit pentru a specifica limba în care este scris documentul. Este folosit pentru a formata data precum si afisarea etichetelor ca "Nota", "Continut", etc. în limba specificata. Valoarea implicita este Engleza.
Mai departe este un tag <title> folosit pentru a seta titlul pentru întregul document.
Apoi ajungem la tag-urile <author> ce contin informatii despre diversii autori ai documentului. Fiecare tag <author> permite un element optional title folosit pentru a specifica tipul de contributie al autorului (autor, coautor, editor, translator, etc.). În acest exemplu particular numele autorului este cuprins în alta pereche -- tag-ul <mail>, folosit pentru a specifica adresa de mail pentru acest autor. Tag-ul <mail> este optional si este suficient un singur element <author> într-un ghid (pot fi oricâte astfel de elemente).
Mai departe observam tag-urile <abstract>, <version> si <date>, folosite pentru a specifica un sumar al documentului, numarul versiunii curente precum si data acestei versiuni (în format YYYY-**-DD). Datele invalide sau ce nu sunt în formatul YYYY-**-DD nu vor fi formatate ci vor fi afisate asa cum au fost scrise în documentul generat.
Cam atât despre tag-urile ce trebuie sa apara la începutul unui document ghid. În afara de <title> si <mail>, aceste tag-uri nu trebuie sa apara decât imediat dupa tag-ul <guide>, si pentru consistenta, se recomanda (dar nu obligatoriu) ca aceste tag-uri sa apara înainte de continutul documentului.
În final avem tag-ul <license/>, folosit pentru a publica documentul sub licenta Creative Commons - Attribution / Share Alike si acest lucru este impus de Politica pentru Documentatie.
Capitole si sectiuni
Odata ce tag-urile initiale au fost specificate, sunteti gata sa adaugati elementele de structura ale documentului. Documentele Ghid sunt împartite în capitole, fiecare capitol putând contine una sau mai multe sectiuni. Fiecare capitol si sectiune au un titlu. Aici aveti un capitol exemplu cu o singura sectiune compusa dintr-un paragraf. Daca adaugati acest cod XML la codul XML anterior si adaugati tag-ul </guide> la finalul fisierului, veti obtine un document Ghid valid (chiar daca minimal):
Cod 2.2: Exemplu de Ghid minimal
<chapter>
<title>Acesta este capitolul meu</title>
<section>
<title>Aceasta este sectiunea unu din capitolul meu</title>
<body>
<p>
Acesta este continutul din sectiunea unu a capitolului meu.
</p>
</body>
</section>
</chapter>
Deasupra am setat titlul capitolului adaugând un element copil <title> pentru elementul <chapter>. Apoi am creat o sectiune adaugând un element <section>. Daca priviti în interiorul elementului <section> veti observa ca acesta contine doua elemente copil -- un element <title> si unul <body>. În timp ce <title> nu este nou pentru noi, elementul <body> este -- acesta înglobeaza continutul efectiv al sectiunii. Vom analiza pe larg elementele ce sunt permise în interiorul elementului <body>.
Nota: Elementul <guide> poate contine multiple elemente <chapter> iar un <chapter> poate contine multiple elemente <section>. Totusi, un element <section> poate contine doar un element <body>.
Un exemplu <body>
Acum este timpul sa învatam cum sa formatam continutul efectiv al documentului. Aici este codul XML pentru un exemplu de element <body>:
Cod 2.3: Exemplu de element body
<p>
Acesta este un paragraf. <path>/etc/passwd</path> este un fisier.
<uri>http://www.gentoo.ro</uri> este situl meu favorit.
Tastati <c>ls</c> daca doriti asta. Eu <e>chiar</e> vreau sa merg la culcare.
</p>
<pre caption="Mostra de cod">
Acesta este iesirea unui program sau un fragment de cod
# <i>acesta este introdus de utilizator</i>
Creati HTML/XML usor de citit folosind selectiv accentuarile:
<foo><i>bar</i></foo>
<comment>(Asa se introduce o nota într-un bloc de cod)</comment>
</pre>
<note>
Aceasta este o nota.
</note>
<warn>
Aceasta este o atentionare.
</warn>
<impo>
Acesta este important.
</impo>
Acum, iata cum este generat elementul <body> de mai sus:
Acesta este un paragraf. /etc/passwd este un fisier. este site-ul meu favorit. Tastati ls daca doriti asta. Eu chiar vreau sa merg la culcare.
Cod 2.4: Mostra de cod
Acesta este iesirea unui program sau cod.
# acesta este introdus de utilizator
Creati HTML/XML usor de citit folosind selectiv accentuarile:
<foo>bar</foo>
(Asa se introduce o nota într-un bloc de cod)
Nota: Aceasta este o nota.
Atentie: Aceasta este o atentionare.
Important: Acesta este important.
Tag-uri <body>
Am introdus în sectiunea precedenta o multime de tag-uri noi -- iata ce trebuie sa stiti. Tag-urile <p> (paragraf), <pre> (bloc de cod), <note> (nota), <warn> (atentionare) si <impo> (important), toate pot contine una sau mai multe linii de text. Exceptând <table>, <ul>, <ol> si <dl> (ce vor fi prezentate imediat), doar aceste tag-uri trebuie sa apara imediat în interiorul elementului <body>. Un alt lucru -- aceste tag-uri nu trebuie sa fie imbricate -- cu alte cuvinte, nu puneti un element <note> în interiorul unui element <p>. Asa cum intuiti, elementul <pre> pastreaza spatiile exact cum sunt scrise, facându-l propice pentru listare de cod. Trebuie sa etichetati tag-ul <pre> cu un atribut caption:
Cod 2.5: <pre> cu eticheta
<pre caption="Afisare uptime">
# <i>uptime</i>
16:50:47 up 164 days, 2:06, 5 users, load average: 0.23, 0.20, 0.25
</pre>
Epigrafe
Delegatii din cele 13 state originale au format Congresul. Thomas Jefferson, cineva din Virginia si Benjamin Franklin au fost doi cântareti ai Declaratiei de Independenta. Frankling a descoperit electricitatea prin frecarea a doua pisici pe spate si a declarat, "Un cal împartit de catre el nu poate rezista.". Franklin a murit în 1790 si este înca mort.
Epigrafele sunt utilizate uneori la începutul capitolelor pentru a ilustra ceea ce va urma. Este pur si simplu un paragraf cu un atribut by ce contine semnatura.
Cod 2.6: Epigraf scurt
<p by="Student anonim">
Delegatii din cele 13 state originale au format...
</p>
<path>, <c>, <b>, <e>, <sub> si <sup>
Elementele <path>, <c>, <e>, <sub> si <sup> pot fi folosite în interiorul oricarui element copil al tag-ului <body>, exceptând <pre>.
Elementul <path> este folosit pentru a marca textul ce face referire la un fisier de pe disc -- oricum ar fi cale absoluta sau relativa, sau un simplu nume de fisier. Acest element este, în general, afisat cu un font monospatiat pentru a-l diferentia de un paragraf standard.
Elementul <c> este folosit pentru a marca o comanda sau date introduse de utilizator. Gânditi-va la <c> ca la un mod de a atentiona cititorul ca urmeaza ceva ce trebuie sa tasteze pentru a efectua anumite actiuni. De exemplu toate tag-urile XML afisate în acest document sunt afisate folosind elementul <c> deoarece reprezinta ceva ce utilizatorul ar trebui sa scrie si nu reprezinta o cale. Folosind elemente <c> veti ajuta cititorii sa identifice rapid comenzile pe care vor fi nevoiti sa le tasteze. De asemenea, deoarece elementele <c> sunt gata diferentiate de textul obisnuit, foarte rar va fi necesar de a încadra textul de introdus între ghilimele. De exemplu, nu folositi elementul "<c>", vedeti ce am scris anterior. Evitati sa folositi ghilimelele ce nu sunt necesare pentru a face documentul mult mai citibil -- si delicios!
Asa cum, probabil, ati ghicit, <b> este utilizat pentru a îngrosa un text.
<e> este folosit pentru a accentua un cuvânt sau o fraza; de exemplu: Eu chiar ar trebui sa folosesc punct si virgula mai des. Dupa cum vedeti, acest text este diferentiat fata de textul obisnuit tocmai pentru a se evidentia accentuarea cuvântului. Acesta va ajuta sa dati frazelor mai multa culoare!
Elementele <sub> si <sup> sunt utilizate pentru a specifica un index sau un exponent.
Mostre de cod si colorarea codului
Pentru a îmbunatati lizibilitatea mostrelor de cod, sunt permise urmatoarele tag-uri în interiorul blocurilor <pre>:
<i> Distinge ceea ce introduce utilizatorul de textul afisat <comment> Comentarii relevante actiunii(lor) ce apar dupa comentariu <keyword> Denota un cuvânt cheie în limbajul utilizat în mostra de cod <ident> Utilizat pentru un identificator <const> Utilizat pentru o constanta <stmt> Utilizata pentru o instructiune <var> Utilizat pentru o variabila
Nota: Amintiti-va ca toate spatiile dinainte si dupa, precum si liniile noi din blocurile <pre> vor aparea afisate în pagina html.
Exemplu de bloc de cod <pre> colorat:
Cod 2.7: Primul meu ebuild
# Copyright 1999-2006 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $
DESCRIPTION="Exuberant ctags generates tags files for quick source navigation"
HOMEPAGE="http://ctags.sourceforge.net"
SRC_URI="mirror://sourceforge/ctags/${P}.tar.gz"
LICENSE="GPL-2"
SLOT="0"
KEYWORDS="~mips ~sparc ~x86"
IUSE=""
src_compile() {
econf --with-posix-regex || die "econf failed"
emake || die "emake failed"
}
src_install() {
make DESTDIR="${D}" install || die "install failed"
dodoc FAQ NEWS README
dohtml EXTENDING.html ctags.html
}
<mail> si <uri>
Mai devreme am aruncat o privire asupra tag-ului <mail>; acesta este folosit pentru a lega un anumit text cu o adresa de mail si ia forma <mail E-mail. Foo Bar</mail>. Daca doriti sa afisati adresa de e-mail, puteti utiliza E-mail;, aceasta fiind afisata ca E-mail.
Tag-ul <uri> este folosit pentru a indica fisiere/locatii din Internet. Acesta are doua forme -- prima poate fi folosita când doriti ca adresa sa fie afisata, cum ar fi aceasta legatura. Pentru a crea aceasta legatura am scris <uri>http://www.gentoo.ro</uri>. Forma alternativa este când dorim sa asociem o adresa cu alt text -- de exemplu, Comunitatea Gentoo Linux România. Pentru a crea aceasta legatura am scris <uri link="http://www.gentoo.ro">Comunitatea Gentoo Linux România</uri>. Nu este nevoie sa scrieti pentru a indica alte pagini din situl Gentoo. De exemplu o legatura catre Index documentatie ar trebui scrisa simplu <uri link="/doc/ro/index.xml">Index documentatie</uri>. Eventual puteti omite index.xml când faceti referire la un fisier index, adica <uri link="/doc/ro/">Index documentatie</uri>.
Figuri
Iata cum putem insera o figura (schita, imagine) într-un document -- <figure link="mygfx.png" short="poza mea" caption="poza mea favorita din toate timpurile"/>. Atributul link indica spre imagine, atributul short specifica o scurta descriere (curent folosita pentru atributul HTML alt= ), si o eticheta. Nu prea dificil  De asemenea este suportat în stilul HTML tag-ul <img src="foo.gif"/> pentru a adauga imagini fara etichete, margini, etc.
Tabele
Ghidul suporta o sintaxa simplificata pentru tabele, similara sintaxei HTML. Pentru a începe un tabel, folositi tag-ul <table>. Începem un rând cu tag-ul <tr>. Totusi, pentru a adauga continutul efectiv, nu este suportat tag-ul HTML <td>; în loc de acesta se va folosi <th> daca inserati un antet, respectiv <ti> când inserati continut normal. Puteti folosi <th> oriunde se poate folosi <ti> -- nu este obligatoriu ca elementele <th> sa apara numai ca prim rând.
În plus, tag-ul pentru capul de tabel (<th> si elementele de tabel (<ti> accepta atributele colspan si rowspan pentru a plasa titlurile de-a lungul mai multor rânduri, coloane sau ambele, asa cum este exemplificat mai jos:
Mai mult, elementele de tabel (<ti> pot fi aliniate la dreapta sau centrate cu ajutorul atributului align. Capetele de tabel (<th> sunt centrate automat.
Acest titlu este plasat de-a lungul a 4 coloane
Acest titlu este plasat de-a lungul a 6 rânduri Elementul A1 Elementul A2 Elementul A3
Elementul B1 Titlu într-un bloc de 2x2
Elementul C1
Elementul D1..D3
Elementul E1..F1 Elementul E2..E3
Elementul F2..F3
Liste
Pentru a crea liste ordonate sau neordonate folositi în stilul XHTML tag-urile <ol>, <ul> si <li>. Tag-urile lista trebuie sa apara numai în interiorul tag-urilor <body> si <li> sau <dd> ceea ce înseamna ca putem avea liste în interiorul altor liste. Nu uitati ca scrieti în limbajul XML si ca trebuie sa închideti toate tag-urile, spre deosebire de HTML.
Listele de definitie (<dl> sunt, de asmenea, suportate. Va rugam sa notati ca nici tag-ul termenului de definitie (<dt> si nici cel de date (<dd> nu accepta un alt nivel de bloc, ca paragrafele si avertizarile. O lista de definitii include:
<dl> Un tag Definitie de Lista ce contine <dt> Perechi de tag-uri pentru Definitii de Termeni <dd> si tag-uri pentru Definirea de Date
Urmatoarea lista copiata de la w3.org arata ca o lista de definitii poate contine liste ordonate si neordonate. Nu poate contine o alta lista, totusi.
Ingredientele:
* 100 g. faina
* 10 g. zahar
* 1 cana cu apa
* 2 oua
* sare, piper
Procedura:
1. Amestecati bine ingredientele uscate
2. Turnati ingredientele lichide
3. Amestecati pentru 10 minute
4. Coaceti pentru o ora la 300 de grade
Note: Reteta poate fi îmbunatatita prin adaugarea de stafide
Referiri interne (în acelasi document)
Ghidul simplifica foarte mult referirea anumitor parti din document folosind hiperlegaturi. Puteti crea o legatura la Capitolul Unu scriind <uri link="#doc_chap1">Capitolul Unu</uri>. Pentru a indica sectiunea doi din Capitolul Unu, scrieti <uri link="#doc_chap1_sect2">sectiunea doi din Capitolul Unu</uri>. Pentru a referi figura 3 din capitolul 1, scrieti <uri link="#doc_chap1_fig3">figura 1.3</uri>. Sau, pentru a referi blocul de cod 2 din capitolul 2, scrieti <uri link="#doc_chap2_pre2">blocul de cod 2.2</uri>.
Totusi, anumite documente ghid se schimba destul de des si folosirea acestui stil "numarare" poate conduce la legaturi incorecte. Pentru a preveni acest lucru, puteti defini diverse nume pentru <chapter>, <section> sau <tr> folosind atributul id si legându-va la acest atribut ca aici:
Cod 2.8: Folosirea atributului id
<chapter id="ceva">
<title>Acesta este ceva!</title>
...
<p>
Mai multe informatii pot fi gasite în <uri link="#ceva">capitolul ceva</uri>
</p>
Avertismente si documente neîntretinute
Un atribut disclaimer (avertisment) poate fi aplicat documentelor ghid si manual pentru a afisa un avertisment predefinit în partea superioara a documentului. Avertismentele disponibile sunt:
* articles este utilizat pentru articolele republicate
* draft este utilizat pentru a indica faptul ca un document este înca în lucru si nu ar trebui considerat oficial
* oldbook este utilizat pentru manualele vechi pentru a indica faptul ca nu mai sunt întretinute
* obsolete este utilizat pentru a marca un document ca fiind învechit.
Când marcati un document ca învechit, ar trebui sa adaugati un link catre o noua versiune. Atributul redirect exista exact pentru acest lucru. Utilizatorul ar putea fi redirectat automat catre pagina noua, însa nu ar trebui sa va bazati pe acest comportament.
Cod 2.9: Exemplu de avertisment
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header$ -->
<guide link="/doc/en/gentoo-x86-install.xml" disclaimer="obsolete" redirect="/doc/en/handbook/handbook-x86.xml">
<title>Ghidul de Instalare Gentoo pentru arhitectura x86</title>
<author title="Autor">
...
3. Stil de redactare
Introducere
Cât timp toata Documentatia Gentoo este un efort colectiv si multi dezvoltatori probabil vor dori sa modifice documentatia existenta, un stil de redactare este necesar. Stilul de redactare contine doua sectiuni. Prima sectiune se refera la stilul intern - cum plasam tag-urile XML. A doua sectiune se refera la continut - cum sa evitam confuziile în rândul cititorilor.
Ambele sectiuni sunt descrise mai jos.
Stilul intern de redactate
Trecerea la linie noua trebuie efectuata imediat dupa fiecare tag GhidXML (atât tag-ul de deschidere cât si cel de închidere), exceptând: <version>, <date>, <title>, <th>, <ti>, <li>, <i>, <e>, <uri>, <path>, <b>, <c>, <comment>, <mail>.
Linii goale trebuie adaugate imediat dupa fiecare <body> (numai tag-ul de deschidere) si înainte de fiecare <chapter>, <p>, <table>, <author> (set), <pre>, <ul>, <ol>, <warn>, <note> si <impo> (numai tag-urile de deschidere).
Ruperea rândurilor trebuie aplicata la 80 de caractere exceptând interiorul <pre>. Va puteti abate de la aceasta regula atunci când nu exista nici o alta optiune (de exemplu când un URL depaseste maximul de caractere permis). Editorul trebuie sa rupa rândul când apare primul caracter spatiu. Ar trebui sa încercati sa pastrati continutul afisat al elementelor <pre> în limita a 80 de coloane pentru a ajuta utilizatorii de consola.
Indentarea poate sa nu fie folosita, exceptând constructiile XML ale caror tag-uri parinte sunt <tr> (din <table>, <ul>, <ol>, <dl> si <author>. Daca se foloseste indentarea, atunci aceasta trebuie sa fie de doua spatii pentru fiecare indentare. Aceasta înseamna fara caractere tab si fara mai multe spatii. În plus, caracterele tab nu sunt permise în documentele GuideXML.
În cazul în care ruperea rândurilor apare în constructiile <ti>, <th>, <li> sau <lt>, indentarea trebuie folosita pentru continut.
Un exemplu de indentare este:
Cod 3.1: Exemplu indentare
<table>
<tr>
<th>Ceva</th>
<th>Altceva</th>
</tr>
<tr>
<ti>Acesta este un exemplu de indentare</ti>
<ti>
În cazul în care textul nu încape pe o linie de 80 de caractere,
trebuie sa folositi indentarea daca tag-ul parinte va permite
</ti>
</tr>
</table>
<ul>
<li>Prima optiune</li>
<li>A doua optiune</li>
</ul>
Atributele nu trebuie sa contina spatii între atribut, semnul "=" si valoarea atributului. De exemplu:
Cod 3.2: Atribute
Gresit: <pre caption = "Atribut">
Corect: <pre caption="Atribut">
Stilul extern de redactare
În interiorul tabelelor (<table> si listelor (<ul> si <ol> si <dl>, punctul ("." nu trebuie folosit cât timp nu scrieti mai multe propozitii. În acest caz, fiecare propozitie trebuie sa se termine cu un punct (sau alt semn final de punctuatie).
Fiecare propozitie, inclusiv cele din interiorul tabelelor si listelor trebuie sa înceapa cu o majuscula.
Cod 3.3: Puncte si majuscule
<ul>
<li>Fara punct</li>
<li>Cu punct. Multiple propozitii, va reamintiti?</li>
</ul>
Listarile (blocurile) de Cod trebuie întotdeauna sa aiba eticheta.
Încercati sa folositi <uri> cu atributul link cât de mult este posibil. Cu alte cuvinte, scrierea Gentoo România este preferabila scrierii.
Când faceti un comentariu în interiorul constructiei <pre>, folositi <comment> si paranteze sau marcajul de comentariu din limbajul folosit (# pentru scripturi bash si multe altele, // pentru cod C, etc.) De asemenea plasati comentariu înainte de subiectul comentat.
Cod 3.4: Exemplu de comentariu
(Înlocuiti "john" cu numele dumneavoastra de utilizator)
# id john
4. Formatul Manual
Ghid vs Carte
Pentru documentatia voluminoasa, cum ar fi Instructiunile de Instalare, este nevoie de un format extins. Am proiectat niste îmbunatatiri compatibile cu GhidXML care ne permit scrierea de documentatie modulara si pe mai multe pagini.
Fisierul principal
Prima schimbare este nevoia de a avea un document "principal". Acest document nu contine continut real, însa leaga diferitele parti (module) ale documentatiei. Sintaxa nu difera cu mult fata de GhidXML:
Cod 4.1: Exemplu de folosire a formatului carte
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
<!-- $Header$ -->
<book link="exemplu.xml">
<title>Exemplu folosire carte</title>
<author...>
...
</author>
<abstract>
...
</abstract>
<!-- Continutul acestui document este sub licenta CC-BY-SA -->
<!-- Detalii la -->
<license/>
<version>...</version>
<date>...</date>
Deci, în mare, nu sunt diferente (exceptând atributul <book> în locul atributului <guide>. În loc de a începe cu tag-uri <chapter> veti defini <part> ce sunt echivalente cu partile separate ale cartii:
Cod 4.2: Definirea unei parti
<part>
<title>Partea Întâi</title>
<abstract>
...
</abstract>
(Definirea diferitelor capitole)
</part>
Fiecare parte este însotita de un atribut <title> si un atribut <abstract> ce ne furnizeaza câteva informatii introductive despre continut.
În interiorul fiecarei parti veti defini capitolele (<chapter>. Fiecare capitol trebuie sa fie un document separat. Deci nu ar trebui sa ne surprinda ca un tag special (<include> este adaugat pentru a permite includerea documentelor separate.
Cod 4.3: Definirea unui capitol
<chapter>
<title>Capitolul Unu</title>
<abstract>
O succinta explicatie a capitolului unu.
</abstract>
<include href="cale/la/capitol-unu.xml"/>
</chapter>
Realizarea individuala a capitolelor
Continutul unui capitol individual este structurat dupa cum urmeaza:
Cod 4.4: Sintaxa Capitol
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- $Header$ -->
<!-- Continutul acestui document este sub licenta CC-BY-SA -->
<!-- Detalii la -->
<sections>
<version>...</version>
<date>...</date>
(Definiti diferitele sectiuni, <section> si <subsection>
</sections>
În interiorul fiecarui capitol puteti defini sectiuni (<section> (echivalentul capitolelor (<chapter> în Ghid) si subsectiuni (<subsection> (echivalentul sectiunilor (<section> în Ghid).
Fiecare capitol individual trebuie sa contina propriile elemente data si versiune. Ultima data din toate capitolele va fi afisata când utilizatorul rasfoieste toate partile din carte.
_______________________________________
|
|
