Hugo

[nelsonic]

Thinking of using Hugo for my "personal site". Not that I don't want to build my own CMS, just that I don't have infinite time. ⏳ Home page: https://gohugo.io/

• Tutorial: https://opensource.com/article/18/3/start-blog-30-minutes-hugo
• Themes: https://themes.gohugo.io/
• "Book" looks good: https://github.com/alex-shpak/hugo-book | https://hugo-book-demo.netlify.app/

[nelsonic]

https://gohugo.io/hosting-and-deployment/hosting-on-github/

[nelsonic]

Updating my version of Go from go1.14.6 darwin/amd64 to 1.17.1 ... Seems like a bit of a beast:

[nelsonic]

Installing via Homebrew:

brew install hugo

[nelsonic]

Check version:

$ hugo version

hugo v0.88.1+extended darwin/amd64 BuildDate=unknown

[nelsonic]

Seems obvious, but I'm assuming Hugo supports writing content in Markdown ... https://freecontent.manning.com/using-markup-languages-with-hugo/ ✅

[nelsonic]

This is basically what I want: https://gohugo.io/hosting-and-deployment/hosting-on-github/ Relevant: https://levelup.gitconnected.com/build-a-personal-website-with-github-pages-and-hugo-6c68592204c7

[nelsonic]

$ hugo version
hugo v0.88.1+extended darwin/amd64 BuildDate=unknown

$ git --version
git version 2.30.1 (Apple Git-130)

$ hugo new site quickstart
Congratulations! Your new Hugo site is created in /Users/n/code/nelsonic.github.io/quickstart.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder.
   Choose a theme from https://themes.gohugo.io/ or
   create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

[nelsonic]

Default home page is not very inspiring ...

[nelsonic]

As someone seeing the project for the first time, I feel that this folder structure is totally overwhelming:

There's a lot going on in this project and there's no clear entry-point. The docs aren't very useful for understanding it.

Meanwhile, compiling a basic quick-start site with one page produces the following files:

Expanding those directories, we see:

These directories in a Hugo site are all fairly self-explanatory. 💭

[nelsonic]

Going to need to come back to this. Want to check something more "nagging" off my Todo List ... https://github.com/dwyl/learn-devops/issues/72

[nelsonic]

Continue: https://gohugo.io/hosting-and-deployment/hosting-on-github/

[nelsonic]

http://www.sebastianseilund.com/static-markdown-blog-posts-with-elixir-phoenix

[nelsonic]

https://gohugo.io/about/features/