wok

wok er en statisk nettside generator som snur en haug av maler, innhold og ressurser (som CSS og bilder) i en pen bunke med vanlig HTML.
Utvikler kommentarer
Ideen er at du ikke trenger en stor PHP-motoren genererer hver side hvert besøk: du kan generere dem alle på forhånd, og bare regenerere ting når noe har endret seg. En god måte dette kunne gjøres ville være med en post-commit krok på en git repository som inneholder innhold eller layout.
Jeg gjorde wok fordi prosjekter som Jekyll, Hyde, og Static var spennende, men til slutt ikke helt samsvarer med hva jeg ønsket å gjøre med min hjemmeside. Så jeg skriver min egen.
Installasjon
Merk at wok er alfa-grade programvare på dette punktet. Det er under aktiv utvikling, og dets funksjoner er fortsatt i forandring, og det er feil. Hvis du fortsatt ønsker å bruke den, er den anbefalte måten å installere wok fra Python Package Index med denne kommandoen.
sudo PIP installere wok
Alternativt, hvis du ønsker å hacke på wok eller bare trenger den nyeste koden, kan du kjøre fra git hode, og hvis du vil kan du installere på systemkataloger med denne kommandoen.
sudo python2 setup.py installere
Bruk
Å kjøre wok, gå til katalogen der nettstedet ditt filene ligger, og kjøre wok. For nå, vil ingen utgang gis med mindre noe går galt. Hvis den gir uten feil, bør du ha en skinnende ny output-mappen containg noen html, og mediene som representerer din skinnende nye nettstedet.
wok trekker bitene av nettstedet ditt fra tre steder. For hvert av disse stedene, kan du endre banen wok ser for dem i konfigurasjonsfilen.
Innhold
Trakk fra en katalog som heter innhold som standard. Innholdet er skrevet i et merke opp språket, eller som ren tekst, med en valgfri YAML header delen. Katalogstrukturen på filen bety noe for wok. Den bygger strukturen i området basert på titlene og kategori meta data.
Maler
Trakk fra maler som standard. wok bruker Jinja2 maler, med ulike variabler utsatt for å bygge sider. Dette er en svært fleksibel templating miljø, med kontrollflyt, filtre og andre måter å dele opp dataene som wok gir deg.
Media
Media er ganske enkel. Den er ment å brukes til ting som site brede bilder, stilark og javascript. wok vil kopiere alt fra media katalogen rett til utgangen katalogen før du genererer noe. Dette betyr at generert innhold kan overskrive media.
Konfigurasjon
Innstillingene kan endres i filen config i gjeldende katalog.
Valg mulig konfigurasjon (og deres standardverdier) er
- Output_dir ("output") - Hvor de utskrevne filer er satt.
- Content_dir ("Innhold") - Hvor å finne innholdet.
- Templates_dir ("maler") - Hvor malene er.
- Media_dir ('media') - Hvor mediefilene er kopiert fra.
. - SITE_TITLE ('Noen Random wok Site') - Tilgjengelig til maler som `site.title

Krav :

• Python