Skip to content
Permalink
Browse files

Actuall show how to generate pages in quickstart

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 Mar 26, 2019
1 parent 0aadc92 commit d9e467b8b7b15f616c2a83335d5b47d256cfeebd
Showing with 24 additions and 1 deletion.
  1. +24 −1 content/en/getting-started/quick-start.md
@@ -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
@@ -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

@@ -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.
You can’t perform that action at this time.