Χρήσιμες ετικέτες DocBook

Ακολουθούν ορισμένες ετικέτες DocBook, ιδιαίτερα χρήσιμες για την τεκμηρίωση του κώδικα.

Για να συνδεθείτε με μια άλλη ενότητα στην τεκμηρίωση GTK:

<link linkend="glib-Hash-Tables">Hash Tables</link>
Ο προορισμός είναι το αναγνωριστικό του SGML/XML στο πρώτο στοιχείο της σελίδας στην οποία παραπέμπει ο σύνδεσμος. Για τις περισσότερες σελίδες είναι το ("gtk", "gdk", glib"), ακολουθούμενο από τον τίτλο της σελίδας ("Πίνακες Hash"). Για τα γραφικά συστατικά είναι το όνομα της κλάσης. Τα διαστήματα και τα «_» μετατρέπονται σε «-» για να υπάρχει συμμόρφωση με το SGML/XML.

Αναφορά σε εξωτερική συνάρτηση, π.χ. τυποποιημένη συνάρτηση C:

<function>...</function>

Συμπερίληψη παραδειγμάτων κώδικα:

<example>
  <title>Using a GHashTable.</title>
  <programlisting>
      ...
  </programlisting>
</example>
ή, ενδεχομένως, για πολύ σύντομο κώδικα που δεν χρειάζεται τίτλο:
<informalexample>
  <programlisting>
  ...
  </programlisting>
</informalexample>
. Στην τελευταία περίπτωση το GTK-Doc υποστηρίζει επίσης μια συντόμευση: |[ ... ]|

Συμπερίληψη λιστών με κουκκίδες:

<itemizedlist>
  <listitem>
    <para>
      ...
    </para>
  </listitem>
  <listitem>
    <para>
      ...
    </para>
  </listitem>
</itemizedlist>

Συμπερίληψη σημειώσεων που ξεχωρίζουν από το υπόλοιπο κείμενο:

<note>
  <para>
    Make sure you free the data after use.
  </para>
</note>

Για να αναφερθείτε σε έναν τύπο:

<type>unsigned char</type>

Για να αναφερθείτε σε μια εξωτερική δομή (που δεν περιγράφεται στην τεκμηρίωση GTK):

<structname>XFontStruct</structname>

Για να αναφερθείτε σε ένα πεδίο μιας δομής:

<structfield>len</structfield>

Για να αναφερθείτε σε ένα όνομα κλάσης, θα μπορούσατε να χρησιμοποιήσετε το :

<classname>GtkWidget</classname>
, αλλά μάλλον θα χρησιμοποιήσετε το #GtkWidget (για αυτόματη δημιουργία συνδέσμου προς τη σελίδα GtkWidget, δείτε τις συντομεύσεις).

Χρήση έντονων χαρακτήρων:

<emphasis>This is important</emphasis>

Για ονόματα αρχείων χρησιμοποιήστε:

<filename>/home/user/documents</filename>

Για να αναφερθείτε σε κλειδιά χρησιμοποιήστε:

<keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>