update the readme.md + re-generate the site
This commit is contained in:
@ -0,0 +1,61 @@
|
||||
---
|
||||
date: 2016-03-09T19:56:50+01:00
|
||||
title: Adding content
|
||||
weight: 20
|
||||
---
|
||||
|
||||
## Hello world
|
||||
|
||||
Let's create our first content file for your documentation. Open a terminal and add the following command for each new file you want to add. Replace `<section-name>` with a general term that describes your document in detail.
|
||||
|
||||
```sh
|
||||
hugo new <section-name>/filename.md
|
||||
```
|
||||
|
||||
Visitors of your website will find the final document under `www.example.com/<section-name>/filename/`.
|
||||
|
||||
Since it's possible to have multiple content files in the same section I recommend to create at least one `index.md` file per section. This ensures that users will find an index page under `www.example.com/<section-name>`.
|
||||
|
||||
## Homepage
|
||||
|
||||
To add content to the homepage you need to add a small indicator to the frontmatter of the content file:
|
||||
|
||||
```toml
|
||||
type: index
|
||||
```
|
||||
|
||||
Otherwise the theme will not be able to find the corresponding content file.
|
||||
|
||||
## Table of contents
|
||||
|
||||
You maybe noticed that the menu on the left contains a small table of contents of the current page. All `<h2>` tags (`## Headline` in Markdown) will be added automatically.
|
||||
|
||||
## Admonitions
|
||||
|
||||
Admonition is a handy feature that adds block-styled side content to your documentation, for example hints, notes or warnings. It can be enabled by using the corresponding [shortcodes](http://gohugo.io/extras/shortcodes/) inside your content:
|
||||
|
||||
```go
|
||||
{{</* note title="Note" */>}}
|
||||
Nothing to see here, move along.
|
||||
{{</* /note */>}}
|
||||
```
|
||||
|
||||
This will print the following block:
|
||||
|
||||
{{< note title="Note" >}}
|
||||
Nothing to see here, move along.
|
||||
{{< /note >}}
|
||||
|
||||
The shortcode adds a neutral color for the note class and a red color for the warning class. You can also add a custom title:
|
||||
|
||||
```go
|
||||
{{</* warning title="Don't try this at home" */>}}
|
||||
Nothing to see here, move along.
|
||||
{{</* /warning */>}}
|
||||
```
|
||||
|
||||
This will print the following block:
|
||||
|
||||
{{< warning title="Don't try this at home" >}}
|
||||
Nothing to see here, move along.
|
||||
{{< /warning >}}
|
Reference in New Issue
Block a user