diff options
author | Luiz F. A. de Prá <rawarkanis@gmail.com> | 2018-02-28 22:38:59 -0300 |
---|---|---|
committer | Luiz F. A. de Prá <rawarkanis@gmail.com> | 2018-02-28 22:38:59 -0300 |
commit | 4db982bb015eddb624e4c7f5776596b166dbaae5 (patch) | |
tree | 7c54044af415f43f3f2ecb2dc44ec01628e31893 /exampleSite/content/post/hugoisforlovers.md | |
download | hugo-coder-4db982bb015eddb624e4c7f5776596b166dbaae5.tar.gz hugo-coder-4db982bb015eddb624e4c7f5776596b166dbaae5.tar.bz2 hugo-coder-4db982bb015eddb624e4c7f5776596b166dbaae5.zip |
Initial files
Diffstat (limited to 'exampleSite/content/post/hugoisforlovers.md')
-rw-r--r-- | exampleSite/content/post/hugoisforlovers.md | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/exampleSite/content/post/hugoisforlovers.md b/exampleSite/content/post/hugoisforlovers.md new file mode 100644 index 0000000..d45b5d0 --- /dev/null +++ b/exampleSite/content/post/hugoisforlovers.md @@ -0,0 +1,87 @@ ++++ +date = "2014-04-02" +title = "Getting Started with Hugo" +tags = [ + "go", + "golang", + "hugo", + "development", +] +categories = [ + "Development", + "golang", +] ++++ + +## Step 1. Install Hugo + +Goto [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 [installing hugo](/overview/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. |