POSTS

Hugo

Mul oli plaanis juba pikemat aega üles seada mingit sorti blogi laadne sait, kuhu ma saaks kirjeldada oma projekte, et teistel oleks sellest ka kasu ja endalgi hea hiljem vaadata. Ühesõnaga väiksemat sorti dokumentatsiooni jaoks. Üldiselt ma olen väga halb dokumenteerija, aga see on siin esimeseks testimise postiks.

Kuna ma tahaks seda asja hoida ikkagi oma serveris, siis hakkasin uurima milliseid blogi mootoreid saada on. Kindlasti ma ei oleks tahtnud sellist, mis vajab töötamiseks andmebaasi ja mingit kindlat sorti veebiserverit. Sest vastasel korral on meeletult ajaraiskamist ümber kolides. Üks selline paljulubav lahendus on go’s kirjutatud hugo.

Lühidalt kirjeldades töötab hugo nii, et sul on hulk markdown‘is kirjutatud tekste, ning tema konverdib need staatiliseks html lehtede komplektiks ning lisab kujunduse. Neid html lehti saad siis serveerida kas oma veebiserverist, või ka otse hugo endaga. Mulle selline lahendus sobib, kuna ma võin kirjutada tekste suvalises editoris puhta tekstina, sest markdown‘i on lihtne formaatida ja samal ajal lugeda. Ning deploy ei ole midagi lihtsamat kui käsk hugo, ning pärast seda on sul public kataloogis genereeritud html failid.

Kiire juhendi hugo installimiseks leiab hugo lehelt.

Mõned nüansid:

  • Kui on vaja modifitseerida mõnda kujundust, siis saab tema üksikuid faile kopeerida oma hugo root kataloogi ja siis neid muuta. Sel juhul kasutatakse seda faili originaali asemel deploy käigus. Näiteks kui on theme nimega “ananke”, siis:
cp themes/ananke/layouts/partials/site-header.html layouts/partials/
vim layouts/partials/site-header.html 
  • Kuna hugo kujundusi saab otse gitist kloonida ja uuendada, siis on mõistlik kogu enda projekt hoida gitis ja kujundus võtta submoodulina sisse.

Comments

Leave a comment