kramdown

kramdown είναι μια ελεύθερη βιβλιοθήκη Ruby που μπορεί να χρησιμοποιηθεί για την ανάλυση ένα υπερσύνολο του Διακριτικών & nbsp?. Είναι εντελώς γραμμένο σε Ruby, υποστηρίζει το πρότυπο Markdown (με κάποιες μικρές τροποποιήσεις) και διάφορες επεκτάσεις που έγιναν δημοφιλή από την PHP Markdown Έξτρα πακέτο και Maruku.
Είναι ίσως ο πιο γρήγορος μετατροπέας καθαρής Ruby Markdown διαθέσιμα (Νοέμβριος 2009), είναι 5 φορές πιο γρήγορα από ό, τι Maruku και περίπου 10 φορές πιο γρήγορα από ό, τι BlueFeather.
Η σύνταξη kramdown βασίζεται σε Διακριτικών, ένα πολύ εύκολο να γράψει, εύκολο να το διαβάσετε σήμανσης για τη σύνταξη των εγγράφων HTML σε μορφή απλού κειμένου. Δεδομένου ότι η βασική σύνταξη Markdown έχει κάποιες ελλείψεις, εφαρμογές (ιδιαίτερα το εξαιρετικό πακέτο PHP Markdown) προσπάθησαν να ξεπεράσουν αυτό το ελλείψεις με πρόσθετη σύνταξη. kramdown υποστηρίζει όλα τα χαρακτηριστικά της αρχικής σύνταξης Markdown (έστω και με κάποιες μικρές διορθώσεις), καθώς και τα νεότερα χαρακτηριστικά που υλοποιούνται στο έξτρα πακέτο PHP Markdown και Maruku.
Χρήση:
Το πακέτο kramdown παρέχει δύο τρόπους για τη χρήση του:
* Ως βιβλιοθήκη
& Nbsp? Kramdown βασικά χρησιμοποιεί το ίδιο API ως RedCloth, BlueCloth και Maruku:
& Nbsp? Απαιτούν «kramdown»
& Nbsp? Kramdown :: Document.new (κείμενο) .to_html
& Nbsp? Η δεύτερη παράμετρος για τη νέα κλήση είναι ένας hash επιλογές για (de) ενεργοποιώντας ορισμένα χαρακτηριστικά. Για περισσότερες πληροφορίες ρίξτε μια ματιά στην τεκμηρίωση API.
* Ως μια εφαρμογή
& Nbsp? Μαζί με τη Βιβλιοθήκη αρχεία ένα δυαδικό ονομάζεται kramdown αποστέλλεται το οποίο μπορεί να χρησιμοποιηθεί για να μετατρέψετε το κείμενο σε kramdown σύνταξη με την HTML. Είτε διαβάζει από τα αρχεία που ορίζονται ως τα επιχειρήματα της γραμμής εντολών ή από την κανονική είσοδο. Για παράδειγμα:
& Nbsp? Μονοπάτι kramdown / να / kramdown / doc / syntax.page

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

• 2 ανήλικος αλλαγές:
• Προστέθηκε μια μονάδα ανάλυσης για Github Άρωμα Markdown (GH επιλύει # 68 από Arne Brasseur που παρείχε η αρχική εφαρμογή)
• ιδιότητες HTML είναι τώρα εξόδου για οριζόντιες γραμμές

Διορθώσεις
• 5 σφάλμα:
• Η σωστή κωδικοποίηση για το κορδόνι αποτέλεσμα είναι τώρα ακόμη και όταν χρησιμοποιείται η επιλογή template
• Σταθερή GH # 72, # 74 GH: Όλοι τρόποι για να ρυθμίσετε ένα αναγνωριστικό κεφαλίδα τώρα ακολουθούν το ίδιο σύστημα το οποίο είναι συμβατό με τα αναγνωριστικά HTML (εκτός από το ότι οι κουκίδες δεν επιτρέπεται) (αναφέρεται και πρώτου patch από τον Matti Schneider)
• Σταθερή GH # 73: Το προεπιλεγμένο πρότυπο HTML έχει τώρα μια DOCTYPE και θέτει σωστά την κωδικοποίηση (πρώτου patch από τον Simon Lydell)
• Σταθερή GH # 67: διευθύνσεις URL των στοιχείων σύνδεσης είναι τώρα διέφυγε στο μετατροπέα LaTeX για την αποφυγή προβλημάτων (μπάλωμα από τον Henning Perl)
• Σταθερή GH # 70: Οποιαδήποτε έκδοση του stringex βιβλιοθήκη υποστηρίζεται τώρα (αναφέρθηκαν από τον Simon Lydell)

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

• 2 μικρές αλλαγές:

Δείκτες
• Υποσημείωση μπορεί τώρα να επαναληφθεί (GH επιλύει # 62 και # 63 GH από τον Θεόδωρο Pak που παρείχε το αρχικό μπάλωμα)
• Το πακέτο ακρωνύμιο LaTeX χρησιμοποιείται τώρα για συντομογραφίες (GH επιλύει # 55 από Tim Besard που παρείχε το αρχικό μπάλωμα)

Διορθώσεις
• 3 bug:
• Σταθερή GH # 60: Αριθμοί αναγνωρίζονται πλέον εκτός από τους χαρακτήρες λέξεων κατά τη μετατροπή υπογράμμισης (μπάλωμα του Trevor Wennblom)
• Σταθερή GH # 66: HTML στοιχεία, και τώρα μετατρέπονται σωστά από το μετατροπέα LaTeX (μπάλωμα από τον Henning Perl)
• Σταθερή GH # 57: Καλύτερη διαχείριση έξυπνη απόσπασμα όταν υπογράμμισης είναι αμέσως μετά ή πριν από εισαγωγικά (αναφέρθηκαν από τον Bill Tozier)

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

• Η σελίδα δοκιμές έχει ενημερωθεί ώστε να συμπεριλάβει σχετική φορές στο σημείο αναφοράς, έτσι ώστε να είναι δυνατή η καλύτερη αξιολόγηση της απόδοσης της kramdown (που ζητήθηκε από μεταμοντέρνα).
• Η kramdown Wiki περιέχει τώρα μια λίστα με τις βιβλιοθήκες που εκτείνονται kramdown (ιδέα από μεταμοντέρνες).

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

• 4 μικρές αλλαγές:
• Νέα transliterated_header_ids επιλογή για transliterating κείμενο επικεφαλίδα σε ASCII πριν από τη δημιουργία μιας ταυτότητας επικεφαλίδα η οποία είναι χρήσιμη για τη γλώσσα, όπως του Βιετνάμ (σταθερό GH # 35, ζητήθηκε από Ky Anh)
• Η οντότητα εισαγωγικά & quot? τώρα παίρνει μετατρέπεται σε ισοδύναμο χαρακτήρα όταν entity_output = as_char.
• Μια προειδοποίηση είναι τώρα έξοδος για IALS / ALDS που δεν περιέχουν αποδίδουν defintion.
• HTML εξόδου υποσημείωση αλλάζει για να χρησιμοποιήσετε κατηγορία αντί της rel για να επιτευχθεί (Χ) HTML4 / 5 συμβατότητα

Διορθώσεις
• 3 bug:
• Σταθερή GH # 38: Κωδικοποίηση πρόβλημα για 1,9 / 2,0 λόγω ασυμβίβαστο κωδικοποιήσεις - το string πηγή έχει πλέον μετατραπεί σε UTF-8 πριν από την ανάλυση και μετατρέπεται και πάλι μετά τη μετατροπή (αναφέρθηκαν από τον Simon Lydell)
• Σταθερή RF # 29647: Συντομογραφίες με τα μη λεκτικά πρώτο χαρακτήρα στην αρχή του κειμένου απαγωγής για εξαίρεση (αναφέρθηκαν από τον Stephan Dale)
• Σταθερή RF # 29704: ID καθορίζονται στις κεφαλίδες στυλ ATX δεν ήταν πάντα σωστά ανιχνεύονται (αναφέρθηκαν από τον Kyle Barbour)

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

• 1 μικρή αλλαγή:
• Νέα link_defs επιλογή για προ-ορισμό ορισμούς
• 1 διορθώσετε το σφάλμα:
• Σταθερή έθεσε λάθη στο ATX κεφαλίδες χωρίς κείμενο

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

• Μόνο τα στοιχεία HTML που δεν πρέπει να περιέχει ένα σώμα ( σαν) εξάγονται σε αυτή τη μορφή, όλα τα άλλα στοιχεία που χρησιμοποιούν τώρα μια ρητή ετικέτα κλεισίματος (επιλύει, μεταξύ άλλων θεμάτων τα πράγματα με)
• Καθορισμός ενός μπλοκ IAL πριν από μια λίστα ορισμών λειτουργεί πλέον σωστά
• Fixed bug GH # 30: Αδειάστε το σώμα για τον ορισμό σε μια λίστα ορισμός οδηγήσει σε εξαίρεση (αναφέρθηκαν από τον Mark Johnson)

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

• 2 σημαντικές αλλαγές:
• Κωδικός γλώσσα διευκρινίζεται πλέον μέσω .language-CODELANG αντί lang = "CODELANG»
• Εφαρμόζεται υποστήριξη για την ρύθμιση της γλώσσας σε περιφραγμένο κώδικα γραμμή εκκίνησης μπλοκ (πρώτου patch από Μπραν)
• 1 μικρή αλλαγή:
• Κεφαλίδες με ένα αναγνωριστικό μπορεί να αποτραπεί από την επίδειξη στον πίνακα περιεχομένων με την ανάθεση της τάξης .no_toc σε αυτούς (μπάλωμα από τον Tim Bates)
• 1 διορθώσετε το σφάλμα:
• Αριθμητική αντί του συμβολικού HTML οντότητες είναι τώρα η προεπιλεγμένη εφεδρική (αυτοκόλλητο με Gioele Barabucci)

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

• 2 μικρές αλλαγές:
• HTML χαρακτηριστικά χωρίς αξίες υποστηρίζονται πλέον (διορθώσεις σφαλμάτων RF # 29490 αναφέρθηκαν από το ΝΑΤ Welch)
• HTML χαρακτηριστικά ονόματα τώρα πάντα μετατρέπονται σε πεζά για τη συνοχή

Διορθώσεις
• 5 σφάλμα:
• Σταθερή Έγγραφο # method_missing να δεχθεί snake_cased όνομα της κλάσης (αυτοκόλλητο με tomykaira)
• Διορθώθηκε το πρόβλημα που τους λείπουν σταθερά REXML σε παλαιότερα Ruby 1.8.6 έκδοση (αναφέρθηκαν από τον Dave Everitt)
• Fixed bug # 29520 RF: Ισχύει inline δήλωση μαθηματικά δεν προκαλεί μπλοκ μαθηματικά πια (αναφέρθηκε από Gioele Barabucci)
• Fixed bug # 29521 RF: Η έξοδος μαθηματικά HTML είναι τώρα πάντα συμβατοί XHTML (αναφέρθηκε από Gioele Barabucci)
• Άδειασμα χαρακτηριστικά ID τώρα χειριστεί καλύτερα από τους μετατροπείς HTML και kramdown (αναφέρθηκαν από τον Jorg Sommer)

Αποτύπωση
• 1 τεκμηρίωσης:
• Σταθερή δήλωση έγκυρες επιλογές στο παράδειγμα για γρήγορη σελίδα αναφοράς (αναφέρεται από τον Jorg Sommer)

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

• Προστέθηκε ένα μετατροπέα που εξάγει τον πίνακα περιεχομένων ενός εγγράφου (που ζητήθηκε από Brendan Hay). Σημειώστε ότι αυτό είναι χρήσιμο μόνο αν χρησιμοποιείτε kramdown ως βιβλιοθήκη!
• Διορθώθηκε ένα τυπογραφικό λάθος: Θα πρέπει να --output και δεν --ouput (έμπλαστρο το μεταμοντέρνο)
• Σταθερή μετατροπέα HTML για τη σωστή έξοδο κενές ετικέτες ανοίγματος (μπάλωμα από τον John croisant)
• Fixed bug # 29350 RF: parsing των ετικετών HTML με ακατάλληλα περίπτωση λειτουργεί τώρα
• Fixed bug # 29426 RF: Περιεχόμενο ετικέτες στυλ αντιμετωπίζεται ως πρώτη κείμενο τώρα
• μετατροπέα HTML χρησιμοποιεί τώρα rel αντί rev να είναι συμβατό HTML5 (αυτοκόλλητο με τον Joe Fiorini)
• Σταθερή Ruby 1.9.3 σχετίζονται με προειδοποιήσεις
• Σταθερή HTML parser για να επιλύσετε μια αλλαγή εφαρμογής της Array # delete_if σε Ruby 1.9.3

Απαιτήσεις :

• Ruby