.Kind (page): .Type (post) / .Layout ()
Bundle: n/a (regular page)
[ categories | tags | search ]
Hugo Bare Min Theme

This is an Example Site for the hugo-bare-min-theme.

It is updated automatically after each commit to the hugo-bare-min-theme repo. It was last updated on Feb 10, 2020 17:48 UTC.


This page was created/modified in commit 8158b67 "Make Org mode content the primary content source" on 2018-06-14.
Markdown source of this page

Getting Started with Hugo

categories: Development golang

tags: go golang development hugo


Description/Summary

Step 1. Install Hugo Goto hugo releases and download the appropriate version for your os and architecture. Save it somewhere specific as we will be using it in the next step. More complete instructions are available at installing hugo Step 2. Build the Docs Hugo has its own example site which happens to also be the documentation site you are reading right now. Follow the following steps: Clone the hugo repository Go into the repo Run hugo in server mode and build the docs Open your browser to http://localhost:1313 Corresponding pseudo commands:


Content

Step 1. Install Hugo

Goto hugo releases and download the appropriate version for your os and architecture.

Save it somewhere specific as we will be using it in the next step.

More complete instructions are available at installing hugo

Step 2. Build the Docs

Hugo has its own example site which happens to also be the documentation site you are reading right now.

Follow the following steps:

  1. Clone the hugo repository
  2. Go into the repo
  3. Run hugo in server mode and build the docs
  4. Open your browser to http://localhost:1313

Corresponding pseudo commands:

git clone https://github.com/spf13/hugo
cd hugo
/path/to/where/you/installed/hugo server --source=./docs
> 29 pages created
> 0 tags index created
> in 27 ms
> Web Server is available at http://localhost:1313
> Press ctrl+c to stop

Once you’ve gotten here, follow along the rest of this page on your local build.

Step 3. Change the docs site

Stop the Hugo process by hitting ctrl+c.

Now we are going to run hugo again, but this time with hugo in watch mode.

/path/to/hugo/from/step/1/hugo server --source=./docs --watch
> 29 pages created
> 0 tags index created
> in 27 ms
> Web Server is available at http://localhost:1313
> Watching for changes in /Users/spf13/Code/hugo/docs/content
> Press ctrl+c to stop

Open your favorite editor and change one of the source content pages. How about changing this very file to fix the typo. How about changing this very file to fix the typo.

Content files are found in docs/content/. Unless otherwise specified, files are located at the same relative location as the url, in our case docs/content/overview/quickstart.md.

Change and save this file.. Notice what happened in your terminal.

> Change detected, rebuilding site

> 29 pages created
> 0 tags index created
> in 26 ms

Refresh the browser and observe that the typo is now fixed.

Notice how quick that was. Try to refresh the site before it’s finished building.. I double dare you. Having nearly instant feedback enables you to have your creativity flow without waiting for long builds.

Step 4. Have fun

The best way to learn something is to play with it.


Page (Debug)

Page VariableValue
Name "Getting Started with Hugo"
Title "Getting Started with Hugo"
ResourceType "page"
Kind "page"
Section "post"
Draft false
Type "post"
Layout ""
Permalink "https://hugo-bare-min.netlify.com/post/hugoisforlovers/"
RelPermalink "/post/hugoisforlovers/"
Data
page.Data{} (type:page.Data)
NextPage(Hu)go Template Primer
PrevPageMigrating to Hugo from Jekyll
NextInSection(Hu)go Template Primer
PrevInSectionMigrating to Hugo from Jekyll

Page Params (Debug)

KeyTypeValue
categories[]string "Development" "golang"
datetime.Time 2014-04-02 00:00:00 +0000 UTC
draftbool false
iscjklanguagebool false
lastmodtime.Time 2018-06-14 11:03:26 -0400 -0400
menumap[string]interface {}
KeyTypeValue
mainmap[string]interface {}
KeyTypeValue
identifierstring "getting-started-with-hugo"
weightint64 2001
publishdatetime.Time 2014-04-02 00:00:00 +0000 UTC
tags[]string "go" "golang" "development" "hugo"
titlestring "Getting Started with Hugo"

File Object (Debug)

FileInfo VariableValue
UniqueID "507bc9792a164d425d567b4bf070f0a1"
BaseFileName "hugoisforlovers"
TranslationBaseName "hugoisforlovers"
Lang "en"
Section "post"
LogicalName "hugoisforlovers.md"
Dir "post/"
Ext "md"
Path "post/hugoisforlovers.md"

This site is generated using the hugo-bare-min-theme + Hugo 0.59.0 (commit 1dd0c69c) . [Test Site home]