mirror of
https://github.com/vacp2p/rfc.git
synced 2025-02-03 02:24:35 +00:00
27ee0f0558
* Hugo init * Init Hugo book * Add basic README and title * Import RFC: 1/COSS * Move example content to dedicated folder * Basic menu * Tweak single layout * Fix base url and permalink * Basic index tweaks * Add netifly config * gitignore * 1/COSS: Add COSS lifecycle * Remove public artifact * Add basic numbers in menu * Empty READMEs init * Import mvds spec raw * 2/MVDS: Simplify * 3/REMOTE-LOG: Import * 3/REMOTE-LOG: Simplify * 4/MVDS-META: Import * 4/MVDS-META Simplify * Tweaks * 5/WAKU0: Import * 5: Simplify * 6/WAKU1: Import * 6/WAKU1: Simplify * 7/WAKU-DATA: Import * 7/WAKU-DATA: Simplify * 8/WAKU-MAIL: Import * 8/WAKU-MAIL: Simplify * Tweak * 9/WAKU-RPC: Import * 9/WAKU-RPC: Simplify * 10/WAKU2: Import * 10/WAKU2: Simplify * 11/WAKU-RELAY: Import * Tweaks * 11/WAKU-RELAY: Simplify * 12/WAKU-FILTER: Import * 12/WAKU2-FILTER: Simplify * 13/WAKU-STORE: Import * 13/WAKU-STORE: Simplify * 14/WAKU-MESSAGE: Import * 14/WAKU-MESSAGE: Simplify * 15/WAKU-BRIDGE: Import * 15: Simplify * 16: Import * 16: Simplify * 17: Import * 17: Simplify * 18: Import * 18: Simplify * 12: Bump update * 14: Bump update * 11: Bump update * 17: Bump update * 18: Bump update * 16: Bump update * Fix slug for 18 * Editor changes for 11, 12, 15 * Revert "Editor changes for 11, 12, 15" This reverts commit 5c32fe791bec57ca1d5326e0d2724339f12a784a. * Revert "Revert "Editor changes for 11, 12, 15"" This reverts commit ccd75131d72a1f1c43b701f445fe66ebd6857fc4. * Editor changes for 13, 2, 4 * Move current specs to archive * Update README * bump
90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
+++
|
|
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.
|