From 170671b35794cf91d9bf20356db4e82b534738b5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nuno=20Cora=C3=A7=C3=A3o?= Date: Mon, 24 Nov 2025 23:57:24 +0000 Subject: [PATCH 01/60] :bookmark: v2.94.0 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index d9c35e3a..f1cf864b 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "hugo-blowfish-theme", - "version": "2.93.0", + "version": "2.94.0", "description": "Blowfish theme for Hugo.", "scripts": { "postinstall": "vendor-copy", From 0e8cc80a8863397da17c0ce5156354562d3100dc Mon Sep 17 00:00:00 2001 From: Florian Hoss Date: Tue, 25 Nov 2025 05:00:51 +0100 Subject: [PATCH 02/60] Document excludeFromSearch front matter parameter Added documentation for the `excludeFromSearch` front matter parameter, explaining its default value and effect on sitemap and search index inclusion. --- exampleSite/content/docs/front-matter/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/exampleSite/content/docs/front-matter/index.md b/exampleSite/content/docs/front-matter/index.md index 5d02d074..1c452c9f 100644 --- a/exampleSite/content/docs/front-matter/index.md +++ b/exampleSite/content/docs/front-matter/index.md @@ -54,6 +54,7 @@ Front matter parameter default values are inherited from the theme's [base confi | `series_order` | _Not set_ | Number of the article within the series. | | `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | | `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | +| `excludeFromSearch` | `false` | Whether or not this article should be excluded from the sitemap and search index. When `true`, the page will not appear in `sitemap.xml` or `index.json`. | | `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | | `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | From 7efecc2148ef1727c659b15e027e89ca29ba8814 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 05:01:29 +0000 Subject: [PATCH 03/60] =?UTF-8?q?=F0=9F=91=B7=20bump=20actions/checkout=20?= =?UTF-8?q?from=205=20to=206?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bumps [actions/checkout](https://github.com/actions/checkout) from 5 to 6. - [Release notes](https://github.com/actions/checkout/releases) - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md) - [Commits](https://github.com/actions/checkout/compare/v5...v6) --- updated-dependencies: - dependency-name: actions/checkout dependency-version: '6' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] --- .github/workflows/build.yml | 2 +- .github/workflows/create-config-zip.yml | 2 +- .github/workflows/hugo-version-update.yml | 2 +- .github/workflows/pages.yml | 2 +- .github/workflows/test.yml | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 6a33d87d..13793a3c 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -8,7 +8,7 @@ jobs: if: ${{ github.actor == 'dependabot[bot]' }} steps: - name: Checkout - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: ref: "${{ github.head_ref }}" - name: Install dependencies and Build Theme diff --git a/.github/workflows/create-config-zip.yml b/.github/workflows/create-config-zip.yml index 207b2a70..0304fadf 100644 --- a/.github/workflows/create-config-zip.yml +++ b/.github/workflows/create-config-zip.yml @@ -8,7 +8,7 @@ jobs: zip: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v5 + - uses: actions/checkout@v6 - run: zip -r config-default.zip config/_default - uses: actions/upload-artifact@v5 with: diff --git a/.github/workflows/hugo-version-update.yml b/.github/workflows/hugo-version-update.yml index cd83befc..39184754 100644 --- a/.github/workflows/hugo-version-update.yml +++ b/.github/workflows/hugo-version-update.yml @@ -11,7 +11,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Check out code into the Go module directory - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: ref: dev submodules: true # Fetch Hugo themes (true OR recursive) diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 675d66c5..b6a8ed1d 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -37,7 +37,7 @@ jobs: wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_Linux-64bit.deb \ && sudo dpkg -i ${{ runner.temp }}/hugo.deb - name: Checkout - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: submodules: recursive - name: Setup Pages diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 495ae217..d46bcb80 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -10,7 +10,7 @@ jobs: group: ${{ github.workflow }}-${{ github.ref }} steps: - name: Checkout - uses: actions/checkout@v5 + uses: actions/checkout@v6 with: submodules: true fetch-depth: 0 From 2137efd7000daf8705347832ba2085849b800931 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 05:01:37 +0000 Subject: [PATCH 04/60] =?UTF-8?q?=F0=9F=93=8C=20bump=20lite-youtube-embed?= =?UTF-8?q?=20from=200.3.3=20to=200.3.4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bumps [lite-youtube-embed](https://github.com/paulirish/lite-youtube-embed) from 0.3.3 to 0.3.4. - [Release notes](https://github.com/paulirish/lite-youtube-embed/releases) - [Commits](https://github.com/paulirish/lite-youtube-embed/compare/v0.3.3...v0.3.4) --- updated-dependencies: - dependency-name: lite-youtube-embed dependency-version: 0.3.4 dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 27 ++++++++++++++++----------- package.json | 2 +- 2 files changed, 17 insertions(+), 12 deletions(-) diff --git a/package-lock.json b/package-lock.json index ddc23067..036f026e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "hugo-blowfish-theme", - "version": "2.93.0", + "version": "2.94.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hugo-blowfish-theme", - "version": "2.93.0", + "version": "2.94.0", "hasInstallScript": true, "license": "MIT", "dependencies": { @@ -24,7 +24,7 @@ "fuse.js": "^7.1.0", "jquery": "^3.7.1", "katex": "^0.16.25", - "lite-youtube-embed": "^0.3.3", + "lite-youtube-embed": "^0.3.4", "medium-zoom": "^1.1.0", "mermaid": "^11.12.1", "packery": "^3.0.0", @@ -1787,6 +1787,7 @@ "integrity": "sha512-ci2iJH6LeIkvP9eJW6gpueU8cnZhv85ELY8w8WiFtNjMHA5ad6pQLaJo9mEly/9qUyCpvqX8/POVUTf18/HFdw==", "dev": true, "license": "Apache-2.0", + "peer": true, "dependencies": { "@chevrotain/cst-dts-gen": "11.0.3", "@chevrotain/gast": "11.0.3", @@ -2026,6 +2027,7 @@ "resolved": "https://registry.npmjs.org/cytoscape/-/cytoscape-3.30.2.tgz", "integrity": "sha512-oICxQsjW8uSaRmn4UK/jkczKOqTrVqt5/1WL0POiJUT2EKNc9STM4hYFHv917yu55aTBMFNRzymlJhVAiWPCxw==", "dev": true, + "peer": true, "engines": { "node": ">=0.10" } @@ -2461,6 +2463,7 @@ "integrity": "sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==", "dev": true, "license": "ISC", + "peer": true, "engines": { "node": ">=12" } @@ -2646,7 +2649,8 @@ "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1521046.tgz", "integrity": "sha512-vhE6eymDQSKWUXwwA37NtTTVEzjtGVfDr3pRbsWEQ5onH/Snp2c+2xZHWJJawG/0hCCJLRGt4xVtEVUVILol4w==", "dev": true, - "license": "BSD-3-Clause" + "license": "BSD-3-Clause", + "peer": true }, "node_modules/dompurify": { "version": "3.2.6", @@ -3533,10 +3537,11 @@ "dev": true }, "node_modules/lite-youtube-embed": { - "version": "0.3.3", - "resolved": "https://registry.npmjs.org/lite-youtube-embed/-/lite-youtube-embed-0.3.3.tgz", - "integrity": "sha512-gFfVVnj6NRjxVfJKo3qoLtpi0v5mn3AcR4eKD45wrxQuxzveFJUb+7Cr6uV6n+DjO8X3p0UzPPquhGt0H/y+NA==", - "dev": true + "version": "0.3.4", + "resolved": "https://registry.npmjs.org/lite-youtube-embed/-/lite-youtube-embed-0.3.4.tgz", + "integrity": "sha512-aXgxpwK7AIW58GEbRzA8EYaY4LWvF3FKak6B9OtSJmuNyLhX2ouD4cMTxz/yR5HFInhknaYd2jLWOTRTvT8oAw==", + "dev": true, + "license": "Apache-2.0" }, "node_modules/local-pkg": { "version": "1.1.2", @@ -3567,7 +3572,6 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", - "peer": true, "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, @@ -3997,6 +4001,7 @@ "integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==", "dev": true, "license": "MIT", + "peer": true, "bin": { "prettier": "bin/prettier.cjs" }, @@ -4253,7 +4258,6 @@ "version": "0.23.2", "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz", "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", - "peer": true, "dependencies": { "loose-envify": "^1.1.0" } @@ -4529,7 +4533,8 @@ "version": "4.1.17", "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.17.tgz", "integrity": "sha512-j9Ee2YjuQqYT9bbRTfTZht9W/ytp5H+jJpZKiYdP/bpnXARAuELt9ofP0lPnmHjbga7SNQIxdTAXCmtKVYjN+Q==", - "license": "MIT" + "license": "MIT", + "peer": true }, "node_modules/tapable": { "version": "2.3.0", diff --git a/package.json b/package.json index f1cf864b..b7fad409 100644 --- a/package.json +++ b/package.json @@ -43,7 +43,7 @@ "fuse.js": "^7.1.0", "jquery": "^3.7.1", "katex": "^0.16.25", - "lite-youtube-embed": "^0.3.3", + "lite-youtube-embed": "^0.3.4", "medium-zoom": "^1.1.0", "mermaid": "^11.12.1", "packery": "^3.0.0", From 4bc91159d691d4ca7a23432104ae0c94ee7aa694 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 05:01:43 +0000 Subject: [PATCH 05/60] =?UTF-8?q?=F0=9F=93=8C=20bump=20rimraf=20from=206.1?= =?UTF-8?q?.0=20to=206.1.2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bumps [rimraf](https://github.com/isaacs/rimraf) from 6.1.0 to 6.1.2. - [Changelog](https://github.com/isaacs/rimraf/blob/main/CHANGELOG.md) - [Commits](https://github.com/isaacs/rimraf/compare/v6.1.0...v6.1.2) --- updated-dependencies: - dependency-name: rimraf dependency-version: 6.1.2 dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 425 +++------------------------------------------- package.json | 2 +- 2 files changed, 24 insertions(+), 403 deletions(-) diff --git a/package-lock.json b/package-lock.json index ddc23067..48372f79 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "hugo-blowfish-theme", - "version": "2.93.0", + "version": "2.94.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hugo-blowfish-theme", - "version": "2.93.0", + "version": "2.94.0", "hasInstallScript": true, "license": "MIT", "dependencies": { @@ -31,7 +31,7 @@ "prettier": "^3.6.2", "prettier-plugin-go-template": "^0.0.15", "puppeteer": "^24.31.0", - "rimraf": "^6.1.0", + "rimraf": "^6.1.2", "tailwind-scrollbar": "^4.0.2", "tailwindcss": "^4.1.16", "tw-elements": "2.0.0", @@ -303,24 +303,6 @@ "node": "20 || >=22" } }, - "node_modules/@isaacs/cliui": { - "version": "8.0.2", - "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", - "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==", - "dev": true, - "license": "ISC", - "dependencies": { - "string-width": "^5.1.2", - "string-width-cjs": "npm:string-width@^4.2.0", - "strip-ansi": "^7.0.1", - "strip-ansi-cjs": "npm:strip-ansi@^6.0.1", - "wrap-ansi": "^8.1.0", - "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0" - }, - "engines": { - "node": ">=12" - } - }, "node_modules/@jridgewell/gen-mapping": { "version": "0.3.13", "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", @@ -1543,32 +1525,6 @@ "node": ">= 14" } }, - "node_modules/ansi-regex": { - "version": "6.2.2", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", - "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/ansi-regex?sponsor=1" - } - }, - "node_modules/ansi-styles": { - "version": "6.2.3", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", - "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", @@ -1787,6 +1743,7 @@ "integrity": "sha512-ci2iJH6LeIkvP9eJW6gpueU8cnZhv85ELY8w8WiFtNjMHA5ad6pQLaJo9mEly/9qUyCpvqX8/POVUTf18/HFdw==", "dev": true, "license": "Apache-2.0", + "peer": true, "dependencies": { "@chevrotain/cst-dts-gen": "11.0.3", "@chevrotain/gast": "11.0.3", @@ -1994,21 +1951,6 @@ } } }, - "node_modules/cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", - "dev": true, - "license": "MIT", - "dependencies": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - }, - "engines": { - "node": ">= 8" - } - }, "node_modules/cssesc": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz", @@ -2026,6 +1968,7 @@ "resolved": "https://registry.npmjs.org/cytoscape/-/cytoscape-3.30.2.tgz", "integrity": "sha512-oICxQsjW8uSaRmn4UK/jkczKOqTrVqt5/1WL0POiJUT2EKNc9STM4hYFHv917yu55aTBMFNRzymlJhVAiWPCxw==", "dev": true, + "peer": true, "engines": { "node": ">=0.10" } @@ -2461,6 +2404,7 @@ "integrity": "sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==", "dev": true, "license": "ISC", + "peer": true, "engines": { "node": ">=12" } @@ -2646,7 +2590,8 @@ "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1521046.tgz", "integrity": "sha512-vhE6eymDQSKWUXwwA37NtTTVEzjtGVfDr3pRbsWEQ5onH/Snp2c+2xZHWJJawG/0hCCJLRGt4xVtEVUVILol4w==", "dev": true, - "license": "BSD-3-Clause" + "license": "BSD-3-Clause", + "peer": true }, "node_modules/dompurify": { "version": "3.2.6", @@ -2658,20 +2603,6 @@ "@types/trusted-types": "^2.0.7" } }, - "node_modules/eastasianwidth": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz", - "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==", - "dev": true, - "license": "MIT" - }, - "node_modules/emoji-regex": { - "version": "9.2.2", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", - "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==", - "dev": true, - "license": "MIT" - }, "node_modules/end-of-stream": { "version": "1.4.5", "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", @@ -2872,23 +2803,6 @@ "desandro-matches-selector": "^2.0.0" } }, - "node_modules/foreground-child": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz", - "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==", - "dev": true, - "license": "ISC", - "dependencies": { - "cross-spawn": "^7.0.6", - "signal-exit": "^4.0.1" - }, - "engines": { - "node": ">=14" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, "node_modules/fuse.js": { "version": "7.1.0", "resolved": "https://registry.npmjs.org/fuse.js/-/fuse.js-7.1.0.tgz", @@ -2947,22 +2861,16 @@ } }, "node_modules/glob": { - "version": "11.0.3", - "resolved": "https://registry.npmjs.org/glob/-/glob-11.0.3.tgz", - "integrity": "sha512-2Nim7dha1KVkaiF4q6Dj+ngPPMdfvLJEOpZk/jKiUAkqKebpGAWQXAq9z1xu9HKu5lWfqw/FASuccEjyznjPaA==", + "version": "13.0.0", + "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.0.tgz", + "integrity": "sha512-tvZgpqk6fz4BaNZ66ZsRaZnbHvP/jG3uKJvAZOwEVUL4RTA5nJeeLYfyN9/VA8NX/V3IBG+hkeuGpKjvELkVhA==", "dev": true, - "license": "ISC", + "license": "BlueOak-1.0.0", "dependencies": { - "foreground-child": "^3.3.1", - "jackspeak": "^4.1.1", - "minimatch": "^10.0.3", + "minimatch": "^10.1.1", "minipass": "^7.1.2", - "package-json-from-dist": "^1.0.0", "path-scurry": "^2.0.0" }, - "bin": { - "glob": "dist/esm/bin.mjs" - }, "engines": { "node": "20 || >=22" }, @@ -3130,29 +3038,6 @@ "node": ">=0.12.0" } }, - "node_modules/isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "dev": true, - "license": "ISC" - }, - "node_modules/jackspeak": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-4.1.1.tgz", - "integrity": "sha512-zptv57P3GpL+O0I7VdMJNBZCu+BPHVQUk55Ft8/QCJjTVxrnJHuVuX/0Bl2A6/+2oyR/ZMEuFKwmzqqZ/U5nPQ==", - "dev": true, - "license": "BlueOak-1.0.0", - "dependencies": { - "@isaacs/cliui": "^8.0.2" - }, - "engines": { - "node": "20 || >=22" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, "node_modules/jiti": { "version": "2.6.1", "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz", @@ -3567,7 +3452,6 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", - "peer": true, "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, @@ -3889,20 +3773,10 @@ "integrity": "sha512-NOnmBpt5Y2RWbuv0LMzsayp3lVylAHLPUTut412ZA3l+C4uw4ZVkQbjShYCQ8TCpUMdPapr4YjUqLYD6v68j+w==", "dev": true }, - "node_modules/path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, "node_modules/path-scurry": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.0.tgz", - "integrity": "sha512-ypGJsmGtdXUOeM5u93TyeIEfEhM6s+ljAhrk5vAvSx8uyY/02OvrZnA0YNGUrPXfpJMgI1ODd3nwz8Npx4O4cg==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.1.tgz", + "integrity": "sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==", "dev": true, "license": "BlueOak-1.0.0", "dependencies": { @@ -3997,6 +3871,7 @@ "integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==", "dev": true, "license": "MIT", + "peer": true, "bin": { "prettier": "bin/prettier.cjs" }, @@ -4197,13 +4072,13 @@ } }, "node_modules/rimraf": { - "version": "6.1.0", - "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.1.0.tgz", - "integrity": "sha512-DxdlA1bdNzkZK7JiNWH+BAx1x4tEJWoTofIopFo6qWUU94jYrFZ0ubY05TqH3nWPJ1nKa1JWVFDINZ3fnrle/A==", + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.1.2.tgz", + "integrity": "sha512-cFCkPslJv7BAXJsYlK1dZsbP8/ZNLkCAQ0bi1hf5EKX2QHegmDFEFA6QhuYJlk7UDdc+02JjO80YSOrWPpw06g==", "dev": true, "license": "BlueOak-1.0.0", "dependencies": { - "glob": "^11.0.3", + "glob": "^13.0.0", "package-json-from-dist": "^1.0.1" }, "bin": { @@ -4253,7 +4128,6 @@ "version": "0.23.2", "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz", "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", - "peer": true, "dependencies": { "loose-envify": "^1.1.0" } @@ -4271,42 +4145,6 @@ "node": ">=10" } }, - "node_modules/shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "dev": true, - "license": "MIT", - "dependencies": { - "shebang-regex": "^3.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/signal-exit": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", - "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", - "dev": true, - "license": "ISC", - "engines": { - "node": ">=14" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, "node_modules/smart-buffer": { "version": "4.2.0", "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz", @@ -4381,110 +4219,6 @@ "text-decoder": "^1.1.0" } }, - "node_modules/string-width": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz", - "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==", - "dev": true, - "license": "MIT", - "dependencies": { - "eastasianwidth": "^0.2.0", - "emoji-regex": "^9.2.2", - "strip-ansi": "^7.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/string-width-cjs": { - "name": "string-width", - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "dev": true, - "license": "MIT", - "dependencies": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/string-width-cjs/node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/string-width-cjs/node_modules/emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true, - "license": "MIT" - }, - "node_modules/string-width-cjs/node_modules/strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-regex": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/strip-ansi": { - "version": "7.1.2", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", - "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-regex": "^6.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/strip-ansi?sponsor=1" - } - }, - "node_modules/strip-ansi-cjs": { - "name": "strip-ansi", - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-regex": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/strip-ansi-cjs/node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, "node_modules/stylis": { "version": "4.3.6", "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.6.tgz", @@ -4529,7 +4263,8 @@ "version": "4.1.17", "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.17.tgz", "integrity": "sha512-j9Ee2YjuQqYT9bbRTfTZht9W/ytp5H+jJpZKiYdP/bpnXARAuELt9ofP0lPnmHjbga7SNQIxdTAXCmtKVYjN+Q==", - "license": "MIT" + "license": "MIT", + "peer": true }, "node_modules/tapable": { "version": "2.3.0", @@ -4813,120 +4548,6 @@ "dev": true, "license": "Apache-2.0" }, - "node_modules/which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "dev": true, - "license": "ISC", - "dependencies": { - "isexe": "^2.0.0" - }, - "bin": { - "node-which": "bin/node-which" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/wrap-ansi": { - "version": "8.1.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", - "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-styles": "^6.1.0", - "string-width": "^5.0.1", - "strip-ansi": "^7.0.1" - }, - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/chalk/wrap-ansi?sponsor=1" - } - }, - "node_modules/wrap-ansi-cjs": { - "name": "wrap-ansi", - "version": "7.0.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", - "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-styles": "^4.0.0", - "string-width": "^4.1.0", - "strip-ansi": "^6.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/chalk/wrap-ansi?sponsor=1" - } - }, - "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, - "license": "MIT", - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true, - "license": "MIT" - }, - "node_modules/wrap-ansi-cjs/node_modules/string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "dev": true, - "license": "MIT", - "dependencies": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-regex": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", diff --git a/package.json b/package.json index f1cf864b..af3dfde3 100644 --- a/package.json +++ b/package.json @@ -50,7 +50,7 @@ "prettier": "^3.6.2", "prettier-plugin-go-template": "^0.0.15", "puppeteer": "^24.31.0", - "rimraf": "^6.1.0", + "rimraf": "^6.1.2", "tailwind-scrollbar": "^4.0.2", "tailwindcss": "^4.1.16", "tw-elements": "2.0.0", From 0f105d2acba9c2cf4d420e115e20eab3632a36b4 Mon Sep 17 00:00:00 2001 From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com> Date: Tue, 25 Nov 2025 03:05:27 +0800 Subject: [PATCH 06/60] docs: add theme-switcher for color schemes --- assets/css/compiled/main.css | 16 ++- .../content/docs/getting-started/index.it.md | 74 +----------- .../content/docs/getting-started/index.ja.md | 74 +----------- .../content/docs/getting-started/index.md | 74 +----------- .../docs/getting-started/index.zh-cn.md | 74 +----------- .../layouts/shortcodes/theme-switcher.html | 111 ++++++++++++++++++ 6 files changed, 133 insertions(+), 290 deletions(-) create mode 100644 exampleSite/layouts/shortcodes/theme-switcher.html diff --git a/assets/css/compiled/main.css b/assets/css/compiled/main.css index 4aa0bfcb..4a5b2722 100644 --- a/assets/css/compiled/main.css +++ b/assets/css/compiled/main.css @@ -2139,6 +2139,10 @@ --tw-shadow: 0 20px 25px -5px var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 8px 10px -6px var(--tw-shadow-color, rgb(0 0 0 / 0.1)); box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow); } + .outline { + outline-style: var(--tw-outline-style); + outline-width: 1px; + } .blur { --tw-blur: blur(8px); filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,); @@ -4139,6 +4143,11 @@ pre { inherits: false; initial-value: 0 0 #0000; } +@property --tw-outline-style { + syntax: "*"; + inherits: false; + initial-value: solid; +} @property --tw-blur { syntax: "*"; inherits: false; @@ -4241,11 +4250,6 @@ pre { initial-value: ""; inherits: false; } -@property --tw-outline-style { - syntax: "*"; - inherits: false; - initial-value: solid; -} @keyframes pulse { 50% { opacity: 0.5; @@ -4302,6 +4306,7 @@ pre { --tw-ring-offset-width: 0px; --tw-ring-offset-color: #fff; --tw-ring-offset-shadow: 0 0 #0000; + --tw-outline-style: solid; --tw-blur: initial; --tw-brightness: initial; --tw-contrast: initial; @@ -4327,7 +4332,6 @@ pre { --tw-duration: initial; --tw-ease: initial; --tw-content: ""; - --tw-outline-style: solid; } } } diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md index a0ea966a..a3707243 100644 --- a/exampleSite/content/docs/getting-started/index.it.md +++ b/exampleSite/content/docs/getting-started/index.it.md @@ -66,79 +66,11 @@ Se hai bisogno di ulteriori dettagli, ulteriori informazioni su ciascuna di ques ## Schemi di colori -Blowfish viene fornito con una serie di schemi di colori già pronti. Per cambiare lo schema, è sufficiente impostare il parametro del tema `colorScheme`. Le opzioni valide sono `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github` and `one-light`. +Blowfish offre diversi schemi di colore predefiniti. Puoi provare gli schemi incorporati qui sotto: -```toml -# config/_default/params.toml +{{< theme-switcher >}} -colorScheme = "blowfish" -``` - -Blowfish definisce una palette di tre colori che viene utilizzata in tutto il tema. Ogni colore principale contiene dieci sfumature basate sui colori inclusi in [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). I tre colori principali sono utilizzati per l'intestazione, il piè di pagina e i colori d'accento. Ecco i colori per ogni schema: - -### Blowfish (default) - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Avocado - -{{< swatches "#78716c" "#84cc16" "#10b981" >}} - -### Fire - -{{< swatches "#78716c" "#f97316" "#f43f5e" >}} - -### Ocean - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Forest - -{{< swatches "#658c86" "#3bf5df" "#06d45c" >}} - -### Princess - -{{< swatches "#8c658c" "#f53bf2" "#7706d4" >}} - -### Neon - -{{< swatches "#8338ec" "#ff006e" "#3a86ff" >}} - -### Bloody - -{{< swatches "#d90429" "#8d99ae" "#457b9d" >}} - -### Terminal - -{{< swatches "#004b23" "#38b000" "#1a759f" >}} - -### Marvel - -{{< swatches "#2541b2" "#d81159" "#ffbc42" >}} - -### Noir - -{{< swatches "#5c6b73" "#9db4c0" "#00a5cf" >}} - -### Autumn - -{{< swatches "#0a9396" "#ee9b00" "#bb3e03" >}} - -### Congo - -{{< swatches "#71717a" "#8b5cf6" "#d946ef" >}} - -### Slate - -{{< swatches "#6B7280" "#64748b" "#6B7280" >}} - -### Github - -{{< swatches "#64748b" "#0092ff" "#f54728" >}} - -### One-Light - -{{< swatches "#646464" "#0070cc" "#20a077" >}} +Ogni schema di colore in Blowfish si basa su una palette composta da tre colori, utilizzata in modo coerente all’interno del tema. Ciascuno di questi colori principali deriva dalle palette a dieci tonalità incluse in [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). Sebbene questi siano gli schemi predefiniti, è possibile crearne di propri. Per maggiori informazioni, consultare la sezione [Personalizzazione avanzata]({{< ref "advanced-customisation#colour-schemes" >}}). diff --git a/exampleSite/content/docs/getting-started/index.ja.md b/exampleSite/content/docs/getting-started/index.ja.md index ab155247..6594f4a3 100644 --- a/exampleSite/content/docs/getting-started/index.ja.md +++ b/exampleSite/content/docs/getting-started/index.ja.md @@ -63,79 +63,11 @@ links = [ ## カラースキーム -Blowfish には、すぐに使用できる多くのカラースキームが付属しています。スキームを変更するには、`colorScheme` テーマパラメータを設定するだけです。有効なオプションは、`blowfish` (デフォルト)、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`、`github`、`one-light` です。 +Blowfish には複数のカラースキームが用意されている。以下の組み込みスキームを試すことができます: -```toml -# config/_default/params.toml +{{< theme-switcher >}} -colorScheme = "blowfish" -``` - -Blowfish は、テーマ全体で使用される3色のパレットを定義しています。各メインカラーには、[Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) に含まれる色に基づいた10の色合いが含まれています。3つのメインカラーは、ヘッダー、フッター、およびアクセントカラーに使用されます。各スキームの色は次のとおりです。 - -### Blowfish (デフォルト) - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Avocado - -{{< swatches "#78716c" "#84cc16" "#10b981" >}} - -### Fire - -{{< swatches "#78716c" "#f97316" "#f43f5e" >}} - -### Ocean - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Forest - -{{< swatches "#658c86" "#3bf5df" "#06d45c" >}} - -### Princess - -{{< swatches "#8c658c" "#f53bf2" "#7706d4" >}} - -### Neon - -{{< swatches "#8338ec" "#ff006e" "#3a86ff" >}} - -### Bloody - -{{< swatches "#d90429" "#8d99ae" "#457b9d" >}} - -### Terminal - -{{< swatches "#004b23" "#38b000" "#1a759f" >}} - -### Marvel - -{{< swatches "#2541b2" "#d81159" "#ffbc42" >}} - -### Noir - -{{< swatches "#5c6b73" "#9db4c0" "#00a5cf" >}} - -### Autumn - -{{< swatches "#0a9396" "#ee9b00" "#bb3e03" >}} - -### Congo - -{{< swatches "#71717a" "#8b5cf6" "#d946ef" >}} - -### Slate - -{{< swatches "#6B7280" "#64748b" "#6B7280" >}} - -### Github - -{{< swatches "#64748b" "#0092ff" "#f54728" >}} - -### One-Light - -{{< swatches "#646464" "#0070cc" "#20a077" >}} +Blowfish の各カラースキームは三色のパレットに基づき、テーマ全体で一貫して使用される。各主色は [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) に含まれる十段階のカラーパレットを基礎として構成される。 これらはデフォルトのスキームですが、独自のスキームを作成することもできます。詳細については、[高度なカスタマイズ]({{< ref "advanced-customisation#colour-schemes" >}})セクションを参照してください。 diff --git a/exampleSite/content/docs/getting-started/index.md b/exampleSite/content/docs/getting-started/index.md index ef5aa866..4bb58105 100644 --- a/exampleSite/content/docs/getting-started/index.md +++ b/exampleSite/content/docs/getting-started/index.md @@ -63,79 +63,11 @@ If you need extra detail, further information about each of these configuration ## Colour schemes -Blowfish ships with a number of colour schemes out of the box. To change the scheme, simply set the `colorScheme` theme parameter. Valid options are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github` and `one-light`. +Blowfish ships with a number of colour schemes out of the box. You can try out the built-in schemes below: -```toml -# config/_default/params.toml +{{< theme-switcher >}} -colorScheme = "blowfish" -``` - -Blowfish defines a three-colour palette that is used throughout the theme. Each main colour contains ten shades which are based upon the colours that are included in [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). The three main colours are used for the header, footer, and accent colours. Here are the colors for each scheme: - -### Blowfish (default) - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Avocado - -{{< swatches "#78716c" "#84cc16" "#10b981" >}} - -### Fire - -{{< swatches "#78716c" "#f97316" "#f43f5e" >}} - -### Ocean - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Forest - -{{< swatches "#658c86" "#3bf5df" "#06d45c" >}} - -### Princess - -{{< swatches "#8c658c" "#f53bf2" "#7706d4" >}} - -### Neon - -{{< swatches "#8338ec" "#ff006e" "#3a86ff" >}} - -### Bloody - -{{< swatches "#d90429" "#8d99ae" "#457b9d" >}} - -### Terminal - -{{< swatches "#004b23" "#38b000" "#1a759f" >}} - -### Marvel - -{{< swatches "#2541b2" "#d81159" "#ffbc42" >}} - -### Noir - -{{< swatches "#5c6b73" "#9db4c0" "#00a5cf" >}} - -### Autumn - -{{< swatches "#0a9396" "#ee9b00" "#bb3e03" >}} - -### Congo - -{{< swatches "#71717a" "#8b5cf6" "#d946ef" >}} - -### Slate - -{{< swatches "#6B7280" "#64748b" "#6B7280" >}} - -### Github - -{{< swatches "#64748b" "#0092ff" "#f54728" >}} - -### One-Light - -{{< swatches "#646464" "#0070cc" "#20a077" >}} +Each colour scheme in Blowfish is built upon a three-colour palette that is used consistently throughout the theme. Each of these main colours is based on the ten-shade colour palettes included in [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference). Although these are the default schemes, you can also create your own. Refer to the [Advanced Customisation]({{< ref "advanced-customisation#colour-schemes" >}}) section for details. diff --git a/exampleSite/content/docs/getting-started/index.zh-cn.md b/exampleSite/content/docs/getting-started/index.zh-cn.md index 22e089a0..d5090801 100644 --- a/exampleSite/content/docs/getting-started/index.zh-cn.md +++ b/exampleSite/content/docs/getting-started/index.zh-cn.md @@ -63,79 +63,11 @@ links = [ ## 颜色方案 -Blowfish 主题中包含了数个颜色方案,这些方案可以快速使用。如果需要修改方案,只需要简单的设置 `colorScheme` 参数即可。`colorScheme` 可选的值有`blowfish` (默认)、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`、`github` 和 `one-light`。 +Blowfish 提供多种预设配色方案。你可以在下面测试可用的配色方案: -```toml -# config/_default/params.toml +{{< theme-switcher >}} -colorScheme = "blowfish" -``` - -Blowfish 定义了一种由三种主色调构成的配色方案,每种主色调包含了10种子色调,10个色调是借鉴 [Tailwind](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) 中的定义。Blowfish 中定义了多个预置的三色主题,以便在整个主题中使用。 - -### Blowfish(默认) - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Avocado - -{{< swatches "#78716c" "#84cc16" "#10b981" >}} - -### Fire - -{{< swatches "#78716c" "#f97316" "#f43f5e" >}} - -### Ocean - -{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}} - -### Forest - -{{< swatches "#658c86" "#3bf5df" "#06d45c" >}} - -### Princess - -{{< swatches "#8c658c" "#f53bf2" "#7706d4" >}} - -### Neon - -{{< swatches "#8338ec" "#ff006e" "#3a86ff" >}} - -### Bloody - -{{< swatches "#d90429" "#8d99ae" "#457b9d" >}} - -### Terminal - -{{< swatches "#004b23" "#38b000" "#1a759f" >}} - -### Marvel - -{{< swatches "#2541b2" "#d81159" "#ffbc42" >}} - -### Noir - -{{< swatches "#5c6b73" "#9db4c0" "#00a5cf" >}} - -### Autumn - -{{< swatches "#0a9396" "#ee9b00" "#bb3e03" >}} - -### Congo - -{{< swatches "#71717a" "#8b5cf6" "#d946ef" >}} - -### Slate - -{{< swatches "#6B7280" "#64748b" "#6B7280" >}} - -### Github - -{{< swatches "#64748b" "#0092ff" "#f54728" >}} - -### One-Light - -{{< swatches "#646464" "#0070cc" "#20a077" >}} +Blowfish 中的每个配色方案均基于三色调色板,并在整个主题中保持一致应用。这些主色基于 [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) 所提供的十阶色板构建。 这些是内置的配色方案,你也可以去自定义这一部分,请参阅 [高级自定义]({{< ref "advanced-customisation#colour-schemes" >}}) 。 diff --git a/exampleSite/layouts/shortcodes/theme-switcher.html b/exampleSite/layouts/shortcodes/theme-switcher.html new file mode 100644 index 00000000..cd4eb46b --- /dev/null +++ b/exampleSite/layouts/shortcodes/theme-switcher.html @@ -0,0 +1,111 @@ +{{ $schemes := slice }} +{{ $schemesData := newScratch }} +{{ $ignore := slice "ocean" }} +{{ range resources.Match "css/schemes/*.css" }} + {{ $name := path.BaseName .RelPermalink }} + {{ if in $ignore $name }} + {{ continue }} + {{ end }} + {{ $schemes = $schemes | append $name }} + {{ $schemesData.SetInMap "data" $name .Content }} +{{ end }} +{{ $schemesDataFinal := $schemesData.Get "data" }} + + +
+
    + {{ range sort $schemes }} +
  • + {{ . }} +
  • + {{ end }} +
+
+ +
+ {{ $defaultScheme := site.Params.colorScheme | default "blowfish" }} + {{ $configCode := printf "# config/_default/params.toml\n\n" }} + {{ $configCode = printf "%scolorScheme = \"%s\"" $configCode $defaultScheme }} + {{ highlight $configCode "toml" }} +
+ + + + + + From f9f9cf8e11eb16689c3a7a31660fb04c8596059a Mon Sep 17 00:00:00 2001 From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com> Date: Tue, 25 Nov 2025 11:31:30 +0800 Subject: [PATCH 07/60] docs: use a simpler command in custom syntax highlighter change command because tailwind v4 natively support css nesting --- .../docs/advanced-customisation/index.it.md | 35 +++---------------- .../docs/advanced-customisation/index.ja.md | 35 +++---------------- .../docs/advanced-customisation/index.md | 35 +++---------------- .../advanced-customisation/index.zh-cn.md | 35 +++---------------- 4 files changed, 20 insertions(+), 120 deletions(-) diff --git a/exampleSite/content/docs/advanced-customisation/index.it.md b/exampleSite/content/docs/advanced-customisation/index.it.md index dcdbb419..35e5bc30 100644 --- a/exampleSite/content/docs/advanced-customisation/index.it.md +++ b/exampleSite/content/docs/advanced-customisation/index.it.md @@ -135,7 +135,7 @@ Blowfish uses a custom syntax highlighting style, with colors defined in `assets .chroma:is(.dark *) * { color: unset; font-weight: unset; - background-color: unset; + font-style: unset; } ``` @@ -143,38 +143,13 @@ This clears the default Chroma styles. The next step is to incorporate Chroma st ```sh # Mac/Linux -hugo gen chromastyles --style=emacs | sed 's/\./html:not(.dark) ./' >> assets/css/custom.css -hugo gen chromastyles --style=evergarden | sed 's/\./html.dark ./' >> assets/css/custom.css +(echo 'html:not(.dark) {'; hugo gen chromastyles --style=emacs; echo '}') >> assets/css/custom.css +(echo 'html.dark {'; hugo gen chromastyles --style=evergarden; echo '}') >> assets/css/custom.css # Windows PowerShell # This command cannot run in CMD; it must run in PowerShell -hugo gen chromastyles --style=emacs | ForEach-Object { $_ -replace '\.', 'html:not(.dark) .' } | Add-Content -Path "css/custom.txt" -hugo gen chromastyles --style=evergarden | ForEach-Object { $_ -replace '\.', 'html.dark .' } | Add-Content -Path "css/custom.txt" -``` - -The final `custom.css` file should resemble the following: - -```css -.chroma, -.chroma *, -.chroma:is(.dark *), -.chroma:is(.dark *) * { - color: unset; - font-weight: unset; - background-color: unset; -} - -/* Generated using: hugo gen chromastyles --style=emacs */ - -/* Background */ html:not(.dark) .bg { background-color:#f8f8f8; } -/* PreWrapper */ html:not(.dark) .chroma { background-color:#f8f8f8; } -/* ... */ - -/* Generated using: hugo gen chromastyles --style=evergarden */ - -/* Background */ html.dark .bg { color:#d6cbb4;background-color:#252b2e; } -/* PreWrapper */ html.dark .chroma { color:#d6cbb4;background-color:#252b2e; } -/* ... */ +@("html:not(.dark) {"; (hugo gen chromastyles --style=emacs); "}") | Add-Content -Path "assets/css/custom.css" +@("html.dark {"; (hugo gen chromastyles --style=evergarden); "}") | Add-Content -Path "assets/css/custom.css" ``` See all available styles in [Hugo's documentation](https://gohugo.io/quick-reference/syntax-highlighting-styles/#styles). diff --git a/exampleSite/content/docs/advanced-customisation/index.ja.md b/exampleSite/content/docs/advanced-customisation/index.ja.md index 31618f4d..59fc0e61 100644 --- a/exampleSite/content/docs/advanced-customisation/index.ja.md +++ b/exampleSite/content/docs/advanced-customisation/index.ja.md @@ -136,7 +136,7 @@ Blowfish はカスタム構文ハイライトスタイルを使用しており .chroma:is(.dark *) * { color: unset; font-weight: unset; - background-color: unset; + font-style: unset; } ``` @@ -144,38 +144,13 @@ Blowfish はカスタム構文ハイライトスタイルを使用しており ```sh # Mac/Linux -hugo gen chromastyles --style=emacs | sed 's/\./html:not(.dark) ./' >> assets/css/custom.css -hugo gen chromastyles --style=evergarden | sed 's/\./html.dark ./' >> assets/css/custom.css +(echo 'html:not(.dark) {'; hugo gen chromastyles --style=emacs; echo '}') >> assets/css/custom.css +(echo 'html.dark {'; hugo gen chromastyles --style=evergarden; echo '}') >> assets/css/custom.css # Windows PowerShell # このコマンドは CMD では実行できず PowerShell で実行する必要がある -hugo gen chromastyles --style=emacs | ForEach-Object { $_ -replace '\.', 'html:not(.dark) .' } | Add-Content -Path "css/custom.txt" -hugo gen chromastyles --style=evergarden | ForEach-Object { $_ -replace '\.', 'html.dark .' } | Add-Content -Path "css/custom.txt" -``` - -最終的な `custom.css` ファイルは以下のようになります: - -```css -.chroma, -.chroma *, -.chroma:is(.dark *), -.chroma:is(.dark *) * { - color: unset; - font-weight: unset; - background-color: unset; -} - -/* Generated using: hugo gen chromastyles --style=emacs */ - -/* Background */ html:not(.dark) .bg { background-color:#f8f8f8; } -/* PreWrapper */ html:not(.dark) .chroma { background-color:#f8f8f8; } -/* ... */ - -/* Generated using: hugo gen chromastyles --style=evergarden */ - -/* Background */ html.dark .bg { color:#d6cbb4;background-color:#252b2e; } -/* PreWrapper */ html.dark .chroma { color:#d6cbb4;background-color:#252b2e; } -/* ... */ +@("html:not(.dark) {"; (hugo gen chromastyles --style=emacs); "}") | Add-Content -Path "assets/css/custom.css" +@("html.dark {"; (hugo gen chromastyles --style=evergarden); "}") | Add-Content -Path "assets/css/custom.css" ``` すべての利用可能なスタイルは、[Hugo のドキュメント](https://gohugo.io/quick-reference/syntax-highlighting-styles/#styles)で確認できます。 diff --git a/exampleSite/content/docs/advanced-customisation/index.md b/exampleSite/content/docs/advanced-customisation/index.md index dcdbb419..35e5bc30 100644 --- a/exampleSite/content/docs/advanced-customisation/index.md +++ b/exampleSite/content/docs/advanced-customisation/index.md @@ -135,7 +135,7 @@ Blowfish uses a custom syntax highlighting style, with colors defined in `assets .chroma:is(.dark *) * { color: unset; font-weight: unset; - background-color: unset; + font-style: unset; } ``` @@ -143,38 +143,13 @@ This clears the default Chroma styles. The next step is to incorporate Chroma st ```sh # Mac/Linux -hugo gen chromastyles --style=emacs | sed 's/\./html:not(.dark) ./' >> assets/css/custom.css -hugo gen chromastyles --style=evergarden | sed 's/\./html.dark ./' >> assets/css/custom.css +(echo 'html:not(.dark) {'; hugo gen chromastyles --style=emacs; echo '}') >> assets/css/custom.css +(echo 'html.dark {'; hugo gen chromastyles --style=evergarden; echo '}') >> assets/css/custom.css # Windows PowerShell # This command cannot run in CMD; it must run in PowerShell -hugo gen chromastyles --style=emacs | ForEach-Object { $_ -replace '\.', 'html:not(.dark) .' } | Add-Content -Path "css/custom.txt" -hugo gen chromastyles --style=evergarden | ForEach-Object { $_ -replace '\.', 'html.dark .' } | Add-Content -Path "css/custom.txt" -``` - -The final `custom.css` file should resemble the following: - -```css -.chroma, -.chroma *, -.chroma:is(.dark *), -.chroma:is(.dark *) * { - color: unset; - font-weight: unset; - background-color: unset; -} - -/* Generated using: hugo gen chromastyles --style=emacs */ - -/* Background */ html:not(.dark) .bg { background-color:#f8f8f8; } -/* PreWrapper */ html:not(.dark) .chroma { background-color:#f8f8f8; } -/* ... */ - -/* Generated using: hugo gen chromastyles --style=evergarden */ - -/* Background */ html.dark .bg { color:#d6cbb4;background-color:#252b2e; } -/* PreWrapper */ html.dark .chroma { color:#d6cbb4;background-color:#252b2e; } -/* ... */ +@("html:not(.dark) {"; (hugo gen chromastyles --style=emacs); "}") | Add-Content -Path "assets/css/custom.css" +@("html.dark {"; (hugo gen chromastyles --style=evergarden); "}") | Add-Content -Path "assets/css/custom.css" ``` See all available styles in [Hugo's documentation](https://gohugo.io/quick-reference/syntax-highlighting-styles/#styles). diff --git a/exampleSite/content/docs/advanced-customisation/index.zh-cn.md b/exampleSite/content/docs/advanced-customisation/index.zh-cn.md index 666cce57..94ba2ce5 100644 --- a/exampleSite/content/docs/advanced-customisation/index.zh-cn.md +++ b/exampleSite/content/docs/advanced-customisation/index.zh-cn.md @@ -134,7 +134,7 @@ Blowfish 使用自定义的语法高亮样式,颜色定义在 `assets/css/sche .chroma:is(.dark *) * { color: unset; font-weight: unset; - background-color: unset; + font-style: unset; } ``` @@ -142,38 +142,13 @@ Blowfish 使用自定义的语法高亮样式,颜色定义在 `assets/css/sche ```sh # Mac/Linux -hugo gen chromastyles --style=emacs | sed 's/\./html:not(.dark) ./' >> assets/css/custom.css -hugo gen chromastyles --style=evergarden | sed 's/\./html.dark ./' >> assets/css/custom.css +(echo 'html:not(.dark) {'; hugo gen chromastyles --style=emacs; echo '}') >> assets/css/custom.css +(echo 'html.dark {'; hugo gen chromastyles --style=evergarden; echo '}') >> assets/css/custom.css # Windows PowerShell # 此命令不能在 CMD 中运行,必须在 PowerShell 中运行 -hugo gen chromastyles --style=emacs | ForEach-Object { $_ -replace '\.', 'html:not(.dark) .' } | Add-Content -Path "css/custom.txt" -hugo gen chromastyles --style=evergarden | ForEach-Object { $_ -replace '\.', 'html.dark .' } | Add-Content -Path "css/custom.txt" -``` - -您的 `custom.css` 档案最后应该会像是以下: - -```css -.chroma, -.chroma *, -.chroma:is(.dark *), -.chroma:is(.dark *) * { - color: unset; - font-weight: unset; - background-color: unset; -} - -/* Generated using: hugo gen chromastyles --style=emacs */ - -/* Background */ html:not(.dark) .bg { background-color:#f8f8f8; } -/* PreWrapper */ html:not(.dark) .chroma { background-color:#f8f8f8; } -/* ... */ - -/* Generated using: hugo gen chromastyles --style=evergarden */ - -/* Background */ html.dark .bg { color:#d6cbb4;background-color:#252b2e; } -/* PreWrapper */ html.dark .chroma { color:#d6cbb4;background-color:#252b2e; } -/* ... */ +@("html:not(.dark) {"; (hugo gen chromastyles --style=emacs); "}") | Add-Content -Path "assets/css/custom.css" +@("html.dark {"; (hugo gen chromastyles --style=evergarden); "}") | Add-Content -Path "assets/css/custom.css" ``` 在 [Hugo 文档](https://gohugo.io/quick-reference/syntax-highlighting-styles/#styles)中查看所有可用的样式。 From 825f9fec18361e853be7756c512766b85937c1c8 Mon Sep 17 00:00:00 2001 From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com> Date: Thu, 27 Nov 2025 13:46:47 +0800 Subject: [PATCH 08/60] docs: clarify showHero --- exampleSite/content/docs/configuration/index.it.md | 8 ++++---- exampleSite/content/docs/configuration/index.ja.md | 8 ++++---- exampleSite/content/docs/configuration/index.md | 8 ++++---- exampleSite/content/docs/configuration/index.zh-cn.md | 8 ++++---- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/exampleSite/content/docs/configuration/index.it.md b/exampleSite/content/docs/configuration/index.it.md index 604ed6aa..76ede697 100644 --- a/exampleSite/content/docs/configuration/index.it.md +++ b/exampleSite/content/docs/configuration/index.it.md @@ -236,7 +236,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | `article.showAuthor` | `true` | Whether or not the author box is displayed in the article footer. | | `article.showAuthorBottom` | `false` | Author boxes are displayed at the bottom of each page instead of the top. | | `article.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each article page. | -| `article.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `article.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `article.showHero = true`. | | `article.layoutBackgroundBlur` | `true` | Makes the background image in the background article heroStyle blur with the scroll | | `article.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | | `article.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the article header. | @@ -264,7 +264,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | Name | Default | Description | | --- | --- | --- | | `list.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each list page. | -| `list.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `list.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `list.showHero = true`. | | `list.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the header on list pages. | | `list.layoutBackgroundBlur` | `true` | Makes the background image in the background list heroStyle blur with the scroll | | `list.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | @@ -292,7 +292,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | --- | --- | --- | | `taxonomy.showTermCount` | `true` | Whether or not the number of articles within a taxonomy term is displayed on the taxonomy listing. | | `taxonomy.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each taxonomy page. | -| `taxonomy.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `taxonomy.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `article.taxonomy = true`. | | `taxonomy.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the taxonomy header. | | `taxonomy.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | | `taxonomy.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | @@ -304,7 +304,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | Name | Default | Description | | --- | --- | --- | | `term.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each term page. | -| `term.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `term.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `term.showHero = true`. | | `term.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the term header. | | `term.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | | `term.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | diff --git a/exampleSite/content/docs/configuration/index.ja.md b/exampleSite/content/docs/configuration/index.ja.md index 6e7c26a2..389ac626 100644 --- a/exampleSite/content/docs/configuration/index.ja.md +++ b/exampleSite/content/docs/configuration/index.ja.md @@ -236,7 +236,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ | `article.showAuthor` | `true` | 記事のフッターに著者ボックスを表示するかどうかです。 | | `article.showAuthorBottom` | `false` | 著者ボックスは、各ページの上部ではなく下部に表示されます。 | | `article.showHero` | `false` | サムネイル画像を各記事ページ内でヒーロー画像として表示するかどうかです。 | -| `article.heroStyle` | _未設定_ | ヒーロー画像を表示するスタイルです。有効なオプションは、`basic`、`big`、`background`、`thumbAndBackground` です。 | +| `article.heroStyle` | _未設定_ | ヒーロー画像を表示するスタイルです。有効なオプションは、`basic`、`big`、`background`、`thumbAndBackground` です。`article.showHero = true` の場合にのみ有効。 | | `article.layoutBackgroundBlur` | `true` | 背景記事 heroStyle の背景画像をスクロールに合わせてぼかします。 | | `article.layoutBackgroundHeaderSpace` | `true` | ヘッダーと本文の間にスペースを追加します。 | | `article.showBreadcrumbs` | `false` | 記事のヘッダーにパンくずリストを表示するかどうかです。 | @@ -264,7 +264,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ | 名前 | デフォルト | 説明 | | --- | --- | --- | | `list.showHero` | `false` | 各リストページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | -| `list.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `list.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。`list.showHero = true` の場合にのみ有効。 | | `list.showBreadcrumbs` | `false` | リストページのヘッダーにパンくずリストを表示するかどうか。 | | `list.layoutBackgroundBlur` | `true` | `background` リストの heroStyle の背景画像をスクロールでぼかします。 | | `list.layoutBackgroundHeaderSpace` | `true` | ヘッダーと本文の間にスペースを追加します。 | @@ -292,7 +292,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ | --- | --- | --- | | `taxonomy.showTermCount` | `true` | タクソノミーリストにタクソノミー用語内の記事数を表示するかどうか。 | | `taxonomy.showHero` | `false` | 各タクソノミーページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | -| `taxonomy.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `taxonomy.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。`taxonomy.showHero = true` の場合にのみ有効。 | | `taxonomy.showBreadcrumbs` | `false` | タクソノミーのヘッダーにパンくずリストを表示するかどうか。 | | `taxonomy.showViews` | `false` | 記事の閲覧数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | | `taxonomy.showLikes` | `false` | 記事のいいね数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | @@ -304,7 +304,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ | 名前 | デフォルト | 説明 | | --- | --- | --- | | `term.showHero` | `false` | 各タームページ内でサムネイル画像をヒーロー画像として表示するかどうか。 | -| `term.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 | +| `term.heroStyle` | _未設定_ | ヒーロー画像の表示スタイル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。`term.showHero = true` の場合にのみ有効。 | | `term.showBreadcrumbs` | `false` | タームのヘッダーにパンくずリストを表示するかどうか。 | | `term.showViews` | `false` | 記事の閲覧数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | | `term.showLikes` | `false` | 記事のいいね数を表示するかどうか。これを有効にするには、Firebase の統合を有効にする必要があります。以下をご覧ください。 | diff --git a/exampleSite/content/docs/configuration/index.md b/exampleSite/content/docs/configuration/index.md index 042edb7b..4d23e3ee 100644 --- a/exampleSite/content/docs/configuration/index.md +++ b/exampleSite/content/docs/configuration/index.md @@ -242,7 +242,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | `article.showAuthor` | `true` | Whether or not the author box is displayed in the article footer. | | `article.showAuthorBottom` | `false` | Author boxes are displayed at the bottom of each page instead of the top. | | `article.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each article page. | -| `article.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `article.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `article.showHero = true`. | | `article.layoutBackgroundBlur` | `true` | Makes the background image in the background article heroStyle blur with the scroll | | `article.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | | `article.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the article header. | @@ -271,7 +271,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | Name | Default | Description | | --- | --- | --- | | `list.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each list page. | -| `list.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `list.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `list.showHero = true`. | | `list.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the header on list pages. | | `list.layoutBackgroundBlur` | `true` | Makes the background image in the background list heroStyle blur with the scroll | | `list.layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | @@ -299,7 +299,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | --- | --- | --- | | `taxonomy.showTermCount` | `true` | Whether or not the number of articles within a taxonomy term is displayed on the taxonomy listing. | | `taxonomy.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each taxonomy page. | -| `taxonomy.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `taxonomy.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `taxonomy.showHero = true`. | | `taxonomy.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the taxonomy header. | | `taxonomy.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | | `taxonomy.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | @@ -311,7 +311,7 @@ Many of the article defaults here can be overridden on a per article basis by sp | Name | Default | Description | | --- | --- | --- | | `term.showHero` | `false` | Whether the thumbnail image will be shown as a hero image within each term page. | -| `term.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | +| `term.heroStyle` | _Not set_ | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. Effective only if `term.showHero = true`. | | `term.showBreadcrumbs` | `false` | Whether or not breadcrumbs are displayed in the term header. | | `term.showViews` | `false` | Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. | | `term.showLikes` | `false` | Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. | diff --git a/exampleSite/content/docs/configuration/index.zh-cn.md b/exampleSite/content/docs/configuration/index.zh-cn.md index 0d4f23b4..c5eea1d7 100644 --- a/exampleSite/content/docs/configuration/index.zh-cn.md +++ b/exampleSite/content/docs/configuration/index.zh-cn.md @@ -240,7 +240,7 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中 | `article.showAuthor` | `true` | 是否在文章底部显示作者框。 | | `article.showAuthorBottom` | `false` | 作者框显示在每页的底部而不是顶部。 | | `article.showHero` | `false` | 缩略图是否会在每个页面中作为 hero 图像显示。 | -| `article.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。 | +| `article.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。仅在 `article.showHero = true` 时生效。 | | `article.layoutBackgroundBlur` | `true` | 向下滚动文章页时,是否模糊背景图。 | | `article.layoutBackgroundHeaderSpace` | `true` | 在标题和正文之间添加空白区域间隔。 | | `article.showBreadcrumbs` | `false` | 是否在标题栏显示面包屑导航。 | @@ -268,7 +268,7 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中 | 名称 | 默认值 | 描述 | | --- | --- | --- | | `list.showHero` | `false` | 缩略图是否会在每个页面中作为 hero 图像显示。 | -| `list.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。 | +| `list.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。仅在 `list.showHero = true` 时生效。 | | `list.showBreadcrumbs` | `false` | 是否在标题栏显示面包屑导航。 | | `list.layoutBackgroundBlur` | `true` | 向下滚动列表页时,是否模糊背景图。 | | `list.layoutBackgroundHeaderSpace` | `true` | 在标题和正文之间添加空白区域间隔。 | @@ -296,7 +296,7 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中 | --- | --- | --- | | `taxonomy.showTermCount` | `true` | 是否在分类列表总显示对应的数量。 | | `taxonomy.showHero` | `false` | 缩略图是否会在每个页面中作为 hero 图像显示。 | -| `taxonomy.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。 | +| `taxonomy.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有:`basic`、`big`、`background`、`thumbAndBackground`。仅在 `taxonomy.showHero = true` 时生效。 | | `taxonomy.showBreadcrumbs` | `false` | 是否在标题栏显示面包屑导航。 | | `taxonomy.showViews` | `false` | 是否显示文章阅读量。这需要集成 firebase ,具体可以看下面。 | | `taxonomy.showLikes` | `false` | 是否显示文章点赞量。这需要集成 firebase ,具体可以看下面。 | @@ -308,7 +308,7 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中 | 名称 | 默认值 | 描述 | | --- | --- | --- | | `term.showHero` | `false` | 缩略图是否会在每个页面中作为 hero 图像显示。 | -| `term.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有: `basic`、`big`、`background`、`thumbAndBackground`。 | +| `term.heroStyle` | 无 | hero 图像的展示样式,可选的参数值有: `basic`、`big`、`background`、`thumbAndBackground`。仅在 `term.showHero = true` 时生效。 | | `term.showBreadcrumbs` | `false` | 是否在标题栏显示面包屑导航。 | | `term.showViews` | `false` | 是否显示文章阅读量。这需要集成 firebase ,具体可以看下面。 | | `term.showLikes` | `false` | 是否显示文章点赞量。这需要集成 firebase ,具体可以看下面。 | From 19ebf4f5d2bdaacc95650333f6fd3d671a6717c6 Mon Sep 17 00:00:00 2001 From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com> Date: Thu, 27 Nov 2025 13:47:16 +0800 Subject: [PATCH 09/60] docs: remove duplicate `en` content in `it` doc --- .../content/docs/front-matter/index.it.md | 40 ------------------- 1 file changed, 40 deletions(-) diff --git a/exampleSite/content/docs/front-matter/index.it.md b/exampleSite/content/docs/front-matter/index.it.md index 774ed64c..0f6faa73 100644 --- a/exampleSite/content/docs/front-matter/index.it.md +++ b/exampleSite/content/docs/front-matter/index.it.md @@ -55,44 +55,4 @@ I valori predefiniti dei parametri del front metter vengono ereditati dalla [con | `xml` | `true` unless excluded by `sitemap.excludedKinds` | Se questo articolo è incluso o meno nel file `/sitemap.xml` generato. | | `layoutBackgroundBlur` | `true` | Rende l'immagine di sfondo sullo sfondo heroStyle sfocata con lo scorrimento. | | `layoutBackgroundHeaderSpace` | `true` | Aggiungi spazio tra l'intestazione e il body. | -| `title` | _Not set_ | The name of the article. | -| `description` | _Not set_ | The text description for the article. It is used in the HTML metadata. | -| `externalUrl` | _Not set_ | If this article is published on a third-party website, the URL to this article. Providing a URL will prevent a content page being generated and any references to this article will link directly to the third-party website. | -| `editURL` | `article.editURL` | When `showEdit` is active, the URL for the edit link. | -| `editAppendPath` | `article.editAppendPath` | When `showEdit` is active, whether or not the path to the current article should be appended to the URL set at `editURL`. | -| `groupByYear` | `list.groupByYear` | Whether or not articles are grouped by year on list pages. | -| `menu` | _Not set_ | When a value is provided, a link to this article will appear in the named menus. Valid values are `main` or `footer`. | -| `robots` | _Not set_ | String that indicates how robots should handle this article. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values. | -| `sharingLinks` | `article.sharingLinks` | Which sharing links to display at the end of this article. When not provided, or set to `false` no links will be displayed. | -| `showAuthor` | `article.showAuthor` | Whether or not the author box for the default author is displayed in the article footer. | -| `showAuthorBottom` | `article.showAuthorBottom` | Author boxes are displayed at the bottom of each page instead of the top. | -| `authors` | _Not set_ | Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature. | -| `showAuthorsBadges` | `article.showAuthorsBadges` | 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. | -| `featureimage` | _Not set_ | External URL for feature image | -| `featureimagecaption` | _Not set_ | Caption for feature image. Only displayed in heroStyle `big` | -| `showHero` | `article.showHero` | Whether the thumbnail image will be shown as a hero image within the article page. | -| `heroStyle` | `article.heroStyle` | Style to display the hero image, valid options are: `basic`, `big`, `background`, `thumbAndBackground`. | -| `showBreadcrumbs` | `article.showBreadcrumbs` or `list.showBreadcrumbs` | Whether the breadcrumbs are displayed in the article or list header. | -| `showDate` | `article.showDate` | Whether or not the article date is displayed. The date is set using the `date` parameter. | -| `showDateUpdated` | `article.showDateUpdated` | Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter. | -| `showEdit` | `article.showEdit` | Whether or not the link to edit the article content should be displayed. | -| `showHeadingAnchors` | `article.showHeadingAnchors` | Whether or not heading anchor links are displayed alongside headings within this article. | -| `showPagination` | `article.showPagination` | Whether or not the next/previous article links are displayed in the article footer. | -| `invertPagination` | `article.invertPagination` | Whether or not to flip the direction of the next/previous article links. | -| `showReadingTime` | `article.showReadingTime` | Whether or not the article reading time is displayed. | -| `showTaxonomies` | `article.showTaxonomies` | Whether or not the taxonomies that relate to this article are displayed. | -| `showTableOfContents` | `article.showTableOfContents` | Whether or not the table of contents is displayed on this article. | -| `showWordCount` | `article.showWordCount` | Whether or not the article word count is displayed. | -| `showComments` | `article.showComments` | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer. | -| `showSummary` | `list.showSummary` | Whether or not the article summary should be displayed on list pages. | -| `showViews` | `article.showViews` | Whether or not the article views should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | -| `showLikes` | `article.showLikes` | Whether or not the article likes should be displayed in lists and detailed view. This requires a firebase integration. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish | -| `seriesOpened` | `article.seriesOpened` | Whether or not the series module will be displayed open by default or not. | -| `series` | _Not set_ | Array of series the article belongs to, we recommend using only one series per article. | -| `series_order` | _Not set_ | Number of the article within the series. | -| `summary` | Auto generated using `summaryLength` (see [site configuration]({{< ref "configuration#site-configuration" >}})) | When `showSummary` is enabled, this is the Markdown string to be used as the summary for this article. | -| `xml` | `true` unless excluded by `sitemap.excludedKinds` | Whether or not this article is included in the generated `/sitemap.xml` file. | -| `layoutBackgroundBlur` | `true` | Makes the background image in the background heroStyle blur with the scroll | -| `layoutBackgroundHeaderSpace` | `true` | Add space between the header and the body. | - From ec942b013a32f4b4015cd901e334ae706c1d2757 Mon Sep 17 00:00:00 2001 From: ZhenShuo Leo <98386542+ZhenShuo2021@users.noreply.github.com> Date: Mon, 24 Nov 2025 08:20:15 +0800 Subject: [PATCH 10/60] fix: remove alt in decorative images --- layouts/partials/article-link/_shortcode.html | 2 +- layouts/partials/article-link/card-related.html | 2 +- layouts/partials/article-link/card.html | 2 +- layouts/partials/article-link/simple.html | 2 +- layouts/partials/hero/background.html | 2 +- layouts/partials/hero/basic.html | 2 +- layouts/partials/hero/thumbAndBackground.html | 3 +-- 7 files changed, 7 insertions(+), 8 deletions(-) diff --git a/layouts/partials/article-link/_shortcode.html b/layouts/partials/article-link/_shortcode.html index c6cb2f03..b370039a 100644 --- a/layouts/partials/article-link/_shortcode.html +++ b/layouts/partials/article-link/_shortcode.html @@ -85,7 +85,7 @@
{{ with $target.Params.featuredImageAlt }}{{ . }}{{ else }}{{ $target.Title | emojify }}{{ end }} diff --git a/layouts/partials/article-link/card-related.html b/layouts/partials/article-link/card-related.html index 0e4fdfd7..e74f58db 100644 --- a/layouts/partials/article-link/card-related.html +++ b/layouts/partials/article-link/card-related.html @@ -56,7 +56,7 @@