Socrates

Sokrates bloglar yönelik basit bir statik sitesi jeneratör olduğunu. HTML dili (örneğin Markdown, tekstil) en sevdiğiniz düz metin mesajlarınızı yazmak ve sabitdisk metin dosyaları olarak kaydedebilirsiniz. Sokrates sonra onları alır, ve sizin için tam bir HTML sitesi oluşturur. Ücretsiz, son mesajları, tek direkli sayfaları, kategori sayfaları, arşiv sayfaları, bir yaklaşık sayfa ve bir atom besleme listeleyen bir ana sayfa alacak.
Kullanım
İlk olarak, yeni bir blog oluşturmanız gerekir:
Sokrates'in -i günlüğü
Bu basit bir blog yapısına sahip bir blog dizini oluşturur:
Blog
& Nbsp; mesajlar
& Nbsp; 2010-your-post.md
& Nbsp; düzen
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& Nbsp; medya
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Eğer mesajlar dosyaları yerleştirmek nerede mesaj dizin. Her şey ya _ öneki. göz ardı edilecektir. düzeni temel tema veya bir şablon olduğunu. config.yaml bir site çapında yapılandırma dosyasıdır. Ilgili bilgiler hakkında dosyasını güncellemek için unutmayın.
Ayrıca, geçerli çalışma dizini yeni bir blog oluşturabilirsiniz:
socrates -i
Eğer sitenizi oluşturmak için hazır olduğunuzda, çalıştırmak:
Sokrates'in -g günlüğü
Ya da,
socrates -g
Geçerli dizin.
Bu / blog tüm oluşturulan dosyaları yerleştirmek dağıtmak olacaktır. Daha sonra bu dizin almak ve sunucuya yükleyebilirsiniz.
Kurulum
İlk olarak, sanal ortamı kurmak ve Sokrates yükleyin pip.
virtualenv env --no-sitesi-paketler
Kaynak env / bin / etkinleştirmek
socrates yüklemek pip
Ya da, son kodu almak için, Github yükleyebilirsiniz.
-e git'e yüklemek pip: //github.com/honza/socrates.git#egg=socrates
Bir sonraki adım şablonları yüklemektir. Şu anda, Django şablonlar ve Jinja2 şablonları arasında seçim yapabilirsiniz. Varsayılan tema Django kullanır.
Temalar
Sokrates Django şablonları ve Jinja2 şablonları destekler. Sen config.yaml dosyasında kullanmak istediğiniz çiftleşmiş motoru belirtebilirsiniz. Başlamak için temalar dizinde iki temel temalar vardır.
HTML Metin
Sokrates bir metin işlemci kullanarak HTML içine metin dosyaları dönüştürmek için gayret etmekte edecektir. Sen config.yaml metin işlemci adını belirtmeniz gerekir. Tüm küçük olmalıdır. Şu anda desteklenen işlemciler:
- Markdown
- Tekstil
- ReStructuredText
- HTML (değiştirilmemiş metin)
Varsayılan olarak, Sokrates, sadece Markdown metin işlemcileri yükler. Sen pip ile diğerleri yükleyebilirsiniz:
tekstil yüklemek pip
docutils yüklemek pip
Geliştirme
Siz geliştirme size yardım etmek için basit bir geliştirme sunucusu başlayabilirsiniz .:
Sokrates'in r günlüğü
Ya da,
socrates -r
Geçerli dizin.
Belgeler
dokümantasyon docs dizini içinde bulunan ve Sfenks kullanarak reStructuredText yazılmıştır. belgeler kolayca standart bir metin editörü okunur. Ancak, bunu gibi bir HTML versiyonu inşa edebilirsiniz:
sphinx yüklemek pip
cd docs /
html yapmak
Açık _build / html / index.html
Ya da, son belgelerin çevrimiçi sürümünü görebilirsiniz

Özellikler :.

• Tanıdık Django ve Jinja2 şablonları
• pip üzerinden yüklemek Basit
• Markdown, reStructuredText, Tekstil desteği
• YAML yapılandırma
• Atom besleme
• Github sayfaları uyumlu

Gereksinimler :

• Python