Socrates

Socrates ay isang simpleng generator static na site na nilalayon sa mga blog. Isulat mo ang iyong mga post sa iyong mga paboritong plain text sa wikang HTML (hal Markdown, ukol sa paghabi) at i-save ang mga ito bilang teksto ng mga file sa iyong harddrive. Pagkatapos ay tumatagal ng Socrates ang mga ito, at lumilikha ng isang buong site HTML para sa iyo. Para sa libreng, makakakuha ka ng isang home page na naglilista ng mga pinakabagong post, nag-iisang pahina post, mga pahina ng kategorya, mga pahina ng archive, isang pahina tungkol sa isang at atom feed.
Paggamit
Una, kailangan mo upang lumikha ng bagong blog:
Socrates -i blog
Ito ay bubuo ng isang direktoryo ng blog na may isang simpleng istraktura blog:
blog
& Nbsp; mga post
& 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
Ang direktoryo ng mga post ay kung saan mo ilalagay ang iyong mga file post. Anumang bagay may prefix na _ o. ay hindi papansinin. Layout ng ay ang iyong pangunahing tema o isang template. config.yaml ay isang buong site configuration file. Huwag kalimutan na i-update ang tungkol sa file na may-katuturang impormasyon.
Maaari ka ring lumikha ng isang bagong blog sa kasalukuyang direktoryo ng pagtatrabaho:
Socrates -i
Kapag handa ka na upang bumuo ng iyong site, patakbuhin mo ang:
Socrates -g blog
O kaya naman,
Socrates -g
para sa kasalukuyang direktoryo.
Ito ay ilagay ang lahat ng mga nabuong file sa blog / deploy. Pagkatapos ay maaari mong gumawa ng directory na iyon at i-upload ito sa iyong server.
Pag-install
Una, i-set up ang iyong virtual na kapaligiran at buto ng bungang-kahoy-install ng Socrates.
virtualenv env --no-site-pakete
pinagmulan env / bin / isaaktibo ang
buto ng bungang-kahoy-install ng Socrates
O kaya naman, upang makuha ang pinakabagong code, maaari mong i-install mula sa Github.
buto ng bungang-kahoy-install ng Git -e: //github.com/honza/socrates.git#egg=socrates
Ang susunod na hakbang ay upang i-install ang iyong mga template. Sa sandaling ito, maaari kang pumili sa pagitan ng Django mga template at mga template Jinja2. Ang default na tema ay gumagamit ng Django.
Mga tema
Socrates ay sumusuporta Django mga template at mga template Jinja2. Maaari mong tukuyin kung aling mga templating engine ang nais mong gamitin sa config.yaml file. Mayroong dalawang mga pangunahing tema sa direktoryo ng tema upang makapagsimula ka.
Teksto sa HTML
Socrates ay attemp na i-convert ang iyong mga file ng teksto sa HTML gamit ang isang teksto processor. Dapat mong tukuyin ang pangalan ng teksto processor sa config.yaml. Dapat ito ay lahat ng maliit na. Sa kasalukuyan sinusuportahan processors:
- Markdown
- Tela
- ReStructuredText
- HTML (hindi nababago ang TinyLine teksto)
Sa pamamagitan ng default, i-install lamang Socrates ang processor Markdown teksto. Maaari mong i-install ang iba sa buto ng bungang-kahoy:
buto ng bungang-kahoy-install ukol sa paghabi
buto ng bungang-kahoy-install docutils
Pag-unlad
Maaari kang magsimula ng isang simpleng server unlad upang tulungan ka sa pag-unlad .:
Socrates -r blog
O kaya naman,
Socrates -r
para sa kasalukuyang direktoryo.
Documentation
Dokumentasyon ay nasa loob ng doc direktoryo at nakasulat sa reStructuredText gamit Sphinx. Dokumentasyon ay madaling basahin sa isang karaniwang text editor. Gayunpaman, maaari kang bumuo ng HTML na bersyon tulad nito:
buto ng bungang-kahoy-install sphinx
cd docs /
gumawa ng html
bukas _build / html / index.html
O kaya, maaari mong tingnan ang online na bersyon ng pinakabagong dokumentasyon

Mga Tampok :.

• pamilyar Django at Jinja2 template
• Simpleng i-install sa pamamagitan ng buto ng bungang-kahoy
• Markdown, reStructuredText, Tela suporta
• configuration YAML
• Atom feed
• Github pahina tugma ang

Mga Kinakailangan :

• Python