wok

wok is 'n statiese webwerf kragopwekker wat draai 'n stapel van templates, die inhoud en hulpbronne (soos CSS en beelde) in 'n netjiese stapel plain HTML.
Ontwikkelaar kommentaar
Die idee is dat jy nie nodig het nie 'n groot PHP enjin elke besoek genereer elke bladsy: jy kan genereer om hulle almal voor die tyd, en slegs regenereer dinge wanneer iets het verander. 'N Goeie manier om dit gedoen kan word sou wees met 'n post-pleeg haak op 'n git bewaarplek met jou inhoud of uitleg.
Ek het wok omdat projekte soos Jekyll, Hyde, en statiese was intrige, maar in die einde het nie heeltemal ooreenstem met wat ek wou doen met my webwerf. So ek skryf my eie.
Installasie
Let daarop dat wok is alfa-graad sagteware op hierdie punt. Dit is onder aktiewe ontwikkeling, en sy funksies is nog steeds in vloed en daar is foute. As jy nog steeds wil hê om dit te gebruik, die aanbevole manier wok te installeer is uit die die Python pakket indeks met hierdie opdrag.
sudo PIP installeer wok
Alternatiewe, as jy wil om te hack op wok of net nodig het om die nuutste kode, kan jy hardloop uit git kop, en as jy wil, kan jy installeer op jou stelsel dopgehou met hierdie opdrag.
sudo python2 setup.py installeer
Gebruik
Wok om te hardloop, gaan na die gids waar jou site lêers geleë is, en hardloop wok. Vir nou, sal geen uitset gegee word nie, tensy daar iets verkeerd gaan. As dit terug sonder fout, moet jy 'n blink nuwe uitset gids containg sommige html, en jou media dat jou blink nuwe terrein verteenwoordig.
wok trek die stukke van jou site uit drie plekke. Vir elkeen van hierdie plekke, kan jy verander die pad wok lyk vir hulle in die opstelling lêer.

Getrek uit 'n gids met die naam inhoud by verstek. Inhoud is geskryf in 'n punt op die taal, of as teks, met 'n opsionele YAML kop afdeling. Die gids struktuur van die lêer beteken niks vir WOK. Dit bou die struktuur van die webwerf wat gebaseer is op die titels en die kategorie meta data.
Templates
Getrek uit templates by verstek. wok gebruik Jinja2 templates, met verskeie veranderlikes blootgestel bladsye te bou. Dit is 'n baie buigsame template omgewing, met beheer vloei, filters en ander maniere opdelen die data wat wok gee.
Media
Media is redelik eenvoudig. Dit is bedoel om gebruik te word vir dinge soos webwerf wye beelde, style sheets en JavaScript. wok sal alles van die media gids kopieer reguit na die uitset gids voordat enigiets te genereer. Dit beteken dat gegenereerde inhoud media kan oorskryf.
Konfigurasie
Instellings kan verander word in die lêer config in die huidige gids.
Moontlike opsies by die instellings (en hul standaard) is
- Output_dir ('uitset') - Waar die outputted lêers sit.
- Content_dir ('inhoud') - Waar die inhoud te vind.
- Templates_dir ('templates') - Waar die templates is.
- Media_dir ('media') - Waar die media lêers kopieer van.
. - SITE_TITLE ('n paar random wok webwerf) - Beskikbaar vir templates as `site.title

Vereistes :

• Python