Markowik

Markowik είναι μια εφαρμογή που μετατρέπει Python Markdown μορφοποιημένο κείμενο στο Google Code Wiki.
Markowik είναι σε θέση να μετατρέψει τα περισσότερα κατασκευάσματα Markdown στο Google Code Wiki (GCW) ισοδύναμα του. Αντί της απαρίθμησης όλες τις υποστηριζόμενες μετατροπές, παρακαλώ ρίξτε μια ματιά στη σουίτα δοκιμών Markowik και δείχνουν την υπόθεσή του.
installation
Εκτέλεση:
Pip εγκαταστήσετε markowik
ή:
easy_install markowik
Μπορείτε επίσης να χρησιμοποιήσετε Markowik χωρίς εγκατάσταση, όπως περιγράφεται στο Συμβολή.
Γραμμή εντολών Χρήση
Από το αποτέλεσμα της βοήθειας:
Χρήση: markowik [-h] [--mx [MX [MX ...]]] [--image-baseURL URL]
& Nbsp? [- Html-εικόνες] [--encoding ΚΩΔΙΚΟΠΟΙΗΣΗ] [--quiet]
& Nbsp? Infile [outfile]
Μετατροπή Markdown στο Google Code Wiki.
επιχειρήματα θέσης:
& Nbsp? Infile αρχείο markdown
& Nbsp? Outfile αρχείο wiki (προεπιλογή: stdout)
προαιρετικά επιχειρήματα:
& Nbsp? -h, --help Εμφανιστεί αυτό το μήνυμα βοήθειας και έξοδος
& Nbsp? - MX [MX [MX ...]] επεκτάσεις markdown να ενεργοποιήσετε
& Nbsp? - Εικόνας baseURL βασική διεύθυνση URL για να προσθέσετε το πρόθεμα σε σχετικές θέσεις εικόνα
& Nbsp? - Html-εικόνες χρησιμοποιείτε πάντα HTML για εικόνες
& Nbsp? - Κωδικοποίηση ΚΩΔΙΚΟΠΟΙΗΣΗ κωδικοποίηση της εισόδου και εξόδου (προεπιλογή: UTF8)
& Nbsp? - Ήσυχη απενεργοποίηση μηνύματα πληροφοριών
Επεκτάσεις Markdown μπορεί να δοθεί ομοίως ως προς την Python Markdown (PyMD) εργαλείο γραμμής εντολών, με την εξαίρεση ότι η ατομική επεκτάσεις πρέπει να διαχωρίζονται από ένα διάστημα:
markowik πίνακες εισροών --mx def_list
Υποστηρίζονται αυτήν τη στιγμή (δηλαδή το εισόδημα) επεκτάσεις είναι abbr, πίνακες, και def_list. Άλλες επεκτάσεις γενικά θα πρέπει να εργαστεί πάρα πολύ, αλλά μπορεί να δώσει απρόσμενα αποτελέσματα στο ειδικά διαμορφωμένο κείμενο wiki.
Όσον αφορά τους επιλογή --html-εικόνες, δείτε τις παρακάτω εξηγήσεις στο Περιορισμοί.
Προγραμματική Χρήση
Markowik υλοποιείται σε Python. Η μονάδα markowik παρέχει μια λειτουργία που ονομάζεται μετατρέψετε. Σημασιολογικά είναι παρόμοια με τη γραμμή εντολών (επιχειρήματα λέξη-κλειδί αντιστοιχούν σε επιλογές γραμμής εντολών). Εδώ είναι ένα σύντομο παράδειγμα χρήσης:
>>> Markowik εισαγωγής
>>> Markowik.convert («Μερικοί * * markdown κείμενο ...", mx = [«πίνακες»])
u'Some _markdown_ κείμενο ... »
Σελίδα Pragmas
GCW pragmas σελίδα μπορεί να ρυθμιστεί σε Διακριτικών αρχεία προέλευσης ως μετα-δεδομένα με τη μορφή που ορίζεται από την PyMD μετα επέκταση:
>>> Src = "" "Περίληψη: περίληψη σελίδα
... Ετικέτες: μερικοί, ετικέτες
...
... Εδώ ξεκινάει την * σελίδα * ..
... "" "
>>> Markowik.convert εκτύπωσης (SRC, mx = [«μετα»])
#summary περίληψη σελίδα
#labels κάποιες ετικέτες

Εδώ ξεκινάει το _page_ ..
Σημειώστε ότι η μετα-επέκταση πρέπει να ενεργοποιηθεί ρητά, δηλαδή από προεπιλογή Markowik δεν αναγνωρίζει τη σελίδα pragmas

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

< ul>

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

• Βελτιωμένη τεκμηρίωση
• Μικρά διορθώσεις.

Απαιτήσεις :

• Python

Περιορισμοί :

• GCW δεν μπορεί να εκφράσει όλες σήμανσης δυνατόν Διακριτικών. Αυτό σημαίνει Markdown αρχεία προέλευσης πρέπει να γράφεται με τους ακόλουθους περιορισμούς στο μυαλό.


• διευθύνσεις URL σε συνδέσμους και εικόνες:
• διευθύνσεις URL που χρησιμοποιούνται για τις συνδέσεις ή πηγών εικόνας πρέπει να είναι απόλυτη και πρέπει να έχει ένα ειδικό πρωτόκολλο για να αναγνωριστεί από GCW. Ειδικότερα, κάθε διεύθυνση URL πρέπει να ξεκινά με http: //, https: // ή ftp: //. Markowik ματαιώνει τη μετατροπή, εάν διαπιστώσει διευθύνσεις URL που δεν ταιριάζουν με αυτές τις απαιτήσεις.


• Typefacing στο σύνδεσμο Ονόματα:
• GCW δεν υποστηρίζει typefacing σε ονόματα συνδέσμων. Για παράδειγμα GCW καθιστά το όνομα του συνδέσμου σε [http://foo.com _Foo_] κυριολεκτικά, δηλαδή ως _Foo_. Ωστόσο, GCW αναγνωρίζει typefacing σε συνδέσμους HTML, δηλαδή & lt? a href = & quot? http: //foo.com"? & Gt? _Foo_ & Lt? / A & gt? τονίζεται σωστά. Για το λόγο αυτό Markdown συνδέσεις με ένθετη typefacing όπως [* Foo *] (http://foo.com) θα μετατραπεί σε HTML συνδέσμους. Ως αποτέλεσμα, οι ετικέτες σύνδεση με ορισμένους ειδικούς χαρακτήρες που πρέπει να διαφύγει στο GCW χρήση βαρεία (`) δείκτες θα οδηγήσει επίσης σε HTML συνδέσμους.


• Φωλιά παράγραφοι:
• GCW δεν υποστηρίζει πραγματικά πολλαπλά ένθετα σημεία (π.χ. σε λίστες ή blockquotes). Markowik προσομοιώνει πολλαπλά ένθετα παραγράφους διαχωρίζοντας τους με έναν & lt? br / & gt? (Η οποία μιμείται οπτικά σημεία, αλλά δεν σπάσει το περιβάλλον ωοτοκίας).


• Εικόνες:
• Markdown επιτρέπει να εκφράσουν εναλλακτικές και τίτλο κείμενα για τις εικόνες. Σύνταξη εικόνα GCW δεν υποστηρίζει αυτό. Ο μόνος τρόπος για να διατηρήσουμε αυτά τα κείμενα είναι να χρησιμοποιήσετε απλή HTML & lt? img & gt? ετικέτες. Η επιλογή --html-εικόνων επιτρέπει αυτήν τη λύση.
• Ένα άλλο ζήτημα είναι ότι GCW αναμένει την εικόνα URLs για να τελειώσει με μια επέκταση της εικόνας τύπου αρχείου. Markowik προσθέτει επεκτάσεις τεχνητή εικόνα αν είναι απαραίτητο, για παράδειγμα http://foo.bar/image αλλάζει σε http://foo.bar/image?x=x.png.


• Συντομογραφίες:
• GCW δεν έχει καμία σήμανση για συντομογραφίες ούτε υποστηρίζουν την ετικέτα HTML & lt? abbr & gt ;. Markowik μετατρέπει συντομογραφίες να & lt? βαθμονόμησης & gt? -Στοιχεία ποιο είδος μιμείται συντομογραφίες (σε περιορισμένη κλίμακα φυσικά)
.

• HTML:
• Κάθε μορφή απλού HTML που συμβαίνουν σε μια πηγή Markdown καταλήγει κυριολεκτικά σε GCW (με εξαίρεση το περιεχόμενο των ετικετών ανοίγματος-επίπεδο). Αυτό σημαίνει ότι η πηγή Markdown πρέπει να περιέχει μόνο HTML υποστηρίζεται από GCW. Ένα άλλο συμπέρασμα είναι ότι οι διευθύνσεις URL που χρησιμοποιείται σε απλή ετικέτες HTML δεν ελέγχονται για τη συμβατότητα GCW. Με άλλα λόγια: όταν χρησιμοποιούν πρώτες HTML είστε μόνοι σας
!