# (c) cavaliba.com - doc with hugo/hextra theme



Generator: Hugo https://gohugo.io/


-----------------------------------------
local view
-----------------------------------------
# prerequisite : go & hugo
$ go version
go version go1.23.3 linux/amd64

$ hugo version
hugo v0.135.0-f30603c47f5205e30ef83c70419f57d7eb7175ab+extended linux/amd64 BuildDate=2024-09-27T13:17:08Z VendorInfo=gohugoio


# content / edit
doc/content/*


# preview 
cd doc/
hugo server --buildDrafts --disableFastRender
=> http://localhost:1313/


#  build
hugo


# deply
=> doc/public/ ready to be uploaded to a public website.


-----------------------------------------
theme update
-----------------------------------------

cd doc/
hugo mod get -u github.com/imfing/hextra



-----------------------------------------
init new site with theme
-----------------------------------------
See: https://imfing.github.io/hextra/docs/guide/configuration/

hugo new site doc --format=yaml
cd doc/
hugo mod init cavaliba.com/doc
hugo mod get github.com/imfing/hextra

vi hugo.yaml 
module:
  imports:
    - path: github.com/imfing/hextra

hugo server --buildDrafts --disableFastRender
=> http://localhost:1313/


vi .gitignore
# Hugo output
public/
resources/
.hugo_build.lock

# Editor
.vscode/
