Socrates

Ο Σωκράτης είναι μια απλή γεννήτρια στατική ιστοσελίδα προσανατολίζονται προς τα blogs. Μπορείτε να γράψετε τις θέσεις σας στο αγαπημένο σας απλό κείμενο σε γλώσσα HTML (π.χ. Markdown, ύφασμα) και να τις αποθηκεύσετε ως αρχεία κειμένου στον σκληρό σας δίσκο. Σωκράτης τους παίρνει στη συνέχεια, και δημιουργεί μια πλήρη ιστοσελίδα HTML για σας. Για δωρεάν, θα πάρετε μια αρχική σελίδα που απαριθμεί τελευταίες θέσεις, και μόνο μετά σελίδες, κατηγορία, σελίδες αρχείων, ένα περίπου σελίδα και μια τροφή άτομο.
Χρήση
Κατ 'αρχάς, θα πρέπει να δημιουργήσετε ένα νέο blog:
Σωκράτης -i blog
Αυτό θα δημιουργήσει ένα blog κατάλογο με μια απλή δομή blog:
blog
& Nbsp? Δημοσιεύσεις
& Nbsp? 2010-your-post.md
& Nbsp? Διάταξη
& Nbsp? Index.html
& Nbsp? Single.html
& Nbsp? Category.html
& Nbsp? ...
& Nbsp? Μέσων
& Nbsp? Style.css
& Nbsp? Config.yaml
& Nbsp? About.md
Ο κατάλογος των μηνυμάτων είναι όπου θα τοποθετήσετε τις θέσεις των αρχείων σας. Οτιδήποτε πρόθεμα _ ή. θα πρέπει να αγνοηθεί. διάταξη είναι βασικό θέμα σας ή ένα πρότυπο. config.yaml είναι ένα αρχείο ρυθμίσεων σε όλη την τοποθεσία. Μην ξεχάσετε να ενημερώσετε το αρχείο σχετικά με τις σχετικές πληροφορίες.
Μπορείτε επίσης να δημιουργήσετε ένα νέο blog στον τρέχοντα κατάλογο εργασίας:
Σωκράτης -i
Όταν είστε έτοιμοι να δημιουργήσετε το site σας, μπορείτε να εκτελέσετε:
Σωκράτης -g blog
Ή,
Σωκράτης -g
για τον τρέχοντα κατάλογο.
Αυτό θα τοποθετήσει όλα τα αρχεία που δημιουργούνται στο blog / ανάπτυξη. Στη συνέχεια μπορείτε να πάρετε τον κατάλογο και ανεβάστε το στο διακομιστή σας.
installation
Πρώτον, έχει συσταθεί εικονικό περιβάλλον σας και PIP εγκατάσταση Σωκράτης.
virtualenv env --no χώρο-πακέτα
πηγή ENV / bin / ενεργοποιήσετε
Pip εγκατάσταση socrates
Ή, για να δείτε τις τελευταίες κώδικα, μπορείτε να εγκαταστήσετε από Github.
PIP εγκαταστήσετε -e git: //github.com/honza/socrates.git#egg=socrates
Το επόμενο βήμα είναι να εγκαταστήσετε τα πρότυπά σας. Προς το παρόν, μπορείτε να επιλέξετε μεταξύ Django πρότυπα και Jinja2 πρότυπα. Το προεπιλεγμένο θέμα χρησιμοποιεί Django.
Θέματα
Σωκράτης υποστηρίζει Django πρότυπα και Jinja2 πρότυπα. Μπορείτε να καθορίσετε ποια προτυποποίησης κινητήρα που θέλετε να χρησιμοποιήσετε στο αρχείο config.yaml. Υπάρχουν δύο βασικά θέματα στον κατάλογο θεμάτων για να ξεκινήσετε.
Κείμενο σε HTML
Σωκράτης θα Απόπειρα να μετατρέψετε τα αρχεία κειμένου σας σε HTML χρησιμοποιώντας έναν επεξεργαστή κειμένου. Θα πρέπει να καθορίσετε το όνομα του επεξεργαστή κειμένου σε config.yaml. Θα πρέπει να είναι όλα πεζά. Προς το παρόν υποστηρίζονται επεξεργαστές:
- Markdown
- Υφάσματα
- ReStructuredText
- HTML (μη τροποποιημένο κείμενο)
Από προεπιλογή, ο Σωκράτης εγκαθιστά μόνο τους επεξεργαστές κειμένου Markdown. Μπορείτε να εγκαταστήσετε τους άλλους με PIP:
Pip εγκαταστήσετε κλωστοϋφαντουργίας
Pip εγκατάσταση docutils
Ανάπτυξη
Μπορείτε να ξεκινήσετε μια απλή διακομιστή ανάπτυξης για να σας βοηθήσει στην ανάπτυξη .:
Σωκράτης -r blog
Ή,
Σωκράτης -r
για τον τρέχοντα κατάλογο.
Τεκμηρίωση
Η τεκμηρίωση περιέχεται μέσα στον κατάλογο docs και είναι γραμμένο σε reStructuredText χρησιμοποιώντας Σφίγγα. Η τεκμηρίωση είναι εύκολα διαβάζεται σε ένα συνηθισμένο επεξεργαστή κειμένου. Ωστόσο, μπορείτε να δημιουργήσετε μια έκδοση HTML, όπως έτσι:
Pip εγκαταστήσετε σφίγγα
cd docs /
κάνει html
ανοιχτή _build / HTML / index.html
Ή, μπορείτε να προβάλετε την ηλεκτρονική έκδοση της τελευταίας τεκμηρίωσης

Χαρακτηριστικά :.

• Familiar Django και Jinja2 πρότυπα
• Απλή εγκατάσταση μέσω pip
• Markdown, reStructuredText, Υφάσματα υποστήριξη
• διαμόρφωση YAML
• Atom τροφοδοσία
• Github σελίδες συμβατά

Απαιτήσεις :

• Python