Sokratas yra paprastas statinis svetainę generatorius orientuota į dienoraščius. Jūs rašote savo pranešimų jūsų mėgstamiausia paprasto teksto HTML kalba (pvz vadove elektroniniu, tekstilės) ir išsaugokite juos kaip tekstinius failus į savo diską. Sokratas tada priima juos ir sukuria visą HTML puslapį už jus. Nemokamai, gausite namų puslapį, kuriame išvardyti naujausius pranešimus, Single Post puslapių, kategorijų puslapiuose archyvas puslapius, apie puslapį ir Atom.
Naudojimas
Pirma, jums reikia sukurti naują dienoraštį:
Sokrato-i dienoraštį
Tai sukurs Blog Directory su paprasta dienoraščio struktūra:
Dienoraštis
& nbsp; pranešimų
& Nbsp; 2010-your-post.md
& Nbsp; išdėstymas
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; laikmenos
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Pranešimų katalogas yra kur įdėti savo pranešimų failus. Viskas su priešdėliu "_" ar. bus ignoruojamas. išdėstymas yra jūsų pagrindinė tema ar šablonas. config.yaml yra site-wide konfigūracijos failą. Nepamirškite atnaujinti apie failą su tuo susijusią informaciją.
Taip pat galite sukurti naują dienoraštį dabartinėje darbo kataloge:
Sokratas -i
Kai esate pasirengę kurti savo svetainę, galite paleisti:
Sokrato -G dienoraštį
Arba
Sokratas -g
už einamojo katalogo.
Tai bus pastatyti visus sugeneruotus failus dienoraštis / dislokuoti. Tada galite imtis, kad katalogą ir įkelkite jį į savo serverį.
Diegimas
Pirma, sukurti savo virtualią aplinką ir PIP įdiegti Sokratą.
virtualenv ENV no-Site-paketai
šaltinis ENV / bin / įjungti
PIP įdiegti Sokratą
Arba, jei norite gauti naujausią kodą, galite įdiegti iš GitHub.
PIP įdiegti-e git: //github.com/honza/socrates.git#egg=socrates
Kitas žingsnis yra įdiegti savo šablonus. Šiuo metu, galite pasirinkti tarp Django šablonų ir Jinja2 šablonus. Numatytoji tema naudoja Django.
Temos
Sokratas palaiko Django šablonus ir Jinja2 šablonus. Galite nurodyti, kuri šablonų variklis norite naudoti iš config.yaml failą. Yra du pagrindiniai temos TEMŲ kataloge jums pradėti.
tekstas į HTML
Sokratas bus attemp konvertuoti tekstinius failus į HTML naudojant teksto procesorius. Turėtumėte nurodyti teksto procesorius config.yaml vardą. Tai turėtų būti visos mažosios. Šiuo metu palaikomi procesoriai:
- Reklamos kainos
- Tekstilės
- ReStructuredText
- HTML (nemodifikuotos tekstas)
Pagal nutylėjimą, Sokratas įdiegia tik reklamos kainos tekstinių procesorių. Jūs galite įdiegti su pip kitiems:
PIP įdiegti tekstilės
PIP įdiegti docutils
kūrimas
Galite pradėti paprastą plėtros serverio pagalba jums plėtros .:
Sokrato -R dienoraštį
Arba
Sokratas -r
už einamojo katalogo.
Dokumentacija
Dokumentai yra pateikiami per docs ir yra parašyta reStructuredText naudojant Sfinksas. Dokumentai yra lengvai skaitomas standartinio teksto redaktoriumi. Tačiau, jūs galite sukurti HTML versija, kaip taip:
PIP įdiegti Sfinksas
cd docs /
padaryti html
atvira _build / Html / index.html
Arba, jūs galite pamatyti online versija naujausia dokumentus
Įranga :.
- Susipažinęs Django ir Jinja2 šablonai
- Paprasta įdiegti per pip
- reklamos kainos, reStructuredText, tekstilė parama
- yaml konfigūracija
- Atom
- GitHub puslapiai suderinama
Reikalavimai :
- Python
Komentarai nerastas