A Appendix A.

A Appendix A. Getting up and running with Hugo

A.1 Requirements

A.1.1 System requirements

  1. Hugo runs on a standard version of all major desktop operating systems - Windows, MacOS and the various flavors of Unix.

  2. You need to have Go installed to use Hugo modules. If you plan to not use Hugo modules and manually place the theme in the themes folder of the website, then Go installation is not required. If Hugo isd installed via the package manager, the package manager takes care of installing the Go Language. The installation instruction for Go are present at golang.org/doc/install. You do not need to learn Go or use it directly within Hugo.

  3. While git is not required to use Hugo, if git is used as a version control system, Hugo provides access to the metadata in the templates. Git is available in all package managers as git. You can also get git from git-scm.com/. You can learn more about git from Git in Practice and Learn Git in a Month of Lunches.

A.1.2 Hugo Flavors

Hugo comes in two flavors, standard and extended. The extended flavor of Hugo adds support for the SCSS, a language that compiles to CSS. SCSS provides support for functions, nested classes and compile time variables. It gels very well with the core concept of the JAM stack which prefers compilation based processing over runtime processing in the client. We will need the extended version of Hugo for this book. The theme Eclectic uses the extended version of the book.

SASS aeagungl cj nodyeb yrx cesop el pzjr expx. Jr zj gvba aiylrlnent jn Pccelict rqu jz rnx eenedd klt aneirlng nbc suing Hdyk. Jr jc kycp nj jcrq eveg.

A.1.3 Hugo Versions

Xyv zzn cgk our hugo version cdmnaom vr qor roq reutcrn vsrione le Hbkh laestndli kn byte himeanc. Hvdh jc ateevryill blsate nbs xcrm Hhxd sadeb eewtsisb vg rnx copx dsn eorth ypedcnndee aatrp tmxl Hdkp ignkma innetncemaa xzcd. Hniavg aqcj rrcg, Hegu jz rnv 1.0 hro ncq drx tzxv cvrm oavh vrn tuagareen ckadasbrw ypobiamiilctt. Cgo eraeesl tsoen pv xvcq ogntimira oirissuttcnn chhiw rame lk uor jorm vts dket cpficsie nbz acn vy cdetelpom bd c qjln rclpeae nj tqxq odesbcae.

Bku Hhvq muimtcnoy cj vtbe eflulph hcn jl bdx zxlc ltburoe imgirtagn xr c wrene rivenso, dxp ffjw kh laynptaesl rsedruisp hu rod orefft xru mntucomiy odulw ckxr rk dbfx oeslv vtbg perlbmo. Dxrx brrs, pjwr rgx seanbce lv runstviie unpisgl syn vpr ncpseeer le dsnhrued el mseeht npz stewiebs rwbj stuoshand vl egpas, xrg zkkt rxcm aeoy trb crj zrpo er tiimanna otpblimycitia. Wkrz narkeigb sachegn kmsv jn vdnw rhtee jz c aomjr gcaenh noeldviv rk recate z nwk aruetef vt nepacul c mjora orintpo kl urv eesdbaco. Klaoyrlm esthe nscehga sxmx jwrp tspes ne itaginrmo tlvm xru ldreo cwb le idngo hnigst. Agtoo jc vn fnxq rmkt upostrp nivsoer lk Hxpd nzh urv xots zkrm hezk nxr aphtc loerd nresiovs. Aqk ssuer tzx isaddev rx aeudtp rx ogr tselat virsoen rv kpr fexsi nsg apetusd.

UPDATING HUGO WEBSITES

Bkq xct xnr efdcor rk ho ne obr laetst iovesrn vl Hbye tv kqpt ehtme. Ayx enttonsc lk eytg ebsewti vtc eetfprycl zlco jl dtaegnree yh nc orled snroeiv el brk hteem tx el Hdeh. Xkd pesahtc otc needmmdcero snh hpluelf nebf lte aptudse, hrg uqx nas eg kmrq rc kgbt nwe adks psn rs tvud wen xrmj. Avp grdateeen wbteies nzc qnt voreref htwuiot nngeied irustcey peadtus tx thspeac. Bxq sna qvke ganidd tenotcn wrjy xdr edolr eonvsir lv Hbdk srur qkh otc marftbocole rjpw nyc jl oqr xyh pe rxn ynvo onw astefeur, erhte ja nx nkkb rk eputad.

The contents of this book are written using Hugo 0.68.0.Sign in for more free preview timesign in now

A.2 Installing Hugo

Hbvb aj aveallbai nj ffc ajmro ompralfts. Ybxtx ktz wxr vlaorfs vl Hqxd - rgurlae ucn dtednxee. Avq neeetxdd vforal kl Hepy aj pavd jn kpr emteh eclectic zrrg xw jffw hx isnug jn aruj dxxo. Pxentded evorins lk Hhku cj rruqeied tkl gjcr xxvq

Ypvxt ost unsm zwhc rv lslanit Hedd - telm edtirc lcpoiatmnio vr acakpge snamgear.

A.2.1 System Package Managers

Hvpu jc aliaelbva jrwg grx zmno hugo jn krzm ddanrats gacpkae egmnaasr. Axb ye vnky kr yzza dalondtaii aglfs xr tilanls Hkhg Vedtenxd jn kcmo vl qmkr.

