Socrates

Sokrates er en simpel statisk hjemmeside generator gearet til blogs. Du skriver dine indlæg i din foretrukne almindelig tekst til HTML-sproget (f.eks Markdown, tekstil) og gemme dem som tekst filer på din harddisk. Så Socrates tager dem, og skaber en fuld HTML site for dig. Gratis, vil du få en hjemmeside, der viser nyeste indlæg, enlige indlægssider, kategori sider, arkiv sider, en om side og et atom-feed.
Anvendelse
Først skal du nødt til at oprette en ny blog:
Socrates -i blog
Dette vil skabe en blog directory med en simpel blog struktur:
blog
& nbsp; indlæg
& Nbsp; 2010-your-post.md
& Nbsp; layout
& Nbsp; index.html
& Nbsp; single.html
& Nbsp; category.html
& Nbsp; ...
& nbsp; medier
& Nbsp; style.css
& Nbsp; config.yaml
& Nbsp; about.md
Stillingerne mappe er, hvor du vil placere dine indlæg filer. Alt starter med _ eller. vil blive ignoreret. layout er din grundlæggende tema eller en skabelon. config.yaml er et site-wide konfigurationsfil. Glem ikke at opdatere om fil med relevante oplysninger.
Du kan også oprette en ny blog i den aktuelle arbejdsmappe:
Socrates -i
Når du er klar til at generere dit websted, du kører:
Socrates -G blog
Eller,
Socrates -g
for aktuelle mappe.
Dette vil placere alle de genererede filer i blog / implementere. Du kan derefter tage mappen og uploade den til din server.
Installation
Først oprette din virtuelle miljø og Pip installere Sokrates.
virtualenv env --no-site-pakker
source ENV / bin / aktivere
pip installere socrates
Eller, for at få den nyeste kode, kan du installere fra Github.
pip installere -e git: //github.com/honza/socrates.git#egg=socrates
Det næste skridt er at installere dine skabeloner. I øjeblikket kan du vælge mellem Django skabeloner og Jinja2 skabeloner. Standard tema bruger Django.
Temaer
Socrates understøtter Django skabeloner og Jinja2 skabeloner. Du kan angive, hvilken templating motor du ønsker at bruge i config.yaml filen. Der er to grundlæggende temaer i temaer bibliotek for at komme i gang.
Tekst til HTML
Vil Socrates attemp at konvertere dine tekstfiler i HTML ved hjælp af en tekst processor. Du skal angive navnet på teksten processor i config.yaml. Det bør være små bogstaver. Aktuelt understøttede processorer:
- Markdown
- Tekstil
- ReStructuredText
- HTML (umodificeret tekst)
Som standard kun Sokrates installerer Markdown tekst processorer. Du kan installere andre med pip:
pip installere tekstil
pip installere docutils
Udvikling
Du kan starte en simpel udvikling server til at støtte dig i udviklingen .:
Socrates -r blog
Eller,
Socrates -r
for aktuelle mappe.
Dokumentation
Dokumentationen er indeholdt i docs biblioteket og er skrevet i reStructuredText hjælp Sphinx. Dokumentationen er let læst i en standard teksteditor. Men du kan bygge en HTML-version som så:
pip installere sphinx
cd docs /
gøre html
åben _build / html / index.html
Eller du kan se online version af den seneste dokumentation

Egenskaber :.

• Familiar Django og Jinja2 skabeloner
• Enkel installation via pip
• Markdown, reStructuredText, Tekstil støtte
• YAML konfiguration
• Atom-feed
• GitHub sider kompatible

Krav :

• Python