Merge branch 'master' into add_icons_customizability

.github/workflows/test.yml

@@ -9,12 +9,12 @@ jobs:
       matrix:
         hugo-version:
           - 'latest'
-          - '0.95.0'
+          - '0.128.0'
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v2
+        uses: peaceiris/actions-hugo@v3
         with:
           hugo-version: ${{ matrix.hugo-version }}
           extended: true

CONTRIBUTING.md

@@ -10,7 +10,7 @@ and are **greatly appreciated**!
 
 When contributing, especially for the first time, consider starting by
 [creating an issue](https://github.com/chipzoller/hugo-clarity/issues/new/choose)
-so you can get feedback from the maintainers and avoid unncessary work.
+so you can get feedback from the maintainers and avoid unnecessary work.
 
 **Note:** Hugo Clarity has a [code of conduct](CODE_OF_CONDUCT.md).
 Please follow it in all your interactions with the project.

README.md

@@ -1,4 +1,4 @@
-# Hugo Clarity
+# Hugo Clarity Theme
 
 A technology-minded theme for Hugo based on VMware's open-source [Clarity Design System](https://clarity.design/) featuring rich code support, dark/light mode, mobile support, and much more. See [a live demo at __neonmirrors.net__](https://neonmirrors.net/).
 
@@ -217,6 +217,7 @@ These options set global values that some pages or all pages in the site use by
 | twitter                    | string                      | no                  |
 | largeTwitterCard           | boolean                     | no                  |
 | ga_analytics               | string                      | no                  |
+| google_tag_manager_id      | string                      | no                  |
 | baidu_analytics            | string                      | no                  |
 | plausible_analytics        | boolean                     | no                  |
 | matomo_analytics           | boolean                     | no                  |
@@ -295,6 +296,7 @@ These options can be set from a page [frontmatter](https://gohugo.io/content-man
 | sidebar              | boolean            | N/A              |
 | singleColumn         | boolean            | N/A              |
 | showRelatedInArticle | boolean            | N/A              |
+| noindex              | boolean            | N/A              |
 
 ### Modify Menus
 
@@ -326,7 +328,7 @@ If you're not using certain icons, remove them from the list.
 
 ### Web site analytics
 
-If using Google Analytics, configure the `ga_analytics` global parameter in your site with your ID.
+If using Google Analytics, configure the `ga_analytics` global parameter in your site with your ID. You can opt to set a google tag manager using `google_tag_manager_id`.
 
 If using Baidu Analytics, configure the `baidu_analytics` global parameter in your site with your ID.
 
@@ -723,7 +725,7 @@ customJS = ["js/custom.js"] # Include custom JS files
 
 ### Notices
 
-This theme includes functionality to display some "hightlight blocks" - called "notices" using a shortcode.
+This theme includes functionality to display some "highlight blocks" - called "notices" using a shortcode.
 
 For example, see the shortcode markup below will render as a notice:
 
@@ -828,14 +830,15 @@ You can override these setting from each post individually. For example, you may
 
 #### Utterances Commenting Support
 
- If you wish use [Utterances](https://github.com/utterance/utterances) comments on your site, you'll need to perform the following:
+If you wish use [Utterances](https://github.com/utterance/utterances) comments on your site, you'll need to perform the following:
 
  * Ensure you have a GitHub public repository, which you've granted permissions to the [Utterances GitHub App](https://github.com/apps/utterances).
  * Comment out the line for `disqusShortname = ""` in the `/config/_default/config.toml` file.
  * Set `comments = true` in the `/config/_default/params.toml` file.
  * Configure the utterances parameters in the `/config/_default/params.toml` file.
+ * Optionally, you can choose a label that will be assigned to all issues created by Utterances. The label must exist in your Github repository, as Utterances cannot attach labels that do not exist. Configure `utterancesLabel` parameter in `/config/_default/params.toml` file, after you have added a label to your Github repository Issues labels. Labels are case sensitive and support Emoji in label names. ✨💬✨
 
- Utterances is loaded in the `comments.html` partial by referring to the `utterances.html` partial.   Since `single.html` layout loads comments if comments are enabled, you must ensure *both* the `comments` and `utterances` parameters are configured.
+Utterances is loaded in the `comments.html` partial by referring to the `utterances.html` partial.   Since `single.html` layout loads comments if comments are enabled, you must ensure *both* the `comments` and `utterances` parameters are configured.
 
 
 

assets/sass/_variables.sass

@@ -110,7 +110,9 @@ html
         img
           background: none
         svg
-          fill: #fafafa
+          fill: #fafafa 
+        &:not(svg)
+          filter: invert(0.87)
       .sidebar
         &_inner
           &::before

assets/sass/main.sass

@@ -4,7 +4,7 @@ $imagesPath: '{{ printf "../%s" (default "images/" .Site.Params.imagesDir) }}'
 $iconsPath: '{{ printf "../%s" (default "icons/" .Site.Params.iconsDir) }}'
 @import 'variables'
 @import 'override'
-// include static fonts only when they're not overriden
+// include static fonts only when they're not overridden
 {{- if ne .Site.Params.customFonts true }}
 @import 'fonts'
 {{- end }}

exampleSite/.gitignore

@@ -0,0 +1,2 @@
+public/
+resources/

exampleSite/README.md

@@ -19,5 +19,5 @@ hugo server -t YOURTHEME
 - A section called `/post/` with sample markdown content
 - A headless bundle called `homepage` that you may want to use for single page applications. You can find instructions about headless bundles over [here](https://gohugo.io/content-management/page-bundles/#headless-bundle)
 - An `about.md` that is intended to provide the `/about/` page for a theme demo
-6. If you intend to build a theme that does not fit in the content structure provided in this repository, then you are still more than welcome to submit it for review at the [Hugo Themes](https://github.com/gohugoio/hugoThemes/issues) respository
+6. If you intend to build a theme that does not fit in the content structure provided in this repository, then you are still more than welcome to submit it for review at the [Hugo Themes](https://github.com/gohugoio/hugoThemes/issues) repository
 

exampleSite/config/_default/config.toml → exampleSite/config/_default/hugo.toml

@@ -4,7 +4,7 @@ baseurl = "https://example.com/"  # Include trailing slash
 # title = "Clarity"  # Edit directly from config/_default/languages.toml # alternatively, uncomment this and remove `title` entry from the aforemention file.
 copyright = "Copyright © 2008–2018, Steve Francia and the Hugo Authors; all rights reserved."
 # canonifyurls = true
-paginate = 10
+
 theme = "hugo-clarity"
 disqusShortname = ""
 
@@ -22,3 +22,6 @@ series = "series"
 
 [outputs]
 home = ["HTML", "RSS", "JSON"]
+
+[pagination]
+  pagerSize = 10

exampleSite/config/_default/params.toml

@@ -12,7 +12,10 @@ introDescription = "Technologist, perpetual student, teacher, continual incremen
 # showShare = false # Uncomment to not show share buttons on each post. Also available in each post's front matter.
 
 # Google analytics Id
-ga_analytics = "XXXXXXXXXX"
+ga_analytics = ""
+
+# Google tag manager
+google_tag_manager_id = ""
 
 # Baidu analytics Id
 # baidu_analytics = "XXXXXXXX"
@@ -91,7 +94,7 @@ mobileNavigation = "left" # if you prefer right change to 'right'
 
 # some site owners want to decide how they would like their sites to be introduced users. These settings give you as a site owner to decide how the user will view your site for the first time.
 
-# please note that you cannot enforce both modes at the same time. i.e by enforcing one mode, you priotise it over the other (by setting it to true). enforceDarkMode will be commented out
+# please note that you cannot enforce both modes at the same time. i.e by enforcing one mode, you prioritise it over the other (by setting it to true). enforceDarkMode will be commented out
 
 # please also not that mode toggle UI will remain in place. That way, if a user prefers darkmode, they can have their way.
 
@@ -115,8 +118,9 @@ languageMenuName = "🌐"
 # comments = false
 
 # Enable or disable Utterances (https://github.com/utterance/utterances) Github Issue-Based Commenting
-# utterances = true  #Run the utterances script in the single.html layout to load https://utteranc.es comments
+# utterances = true  # Run the utterances script in the single.html layout to load https://utteranc.es comments
 # utterancesRepo = "GHUsername/Repository.Name" # Utterances is enabled when this param is set
+# utterancesLabel = "blog comments ✨💬✨" # The label needs to be manually added to your Github repository issues before configuring here
 # utterancesTheme = "github-light" # Default: github-dark
 # utterancesIssueTerm = "pathname" # Default: pathname
 
@@ -136,7 +140,7 @@ languageMenuName = "🌐"
 # dateFormat = "2006-01-02" # Default to "Jan 2, 2006".
 # customFonts = false # toggle to true if you want to use custom fonts only.
 
-# The year when ths website was created, this value is used in the copyright
+# The year when this website was created, this value is used in the copyright
 # notice of the footer.
 # since = 2016
 
@@ -152,8 +156,8 @@ name = "Jane Doe"
 [plausible_analytics]
 enable = false # to enable plausible analytics set to true.
 websiteDomain = "example.com" # domain name of your website, most cases same as your base url
-# plausibleDomain = "plausible.io" # default is set to plausible.io, only required if plausible is selfhosted
-# scritpName = "plausible" # default is set to plausible, only required if using a custome name for script
+# plausibleDomain = "plausible.io" # default is set to plausible.io, only required if plausible is self hosted
+# scriptName = "plausible" # default is set to plausible, only required if using a custom name for script
 
 [matomo_analytics]
 enable = false # To enable matomo analytics change to `true`.

exampleSite/content/about.md

@@ -20,6 +20,6 @@ Hugo is ideal for blogs, corporate websites, creative portfolios, online magazin
 
 Hugo is for people who want to hand code their own website without worrying about setting up complicated runtimes, dependencies and databases.
 
-Websites built with Hugo are extremelly fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
+Websites built with Hugo are extremely fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
 
 Learn more and contribute on [GitHub](https://github.com/gohugoio).

exampleSite/content/about.pt.md

@@ -23,6 +23,6 @@ Hugo is ideal for blogs, corporate websites, creative portfolios, online magazin
 
 Hugo is for people who want to hand code their own website without worrying about setting up complicated runtimes, dependencies and databases.
 
-Websites built with Hugo are extremelly fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
+Websites built with Hugo are extremely fast, secure and can be deployed anywhere including, AWS, GitHub Pages, Heroku, Netlify and any other hosting provider.
 
 Learn more and contribute on [GitHub](https://github.com/gohugoio).

i18n/de.toml

@@ -17,7 +17,7 @@ other = "Empfohlene Artikel"
 other = "Neueste Artikel"
 
 [404_title]
-other = "Verloren"
+other = "Verirrt"
 
 [could_not_find]
 other = "Die gesuchte Seite konnte nicht gefunden werden"
@@ -50,7 +50,7 @@ other = "Alle Serien"
 other = "Inhalt"
 
 [reading_time]
-other = "{{ .ReadingTime }} min lesen"
+other = "Lesezeit {{ .ReadingTime }} Min."
 
 [series_posts]
 other = "Beiträge in dieser Serie"