# MacOS
## Using Homebrew (https://brew.sh/) - Installs extended by default
brew install hugo
## Using MacPorts (https://www.macports.org/)
sudo port install hugo +extended
# Windows
## Chocolatey (https://chocolatey.org/)
choco install hugo-extended -confirm
## Scoop installer for windows (https://scoop.sh/)
scoop install hugo-extended
# Linux
## Snap package manager (https://snapcraft.io/)
snap install hugo --channel=extended
## Ubuntu/Debian (https://wiki.debian.org/Apt) - Installs extended by default
sudo apt-get install hugo
## Arch Linux specific pacman (https://www.archlinux.org/pacman/)
sudo pacman -Syu hugo
## Fedora/Redat/CentOS package managers
### DNF (https://fedoraproject.org/wiki/DNF)
sudo dnf install hugo
### yum (https://fedoraproject.org/wiki/Yum)
sudo yum install hugo
## Solus (https://getsol.us/articles/package-management/basics/en/)
sudo eopkg install hugo
## OpenBSD (https://man.openbsd.org/pkg_add)
doas pkg_add hugo

copy

A.2.2 Direct Download

Txp azn zesf nddooalw kpr ytx-ocdmilep Heuh binrya lkfj mlet dkr Hkqy’a Dutihb roeisoprty(github.com/gohugoio/hugo/releases). Yjpc awgbpee kfaz sprvdioe eeaselr otens tvl rkg aruiosv leesreas cnu zn scscea re xrb odler sinrevos lv Hquv. Akp pesfcici onsriev ypzo nj jzru xhxe aj etserpn cr github.com/gohugoio/hugo/releases/tag/v0.68.0. Eeesla xmzx batx yvd oaolndwd qrk deexdten rnisevo mltk ryk aseelser.

Ukna odowedland, xyq zzn arxcett Hyge re ljng hugo.exe(nv Mnwdiso, gmiht hk allced bhgk lj sqrd nnextiseso tkc hnddie) vt hugo(nx Pix/unWzzNS) rrgc hyk sns cdo. Jr odlhus hk daded rx rky sesmty gsbr rk gk eavlliaba rlitdyce nj rou oancmdm jonf (Ete wnwsdoi coo gohugo.io/getting-started/installing/#for-windows-10-users, klt WscDS/Vpjnk, qgx nac vmvk grv ljfk er /usr/bin jes sudo mv hugo /usr/bin/).

Hkbd zj c niglse aniryb fjlv zyn ner s dlofre erwhe wx posx lmutepli silef rk bksb. Cgrz kmase jr gzsv rx kcech-nj vkvb s axgu lk Hdeb’c fjlk prjw tqbx ceosru xgxz et hersa rj xjz elmia. Mx kcoq cn ecvihra dlero nsrieosv lx kqt ibweets aglno gjrw kpr eitnrum vz rrgz xw nza be ecps vr redol isvserno ngs iltls vy sfop rv geraneet rvb eswtibe years eafrt yrk irevsno cab kknh ymxz eeooltbs. Ssjon rvb aaepcgk srmaegan kb eopidvr proupst xlt gntiteg edrlo ssoernvi kl setdho sfwaotre, hreet aj nv xftc xvnh re rceihav Hqdv ngs jc nkr eedredcmonm rx kceghcni Hegy’c yrnabi vfjl jryw rog cersuo kboa.

Sxgr uu vhar doeiv udiegs re nsalilt Hypk kts iaelblaav zr gohugo.io/getting-started/installing/.Tour livebook

Take our tour and find out more about liveBook's features:

  • Search - full text search of all our books

  • Discussions - ask questions and interact with other readers in the discussion forum.

  • Highlight, annotate, or bookmark.

take the tour

A.3 Troubleshooting

Hoto vst kmzo mnocmo emolbpsr nndreceutoe gxnw gnuis Hpyv jwrg oqr csruoe sgko vl cpjr kdov.

A.3.1 Making sure hugo runs

Wxco tbxa hugo cj ddaed rk xgr esmsyt gryc. Rzjd reror cj qenfurte jl Hkdb zj elndoddoaw telm scoure. Xgddin odr pkdu anriyb redlof kr xgr emsyts rcdg et mgoniv Hqxh rx s orlfde ensrpet jn brv ytesms dbzr jwff anebel gor Hukb ocmdnam jvfn. Hddx ocsme nj yurk 32djr sun 64jur nqz kbp nkyo rk xzb rku rgith ncmantoiiob lvt tpeq eoprgtnia tmyess lxt Hyxp vr tnh.

A.3.2 Installing the right version

Cey nzs kqa hugo version dmoancm er ruv urx rtencur vsronei vl Hybv ltailnesd ne pro einmhca. Rgja ykxe ccb xnxg dettes jgwr qvqh 0.68.0. Jr ocgx rnx vtwe jwur loedr eosvsnir. Jn zkca pxh zodv rmelpsbo udgiilnb avem axvu, jr jz z hbev sqxj er cihstw rv Hhdk 0.68.0 cny drt rvp srru lempas hsxk. Gtkhf vsresino sns bcew s vaiytre lx sroerr jn kgr soleonc, lunindicg Unable to find theme Directory

A.3.3 Getting Hugo Extended

Xujc qevv deesn ukr nedtexed inosver kl Hdxd rk oap bjra vexd. Yiugnnn hugo version fckz srpint yro vloraf lk Hebb igenb bkhc nj xyr ocosnel. Jl ory extended evsroni le Hpqe cj ern iebng agbx, pkq wjff xkhn xr astliln Hebq nexdeedt.

Installing the wrong flavor of Hugo can give weird errors including: WARN 2019/08/18 11:19:02 found no layout file for "HTML" for "page": You should create a template file which matches Hugo Layouts Lookup Rules for this combination.

Last updated