aboutsummaryrefslogtreecommitdiff
path: root/exampleSite/content/posts/hugoisforlovers.md
diff options
context:
space:
mode:
Diffstat (limited to 'exampleSite/content/posts/hugoisforlovers.md')
-rw-r--r--exampleSite/content/posts/hugoisforlovers.md89
1 files changed, 89 insertions, 0 deletions
diff --git a/exampleSite/content/posts/hugoisforlovers.md b/exampleSite/content/posts/hugoisforlovers.md
new file mode 100644
index 0000000..02bb509
--- /dev/null
+++ b/exampleSite/content/posts/hugoisforlovers.md
@@ -0,0 +1,89 @@
++++
+title = "Getting Started with Hugo"
+description = ""
+tags = [
+ "go",
+ "golang",
+ "hugo",
+ "development",
+]
+date = "2014-04-02"
+categories = [
+ "Development",
+ "golang",
+]
+menu = "main"
++++
+
+## Step 1. Install Hugo
+
+Go to [Hugo releases](https://github.com/spf13/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 [Install Hugo](https://gohugo.io/getting-started/installing/)
+
+## 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](http://github.com/spf13/hugo)
+ 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](http://vim.spf13.com) 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.