MkDocs

MkDocs χρησιμοποιεί τις ίδιες αρχές όπως και κάθε άλλο στατική ιστοσελίδα γεννήτρια γύρω.
Απαιτεί την προγραμματιστής για να επεξεργαστείτε ένα αρχείο ρυθμίσεων (MKDocs χρησιμοποιεί YAML γι 'αυτό), να δημιουργήσετε πρότυπα σελίδων (μέσω Jinja2), και προσθέστε περιεχόμενο του σε ένα ειδικό φάκελο (όπως αρχεία Markdown).
Στη συνέχεια μπορείτε να ανοίξετε το Python CLI τρέξει μερικές εντολές και να συγκεντρώσει ένα τελικό ιστοσελίδα HTML από όλους τους πόρους του.
Αν θέλει να ενημερώσει κάτι, μπορεί να κάνει όλες τις αλλαγές του στην αρχική πηγή και την εκ νέου σύνταξη του τόπου μέσω της κονσόλας.
Το τελικό προϊόν είναι μια συλλογή HTML, CSS, JS και στατικά στοιχεία του ενεργητικού που μπορούν να φιλοξενηθούν με οποιοδήποτε τύπο του διακομιστή Web που διατίθενται στην αγορά.
MkDocs υποστηρίζει απεριόριστο αριθμό σελίδων, αυτόματη δημιουργία μενού, τελική ιστοσελίδας θέματα, σελίδα μετα-δεδομένα, και έρχεται με μια βασική δομή του έργου κατά την οποία για να ξεκινήσετε.
MkDocs συνεργάζεται με τις δύο εκδόσεις της γλώσσας Python, 2.x και 3.x

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

< li> Render 404.html αρχεία, εάν υπάρχουν για την τρέχουσα θέμα.
• Διόρθωση bug:
• Long nav μπαρ, τραπέζι απόδοση και τον κωδικό τονίζοντας MkDocs και ReadTheDocs θέματα.
• Ένα ζήτημα με τον κωδικό google_analytics.
• Κατάργηση __pycache__ από την πίσσα πακέτο.
• Markdown συνδέσεις που πηγαίνουν σε μια άγκυρα στην τρέχουσα σελίδα.
• Μην προσθέτετε prettyprint τάξεις και σε όλα τα CSS HTML, μόνο το προσθέσετε στο θέμα MkDocs.
• ενότητα Display τίτλους στο θέμα ReadTheDocs.
• Χρησιμοποιήστε τον παρατηρητή των εκλογών στο φύλακα έτσι ανοικοδόμηση έργων για συστήματα αρχείων χωρίς inotify.
• Βελτίωση εξόδου σφάλμα για συνηθισμένα σφάλματα που σχετίζονται με τη διαμόρφωση.

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

• Render αρχεία 404.html εφόσον υπάρχουν για την τρέχον θέμα.
• Διόρθωση bug:
• Long nav μπαρ, τραπέζι απόδοση και τον κωδικό τονίζοντας MkDocs και ReadTheDocs θέματα.
• Ένα ζήτημα με τον κωδικό google_analytics.
• Κατάργηση __pycache__ από την πίσσα πακέτο.
• Markdown συνδέσεις που πηγαίνουν σε μια άγκυρα στην τρέχουσα σελίδα.
• Μην προσθέτετε prettyprint τάξεις και σε όλα τα CSS HTML, μόνο το προσθέσετε στο θέμα MkDocs.
• ενότητα Display τίτλους στο θέμα ReadTheDocs.
• Χρησιμοποιήστε τον παρατηρητή των εκλογών στο φύλακα έτσι ανοικοδόμηση έργων για συστήματα αρχείων χωρίς inotify.
• Βελτίωση εξόδου σφάλμα για συνηθισμένα σφάλματα που σχετίζονται με τη διαμόρφωση.

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

• Render αρχεία 404.html εφόσον υπάρχουν για την τρέχον θέμα.
• Διόρθωση bug:
• Long nav μπαρ, τραπέζι απόδοση και τον κωδικό τονίζοντας MkDocs και ReadTheDocs θέματα.
• Ένα ζήτημα με τον κωδικό google_analytics.
• Κατάργηση __pycache__ από την πίσσα πακέτο.
• Markdown συνδέσεις που πηγαίνουν σε μια άγκυρα στην τρέχουσα σελίδα.
• Μην προσθέτετε prettyprint τάξεις και σε όλα τα CSS HTML, μόνο το προσθέσετε στο θέμα MkDocs.
• ενότητα Display τίτλους στο θέμα ReadTheDocs.
• Χρησιμοποιήστε τον παρατηρητή των εκλογών στο φύλακα έτσι ανοικοδόμηση έργων για συστήματα αρχείων χωρίς inotify.
• Βελτίωση εξόδου σφάλμα για συνηθισμένα σφάλματα που σχετίζονται με τη διαμόρφωση.

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

• Render αρχεία 404.html εφόσον υπάρχουν για την τρέχον θέμα.
• Διόρθωση bug:
• Long nav μπαρ, τραπέζι απόδοση και τον κωδικό τονίζοντας MkDocs και ReadTheDocs θέματα.
• Ένα ζήτημα με τον κωδικό google_analytics.
• Κατάργηση __pycache__ από την πίσσα πακέτο.
• Markdown συνδέσεις που πηγαίνουν σε μια άγκυρα στην τρέχουσα σελίδα.
• Μην προσθέτετε prettyprint τάξεις και σε όλα τα CSS HTML, μόνο το προσθέσετε στο θέμα MkDocs.
• ενότητα Display τίτλους στο θέμα ReadTheDocs.
• Χρησιμοποιήστε τον παρατηρητή των εκλογών στο φύλακα έτσι ανοικοδόμηση έργων για συστήματα αρχείων χωρίς inotify.
• Βελτίωση εξόδου σφάλμα για συνηθισμένα σφάλματα που σχετίζονται με τη διαμόρφωση.

Απαιτήσεις :

• Τζίντζα ​​2.7.1 ή νεότερη έκδοση
• Markdown 2.3.1 ή νεότερη έκδοση
• PyYAML 3.1 ή νεότερη έκδοση