wok

wok je statický webové stránky generátor, který změní hromadu šablon, obsahu a zdrojů (jako CSS a obrázků) do úhledné hromady prostého HTML.
Vývojářské komentáře
Myšlenka je, že nepotřebujete velký PHP motor generuje každou stránku při každé návštěvě: můžete vytvořit jim všem ještě čas, a to pouze regenerovat věci, když se něco změnilo. Dobrým způsobem, jak by to mohlo být provedeno bude s post-commit na git repozitáře, který obsahuje obsah nebo rozvržení.
Udělal jsem wok, protože projekty, jako Jekyll Hyde, a Static byly zajímavé, ale nakonec ne zcela odpovídat tomu, co jsem chtěl dělat s mých webových stránkách. Takže já píšu své vlastní.
Instalace
Všimněte si, že wok je alfa-grade software v tomto bodě. Je v aktivním vývoji, a jeho funkce jsou stále v pohybu a tam jsou chyby. Pokud si přesto chcete používat, Doporučený způsob instalace wok je od Python indexu balíčku s tímto příkazem.
sudo Pip nainstalovat wok
Alternative, pokud chcete proniknout na wok, nebo jen potřebujete nejnovější kód, můžete spustit z git hlavy, a pokud chcete, aby si můžete nainstalovat do adresáře systému s tímto příkazem.
sudo python2 setup.py nainstalovat
Použít
Chcete-li spustit wok, přejděte do adresáře, kde jsou umístěny soubory v místě, a spusťte wok. Pro tuto chvíli, žádný výstup mít, pokud se něco pokazí. Pokud se vrátí bez chyb, měli byste mít zbrusu nový výstupní složku containg nějaké HTML a médií, která představuje zbrusu nový web.
wok táhne kousky vašeho webu ze tří míst. Pro každou z těchto míst, můžete upravit cestu wok hledá pro ně v konfiguračním souboru.
Obsah
Vytáhl z adresáře s názvem obsah ve výchozím nastavení. Obsah je napsán ve označit jazyka, nebo jako prostý text, s volitelnou část YAML záhlaví. Adresářová struktura souboru neznamená nic wok. Staví struktury webu na základě názvů a údajů o kategorii meta.
Šablony
Vytáhl ze šablon ve výchozím nastavení. wok využívá Jinja2 šablony, s různými proměnné vystaveny vytváření stránek. Jedná se o velmi flexibilní šablon prostředí, s regulací průtoku, filtry a další způsoby, jak a nakrájíme na kostky data, která wok vám dává.
Reklama
Media je poměrně jednoduchý. Je určen k použití pro věci, jako je na místě širokých obrázků, stylů a JavaScript. wok bude kopírovat vše z adresáře médií přímo do výstupního adresáře před generováním cokoliv. To znamená, že generovaný obsah může přepsat médií.
Configuration
Nastavení lze změnit v konfiguračním souboru v aktuálním adresáři.
Volby Možné konfigurace (a jejich výchozí nastavení) jsou
- Output_dir ("výstup") - Jsou-li dát vystupující soubory.
- Content_dir ("obsah") - Kde najít obsah.
- Templates_dir ("šablony") - Kde jsou ty šablony.
- Media_dir ("media") - Tam, kde jsou multimediální soubory zkopírovány z.
, - SITE_TITLE ("Některé Random wok místo"), - k dispozici do šablon, jako `site.title

Požadavky na :

• Python