Socrates

Socrates egy egyszerű statikus oldal generátor irányába blogok. Írsz a hozzászólásaidat a kedvenc sima szöveget HTML nyelv (pl Markdown, textil), és mentse őket szöveges fájlokat a merevlemez. Socrates majd elviszi őket, és létrehoz egy teljes HTML site neked. Ingyen, kapsz egy honlapot, amely felsorolja legújabb hozzászólásokat, egyetlen pozíciót oldalak, kategóriaoldalain archív lapokat, egy oldalról szól, és az Atom.
Használat
Először is meg kell, hogy hozzon létre egy új blog:
Szókratész -i blog
Ez létrehoz egy blog könyvtár egy egyszerű blog szerkezete:
blog
& Nbsp; hozzászólása
& Nbsp; 2010-your-post.md
& Nbsp; layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; a média
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
A hozzászólás könyvtár, ahol lesz hely a hozzászólásaidat fájlokat. Bármi előtaggal _ vagy. figyelmen kívül hagyja. elrendezés az alapvető téma vagy a sablon. config.yaml egy globális konfigurációs fájlban. Ne felejtsd el, hogy frissítse a fájlról a vonatkozó információkat.
Ön is létrehozhat egy új blog a jelenlegi munkakönyvtárba:
Szókratész -i
Ha készen áll, hogy létrehoz a helyén, akkor fut:
Szókratész -g blog
Vagy,
Szókratész -g
Az aktuális könyvtárban.
Ez a hely a legenerált fájlokat blog / telepíteni. Ezután le lehet venni a könyvtárba, és töltsd fel a szerverre.
Telepítés
Először létre a virtuális környezet és Pip telepíteni Socrates.
virtualenv ENV -no-site-csomagok
forrás ENV / bin / aktiválni
pip telepíteni Szókratész
Vagy, hogy a legfrissebb kódot, telepítheti a GitHub.
pip telepíteni -e git: //github.com/honza/socrates.git#egg=socrates
A következő lépés, hogy telepítse a sablonokat. Abban a pillanatban, akkor választhat a Django sablonok és Jinja2 sablonok. Az alapértelmezett téma használ Django.
Témák
Socrates támogatja Django sablonok és Jinja2 sablonok. Megadhatja, hogy mely sablonozó motort használni kívánt a config.yaml fájlt. Két alapvető témák a témák könyvtár a kezdéshez.
szöveg a HTML
Socrates majd teszünk kísérletet arra, hogy a Szöveg fájlok HTML segítségével a szöveges processzort. Meg kell adnia a nevét a szöveg processzor config.yaml. Meg kell csupa kisbetűvel. A jelenleg támogatott processzorok:
- Markdown
- Textil
- ReStructuredText
- HTML (nem módosított szöveg)
Alapértelmezésben Socrates csak telepíti a Markdown szöveget processzorok. Telepítheti a többiek pip:
pip telepíteni textil
pip telepíteni docutils
Fejlesztési
Meg lehet kezdeni egy egyszerű fejlesztési szerver, hogy segítséget fejlesztési .:
Szókratész -r blog
Vagy,
Szókratész -r
Az aktuális könyvtárban.
Dokumentáció
A dokumentáció tartalmazza a docs könyvtárban, és van írva reStructuredText segítségével Sphinx. A dokumentáció könnyen olvasható egy szövegszerkesztővel. Azonban meg lehet építeni egy HTML verzió valahogy így:
pip telepíteni szfinx
cd docs /
hogy html
nyitott _build / html / index.html
Vagy, akkor nézze meg az online változata a legújabb dokumentációt.

Tulajdonságok :

• Ismerős Django és Jinja2 sablonok
• Egyszerű telepítés az pip
• Markdown, reStructuredText, Textil támogatása
• YAML konfiguráció
• Atom feed
• GitHub oldalak kompatibilis

követelmények :

• Python