Skip to content

Commit

Permalink
(MAINT) Standardize frontmatter metadata
Browse files Browse the repository at this point in the history
Prior to this change, the usage of frontmatter keys and formatting was
messy, inconsistent, and difficult to understand.

This change standardizes the metadata across the site and updates it
where appropriate.

Every file _must_ define:

- `title` - Used in the page metadata and stands as the first header for
  any page.
- `summary` - Used as the description in the metadata and for previewing
  the page in various circumstances, especially with the `section`
  shortcode and when paginating.

Every blog post must also define:

- `author` - the person who wrote the post
- `date` - the published date for the post
- `categories` - the post must fit under one or more categories

Game texts must define `date` as the day they are done with editing and
no longer considered WIP.

This change also sets the **enableGitInfo** setting to `true`, which
auto-populates the last modified date for any files with the date they
were last committed.
  • Loading branch information
michaeltlombardi committed Sep 11, 2022
1 parent e7bd7ad commit 241932f
Show file tree
Hide file tree
Showing 48 changed files with 121 additions and 149 deletions.
2 changes: 1 addition & 1 deletion config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ module:

# Book configuration
disablePathToLower: true
# enableGitInfo: true
enableGitInfo: true

# Needed for mermaid/katex shortcodes
markup:
Expand Down
3 changes: 2 additions & 1 deletion content/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Flagrant Garden
description: A Garden of Play, Flagrantly Cultivated
date: 2021-09-12
summary: A Garden of Play, Flagrantly Cultivated
type: docs
---

Expand Down
3 changes: 2 additions & 1 deletion content/cultivars.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Available Cultivars
description: |
date: 2022-01-04
summary: |
A quick list of available texts and projects, flagrantly cultivated.
type: docs
---
Expand Down
3 changes: 2 additions & 1 deletion content/cultivation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Flagrant Cultivation
description: >
date: 2021-09-12
summary: >
Make kitbashable shit. Release as early as possible. Iterate and accelerate collaboration. Build
out, not up. Fuck hierarchies.
type: docs
Expand Down
5 changes: 3 additions & 2 deletions content/games/66/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Flagrant66"
description: "A d66 engine for attribute & domain games"
title: Flagrant66
date: 2021-09-12
summary: A d66 engine for attribute & domain games
bookCollapseSection: true
weight: 10
---
Expand Down
5 changes: 3 additions & 2 deletions content/games/66/engine.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Engine"
description: "A d66 engine for attribute & domain games"
title: Engine
date: 2021-09-12
summary: A d66 engine for attribute & domain games
weight: 10
---

Expand Down
5 changes: 3 additions & 2 deletions content/games/66/publishing.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Publishing"
description: "Publishing & Flagrant66"
title: Publishing
date: 2021-09-12
summary: Publishing & Flagrant66
weight: 10
---

Expand Down
5 changes: 3 additions & 2 deletions content/games/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Games"
description: "Tools to help players flourish"
title: Games
date: 2021-09-12
summary: Tools to help players flourish
bookFlatSection: true
weight: 10
---
5 changes: 3 additions & 2 deletions content/games/factions/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Flagrant Factions"
description: "A Fantastic Skirmish Wargame"
title: Flagrant Factions
date: 2021-09-12
summary: A Fantastic Skirmish Wargame
bookCollapseSection: true
weight: 10
---
Expand Down
5 changes: 3 additions & 2 deletions content/games/factions/companies.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Companies"
description: "Sample companies to play in Flagrant Factions"
title: Companies
date: 2022-09-12
summary: Sample companies to play in Flagrant Factions.
bookToC: false
weight: 60
---
Expand Down
5 changes: 3 additions & 2 deletions content/games/factions/locations.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Locations"
description: "Sample locations for Flagrant Factions"
title: Locations
date: 2022-06-05
summary: Sample locations for Flagrant Factions
weight: 15
---

Expand Down
5 changes: 3 additions & 2 deletions content/games/factions/routines.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Routines"
description: "Rules for non-player Companies in Flagrant Factions"
title: Routines
date: 2022-06-12
summary: Rules for non-player Companies in Flagrant Factions
weight: 50
---

Expand Down
5 changes: 3 additions & 2 deletions content/games/factions/rules.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Rules"
description: "Rules for playing Flagrant Factions"
title: Rules
date: 2021-09-12
summary: Rules for playing Flagrant Factions
weight: 10
---

