Skip to content

Commit 300c161

Browse files
author
Mathieu Cornic
committed
2 parents 9f15246 + a1d948f commit 300c161

File tree

8 files changed

+29
-24
lines changed

8 files changed

+29
-24
lines changed

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ $ git clone https://github.com/matcornic/hugo-theme-learn.git
2929
Check that your Hugo version is minimum `0.25` with `hugo version`.
3030

3131
![Overview](https://github.com/matcornic/hugo-theme-learn/raw/master/images/tn.png)
32+
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn?ref=badge_shield)
3233

3334
## Usage
3435

@@ -51,3 +52,7 @@ For both solutions, the documentation is available at https://github.com/matcorn
5152
## Credits
5253

5354
Many thanks to [@vjeantet](https://github.com/vjeantet/) for the fork [docdock](https://github.com/vjeantet/hugo-theme-docdock). The v2 of this theme is mainly based on his work !
55+
56+
57+
## License
58+
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn?ref=badge_large)

archetypes/chapter.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
+++
2-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
2+
title = "{{ replace .Name "-" " " | title }}"
33
date = {{ .Date }}
44
weight = 5
55
chapter = true

archetypes/default.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
+++
2-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
2+
title = "{{ replace .Name "-" " " | title }}"
33
date = {{ .Date }}
44
weight = 5
55
+++

exampleSite/content/basics/installation/_index.en.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Installation
33
weight: 15
44
---
55

6-
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/).
6+
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/).
77

88
## Create your project
99

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

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

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

22-
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
22+
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
2323

2424
## Basic configuration
2525

26-
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.
26+
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.
2727

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

32-
# For search functionnality
32+
# For search functionality
3333
[outputs]
3434
home = [ "HTML", "RSS", "JSON"]
3535
```
3636

3737
## Create your first chapter page
3838

39-
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.
39+
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.
4040

4141
```
4242
### Chapter 1
4343
4444
# Basics
4545
46-
Discover what this Hugo theme is all about and the core-concepts behind it.
46+
Discover what this Hugo theme is all about and the core concepts behind it.
4747
```
4848

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

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

61-
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.
61+
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.
6262

6363
## Create your first content pages
6464

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

6767
```
6868
hugo new basics/first-content.md
6969
hugo new basics/second-content/_index.md
7070
```
7171

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

7474
## Launching the website locally
7575

76-
Launch the following command:
76+
Launch by using the following command:
7777

7878
```
7979
hugo serve
@@ -83,19 +83,19 @@ Go to `http://localhost:1313`
8383

8484
You should notice three things:
8585

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

9090
## Build the website
9191

92-
When your site is ready to deploy, launch the following command:
92+
When your site is ready to deploy, run the following command:
9393

9494
```
9595
hugo
9696
```
9797

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

100100
{{% notice note %}}
101101
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/)

exampleSite/content/basics/style-customization/_index.en.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ The size of the logo will adapt automatically
3333

3434
## Change the favicon
3535

36-
If your favicon is a png, just drop off your image in your local `static/images/` folder and names it `favicon.png`
36+
If your favicon is a png, just drop off your image in your local `static/images/` folder and name it `favicon.png`
3737

3838
If you need to change this default behavior, create a new file in `layouts/partials/` named `favicon.html`. Then write something like this:
3939

exampleSite/content/cont/archetypes.en.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ It will create a page with predefined Front-Matter:
1919

2020
```markdown
2121
+++
22-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
22+
title = "{{ replace .Name "-" " " | title }}"
2323
date = {{ .Date }}
2424
weight = 5
2525
chapter = true
@@ -48,7 +48,7 @@ It will create a page with predefined Front-Matter:
4848

4949
```markdown
5050
+++
51-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
51+
title = "{{ replace .Name "-" " " | title }}"
5252
date = {{ .Date }}
5353
weight = 5
5454
+++

exampleSite/content/cont/archetypes.fr.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Cela crééra une page avec le Front Matter suivant:
1919

2020
```markdown
2121
+++
22-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
22+
title = "{{ replace .Name "-" " " | title }}"
2323
date = {{ .Date }}
2424
weight = 5
2525
chapter = true
@@ -48,7 +48,7 @@ Cela crééra une page avec le Front Matter suivant:
4848

4949
```markdown
5050
+++
51-
title = "{{ replace .TranslationBaseName "-" " " | title }}"
51+
title = "{{ replace .Name "-" " " | title }}"
5252
date = {{ .Date }}
5353
weight = 5
5454
+++

layouts/partials/header.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="{{ .Page.Language | default "en" }}" class="js csstransforms3d">
33
<head>
44
<meta charset="utf-8">
5-
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
5+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
{{ .Hugo.Generator }}
77
{{ partial "meta.html" . }}
88
{{ partial "favicon.html" . }}

0 commit comments

Comments
 (0)