Socrates

Socrates je jednoduchý generátor statické stránky zaměřené na blogy. Můžete psát své příspěvky v oblíbeném formátu prostého textu do jazyka HTML (např Markdown, textilní) a uložit je jako textové soubory na váš pevný disk. Socrates potom je vezme, a vytváří kompletní HTML místo pro vás. Pro volný, dostanete domovskou stránku, která uvádí všechny příspěvky, jednotlivé poštovní stránky, kategorie stránek, archivní stránky, informační stránku a krmení Atom.
Použít
Nejprve je nutné vytvořit nový blog:
Socrates -i blog
Tím se vytvoří adresář blog s jednoduchým blog struktuře:
blog
& nbsp; příspěvky
& Nbsp; 2010-your-post.md
& Nbsp; layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; media
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Adresář příspěvků je místo, kde umístí své příspěvky soubory. Cokoliv s předponou _ nebo. budou ignorovány. layout je vaše základní téma nebo šablony. config.yaml je konfigurační soubor pro celé stránky. Nezapomeňte aktualizovat o soubor s příslušnými informacemi.
Můžete si také vytvořit nový blog v aktuálním pracovním adresáři:
Socrates -i
Když jste připraveni vytvořit vaše stránky, spustit:
Socrates -g blog
Nebo
Socrates -g
na aktuální adresář.
Tím se umístit všechny vygenerované soubory v blogu / nasazení. Pak můžete vzít tento adresář a nahrát na server.
Instalace
Za prvé, nastavit virtuální prostředí a Pip nainstalovat Socrates.
VIRTUALENV ENV --no-site-packages
zdroj ENV / bin / aktivovat
Pip nainstalovat Socrates
Nebo získat nejnovější kód, můžete nainstalovat z GitHub.
Pip instalace -e git: //github.com/honza/socrates.git#egg=socrates
Dalším krokem je instalace šablony. V současné době si můžete vybrat mezi šablonami Django a Jinja2 šablon. Výchozí téma používá Django.
Motiv
Socrates podporuje šablony Django a Jinja2 šablony. Můžete určit, které templating engine, které chcete použít v souboru config.yaml. Existují dvě základní témata v adresáři themes, abyste mohli začít.
Text HTML
Socrates se attemp konvertovat textové soubory do HTML pomocí textového procesoru. Měli byste zadat název textového procesoru v config.yaml. Mělo by být malými písmeny. V současné době podporované procesory:
- Markdown
- Textilní
- ReStructuredText
- HTML (bez úprav text)
Ve výchozím nastavení, Socrates instaluje pouze Markdown textové procesory. Můžete nainstalovat ostatní s PIP:
Pip nainstalovat textil
Pip nainstalovat docutils
Development
Můžete začít jednoduchý vývojový server, která vám pomohou v rozvoji .:
Socrates -r blog
Nebo
Socrates -r
na aktuální adresář.
Documentation
Dokumentace je obsažena v adresáři docs a je napsán v reStructuredText pomocí Sphinx. Dokumentace je snadno čitelné ve standardním textovém editoru. Nicméně, můžete vytvořit HTML verzi, jako je takto:
Pip instalace sphinx
cd docs /
vytvořit html
open _build / html / index.html
Nebo můžete prohlížet online verzi nejnovější dokumentace

Vlastnosti :.

• Známé Django a Jinja2 šablony
• Jednoduché nainstalovat pomocí PIP
• Markdown, reStructuredText, textilní podpora
• Nastavení YAML
• Atom zdroj
• stránky GitHub kompatibilní

Požadavky na :

• Python