3.4. Seznami

3.4.1. Preprost seznam (SimpleList)

Od vseh seznamov je za uporabo najlažji SimpleList. Zasnovan je za sezname kartkih fraz (kot na primer nakupovalni listič) in zahteva za izgradnjo seznama le dve znački, kot lahko vidite spodaj. Značka <Member> lahko vsebuje le podatke, tako da SimpleList ne more vsebovati drugih seznamov.

 <simplelist>
 <member>jabolka</member>
 <member>pomaranče</member>
 <member>banane</member>
 <member>granivke</member>
 <member>črn fižol</member>
 </simplelist>

Ko je pretvorjen v HTML bo preprost seznam izgledal nakako takole:

jabolka

pomaranče

banane

grenivke

črn fižol

3.4.2. Naštevanje (ItemizedList)

ItemizedList je podoben seznamu SimpleList, le da vsak vnos vsebuje odstavek namesto kratke fraze, kar omogoča vnos raznovrstnejše vsebine v vaš seznam. Naštevalni seznami lahko vsebujejo druge sezname.

 <itemizedlist>
 <listitem><para>Jabolka - moje najljubše sadje.</para></listitem>
 <listitem><para>Pomaranče - izvrstne, a lepljive.</para></listitem>
 <listitem><para>Banane - zorijo prehitro!</para></listitem>
 <listitem><para>Grenivke - čudovite, kadar jih jemo v polovicah.</para></listitem>
 <listitem><para>Črn fižol - se poda rižu.</para></listitem>
 </itemizedlist>

Ta primer bo izgledal nekako tako ko bo pretvorjen v HTML:

• Jabolka - moje najljubše sadje.

• Pomaranče - izvrstne, a lepljive.

• Banane - zorijo prehitro!

• Grenivke - čudovite, kadar jih jemo v polovicah.

• Črn fižol - se poda rižu.

3.4.3. Urejen seznam (OrderedList)

Urejen seznam je podoben kot ItemizedList, le da je vsak element seznama oštevilčen ali označen s črko. Oznaka Numeration določa kateri način oštevilčenja bo uporabljen in ima lahko naslednje vrednosti: Arabic, Upperalpha, Loweralpha, Upperroman, Lowerroman. Obstaja še več drugih lastnosti, ki določajo izgled urejenega seznama. Za več podrobnosti poglejte v DocBook Reference. Urejen seznam lahko vsebuje druge sezname.

  
 <orderedlist numeration="arabic">
 <listitem><para>Zbudi se.</para></listitem>
 <listitem><para>Pojej zajtrk.</para></listitem>
 <listitem><para>Stuširaj se.</para></listitem>
 <listitem><para>Razmisli o sebi/svojih ciljih.</para></listitem>
 <listitem><para>Pojdi spat.</para></listitem>
 </orderedlist>

Ta seznam bo izgledal nekako tako ko bo pretvorjen v HTML:

1. Zbudi se.

2. Pojej zajtrk.

3. Stuširaj se.

4. Razmisli o sebi/svojih ciljih.

5. Pojdi spat.

3.4.4. VariableList

VariableList je podobna HTML seznamu definicij. Uporablja se, kadar imamo seznam izrazov in definicij. VariableList sestoji iz več značk: <VarListEntry>, ki se uporablja za grupiranje povezanih izrazov skupaj, <Term>, ki vsebuje izraz in <ListItem>, ki vsebuje opis izraza.

  
 <variablelist>
 <varlistentry>
 <term>Črn fižol</term>
 <listitem><para>Moj najljubši fižolov recept je fižolova
 juha, vendar se dobro poda rižu.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term>Jabolka</term>
 <term>Banane</term>
 <listitem><para>Lahko jih kar pojeste, vendar se
 dobro podajo solatam in desertom.</para></listitem>
 </varlistentry>
 </variablelist> 

Po pretvorbi v HTML bi zgled Variable List izgledal nekako tako:

Črn fižol

Moj najljubši fižolov recept je fižolova juha, vendar se dobro poda rižu.

Jabolka, Banane

Lahko jih kar pojeste, vendar se dobro podajo solatam in desertom.

3.4.5. SegmentedList

Deljeni seznami se uporabljajo za urejanje informacij v ločenih poljih kot na primer vsebina adresarja. Ime vsakega polja je podano v znački <SegTitle>. Potem uporabimo <SegListItem> za pričetek in zaključek nabora podakov. Dejanski podatki so postavljeni v značko <Seg>. SegmentedLists are used to list information in distinct fields like the contents of an address book. The name of each field is put inside of a <SegTitle> tag. Then, use the <SegListItem> tag to start and end each set of data. The actual data is put in the <Seg> tag.

  
 <segmentedlist>
 <segtitle>Ime</segtitle>
 <segtitle>Poklic</segtitle>
 <segtitle>Najljubša hrana</segtitle>
 <seglistitem>
 <seg>Tux</seg>
 <seg>Linux-ova maskota</seg>
 <seg>Ribe</seg>
 </seglistitem>
 <seglistitem>
 <seg>Konqui</seg>
 <seg>KDE zmaj</seg>
 <seg>Gnomes</seg>
 </seglistitem>
 </segmentedlist>
  

Ta siten zgled izgleda po pretvorbi v HTML nekako tako:

Ime: Tux

Poklic: Linux-ova maskota

Najljubša hrana: Ribe

Ime: Konqui

Poklic: KDE zmaj

Najljubša hrana: Gnomes

3.4.6. QandASet

QandASet je specializiran seznam zasnovan posebej za obravnavo naborov vprašanj in odgovorov, kot bi videli v FAQ. Vsak nabor vprašanj in odgovorov je vsebovan znotraj značke <QandAEntry>. Znački <Question> in <Answer> vsebujeta vprašanja in odgovore.

  
 <qandaset>
 <qandaentry>
 <question>
 <para>What are little boys made of?</para>
 </question>
 <answer>
 <para>Snips and snails and puppy dog tails.</para>
 </answer>
 </qandaentry>
 <qandaentry>
 <question>
 <para>What are little girls made of?</para>
 </question>
 <answer>
 <para>Sugar and spice and everything nice.</para>
 </answer>
 </qandaentry>
 </qandaset> 

QandASet izgleda po pretvorbi v HTML nekako tako:

3.4.7. Procedure

Seznami procedur so specializirani urejeni seznami, ki se uporabljajo za naštevanje korakov, kot jih najdete v receptih ali LinuxHowTo.

  
 <procedure>
 <title>Zbujanje</title>
 <para>To morate storiti, da se zbudite.</para>
 <step performance="required">
 <para>
 Spravite se v hipnotično stanje, naj bo to iz trenutnih sanj ali z uporabo vaše
 notranje ure. Mogoče se boste počutili nezmožne premikanja vendar ne boste več
 sanjali.</para>
 <para>Sedaj ste pripravljeni na reprilagoditev na realni svet.</para>
 <substeps>
 <step performance="optional">
 <para>Obrnite se.</para>
 </step>
 <step performance="required">
 <para>Odprite oči.</para>
 </step>
 </substeps>
 </step>
 <step performance="required">
 <para>Zazehajte in se dvignite iz postelje.
 </para>
 </step>
 </procedure> 

Zgornji primer bi po pretvorbi v HTML izgledal nekako tako: