gnome-doc-utils

gnome-doc-utils πακέτα περιέχει μια συλλογή των υπηρεσιών κοινής ωφελείας τεκμηρίωσης για το έργο GNOME. Αξίζει να σημειωθεί, ότι περιέχει εργαλεία για την οικοδόμηση τεκμηρίωση και όλα τα βοηθητικά αρχεία στο δέντρο του πηγαίου σας, και περιέχει τα φύλλα στυλ XSLT DocBook που κάποτε ήταν διανέμεται με το Yelp. Ξεκινώντας με το GNOME 2.8, Yelp, θα απαιτήσει το gnome-doc-utils για την XSLT.
Δοκιμή

ΟΡΓΑΝΩΣΗ
/
Ο κατάλογος τεστ περιλαμβάνει μια σειρά δοκιμών για το GNOME -doc-utils. Κατάλογοι των testdocn μορφή, όπου n είναι ένας θετικός ακέραιος, είναι σκελετός δέντρα πηγή που περιέχει τεκμηρίωση, με την ίδια διάταξη η οποία θα μπορούσε να χρησιμοποιηθεί από πραγματικά έργα. Ο κατάλογος testdocs περιέχει τις δοκιμές μονάδα από πακέταdocbook-testdocs, που αναπτύχθηκε από το πρότυπο και ΣΙΑ για το πανευρωπαϊκό γαλαξιακό DocBook stylesheets. Ένα πρόσθετο αρχείο README είναι σε αυτόν τον κατάλογο, δίνοντας οδηγίες σχετικά με την επέκταση ή την αλλαγή οποιοδήποτε από τα αρχεία στο gnome-doc-utils CVS.

Doc /
Ο κατάλογος doc περιέχει τεκμηρίωση για το gnome-doc -utils. Στις περισσότερες περιπτώσεις, το gnome-doc-utils απαιτείται για την κατασκευή τεκμηρίωση. Μηχανισμοί έχουν τεθεί σε εφαρμογή για το bootstrapping.

XSLT /
Ο κατάλογος XSLT περιέχει όλα τα XSLT στο gnome-doc-utils. Αξίζει να σημειωθεί ότι, ο κατάλογος XSLT / docbook περιέχει το DocBook XSLT και XSLT / gettext περιέχει το βοηθητικό πρόγραμμα XSLT gettext για τη μετάφραση αυτόματο κείμενο.

Sandbox /
Ο κατάλογος sandbox δεν είναι DISTed, γι 'αυτό θα εμφανίζονται μόνο αν έχετε ένα ταμείο CVS. Είναι μια παιδική χαρά για νέες ιδέες.

Xml2po /
Ο κατάλογος xml2po περιέχει το εργαλείο xml2po αναπτύχθηκε από τον Danilo Segan για τη μετάφραση των αυθαίρετων μορφές XML. Χρησιμοποιείται από το gnome-doc-utils για DocBook μετάφραση.

ΔΟΚΙΜΕΣ

κάτω από τον κατάλογο δοκιμής είναι ένας αριθμός δοκιμών για το gnome-doc-utils. Για να ελέγξετε το σύστημα κατασκευής (gnome-doc-utils.m4 και gnome-doc-utils.make), μπορείτε να χρησιμοποιήσετε οποιοδήποτε από τα testdocn (για na θετικός ακέραιος) καταλόγους. Αυτά έχουν συσταθεί ως σκελετός δέντρα πηγή, συμπεριφέρεται ακριβώς όπως ένα πραγματικό έργο θα. Επίσης, το gnome-doc-utils που χρησιμοποιεί η ίδια για να χτίσει τη δική της τεκμηρίωση (υπό doc), έτσι ώστε το gnome-doc-utils η ίδια είναι ένα τεστ από τα εργαλεία χτισίματος.

Για να ελέγξετε τα φύλλα στυλ DocBook, χρησιμοποιείστε το Test / testdocs. Αυτές οι δοκιμές μονάδα είναι από το πακέτο πακέταdocbook-testdocs για docbook.sourceforge.net, που αναπτύχθηκε από το πρότυπο και ΣΙΑ Απλά πληκτρολογώντας κάνουν σε αυτόν τον κατάλογο θα βασιστεί σε κάθε δοκιμή. Εάν το όνομα του αρχείου δοκιμής είναι foo.001.xml, η έξοδος θα είναι HTML / foo.001 / foo.001.html. Κάθε τεστ ελέγχει γενικά ένα μικρό αριθμό στοιχείων που σχετίζονται με το DocBook. Πολλά από τα χαρακτηριστικά του DocBook ή του XSLT στο gnome-doc-utils δεν μπορεί να ελεγχθεί από αυτές. Μπορούν να προστεθούν επιπλέον δοκιμές? ακολουθήστε τις οδηγίες στη δοκιμή / testdocs / README για αυτό.

