From ad3af3b0689dd552e3ae9057a73a243846dfe647 Mon Sep 17 00:00:00 2001 From: laundry-96 Date: Fri, 27 Oct 2023 04:24:45 +0200 Subject: [PATCH 1/2] Added more defaults for hugo.toml Upon running the original setup command, I was hit with a 'Error: no existing content directory configured for this project'. Added in defaults taken from lotusdocs.dev and introduced them here. --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f042ac0e..1519faba 100644 --- a/README.md +++ b/README.md @@ -94,6 +94,8 @@ Edit the `hugo.toml` config file: baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' +contentDir = "content" +enableEmoji = true [module] # uncomment line below for temporary local development of module @@ -105,6 +107,17 @@ title = 'My New Hugo Site' [[module.imports]] path = "github.com/gohugoio/hugo-mod-bootstrap-scss/v5" disable = false + +[markup] + [markup.tableOfContents] + endLevel = 3 + startLevel = 1 + [markup.goldmark] + [markup.goldmark.renderer] + unsafe = true # https://jdhao.github.io/2019/12/29/hugo_html_not_shown/ + [markup.goldmark.parser] + [markup.goldmark.parser.attribute] + block = true ``` ### Install Locally @@ -177,4 +190,4 @@ Navigate to `localhost:1313/docs/` and you should see a card link to the **Examp Copyright © 2022-2023 [Colin Wilson](https://github.com/colinwilson) -[^1]: [Hugo Modules](https://gohugo.io/hugo-modules/) \ No newline at end of file +[^1]: [Hugo Modules](https://gohugo.io/hugo-modules/) From 826a3b6937850974467e5b1aa8e4e327df54e492 Mon Sep 17 00:00:00 2001 From: laundry-96 Date: Fri, 27 Oct 2023 04:32:25 +0200 Subject: [PATCH 2/2] Added prerequisites for content creation. Added configuration options for the hugo module and added Prerequistes section to create the content directory. --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1519faba..8595fe0a 100644 --- a/README.md +++ b/README.md @@ -61,6 +61,9 @@ The Lotus Docs theme can be installed using one of the following methods: - As a Git submodule - Clone the theme files locally +Prerequisites: +- `contentDir` present in project folder + ### Install as a Hugo Module (recommended) Edit the `hugo.toml` configuration file to include the [Lotus Docs theme](https://github.com/colinwilson/lotusdocs) and the [Hugo Bootstrap module](https://github.com/gohugoio/hugo-mod-bootstrap-scss) as modules: @@ -69,6 +72,8 @@ Edit the `hugo.toml` configuration file to include the [Lotus Docs theme](https: baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' +contentDir = 'content' +enableEmoji = true [module] [[module.imports]] @@ -77,6 +82,17 @@ title = 'My New Hugo Site' [[module.imports]] path = "github.com/gohugoio/hugo-mod-bootstrap-scss/v5" disable = false + +[markup] + [markup.tableOfContents] + endLevel = 3 + startLevel = 1 + [markup.goldmark] + [markup.goldmark.renderer] + unsafe = true # https://jdhao.github.io/2019/12/29/hugo_html_not_shown/ + [markup.goldmark.parser] + [markup.goldmark.parser.attribute] + block = true ``` ### Install as a Git Submodule @@ -94,7 +110,7 @@ Edit the `hugo.toml` config file: baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' -contentDir = "content" +contentDir = 'content' enableEmoji = true [module]