AsciiDoc

AsciiDoc είναι ένα open source, cross-platform και δωρεάν βοηθητικό πρόγραμμα γραμμής εντολών που εφαρμόζονται σε Python ως μια μορφή εγγράφου κειμένου, το οποίο μπορεί να χρησιμοποιηθεί από όποιον θέλει να γράψει σελίδες manual, άρθρα, σύντομα έγγραφα και βιβλία για το GNU τους / λειτουργικά συστήματα Linux.

Τα αρχεία που δημιουργούνται με το λογισμικό AsciiDoc μπορεί να μεταφραστεί σε HTML (Hypertext Markup Language), XHTML (Extensible Hypertext Markup Language) και DocBook προσαυξήσεις για τη διαμόρφωση, απλά με τη χρήση του & lsquo? Asciidoc & rsquo? εργαλείο γραμμής εντολών (βλέπε ενότητα Ξεκινώντας παρακάτω για λεπτομέρειες).

Επειδή το λογισμικό δεν χρησιμοποιεί περίεργα σύμβολα μορφή ή σήμανσης ετικέτες, οι χρήστες θα είναι σε θέση να γράψει AsciiDoc τεκμηριώνει τον ίδιο τρόπο που θα γράψει μια κανονική έγγραφο κειμένου σε μια λέξη-σαν εφαρμογή

Για να εγκαταστήσετε και να χρησιμοποιήσετε το λογισμικό AsciiDoc από τη διανομή σας GNU / Linux, θα χρειαστεί να κατεβάσετε την τελευταία έκδοση είτε από το σχέδιο & rsquo? S ιστοσελίδα ή Softoware, αποθηκεύστε το αρχείο στο σπίτι σας κατάλογο, και αποσυμπιέστε χρησιμοποιώντας το αγαπημένο σας αρχείο διαχειριστής χρησιμότητα.
Ανοίξτε ένα τερματικό εξομοιωτή εργαλείο, μεταβείτε στη θέση των εξαγομένων αρχεία αρχειοθέτησης (π.χ. CD /home/softoware/asciidoc-8.6.9), εκτελέστε το & lsquo? ./ Configure & amp? & Amp? κάνει & rsquo? εντολών για να ρυθμίσετε το πρόγραμμα και να οικοδομήσουμε το εκτελέσιμο, στη συνέχεια, εκτελέστε το & lsquo? sudo make install & rsquo? εντολή για να το εγκαταστήσετε.
Μετά την εγκατάσταση, εκτελέστε το & lsquo? Asciidoc --help & rsquo? εντολή για να δείτε το πρόγραμμα & rsquo? s μήνυμα για την χρήση και τις διαθέσιμες επιλογές γραμμής εντολών, ώστε να μπορείτε να μάθετε πώς να το χρησιμοποιήσετε. Για μια πλήρη αναφορά των εντολών σήμανσης, θα πρέπει να διαβάσετε τον Οδηγό AsciiDoc χρήστη.

Όντας γραμμένο σε Python, AsciiDoc είναι ένα cross-platform λογισμικό που τρέχει σε οποιαδήποτε διανομή GNU / Linux. Θα πρέπει επίσης να εργαστεί για τα λειτουργικά συστήματα της Microsoft X Windows και Mac OS, και υποστηρίζεται επί του παρόντος στις πλατφόρμες υπολογιστών 32 και 64-bit.

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

