Skip to content

Commit

Permalink
Actuall show how to generate pages in quickstart
Browse files Browse the repository at this point in the history
The development server isn't really that important for quick start.

Yes it is useful but makes things complex.

The most important part is really static site generation, and it is actually hard to find how to do it in your tutorials!

Same for `hugo new`. It is automagic, and anti-thesis of things being simple. This is why I added section to make it less magic, and simply allow content to be done manually.
  • Loading branch information
baryluk authored and bep committed Jun 13, 2019
1 parent 0aadc92 commit d9e467b
Showing 1 changed file with 24 additions and 1 deletion.
25 changes: 24 additions & 1 deletion content/en/getting-started/quick-start.md
Expand Up @@ -83,16 +83,27 @@ echo 'theme = "ananke"' >> config.toml

{{< asciicast 7naKerRYUGVPj8kiDmdh5k5h9 >}}


## Step 4: Add Some Content

You can manually create content files (for example as `content/<CATEGORY>/<FILE>.<FORMAT>`) and provide metadata in them, however you can use `new` commend to do few things for you (like add title and date):

```
hugo new posts/my-first-post.md
```

{{< asciicast eUojYCfRTZvkEiqc52fUsJRBR >}}

Edit the newly created content file if you want, it will start with something like this:

Edit the newly created content file if you want.
```markdown
---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true
---

```


## Step 5: Start the Hugo server
Expand Down Expand Up @@ -130,6 +141,8 @@ Press Ctrl+C to stop

**Navigate to your new site at [http://localhost:1313/](http://localhost:1313/).**

Feel free to edit or add new content and simply refresh in browser to see changes quickly (You might need to force refresh in webbrowser, something like Ctrl-R usually works).


## Step 6: Customize the Theme

Expand Down Expand Up @@ -157,3 +170,13 @@ For theme specific configuration options, see the [theme site](https://github.co

**For further theme customization, see [Customize a Theme](/themes/customizing/).**


### Step 7: Build static pages

It is simple. Just call:

```
hugo
```

Output will be in `./public/` directory by default (`-d`/`--destination` flag to change it, or set `publishdir` in the config file).

0 comments on commit d9e467b

Please sign in to comment.