diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c9bf63e6..8639f1c7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,7 +12,7 @@ - Great! Open a new GitHub pull request with the patch. - All development occurs on the `dev` branch and new PRs should be forked from here. -- The command `npm run example` can be used to test local changes using the example site. +- The commands `npm run example`, `npm run example:core`, and `npm run example:production` can be used to test local changes using the example site. - Ensure the PR description clearly describes the problem and solution. Include the relevant issue number, if applicable. - **Before submitting**, check the [coding conventions](#coding-conventions) section below to learn more about coding and commit message expectations. diff --git a/assets/css/compiled/main.css b/assets/css/compiled/main.css index 6d3f7b22..118e9a78 100644 --- a/assets/css/compiled/main.css +++ b/assets/css/compiled/main.css @@ -1,4 +1,4 @@ -/*! tailwindcss v4.1.7 | MIT License | https://tailwindcss.com */ +/*! tailwindcss v4.1.8 | MIT License | https://tailwindcss.com */ /*! Blowfish | MIT License | https://github.com/nunocoracao/blowfish */ @layer properties; #zen-mode-button { diff --git a/config.toml b/config.toml index d52ad7d9..7386f8d2 100644 --- a/config.toml +++ b/config.toml @@ -2,4 +2,4 @@ [module.hugoVersion] extended = true min = "0.137.0" -max = "0.147.5" \ No newline at end of file +max = "0.147.8" \ No newline at end of file diff --git a/config/_default/params.toml b/config/_default/params.toml index 4ade93d2..7843f825 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -18,6 +18,7 @@ replyByEmail = false # robots = "" disableImageOptimization = false +disableImageOptimizationMD = false disableTextInHeader = false # backgroundImageWidth = 1200 @@ -29,6 +30,8 @@ disableTextInHeader = false # smartTOC = true # smartTOCHideUnfocusedChildren = true +fingerprintAlgorithm = "sha512" # Valid values are "sha512" (default), "sha384", "sha256" + giteaDefaultServer = "https://git.fsfe.org" forgejoDefaultServer = "https://v8.next.forgejo.org" @@ -52,6 +55,7 @@ forgejoDefaultServer = "https://v8.next.forgejo.org" cardView = false cardViewScreenWidth = false layoutBackgroundBlur = false # only used when layout equals background + disableHeroImageFilter = false # only used when layout equals hero [article] showDate = true diff --git a/exampleSite/config/_default/hugo.toml b/exampleSite/config/_default/hugo.toml index dcbc6bf9..d03b41f7 100644 --- a/exampleSite/config/_default/hugo.toml +++ b/exampleSite/config/_default/hugo.toml @@ -70,11 +70,19 @@ googleAnalytics = "G-PEDMYR1V0K" type = 'fragments' weight = 10 -# Render only specific parts of the site for faster development. Use: hugo --renderSegments site_core +# Render only specific parts of the site for faster development. +# Note that there are more files are ignored in development/hugo.toml +# +# Usage: `hugo --renderSegments core` or `hugo --renderSegments core,en_only` [segments] - [segments.site_core] - [[segments.site_core.includes]] + [segments.core] + [[segments.core.includes]] + # Debug core pages path = '{/,/docs,/docs/**,/samples,/samples/**}' [segments.en_only] [[segments.en_only.includes]] + # Alternatively, you can use environment variable + # - UNIX: HUGO_DISABLELANGUAGES='it ja zh-cn' npm run example:core + # - Windows CMD: set "HUGO_DISABLELANGUAGES=it ja zh-cn" && npm run example:core + # - Windows PowerShell: $env:HUGO_DISABLELANGUAGES="it ja zh-cn"; npm run example:core lang = 'en' diff --git a/exampleSite/config/_default/params.toml b/exampleSite/config/_default/params.toml index c6790ad5..e9cdb663 100644 --- a/exampleSite/config/_default/params.toml +++ b/exampleSite/config/_default/params.toml @@ -30,6 +30,11 @@ highlightCurrentMenuArea = true smartTOC = true smartTOCHideUnfocusedChildren = false +# giteaDefaultServer = "https://git.fsfe.org" +# forgejoDefaultServer = "https://v8.next.forgejo.org" + +fingerprintAlgorithm = "sha512" # Valid values are "sha512" (default), "sha384", "sha256" + [header] layout = "fixed" # valid options: basic, fixed, fixed-fill, fixed-gradient, fixed-fill-blur @@ -63,6 +68,7 @@ smartTOCHideUnfocusedChildren = false showHero = true heroStyle = "background" # valid options: basic, big, background, thumbAndBackground layoutBackgroundBlur = true # only used when heroStyle equals background + layoutBackgroundHeaderSpace = true # only used when heroStyle equals background showBreadcrumbs = true showDraftLabel = true showEdit = true diff --git a/exampleSite/content/docs/configuration/index.it.md b/exampleSite/content/docs/configuration/index.it.md index 907442ff..e6b36978 100644 --- a/exampleSite/content/docs/configuration/index.it.md +++ b/exampleSite/content/docs/configuration/index.it.md @@ -186,6 +186,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | `highlightCurrentMenuArea` | _Not set_ | Marks menu entries in the main menu when selected | | `smartTOC` | _Not set_ | Activate smart Table of Contents, items in view will be highlighted. | | `smartTOCHideUnfocusedChildren` | _Not set_ | When smart Table of Contents is turned on, this will hide deeper levels of the table when they are not in focus. | +| `fingerprintAlgorithm` | `"sha512"` | This configures the fingerprint or resources.Fingerprint used in .Data.Integrity for files provided by the theme. Valid values are `sha512` (default), `sha384`, `sha256` | ### Header diff --git a/exampleSite/content/docs/configuration/index.ja.md b/exampleSite/content/docs/configuration/index.ja.md index 41699b8e..0ef0a3a4 100644 --- a/exampleSite/content/docs/configuration/index.ja.md +++ b/exampleSite/content/docs/configuration/index.ja.md @@ -186,6 +186,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ | `highlightCurrentMenuArea` | _未設定_ | メインメニューのメニュー項目が選択されているときにマークを付けます。 | | `smartTOC` | _未設定_ | スマート目次をアクティブにします。表示されている項目が強調表示されます。 | | `smartTOCHideUnfocusedChildren` | _未設定_ | スマート目次がオンになっている場合、フォーカスされていないときに、テーブルのより深いレベルが非表示になります。 | +| `fingerprintAlgorithm` | `"sha512"` | This configures the fingerprint or resources.Fingerprint used in .Data.Integrity for files provided by the theme. Valid values are `sha512` (default), `sha384`, `sha256` | ### ヘッダー(Header) diff --git a/exampleSite/content/docs/configuration/index.md b/exampleSite/content/docs/configuration/index.md index 2e7a5973..ba208363 100644 --- a/exampleSite/content/docs/configuration/index.md +++ b/exampleSite/content/docs/configuration/index.md @@ -192,6 +192,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | `highlightCurrentMenuArea` | _Not set_ | Marks menu entries in the main menu when selected | | `smartTOC` | _Not set_ | Activate smart Table of Contents, items in view will be highlighted. | | `smartTOCHideUnfocusedChildren` | _Not set_ | When smart Table of Contents is turned on, this will hide deeper levels of the table when they are not in focus. | +| `fingerprintAlgorithm` | `"sha512"` | This configures the fingerprint or resources.Fingerprint used in .Data.Integrity for files provided by the theme. Valid values are `sha512` (default), `sha384`, `sha256` | ### Header @@ -252,7 +253,8 @@ Many of the article defaults here can be overridden on a per article basis by sp | `article.showTableOfContents` | `false` | Whether or not the table of contents is displayed on articles. | | `article.showRelatedContent` | `false` | Display related content for each post. Might required additional configuration to your `config.toml`. Please check the theme `config.toml` if you want to enable this feature and copy all the relevant _related_ entries. Also check [Hugo's docs](https://gohugo.io/content-management/related/) on related content. | | `article.relatedContentLimit` | `3` | Limit of related articles to display if `showRelatedContent` is turned on. | -| `article.showTaxonomies` | `false` | Whether or not the taxonomies related to this article are displayed. | +| `article.showTaxonomies` | `false` | Whether or not all the taxonomies related to this article are displayed. | +| `article.showCategoryOnly` | `false` | Whether or not the "category" taxonomy is displayed. `showTaxonomies` should be `false` when this param is used, otherwise duplicates will appear. | | `article.showAuthorsBadges` | `false` | Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | | `article.showWordCount` | `false` | Whether or not article word counts are displayed. | | `article.showComments` | `false` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | diff --git a/exampleSite/content/docs/configuration/index.zh-cn.md b/exampleSite/content/docs/configuration/index.zh-cn.md index 3e4b99b5..69d15240 100644 --- a/exampleSite/content/docs/configuration/index.zh-cn.md +++ b/exampleSite/content/docs/configuration/index.zh-cn.md @@ -190,6 +190,7 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中 | `highlightCurrentMenuArea` | 无 | 当菜单被选择时,标记主菜单中的菜单项。 | | `smartTOC` | 无 | 开启智能目录,视图中的项目将会被高亮显示。 | | `smartTOCHideUnfocusedChildren` | 无 | 当开启智能目录,如果目录级别不再被聚焦时,将会隐藏更深层次的目录。 | +| `fingerprintAlgorithm` | `"sha512"` | This configures the fingerprint or resources.Fingerprint used in .Data.Integrity for files provided by the theme. Valid values are `sha512` (default), `sha384`, `sha256` | ### 页头 diff --git a/exampleSite/content/docs/content-examples/index.it.md b/exampleSite/content/docs/content-examples/index.it.md index 35270195..52d51a05 100644 --- a/exampleSite/content/docs/content-examples/index.it.md +++ b/exampleSite/content/docs/content-examples/index.it.md @@ -198,7 +198,7 @@ date: 2022-01-25 externalUrl: "https://medium.com/" summary: "I wrote a post on Medium." showReadingTime: false -_build: +build: render: "false" list: "local" --- @@ -206,7 +206,7 @@ _build: Along with the normal front matter parameters like `title` and `summary`, the `externalUrl` parameter is used to tell Blowfish that this is not an ordinary article. The URL provided here will be where visitors are directed when they select this article. -Additionally, we use a special Hugo front matter parameter `_build` to prevent a normal page for this content being generated - there's no point generating a page since we're linking to an external URL! +Additionally, we use a special Hugo front matter parameter `build` to prevent a normal page for this content being generated - there's no point generating a page since we're linking to an external URL! The theme includes an archetype to make generating these external link articles simple. Just specify `-k external` when making new content. diff --git a/exampleSite/content/docs/content-examples/index.ja.md b/exampleSite/content/docs/content-examples/index.ja.md index c986daa4..cad99da6 100644 --- a/exampleSite/content/docs/content-examples/index.ja.md +++ b/exampleSite/content/docs/content-examples/index.ja.md @@ -198,7 +198,7 @@ date: 2022-01-25 externalUrl: "https://medium.com/" summary: "Medium に記事を投稿しました。" showReadingTime: false -_build: +build: render: "false" list: "local" --- @@ -206,7 +206,7 @@ _build: `title` や `summary` などの通常の Front Matter パラメータに加えて、`externalUrl` パラメータは、これが通常の記事ではないことを Blowfish に伝えるために使用されます。ここに指定された URL は、訪問者がこの記事を選択した際にリダイレクトされる場所です。 -さらに、特別な Hugo フロントマターパラメータ `_build` を使用して、このコンテンツの通常のページが生成されないようにします。外部リンクにリダイレクトするため、ページを生成する必要はありません。 +さらに、特別な Hugo フロントマターパラメータ `build` を使用して、このコンテンツの通常のページが生成されないようにします。外部リンクにリダイレクトするため、ページを生成する必要はありません。 テーマには、外部リンク記事を簡単に作成するためのアーキタイプが含まれています。新しいコンテンツを作成する際に、`-k external` を指定するだけです。 diff --git a/exampleSite/content/docs/content-examples/index.md b/exampleSite/content/docs/content-examples/index.md index 35270195..52d51a05 100644 --- a/exampleSite/content/docs/content-examples/index.md +++ b/exampleSite/content/docs/content-examples/index.md @@ -198,7 +198,7 @@ date: 2022-01-25 externalUrl: "https://medium.com/" summary: "I wrote a post on Medium." showReadingTime: false -_build: +build: render: "false" list: "local" --- @@ -206,7 +206,7 @@ _build: Along with the normal front matter parameters like `title` and `summary`, the `externalUrl` parameter is used to tell Blowfish that this is not an ordinary article. The URL provided here will be where visitors are directed when they select this article. -Additionally, we use a special Hugo front matter parameter `_build` to prevent a normal page for this content being generated - there's no point generating a page since we're linking to an external URL! +Additionally, we use a special Hugo front matter parameter `build` to prevent a normal page for this content being generated - there's no point generating a page since we're linking to an external URL! The theme includes an archetype to make generating these external link articles simple. Just specify `-k external` when making new content. diff --git a/exampleSite/content/docs/content-examples/index.zh-cn.md b/exampleSite/content/docs/content-examples/index.zh-cn.md index 7308e3b2..befef413 100644 --- a/exampleSite/content/docs/content-examples/index.zh-cn.md +++ b/exampleSite/content/docs/content-examples/index.zh-cn.md @@ -198,7 +198,7 @@ date: 2022-01-25 externalUrl: "https://medium.com/" summary: "我在Medium上写了一篇文章。" showReadingTime: false -_build: +build: render: "false" list: "local" --- @@ -206,7 +206,7 @@ _build: 除了像 `title` 和 `summary` 这种普通的扉页参数外,需要设置 `externalUrl` 参数来告诉 Blowfish 这不是一篇普通的文章。访问者在访问后,会被重定向到这里提供的 URL。 -此外,我们使用了 `_build` 参数来避免 Hugo 生成一个普通页面。因为我们是一个连接到外部的 URL,生成页面是没有意义的。 +此外,我们使用了 `build` 参数来避免 Hugo 生成一个普通页面。因为我们是一个连接到外部的 URL,生成页面是没有意义的。 Hugo 中可以通过命令来快速生成一个外部链接的文件,在创建新的外部链接是,只需要指定 `-k external` 即可。这让生成外部链接文章变得更简单。 diff --git a/exampleSite/content/docs/partials/index.it.md b/exampleSite/content/docs/partials/index.it.md index 13225e0d..c522aaba 100644 --- a/exampleSite/content/docs/partials/index.it.md +++ b/exampleSite/content/docs/partials/index.it.md @@ -137,3 +137,11 @@ If you wish to insert additional code after article links, create a `layouts/par The theme allows for inserting additional code directly into the `` and `