• προσθήκες και αλλαγές:
• Υλοποιήθηκε ένα στυλ float τίτλο. Μια πλωτή τίτλο (ή προγεφύρωμα) καθίσταται ακριβώς όπως ένα κανονικό τμήμα, αλλά δεν συνδέεται επισήμως με ένα σώμα κειμένου και δεν αποτελεί μέρος της τακτικής ιεραρχία τμήμα, ώστε να μην ισχύουν οι συνήθεις κανόνες παραγγελίας.
• Εφαρμόζεται inline σχόλιο μακρο έτσι γραμμές σχόλιο μπορεί να εμφανίζονται τώρα μέσα στοιχεία μπλοκ.
• Οι Σχόλιο γραμμές αποστέλλονται στην έξοδο, αν τα showcomments χαρακτηριστικό καθορίζεται (μπλοκ σχόλιο δεν αποστέλλονται στην έξοδο).
• Ενιαία παραθέτοντας τιμές του χαρακτηριστικού στα στοιχεία AttributeList τους να αντικατασταθεί σαν κανονικό κείμενο inline προκαλεί (χωρίς ενιαία αναφέροντας χαρακτηριστικό μόνο υποκατάσταση γίνεται).
• ξανάγραψε επεξεργασία στοιχείου λίστας (ήταν πολύ crufty). Λίστα συνέχιση και η λίστα μπλοκ λειτουργούν τώρα όπως αναμένεται. Ενημέρωση και τεκμηρίωση διευκρίνισε λίστα στον Οδηγό χρήσης.
• Το χαρακτηριστικό αναθεώρηση αναγνωρίζει πλέον τη μορφή δείκτη RCS $ Id $.
• Ο δείκτης διαμορφωθεί RCS $ Id $ γραμμή αναθεώρηση στην κεφαλίδα δεν χρειάζεται να προηγηθεί μια γραμμή συγγραφέα.
• Αν μια RCS $ Id $ διαμορφωθεί αναθεώρηση καθορίζεται και το όνομα του συγγραφέα δεν έχει ήδη οριστεί, τότε το όνομα του συγγραφέα του δείκτη $ Id $ θα χρησιμοποιηθούν.
• Ενημέρωση Graphviz φίλτρο Gouichi Iisaka στην έκδοση 1.1.3.
• Προστέθηκε autowidth επιλογή πίνακα ιδιοτήτων για τις εξόδους (X) HTML.
• DocBook backend βάζει τώρα orgname προαιρετικό χαρακτηριστικό, σε DocBook κεφαλίδα.
• Αποδοκιμαστεί χωρίς χαρτιά companyname χαρακτηριστικό υπέρ των Φορέας DocBook του.
• Αφαιρέθηκε ανάστροφη ρητή κλείσιμο από HTML4 ετικέτες αυτόματου κλεισίματος για να συμμορφωθεί με τη σύσταση WC3.
• Διορθώσεις σφαλμάτων:
• Σταθερή 8.3.3 παλινδρόμησης όπου δίπλα λίστες με την ίδια σύνταξη αλλά διαφορετικά στυλ λίστας θεωρήθηκε λανθασμένα αντιμετωπίζεται ως ενιαία λίστα.

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

• Διορθώσεις σφαλμάτων:
• Το σπασμένο και σύγχυση αρίθμηση και numeration2 αριθμημένα χαρακτηριστικά λίστα έχουν πέσει, χρησιμοποιήστε το χαρακτηριστικό στυλ αντ 'αυτού.

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

