Skip to content

Commit

Permalink
Merge pull request matcornic#146 from tedyoung/patch-1
Browse files Browse the repository at this point in the history
Clean up the English language phrasing
  • Loading branch information
matcornic authored Aug 10, 2018
2 parents f8d859b + 4254d5e commit 37149c0
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions exampleSite/content/basics/installation/_index.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Installation
weight: 15
---

The following steps are here to help you initialize your new website. If you don't know Hugo at all, we strongly suggest you to train by following this [great documentation for beginners](https://gohugo.io/overview/quickstart/).
The following steps are here to help you initialize your new website. If you don't know Hugo at all, we strongly suggest you learn more about it by following this [great documentation for beginners](https://gohugo.io/overview/quickstart/).

## Create your project

Expand All @@ -17,33 +17,33 @@ hugo new site <new_project>

Install the **Hugo-theme-learn** theme by following [this documentation](https://gohugo.io/themes/installing/)

The theme's repository is: https://github.com/matcornic/hugo-theme-learn.git
This theme's repository is: https://github.com/matcornic/hugo-theme-learn.git

Alternatively, you can [download the theme as .zip](https://github.com/matcornic/hugo-theme-learn/archive/master.zip) file and extract it in the themes directory
Alternatively, you can [download the theme as .zip](https://github.com/matcornic/hugo-theme-learn/archive/master.zip) file and extract it in the `themes` directory

## Basic configuration

When building the website, you can set a theme by using `--theme` option. We suggest you to edit your configuration file and set the theme by default. By the way, add requirements for search functionnality to be enabled.
When building the website, you can set a theme by using `--theme` option. However, we suggest you modify the configuration file (`config.toml`) and set the theme as the default. You can also add the `[outputs]` section to enable the search functionality.

```toml
# Change the default theme to be use when building the site with Hugo
theme = "hugo-theme-learn"

# For search functionnality
# For search functionality
[outputs]
home = [ "HTML", "RSS", "JSON"]
```

## Create your first chapter page

Chapters are pages containg other child pages. It has a special layout style and usually just contains a _chapter name_, the _title_ and a _brief abstract_ of the section.
Chapters are pages that contain other child pages. It has a special layout style and usually just contains a _chapter name_, the _title_ and a _brief abstract_ of the section.

```
### Chapter 1
# Basics
Discover what this Hugo theme is all about and the core-concepts behind it.
Discover what this Hugo theme is all about and the core concepts behind it.
```

renders as
Expand All @@ -58,22 +58,22 @@ hugo new --kind chapter basics/_index.md

By opening the given file, you should see the property `chapter=true` on top, meaning this page is a _chapter_.

By default all chapters and pages are created as draft. If you want to render these pages, remove the property `draft: true` from the metadata.
By default all chapters and pages are created as a draft. If you want to render these pages, remove the property `draft: true` from the metadata.

## Create your first content pages

Then, create content pages inside the previous chapter. Here are two ways to create content in the chapter :
Then, create content pages inside the previously created chapter. Here are two ways to create content in the chapter:

```
hugo new basics/first-content.md
hugo new basics/second-content/_index.md
```

Feel free to edit thoses files by adding some sample content and replacing `title` value in the beginning of the files.
Feel free to edit thoses files by adding some sample content and replacing the `title` value in the beginning of the files.

## Launching the website locally

Launch the following command:
Launch by using the following command:

```
hugo serve
Expand All @@ -83,19 +83,19 @@ Go to `http://localhost:1313`

You should notice three things:

1. You have a left **Basics** menu, containing two submenus with names equals to `title` properties in previously created files.
2. The home page explains you to how to customize it. Follow the instructions.
3. With `hugo serve` command, the page refresh as soon as you save a file. Neat !
1. You have a left-side **Basics** menu, containing two submenus with names equal to the `title` properties in the previously created files.
2. The home page explains how to customize it by following the instructions.
3. When you run `hugo serve`, when the contents of the files change, the page automatically refreshes with the changes. Neat!

## Build the website

When your site is ready to deploy, launch the following command:
When your site is ready to deploy, run the following command:

```
hugo
```

A `public` folder has been generated, containing all statics content and assets for your website. It can now be deployed on any web server !
A `public` folder will be generated, containing all static content and assets for your website. It can now be deployed on any web server.

{{% notice note %}}
This website can be automatically published and hosted with [Netlify](https://www.netlify.com/) (Read more about [Automated HUGO deployments with Netlify](https://www.netlify.com/blog/2015/07/30/hosting-hugo-on-netlifyinsanely-fast-deploys/)). Alternatively, you can use [Github pages](https://gohugo.io/hosting-and-deployment/hosting-on-github/)
Expand Down

0 comments on commit 37149c0

Please sign in to comment.