Socrates

Sokrates ist eine einfache statische Website-Generator in Richtung Blogs ausgerichtet. Sie schreiben Ihre Beiträge in Ihrem Lieblings-Klartext in HTML-Sprache (zB Markdown, Textil) und speichern Sie sie als Textdatei auf Ihrer Festplatte. Sokrates nimmt sie dann, und erstellt eine vollständige HTML-Website für Sie. Kostenlos, erhalten Sie eine Homepage, die neusten Beiträge, einzelne Post-Seiten, Kategorie Seiten, Archiv-Seiten, eine Seite zu und ein Atom-Feed aufgelistet bekommen.
Verwendung
Zuerst müssen Sie einen neuen Blog zu erstellen:
socrates -i Blog
Dies wird ein Blog-Verzeichnis mit einem einfachen Blog Struktur zu schaffen:
blog
& Nbsp; Beiträge
& Nbsp; 2010-your-post.md
& Nbsp; Layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; Medien
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Die Beiträge Verzeichnis ist, wo Sie Ihre Beiträge Dateien zu platzieren. Alles, was mit dem Präfix _ oder. ignoriert. Layout ist Ihr Grundthema oder eine Vorlage. config.yaml ist eine Site-weite Konfigurationsdatei. Vergessen Sie nicht, die Datei über die relevanten Informationen zu aktualisieren.
Sie können auch einen neuen Blog im aktuellen Arbeitsverzeichnis:
socrates -i
Wenn Sie bereit sind, Ihre Website zu generieren sind, führen Sie:
socrates -g Blog
Oder
socrates -g
zum aktuellen Verzeichnis.
Dadurch werden alle erzeugten Dateien in Blog platzieren / deploy. Sie können dann das Verzeichnis und laden Sie es auf Ihren Server.
Installation
Zunächst richten Sie Ihre virtuelle Umgebung und Pip Sokrates installieren.
virtualenv env --no-site-packages
Quelle env / bin / aktivieren
pip socrates installieren
Oder, um den neuesten Code zu bekommen, können Sie von Github zu installieren.
pip installieren -e git: //github.com/honza/socrates.git#egg=socrates
Der nächste Schritt ist, um Ihre Vorlagen zu installieren. Im Moment können Sie zwischen Django Vorlagen und Jinja2 Vorlagen auswählen. Das Standard-Theme verwendet Django.
Themen
Socrates unterstützt Django Vorlagen und Jinja2 Vorlagen. Sie können festlegen, welche Template-Engine, die Sie in der config.yaml Datei verwenden möchten. Es gibt zwei grundlegende Themen der Themen Verzeichnis Sie loslegen.
Text nach HTML
Sokrates wird attemp, um Ihren Text-Dateien in HTML zu konvertieren mit einem Textverarbeitungsprogramm. Sie sollten den Namen der Textverarbeitung in config.yaml angeben. Es sollte in Kleinbuchstaben sein. Derzeit unterstützte Prozessoren:
- Markdown
- Textil
- ReStructuredText
- HTML (unmodifizierten Text)
Standardmäßig Sokrates installiert nur die Markdown-Text-Prozessoren. Sie können die anderen mit pip installieren:
pip Textil installieren
pip docutils installieren
Entwicklung
Sie können eine einfache Entwicklungsserver, um Sie in der Entwicklungshilfe zu starten .:
socrates -r Blog
Oder
socrates -r
zum aktuellen Verzeichnis.
Dokumentation
Die Dokumentation ist im Verzeichnis docs enthalten und wird in reStructuredText mit Sphinx geschrieben. Die Dokumentation ist leicht in einem Standard-Texteditor lesen. Allerdings können Sie eine HTML-Version wie so aufbauen:
pip sphinx installieren
cd docs /
machen html
offene _build / html / index.html
Oder Sie können die Online-Version der aktuellen Dokumentation anzusehen

Eigenschaften .

• Familiar Django und Jinja2 Vorlagen
• Einfache Installation über pip
• Markdown, reStructuredText, Textil Unterstützung
• YAML Konfiguration
• Atom-Feed
• Github Seiten kompatibel

Anforderungen :

• Python