Ακολουθούν παραδείγματα ορισμένων πραγμάτων που θα χρειαστείτε στον κώδικα. Πρώτα ας κατεβούμε σε μια υποενότητα:
Όπως λέει και ο τίτλος της. Προσέξτε ότι είναι απαραίτητο να
χρησιμοποιήσετε την εντολή p
για να αρχίσετε το κυρίως μέρος της
ενότητας, μετά από την εντολή sect1
. Ακολουθεί μια ανθυποενότητα:
Ωραία. Έχετε στη διάθεσή σας 5 επίπεδα ενοτήτων. Χρησιμοποιήστε τις
εντολές sect
, sect1
, sect2
, sect3
, και sect4
για να τα εκμεταλλευτείτε. Αυτό το κείμενο χρησιμοποιεί το στυλ
κειμένου article (άρθρο)
, που είναι κατάλληλο για HOWTO και άλλα
παρόμοια κείμενα το στυλ report (τεχνική αναφορά)
που περιλαμβάνει την εντολή ενότητας chapt (κεφάλαιο)
θα πρέπει
να το χρησιμοποιείτε για τα κείμενα του Linux Documentation Project.
Ας υποθέσουμε λοιπόν ότι, καθώς συνεχίζετε το γράψιμο, θέλετε να
ενσωματώσετε στο κείμενό σας τον κώδικα, την είσοδο, ή την έξοδο ενός
προγράμματος. Σε τέτοιες περιπτώσεις χρησιμοποιήστε τα ``περιβάλλοντα'' code
ή verb
, περικλείοντάς τα σε ένα
περιβάλλον tscreen
, όπως στο παράδειγμα:
This is an example for environment verb.
Επίσης:
This is an example for environment code.
Το περιβάλλον tscreen
απλώς ορίζει μικρότερο μέγεθος
γραμματοσειράς και φροντίζει για τη σωστή στοίχιση. Δεν είναι
απαραίτητο για τη χρήση των verb
ή code
, πάντως εγώ σας το
συνιστώ.
Το κείμενο Linuxdoc-SGML User's Guide εξηγεί ποιους ειδικούς
χαρακτήρες μπορείτε και ποιους δεν μπορείτε να χρησιμοποιήσετε στα
περιβάλλοντα verb
and code
.
Θέλετε και παραπομπές σε άλλα σημεία του κειμένου; Αυτή η ενότητα έχει
μαρκαριστεί με την εντολή label
. Χρησιμοποιώντας την
εντολή ref
θα δημιουργήσετε μια παραπομπή, όπως στο παράδειγμα ``Δείτε
την Ενότητα
dokimastiki-parapompi
για περισσότερες
πληροφορίες''.
Για την ώρα οι παραμπομπές δε δουλεύουν κατά τη μετάφραση (με τη χρήση
του groff
) σε απλό ASCII κείμενο. Δουλεύουν σωστά όταν παράγετε
LaTeX ή HTML.
Αν θέλετε γραμματοσειρές, έχουμε κι απ' αυτές. Φυσικά δε θα τις βλέπετε
στο απλό κείμενο ASCII, αλλά θα εμφανιστούν όλες στα διάφορα φορμάτ
που θα παραγάγετε: boldface (έντονα), emphasis (για έμφαση),
typewriter (γραφομηχανής)
, and italics (``ιταλάκια'').
Οι λίστες είναι επίσης εύκολες. Απλώς χρησιμοποιήστε το στοιχείο
itemize
με τις εντολές item
όπως εμφανίζονται παρακάτω:
enum
επίσης δουλεύουν.descrip
και tag
είναι επίσης διαθέσιμο, όπως φαίνεται κι
εδώ. Να ένα στοιχείο.
Να κι άλλο ένα.
Πάμε και για το τρίτο.
Καλύψαμε σχεδόν καθετί που χρειάζεστε για να ξεκινήσετε με τo
γράψιμο κειμένων SGML χρησιμοποιώντας το linuxdoc-sgml
DTD. Σας
παρακαλώ να με ειδοποιήσετε αν νομίζετε ότι κάτι πρέπει να αλλάξει ή
να προστεθεί σε αυτό το κείμενο.