Expand Down
5 changes: 3 additions & 2 deletions content/games/factions/scenarios.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Scenarios"
description: "Sample scenarios for Flagrant Factions"
title: Scenarios
date: 2021-09-12
summary: Sample scenarios for Flagrant Factions
weight: 20
---

Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/spells.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Spells"
description: "Sample spells for Flagrant Factions"
title: Spells
description: Sample spells for Flagrant Factions
draft: true
bookToC: false
weight: 30
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Supplements"
description: "Addenda for Flagrant Factions"
title: Supplements
summary: Addenda for Flagrant Factions
bookCollapseSection: true
weight: 99
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Forces"
description: "Captains and Companies in the various domains in Wolves Upon the Coast"
title: Forces
summary: Captains and Companies in the various domains in Wolves Upon the Coast
bookCollapseSection: true
draft: false
weight: 80
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/albann.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Albann"
description: "The forces of Albann"
title: Albann
summary: The forces of Albann
draft: false
weight: 40
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/faroe.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Faroe"
description: "The forces of Faroe"
title: Faroe
summary: The forces of Faroe
draft: false
weight: 30
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/mid-isles.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "The Mid-Isles"
description: "The forces of the Mid-Isles"
title: The Mid-Isles
summary: The forces of the Mid-Isles
draft: false
weight: 15
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/noos.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Noos"
description: "The forces of the isle of Noos"
title: Noos
summary: The forces of the isle of Noos
draft: false
weight: 20
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/Forces/ruislip.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Ruislip"
description: "The forces of Ruislip and its surroundings"
title: Ruislip
summary: The forces of Ruislip and its surroundings
draft: false
weight: 10
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Flagrant Coasts"
description: "A supplement for skirmishes in Wolves Upon the Coast."
title: Flagrant Coasts
summary: A supplement for skirmishes in Wolves Upon the Coast.
bookCollapseSection: true
draft: false
weight: 90
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/bynames.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Bynames"
description: "Traits Groups gain and lose by their actions and Glory."
title: Bynames
summary: Traits Groups gain and lose by their actions and Glory.
draft: false
weight: 40
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Characters and Duels"
description: "Guidance for WutC characters as Groups and personal combat"
title: Characters and Duels
summary: Guidance for WutC characters as Groups and personal combat
draft: false
weight: 30
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/fame-and-glory.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Fame and Glory"
description: "Subystems for measuring Captains and Groups"
title: Fame and Glory
summary: Subystems for measuring Captains and Groups
draft: false
weight: 10
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/fleets.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Fleets"
description: "Rules, groups, and traits for naval forces."
title: Fleets
summary: Rules, groups, and traits for naval forces.
draft: false
weight: 60
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/soldiers.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Soldiers"
description: "Groups and traits for land forces."
title: Soldiers
summary: Groups and traits for land forces.
draft: false
weight: 50
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/coasts/spells-and-wards.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Spells and Wards"
description: "Guidance for WutC spells and wards in a skirmish"
title: Spells and Wards
summary: Guidance for WutC spells and wards in a skirmish
draft: false
weight: 90
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Surrender and Capture"
description: "Special rules for taking prisoners"
title: Surrender and Capture
summary: Special rules for taking prisoners
draft: false
weight: 20
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/gerblinflood/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Gerblinflood"
description: "A supplement overflowing with flagrant gerblins"
title: Gerblinflood
description: A supplement overflowing with flagrant gerblins
bookCollapseSection: true
draft: true
weight: 20
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/picaresque/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Flagrant Picaresque"
description: "A Flagrant Factions Supplement for Adventuring"
title: Flagrant Picaresque
summary: A Flagrant Factions Supplement for Adventuring
bookCollapseSection: true
weight: 10
---
Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/picaresque/adventurers.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Adventurers"
description: "Rules and guidance for playing Adventurers in Flagrant Picaresque"
title: Adventurers
summary: Rules and guidance for playing Adventurers in Flagrant Picaresque
weight: 10
---

Expand Down
4 changes: 2 additions & 2 deletions content/games/factions/supplements/picaresque/picaresques.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Picaresques"
description: "Sample adventures for Flagrant Picaresque"
title: Picaresques
summary: Sample adventures for Flagrant Picaresque
weight: 30
---
4 changes: 2 additions & 2 deletions content/games/factions/supplements/picaresque/refereeing.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Refereeing"
description: "Rules and guidance for facillitating Flagrant Picaresque"
title: Refereeing
summary: Rules and guidance for facillitating Flagrant Picaresque
weight: 20
---

Expand Down
3 changes: 2 additions & 1 deletion content/horticulturists/LootTheRoom/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Loot the Room
description: