Socrates

Sokrates er en enkel statisk nettsted generator rettet mot blogger. Du skrive dine egne innlegg i din favoritt ren tekst til HTML-språket (f.eks Markdown, tekstil) og lagre dem som tekstfiler på harddisken din. Sokrates deretter tar dem, og skaper en full HTML nettstedet for deg. Gratis, vil du få en hjemmeside som viser nye innlegg, enkeltinnleggssider, kategorisider, arkivsider, en om side og et atom feed.
Bruk
Først må du opprette en ny blogg:
Sokrates -i blogg
Dette vil skape en blogg katalog med en enkel blogg struktur:
blog
& nbsp; innlegg
& 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
Den innlegg katalogen er hvor du vil plassere dine innlegg filer. Noe som prefiks _ eller. vil bli ignorert. layout er din grunnleggende tema eller en mal. config.yaml er et site-wide konfigurasjonsfil. Ikke glem å oppdatere om filen med relevant informasjon.
Du kan også opprette en ny blogg i den gjeldende arbeidskatalog:
Sokrates -i
Når du er klar til å generere nettstedet ditt, kjører du:
Sokrates -g blogg
Eller,
Sokrates -g
for gjeldende katalog.
Dette vil plassere alle genererte filer i bloggen / distribuere. Deretter kan du ta den katalogen og laste den opp til serveren din.
Installasjon
Først setter opp din virtuelle miljøet og Pip installere Sokrates.
virtualenv env no-site-pakker
kilde env / bin / aktivere
PIP installere Sokrates
Eller, for å få den nyeste koden, kan du installere fra Github.
PIP installere -e git: //github.com/honza/socrates.git#egg=socrates
Det neste trinnet er å installere dine maler. I øyeblikket, kan du velge mellom Django maler og Jinja2 maler. Standardtemaet bruker Django.
Temaer
Sokrates støtter Django maler og Jinja2 maler. Du kan spesifisere hvilke templating motor du ønsker å bruke i config.yaml fil. Det er to grunnleggende temaer i temaer katalogen for å komme i gang.
Tekst til HTML
Sokrates vil freistar å konvertere tekstfiler til HTML ved hjelp av et tekstbehandlingsprogram. Du bør angi navnet på tekstbehandler i config.yaml. Det bør være små bokstaver. Foreløpig støttes prosessorer:
- Markdown
- Tekstil
- ReStructuredText
- HTML (uendret tekst)
Som standard, bare Sokrates installerer Markdown tekstbehandlere. Du kan installere de andre med pip:
PIP installere tekstil
PIP installere docutils
Utvikling
Du kan starte en enkel utvikling server for å hjelpe deg i utviklingen .:
Sokrates -r blogg
Eller,
Sokrates -r
for gjeldende katalog.
Dokumentasjon
Dokumentasjonen er inneholdt i docs katalogen og er skrevet i reStructuredText hjelp Sphinx. Dokumentasjonen er lett å lese i en standard teksteditor. Men, kan du bygge en HTML-versjon som så:
PIP installere sfinks
cd docs /
lage html
åpen _build / html / index.html
Eller, kan du se den elektroniske versjonen av den siste dokumentasjonen

Egenskaper .

• Familiar Django og Jinja2 maler
• Enkel installasjon via pip
• Markdown, reStructuredText, Tekstil støtte
• YAML konfigurasjon
• Atom-feed
• GitHub sider kompatibelt

Krav :

• Python