archetypes: rethink rendering matcornic#300

Author: McShelby

archetypes/chapter.md

@@ -1,12 +1,8 @@
 +++
-chapter = true
-menuPre = "<b>X. </b>"
+archetype = "chapter"
+narrow = true
 title = "{{ replace .Name "-" " " | title }}"
-weight = 5
+weight = X
 +++
 
-### Chapter X
-
-# Some Chapter title
-
 Lorem Ipsum.

archetypes/default.md

@@ -1,6 +1,6 @@
 +++
 title = "{{ replace .Name "-" " " | title }}"
-weight = 5
+weight = X
 +++
 
 Lorem Ipsum.

archetypes/home.md

@@ -0,0 +1,6 @@
++++
+archetype = "home"
+title = "{{ replace .Name "-" " " | title }}"
+++
+
+Lorem Ipsum.

exampleSite/content/_index.en.md

@@ -1,9 +1,8 @@
 +++
+archetype = "home"
 title = "Hugo Relearn Theme"
 +++
 
-# Hugo Relearn Theme
-
 The [Relearn theme](http://github.com/McShelby/hugo-theme-relearn) is a theme for [Hugo](https://gohugo.io/), a static website generator written in Go. Where Hugo is often used for blogs, this theme is designed with documentation in mind.
 
 {{% notice info %}}

exampleSite/content/_index.pir.md

@@ -1,4 +1,5 @@
 +++
+archetype = "home"
 title = "Cap'n Hugo Relearrrn Theme"
 +++
 {{< piratify >}}

exampleSite/content/basics/_index.en.md

@@ -1,11 +1,8 @@
 +++
-chapter = true
+archetype = "chapter"
+narrow = true
 title = "Basics"
 weight = 1
 +++
 
-### Chapter 1
-
-# Basics
-
 Discover what this Hugo theme is all about and the core-concepts behind it.

exampleSite/content/basics/_index.pir.md

@@ -1,5 +1,6 @@
 +++
-chapter = true
+archetype = "chapter"
+narrow = true
 title = "Basics"
 weight = 1
 +++

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

@@ -14,9 +14,16 @@ This document shows you what's new in the latest release. For a detailed list of
 
 ---
 
-## 4.3.0
+## 5.0.0
 
-- **Change**: Renaming the frontmatter options `pre` / `post` to `menuPre` / `menuPost`. The old options will still be used if the new options aren't set. Therefore you don't need to change anything after the upgrade.
+- **Change**: The way [archetypes]({{% relref "cont/archetypes" %}}) are used to generate output has changed. Your existing content files will still work like before and therefore you don't need to change anything after the upgrade.
+
+  Nevertheless, it is recommended to adapt your existing files to the new way.
+
+  - for your home page, add the frontmatter parameter `archetype = "home"`
+  - for all files having the old frontmatter parameter `chapter = true`, replace that parameter with `archetype = "chapter"`
+
+- **Change**: The frontmatter options `pre` / `post` were renamed to `menuPre` / `menuPost`. The old options will still be used if the new options aren't set. Therefore you don't need to change anything after the upgrade.
 
 - **New**: Adding new partials `heading-pre.html` / `heading-post.html` and according frontmatter options `headingPre` / `headingPost` to modifiy the way your page`s main heading gets styled.
 

exampleSite/content/cont/_index.en.md

@@ -1,11 +1,8 @@
 +++
-chapter = true
+archetype = "chapter"
+narrow = true
 title = "Content"
 weight = 2
 +++
 
-### Chapter 2
-
-# Content
-
 Find out how to create and organize your content quickly and intuitively.

exampleSite/content/cont/_index.pir.md

@@ -1,5 +1,6 @@
 +++
-chapter = true
+archetype = "chapter"
+narrow = true
 title = "Rambl'n"
 weight = 2
 +++