mezzanine-mdown

πατάρι-mdown παρέχει widgets και φίλτρα για πατάρι που επιτρέπουν στους διαχειριστές να χρησιμοποιήσετε μορφοποίηση markdown για να δημιουργήσετε το περιεχόμενο του ιστοτόπου τους, αντί να χρησιμοποιούν τον επεξεργαστή tinymce για τη δημιουργία HTML που χρησιμοποιούνται στις πλούσιες τύπους περιεχομένου, όπως είναι πλούσια σελίδες και blog θέσεις.
installation
Αποκτήστε το πακέτο
pip:
χρήστης @ home: ~ $ pip εγκατάσταση πατάρι-mdown
easy_install:
χρήστης @ home: ~ $ easy_install πατάρι-mdown
Προετοιμασία της στατικής μέσα ενημέρωσης
Χρησιμοποιώντας την εξαιρετική staticfiles app, στατικά αρχεία mdown πρέπει να ενταχθεί αυτόματα.
Εάν η staticfiles app δεν είναι το στυλ σας, θα χρειαστεί να εντοπίσετε τη θέση εγκατάσταση του πακέτου mdown (συνήθως το site-πακέτα κατάλογο διερμηνέα python σας) και να αντιγράψετε / συμβολικό σύνδεσμο mdown / στατικές / mdown στο έργο κατάλογο site_media σας.
Διαμόρφωση
Πρώτα απ 'όλα, να προσθέσετε mdown στη λίστα των INSTALLED_APPS στην ενότητα ρυθμίσεις του σχεδίου σας.
Με την εγκατάσταση του app, θα πρέπει να κάνει μια-δυο επιλογές. Θα πρέπει να καθορίσετε το RICHTEXT_WIDGET_CLASS και τις αξίες RICHTEXT_FILTER στην ενότητα ρυθμίσεις σας.
RICHTEXT_WIDGET_CLASS
Αυτό το πακέτο παρέχει δύο επιλογές για τη ρύθμιση αυτή.
mdown.forms.WmdWidget
& Nbsp? Ενεργοποιεί το WMD επεξεργαστή εμπλουτισμένου κειμένου. (Προτείνεται)
mdown.forms.PlainWidget
& Nbsp? Χρησιμοποιήστε ένα απλό Textarea (όχι πλούσιο πρόγραμμα επεξεργασίας κειμένου).
RICHTEXT_FILTER
Και πάλι, υπάρχουν δύο επιλογές για τη ρύθμιση αυτή.
mdown.filters.codehilite
& Nbsp? Αποδίδει το περιεχόμενο χρησιμοποιώντας markdown με την codehilite επέκταση ενεργοποιηθεί.
mdown.filters.plain
& Nbsp? Αποδίδει το περιεχόμενο χρησιμοποιώντας μορφοποίηση markdown βανίλια.
πρόσθετα βήματα
Pygments Στυλ
Χρησιμοποιώντας τις pygments_styles εντολή διαχείρισης μπορείτε να δημιουργήσετε CSS για colorize τμήματα κώδικα θα αναλυθεί από το φίλτρο codehilite.
Σημείωση: Αυτό απαιτεί pygments να εγκατασταθεί (χρήση pip εγκαταστήσετε pygments ή easy_install pygments να χρησιμοποιήσετε αυτή τη δυνατότητα).
Να επικαλεστεί την εντολή χωρίς args για να δείτε ένα μήνυμα για την χρήση και τον κατάλογο των διαθέσιμων χρωμάτων στο σύστημά σας .:
χρήστης @ home: ~ / mysite $ ./manage.py pygments_styles
Χρήση: ./manage.py pygments_styles
Διαθέσιμο συνδυασμούς χρωμάτων:
& Nbsp? Borland
& Nbsp? BW
& Nbsp? Πολύχρωμα
& Nbsp? Προεπιλογή
& Nbsp? ... [Απόκομμα] ...
Επικαλούμενη με το όνομα του καθεστώτος ως επιχείρημα θα εκτυπώσει το CSS στο stdout, το οποίο μπορείτε να ανακατευθύνει σε ένα αρχείο όπως αυτό:
χρήστης @ home: ~ / mysite $ ./manage.py pygment_styles πολύχρωμο> site_media / CSS / pygments.css
Επιπλέον προς αυτή την ενιαία μέθοδο σύστημα, η εντολή αποδέχεται επίσης την --all σημαία, η οποία θα δημιουργήσει στυλ για όλες τις διαθέσιμες, αλλά με μία βασική διαφορά: Κάθε σύστημα πρόθεμα με το όνομά του ως το όνομα της κλάσης CSS. Αυτό είναι χρήσιμο κατά τη διάρκεια της ανάπτυξης θέμα, όπως μπορείτε να μεταβείτε γρήγορα pygments συστήματα ακριβώς με τον καθορισμό της κατηγορίας στην ετικέτα του σώματος με την επιλογή σας από το σύστημα χωρίς να χρειάζεται να αναγεννηθεί αρχεία CSS συνεχώς.
Μόλις έχετε ένα αρχείο CSS που δημιουργούνται, απλά να το προσθέσετε στη βάση πρότυπο το site σας για να πάρετε τον κωδικό σας «αρκετά» τυπωμένο.
Ενημέρωση Θέμα Πρότυπα
Θέματα που βασίζεται στο προεπιλεγμένο θέμα και έχουν δημιουργηθεί πριν από την 0.11.3 απελευθέρωση Mezzanine του πιθανότατα δεν θα έχουν το richtext_filter εφαρμόζεται σε πλούσιο περιεχόμενο. Για να το διορθώσετε αυτό, πρέπει απλά να ενημερώσετε τα πρότυπα για αυτούς τους τύπους περιεχομένου, έτσι ώστε να χρησιμοποιείται το φίλτρο.
Για παράδειγμα, το προεπιλεγμένο θέμα, η templates / blog / blog_post_detail.html είχε μια γραμμή που ενημερώθηκε από ::
{{Blog_post.content | ασφαλές}}
για ::
{{Blog_post.content | richtext_filter | ασφαλές}}
. Απλά εξασφαλίζουν ότι το ασφαλές φίλτρο έρχεται μετά την richtext_filter

Απαιτήσεις :

• Python