openSUSE:Documentation team

Μετάβαση σε: πλοήγηση, αναζήτηση

Doku-wichtl.png

Εισαγωγή

Είμαστε οι άσημοι Doku-Wichtl, μια ομάδα από άτομα αφοσιωμένα στη συγγραφή και συντήρηση των εγχειριδίων χρήσης του openSUSE/SUSE Linux. Συλλέγουμε πληροφορίες από κάθε πηγή που μας είναι διαθέσιμη, ρουφάμε ακόμη και γνώση από τα μυαλά των ανθρώπων που ασχολούνται με την ανάπτυξη λογισμικού την οποία μετατρέπουμε σε κάτι κατανοητό. Μπορεί να έχετε ακούσει ότι το πιο επικίνδυνο ζώο στο σύμπαν είναι ένας προγραμματιστής με ένα κατσαβίδι. Κάνετε λάθος -- είναι ένα Doku-Wichtl σε μορφή κώδικα! ;)

Επικοινωνία

Η επικοινωνία μαζί μας είναι πολύ εύκολη. Αν έχετε βρει τυπογραφικά λάθη, έχετε ερωτήσεις ή προτάσεις ή απλά θέλετε να μας πείτε ένα γεια, μπορείτε να επισκεφτείτε τις παρακάτω διευθύνσεις:

Μέλη

Πώς να συνεισφέρετε

Ρίξτε μια ματιά στην ομαλή εισαγωγή μας Πώς να συνεισφέρετε στην τεκμηρίωση του openSUSE.

Αν είστε χρήστης EMACS, ίσως βρείτε χρήσιμη αυτή τη σελίδα Docbook macros για το Emacs.

Από πού μπορείτε να προμηθευτείτε τα εγχειρίδιά μας

Τα εγχειρίδιά μας παρέχονται με κάθε προϊόν, είτε είναι το openSUSE είτε είναι ένα επιχειρησιακό προϊόν. Τα εγχειρίδια είναι επίσης διαθέσιμα για μεταφόρτωση (download) από τη σελίδα επίσημη τεκμηρίωση.

  • Το openSUSE παρέχεται με πάρα πολλά εγχειρίδια σε μορφή HTML και PDF με το σύνολο των σελίδων να φτάνει σήμερα τις περίπου 2000 σελίδες. Η επίσημη λίστα διατηρείται στη σελίδα Λίστα Εγχειριδίων.
  • Άλλα εγχειρίδια, συνήθως επιχειρησιακών προϊόντων, διατηρούνται στη σελίδα Λίστα επιχειρησιακών προϊόντων.

Για πληροφορίες σχετικά με το πού μπορείτε να βρείτε τα εγχειρίδια στο μέσο εγκατάστασης που χρησιμοποιείτε, ανατρέχτε στις σημειώσεις έκδοσης.

πακέτο susedoc

Για να δημιουργήσουμε και να δημοσιεύσουμε τα εγχειρίδιά μας, χρησιμοποιούμε εργαλεία ανοιχτού κώδικα: Τα εγχειρίδια είναι γραμμένα σε μορφή XML με τη χρήση του Novdoc DTD, ένα υποσύνολο του DocBook (δείτε http://www.docbook.org). Τα αρχεία πηγαίου κώδικα XML επικυρώνονται από το xmllint, επεξεργάζονται από το xsltproc, και μετατρέπονται σε μορφή XSL-FO με τη χρήση μιας τροποποιημένης έκδοσης των Norman Walsh's stylesheets. Το τελικό αρχείο PDF μορφοποιείται μέσω XEP από το εργαλείο RenderX.

Από την έκδοση SUSE Linux 10.1 και έπειτα, παρέχουμε επιπλέον και τα αρχεία πηγαίου κώδικα XML των εγχειριδίων μας. Μπορείτε να τα βρείτε στο πακέτο opensuse-manual_LANGUAGE στο μέσο εγκατάστασής σας (ή μπορείτε να τα κατεβάσετε από τη διεύθυνση http://download.opensuse.org/source/distribution/11.3/repo/oss/suse/src/). Αποσυμπιέστε τα αρχεία .src.rpm και βρείτε τα XML αρχεία σε διάφορα αρχεία tarballs (*tar.bz2) τα οποία μπορείτε να αποσυμπιέσετε ώστε να πάρετε τα αρχεία πηγαίου κώδικα για το σχετικό εγχειρίδιο.

Το περιβάλλον τεκμηρίωσης που χρησιμοποιούμε για να δημιουργήσουμε και να δημοσιεύσουμε τα εγχειρίδιά μας αναπτύσσεται και συντηρείται από εμάς και παρέχεται υπό την άδεια GPL. Επίσης είναι διαθέσιμο ως πακέτο susedoc*.rpm (δείτε επίσης το SVN μας στη διεύθυνση http://svn.berlios.de/svnroot/repos/opensuse-doc/trunk/tools/docmaker/) και παρέχεται μαζί με τη διανομή openSUSE. Εγκαταστήστε το και χρησιμοποιείστε το, αν επιθυμείτε (λειτουργεί επίσης με FOP αντί για XEP)  :).

Βρείτε το τελευταίας έκδοσης susedoc*.rpm πακέτο από τη διεύθυνση openSUSE Build Service (βρίσκεται στη διαδρομή openSUSE_RELEASE/noarch/).

Άλλα έργα

Ένα άλλο έργο είναι το Οδηγός για το openSUSE από τον martin-schlander