• προσθήκες και αλλαγές:
• Graphviz φίλτρο Προστέθηκε Gouichi Iisaka προς διανομή.
• Το στοιχείο SidebarBlock μπορεί πλέον να αποδίδεται με έναν αφηρημένο ύφος.
• Αναδιοργανώθηκε φίλτρα σε ένα ξεχωριστό υποκατάλογο για κάθε φίλτρο.
• Ενημέρωση Makefile.in και MANIFEST αρχεία ώστε να αντικατοπτρίζει τη νέα οργάνωση των φίλτρων.
• Προστέθηκε λίστα στυλ LiteralBlock στοιχείο ώστε καταχωρήσεις με ένθετα μπλοκ λίστα μπορεί να αποδοθεί σαν ένα μπλοκ λίστα.
• Αλλαγή φίλτρου παράδειγμα κώδικα για να χρησιμοποιήσετε προτιμάται σύνταξη ListingBlock (η παλιά σύνταξη του φίλτρου ~ οριοθετείται δεν χρησιμοποιείται πλέον).
• Εφαρμόζεται απαρίθμηση και enumeration2 αριθμημένη λίστα χαρακτηριστικά για τον καθορισμό του στυλ αρίθμησης λίστα (Αραβικά, loweralpha, upperalpha, lowerroman και upperroman).
• AsciiDoc αναγνωρίζει τώρα upperalpha, lowerroman και upperroman αριθμούς σε listdef-numbered2 αριθμημένες λίστες και θέτει τον αριθμό του μοντέλου με βάση το στυλ της πρώτης αριθμημένο στοιχείο της λίστας (εναλλακτική λύση για τη ρύθμιση enumeration2 χαρακτηριστικό).
• Ενημέρωση formatlistpat ορισμός σε .vimrc παράδειγμα στον Οδηγό χρήσης.
• Μπορείτε τώρα ανάστροφη διαφυγής μακροεντολές μπλοκ συστήματος.
• Προστέθηκε Pychart Συχνές ερωτήσεις.
• Drop παράγραφο του κειμένου και κατάλογος κειμένου, δείκτη και τον αγώνα ετικέτα ομάδων από τα χαρακτηριστικά - που περιλαμβάνονται στο κείμενο του στοιχείου και δεν θέλουμε να τους επεξεργασία για δεύτερη φορά ως χαρακτηριστικά
.
• Αλλαγή σχόλιο μακροοικονομικής μπλοκ γραμμή σε μια διέλευση μακροοικονομικής μπλοκ για να διασφαλίσουν ότι δεν θα αντικαταστάσεις.
• Ένα subslist δεν πρέπει να επισυνάπτεται σε ένα μακρο ορισμό PassthroughBlock, εάν παραλείπεται κανένα αντικαταστάσεις πραγματοποιούνται.
• Κωδικός τακτοποιήσει: αντικαθίσταται αποδοκιμαστεί χειριστή =
!.
• Αφαιρέθηκε αχρησιμοποίητα κωδικό linuxdoc.
• Κωδικός τακτοποιημένο UPS: έπεσε παλιά είδη μονάδα αναφοράς? αντικαταστάθηκε has_key () με προτιμώνται σε χειριστή.
• Διορθώσεις σφαλμάτων:
• Παλιά παλινδρόμησης φίλτρο τονίζουν σύνταξη πηγή:. Ειδικούς χαρακτήρες, όπου δεν διέφυγε σε εξόδους DocBook

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

• προσθήκες και αλλαγές:
• Αντικαταστάθηκε το σενάριο install.sh με ενημερωμένα σενάρια autoconf Ben Γουόλτον - βλ. [1] INSTALL για λεπτομέρειες
• Προστέθηκε μια γενικευμένη σύνταξη AttributeEntry να επιτρέπουν αυθαίρετες εγγραφές αρχείο ρυθμίσεων που θα καθοριστούν μέσα από ένα έγγραφο AsciiDoc (προτείνεται από τον Henrik Maier).
• Λίστα οριοθετημένο μπλοκ σε εξόδους DocBook τώρα υποστηρίζουν ταυτότητες? Οι ταυτότητες του ακινήτου τίτλο και κυριολεκτική οριοθετημένη μπλοκ έχουν μεταφερθεί στην επισυνάπτοντας DocBook παράδειγμα ετικέτας (χάρη στην Vijay Kumar για αυτό το patch).
• Αντικαταστάθηκε κάθετη γραφομηχανή απόστροφο με στίξης απόστροφο (χάρη στον Νώε Slater).
• Διορθώσεις σφαλμάτων:
• Παλινδρόμηση:. Εξαιρουμένων διπλά εισαγωγικά από τις μη εισηγμένες αξίες χαρακτηριστικό οδήγησε σε ασυμβατότητα προς τα πίσω, διπλά εισαγωγικά σε μη εισηγμένες αξίες χαρακτηριστικό έχει αποκατασταθεί
• Παλινδρόμηση: Κείμενο, όπως & amp? ...? ήταν μερικές φορές συγχέεται με μια αναφορά οντότητας -. αυστηρότερες ταιριάζουν αναφορά οντότητας

Απαιτήσεις :

• Python