migrate to decoupled Blowfish layout, fix TOC scrollspy, and update docs
- Theme Decoupling & Cleanup:
- Fully decoupled and vendored the Blowfish theme directly into root directories (layouts/,
assets/, static/, data/, i18n/).
- De-registered and cleaned up legacy Git submodules (themes/blowfish, themes/hugo-admonitions)
from the Git index to protect the build from upstream breakages.
- Configured .gitignore to ignore development preview symlinks (content, static,
config/_default/menus.en.toml), build folders (public/, resources/), and locks.
- TOC & Layout Fixes:
- Replaced the custom layouts/_default/single.html template with the Blowfish default to restore
native container widths and the side-by-side flex layout.
- Restored TOC to float on the right sidebar on desktop viewports and render inline on mobile
viewports.
- Fixed a parameter resolution bug in layouts/partials/toc.html by checking both .Site.Params.
smartTOC and .Site.Params.article.smartTOC (where it is defined in params.toml).
- Upgraded the TOC scrollspy JavaScript to target all '#TableOfContents' containers on the page,
enabling highlight tracking on both desktop and mobile layouts.
- Documentation Updates (README.md):
- Restored YAML front matter metadata block at the top.
- Added detailed notes on the CI/CD build process and Gitea runner deployment targets
(/srv/www/docs-public and /srv/www/docs-private).
- Added a categorized and sorted "Shortcodes Quick Reference" table at the top of the shortcodes
section (ordered by Custom, Hugo Default, and Blowfish).
- Documented custom shortcodes (Include, Screenshot, Raw HTML) and missing Hugo default
shortcodes (Highlight, Instagram, Param, Ref, Relref, Twitter, Vimeo, Youtube).
- Restructured headings to ensure all sub-shortcodes are H3, removed block break tags (<br/>),
and appended horizontal separators (---) after H2 sections.
This commit is contained in:
127
package.json
127
package.json
@@ -1,20 +1,123 @@
|
||||
{
|
||||
"name": "blowfish_template",
|
||||
"version": "1.0.0",
|
||||
"description": "Blowfish Template",
|
||||
"main": "index.js",
|
||||
"name": "hugo-blowfish-theme",
|
||||
"version": "2.103.0",
|
||||
"description": "Blowfish theme for Hugo.",
|
||||
"scripts": {
|
||||
"dev": "hugo server --minify -D -E -F"
|
||||
"postinstall": "vendor-copy",
|
||||
"assets": "rimraf assets/vendor && vendor-copy",
|
||||
"dev": "NODE_ENV=development npx @tailwindcss/cli -c ./tailwind.config.js -i ./assets/css/main.css -o ./assets/css/compiled/main.css --jit -w",
|
||||
"build": "NODE_ENV=production npx @tailwindcss/cli -c ./tailwind.config.js -i ./assets/css/main.css -o ./assets/css/compiled/main.css --jit",
|
||||
"dev-windows": "set NODE_ENV=development&& npx @tailwindcss/cli -i ./assets/css/main.css -o ./assets/css/compiled/main.css --jit -w",
|
||||
"build-windows": "set NODE_ENV=production&& npx @tailwindcss/cli -i ./assets/css/main.css -o ./assets/css/compiled/main.css --jit",
|
||||
"build-hugo": "hugo --minify -s exampleSite --themesDir ../.. -d ../docs --baseURL https://nunocoracao.github.io/blowfish/",
|
||||
"example": "hugo server -E -F --minify --source exampleSite --themesDir ../.. --buildDrafts -b http://localhost/ -p 1313",
|
||||
"example:core": "hugo server -E -F --minify --source exampleSite --themesDir ../.. --buildDrafts -b http://localhost/ -p 1313 --renderSegments core",
|
||||
"example:production": "hugo server -E -F --minify --source exampleSite --themesDir ../.. --buildDrafts -b http://localhost/ -p 1313 -e production",
|
||||
"lighthouse": "lhci autorun"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/nunocoracao/blowfish_template.git"
|
||||
"url": "https://github.com/nunocoracao/blowfish.git"
|
||||
},
|
||||
"keywords": [],
|
||||
"author": "",
|
||||
"license": "ISC",
|
||||
"keywords": [
|
||||
"hugo",
|
||||
"hugo-theme",
|
||||
"tailwind",
|
||||
"dark-mode"
|
||||
],
|
||||
"author": {
|
||||
"name": "Nuno Coração",
|
||||
"github": "https://github.com/nunocoracao",
|
||||
"url": "https://n9o.xyz"
|
||||
},
|
||||
"license": "MIT",
|
||||
"bugs": {
|
||||
"url": "https://github.com/nunocoracao/blowfish_template/issues"
|
||||
"url": "https://github.com/nunocoracao/blowfish/issues"
|
||||
},
|
||||
"homepage": "https://github.com/nunocoracao/blowfish_template#readme"
|
||||
}
|
||||
"homepage": "https://github.com/nunocoracao/blowfish#readme",
|
||||
"devDependencies": {
|
||||
"@tailwindcss/cli": "^4.3.0",
|
||||
"@tailwindcss/typography": "^0.5.19",
|
||||
"chart.js": "^4.5.1",
|
||||
"fuse.js": "~7.3.0",
|
||||
"katex": "^0.16.45",
|
||||
"lite-youtube-embed": "^0.3.4",
|
||||
"medium-zoom": "^1.1.0",
|
||||
"mermaid": "^11.14.0",
|
||||
"packery": "^3.0.0",
|
||||
"prettier": "^3.8.3",
|
||||
"prettier-plugin-go-template": "^0.0.15",
|
||||
"puppeteer": "^24.42.0",
|
||||
"rimraf": "^6.1.3",
|
||||
"tailwind-scrollbar": "^4.0.2",
|
||||
"tailwindcss": "^4.3.0",
|
||||
"tw-elements": "2.0.0",
|
||||
"typeit": "^8.8.7",
|
||||
"vendor-copy": "^3.0.1"
|
||||
},
|
||||
"vendorCopy": [],
|
||||
"devVendorCopy": [
|
||||
{
|
||||
"from": "node_modules/mermaid/dist/mermaid.min.js",
|
||||
"to": "assets/lib/mermaid/mermaid.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/chart.js/dist/chart.umd.js",
|
||||
"to": "assets/lib/chart/chart.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/katex/dist/katex.min.js",
|
||||
"to": "assets/lib/katex/katex.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/katex/dist/katex.min.css",
|
||||
"to": "assets/lib/katex/katex.min.css"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/katex/dist/contrib/auto-render.min.js",
|
||||
"to": "assets/lib/katex/auto-render.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/katex/dist/fonts/",
|
||||
"to": "assets/lib/katex/fonts/"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/fuse.js/dist/fuse.min.cjs",
|
||||
"to": "assets/lib/fuse/fuse.min.cjs"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/typeit/dist/index.umd.js",
|
||||
"to": "assets/lib/typeit/typeit.umd.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/packery/dist/packery.pkgd.min.js",
|
||||
"to": "assets/lib/packery/packery.pkgd.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/tw-elements/js/tw-elements.umd.min.js",
|
||||
"to": "assets/lib/tw-elements/index.min.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/lite-youtube-embed/src/lite-yt-embed.js",
|
||||
"to": "assets/lib/lite-youtube-embed/lite-yt-embed.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/lite-youtube-embed/src/lite-yt-embed.css",
|
||||
"to": "assets/lib/lite-youtube-embed/lite-yt-embed.css"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/medium-zoom/dist/pure/medium-zoom.min.umd.js",
|
||||
"to": "assets/lib/zoom/zoom.min.umd.js"
|
||||
},
|
||||
{
|
||||
"from": "node_modules/medium-zoom/dist/style.css",
|
||||
"to": "assets/lib/zoom/style.css"
|
||||
}
|
||||
],
|
||||
"dependencies": {
|
||||
"@headlessui/react": "^2.2.10",
|
||||
"@heroicons/react": "^2.2.0",
|
||||
"@tailwindcss/forms": "^0.5.11",
|
||||
"commander": "^14.0.3"
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user