Επίσης χρήσιμο για τον έλεγχο της XSLT είναι να μετατρέψει ορισμένα μεγάλα έγγραφα χρησιμοποιώντας το. Το Gnome Οδηγός χρήσης και το Εγχειρίδιο Gnumeric εξυπηρετούν ως εξαιρετικές docs δοκιμή.

HACKING

αντίθεση με τα περισσότερα προγραμματισμού C, που εργάζονται για ένα μεγάλο μέρος του gnome-doc-utils πραγματικά συνεπάγεται απομονωμένες σταδιακή βελτίωση. Δεν υπάρχει κανένας τρόπος για να δώσει μια σύντομη λίστα με ευρεία χαρακτηριστικά σε μια λίστα με δουλειές.

Να εργαστούν για την κατασκευή εργαλείων (gnome-doc-utils.m4 και gnome-doc-utils.make), την κατασκευή του docs δοκιμή και να δούμε τι δεν λειτουργεί. gnome-doc-utils.make έχει μια λίστα με όλους τους στόχους υψηλού επιπέδου που θα πρέπει να υποστηριχθεί πλήρως.

να εργαστούν για το DocBook XSLT, να βρεθεί ένα στοιχείο που δεν έχει εφαρμοστεί ακόμη και να την εφαρμόσουν . Εάν έχετε XML Starlet (xmlstar.sourceforge.net) εγκατασταθεί, μπορείτε να γράψετε 'make report.html »στο XSLT / DocBook / html κατάλογο για να πάρει ένα ωραίο
HTML έκθεση σχετικά με το τι υλοποιούνται στοιχεία. Υπάρχει επίσης ένα αρχείο TODO σε αυτόν τον κατάλογο με μια πολύ σύντομη λίστα των αγώνων που πρέπει να κάνει ότι δεν μπορεί να αλιευθεί από report.html.

Σημειώστε ότι η XSLT τεκμηριώνεται inline με xsldoc, η οποία είναι η ίδια ένα μέρος του gnome-doc-utils. Νιώστε ελεύθεροι να εργαστούν σε xsldoc, καθώς και. Η τεκμηρίωση που παράγεται από xsldoc περιλαμβάνεται στο εγχειρίδιο υπό doc / XSLT

Τι είναι καινούργιο σε αυτή την έκδοση:.

• Σταθερή πρόβλημα με dist και να εγκαταστήσετε με πάρα πολλά αρχεία
• Ενημέρωση μεταφράσεις:
• χλμ (MORN Met)

Τι είναι καινούργιο στην έκδοση 0.20.9:

• Προσωρινά προσθέτοντας RNG αρχεία ξανά για συμβατότητα. Τώρα που τα αρχεία RNG δεν αποκαλείται πλέον (όπως του 0.20.8), τα αρχεία RNG θα πρέπει να αφαιρεθεί και πάλι μετά από μια μεταβατική περίοδο.

Τι είναι καινούργιο στην έκδοση 0.20.6:

• Ενημέρωση αγριόπαπια σχήμα
• Σταθερή »κάνει ποτ» κανόνας για αγριόπαπια
• Ενημέρωση μεταφράσεις:
• γα (Jordi δειταΐο)
• ES (Jorge Gonzalez, ο Daniel Mustieles)
• UG (Abduxukur Abdurixit)

Τι είναι καινούργιο στην έκδοση 0.20.5:

• Ενημέρωση αρχείων αγριόπαπια RNG
• Ενημέρωση μεταφράσεις:
• ως (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• EO (Κρίστιαν Schmidt)
• ES (Jorge Gonzalez)
• gu (Sweta Kothari)
• ή (Manoj Kumar Γκίρι)

Τι είναι καινούργιο στην έκδοση 0.20.3:

• Σταθερή ένθετη υποκατάσταση εντολή gnome-doc-utils .make (Chris Coleman)
• Ενημέρωση μεταφράσεις:
• γα @ Βαλένθια (Carles Ferrando)
• de (Χριστιανοδημοκράτες Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• ES (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• FR (Bruno Brouard)
• GL (Fran Dieguez)
• SL (Matej Urbancic)
• UG (Gheyret T.Kenji)

Τι είναι καινούργιο στην έκδοση 0.20.2:

• Ενημέρωση μεταφράσεις:
• de (Mario Blattermann)
• el @ Shaw (Thomas Thurman)
• ES (Jorge Gonzalez)
• FR (Geode)
• GL (Fran Dieguez)
• ο (Yaron Shahrabani)
• hu (Gabor Κέλεμεν)
• ID (Dirgita)
• JA (Takayuki Kusano)
• BGN (Rudols Mazurs)
• SL (Andrej Znidarsic)
• zh_CH (Aron Xu)