+
+
+
+
+## 特性
+
+- 使用 Tailwind CSS 3.0 构建全面响应式布局
+- 多种配色方案，亦可完全由你定义
+- 夜间模式支持（手动开启/关闭或根据用户设备自动切换）
+- 高度自主的配置方式
+- 集成 Firebase 以支持动态数据统计
+- 集成浏览次数统计和点赞机制
+- “相关文章”列表生成
+- 多种主页布局
+- 多作者模式支持
+- 可将文章整理成选集列表
+- 禅模式支持
+- 可灵活定义各种内容类型、分类标准和菜单
+- 页眉和页脚双重菜单可选
+- 支持嵌套菜单和子导航菜单
+- 支持多语言内容，包括 RTL 语言
+- 可链接到第三方网站上的帖子
+- 支持多种简码，如图库、时间轴、GitHub 卡片和图片灯箱
+- 支持 Buymeacoffee
+- 拥有由 Fuse.js 支持的客户端一侧网站搜索功能
+- 植入了基于 Mermaid 的图表功能
+- 植入了基于 Chart.js 的图表功能
+- 集成逼真的自动打字效果
+- 集成性能优化的 Youtube 卡片简码
+- 集成 KaTeX 的公式
+- 集成 FontAwesome 6 的矢量图标引用
+- 使用 Hugo Pipes 自动调整图像大小
+- 拥有标题锚点、目录、代码复制、按钮、分类徽章等功能
+- 文章内部支持 HTML 和 Emoji 🎉
+- 便于搜索引擎优化，文章可一键分享到社交媒体
+- 支持 Fathom Analytics 和 Google Analytics
+- 支持 RSS 订阅、网站图标和评论功能
+- 可使用简单的 Tailwind 对颜色和样式进行高级定制
+- 优化了性能和可访问性，拥有极高的 Lighthouse 评分
+- 文档齐全，定期更新
+
+---
+
+
+
+## 文档
+Blowfish 有 [全面的文档](https://blowfish.page/zh-cn/docs/)，覆盖主题的任何一个方面。 请确保 [阅读文档](https://blowfish.page/zh-cn/docs/) 以详细了解本主题有哪些功能。
+
+---
+
+## 安装
+
+Blowfish 支持多种安装方式，既能作为 git 子模块、Hugo 模块，也可完全手动安装。
+
+每种方法的详细说明都可以在 [安装](https://blowfish.page/zh-cn/docs/installation) 文档中找到。为了获得最简单的安装体验，请查阅文档。如果你使用的是 git，请阅读下面使用子模块的快速开始指南；如果你能安装 Hugo 主题，请阅读下面 Hugo 模块的快速开始指南。
+
+### 使用 Blowfish Tools 快速开始
+
+> **注：** 请确保你已安装 **Node.js**、 **Git**、 **Go** 和 **Hugo** ，且已经创建了一个 Hugo 工程。
+
+我们最新推出了一个新的 CLI 工具，帮助你开始使用 Blowfish。它将为你创建一个新的 Hugo 项目、安装主题并设置主题配置文件。它仍处于测试阶段，因此请 [报告你发现的任何问题](https://github.com/nunocoracao/blowfish-tools)。
+
+使用 npm（或其他软件包管理器）全局安装 CLI 工具：
+```shell
+npm i -g blowfish-tools
+```
+
+然后运行 "blowfish-tools "命令，开启一个交互式进程，引导你完成创建和配置。
+```shell
+blowfish-tools
+```
+
+你也可以运行命令 `blowfish-tools new` 来创建一个新的 Hugo 项目，并一次性安装主题。更多信息请查看 CLI 帮助。
+```shell
+blowfish-tools new mynewsite
+```
+
+### 使用 git 子模块快速开始
+
+> **注：** 请确保你已安装 **Node.js**、 **Git**、 **Go** 和 **Hugo** ，且已经创建了一个 Hugo 工程。
+
+1. 从你工程的所在目录初始化 git 仓库
+
+ ```shell
+ git init
+ ```
+
+2. 配置 Blowfish 作为 git 子模块
+
+ ```shell
+ git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
+ ```
+
+3. 在你网站的根目录中删除由 Hugo 自动生成的 `config.toml`文件，并把主题文件夹中的`*.toml`配置文件复制到你的 `config/_default/`文件夹中
+
+ 你可在 Hugo 缓存目录中找到主题配置文件，或者也可以从[这里](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/nunocoracao/blowfish/tree/main/config/_default)下载一份。
+
+4. 按照[入门指南](https://blowfish.page/zh-cn/docs/getting-started/)来配置你的网站
+
+### 使用 Hugo 快速开始
+
+> **注：** 确保你已经安装了 **Go** 和 **Hugo**，且已创建了一个 Hugo 工程。
+
+1. 从你工程的所在目录初始化 Hugo 模块
+
+ ```shell
+ hugo mod init github.com/<用户名>/<仓库名>
+ ```
+
+2. 新建 `config/_default/module.toml` 并写入以下内容:
+
+ ```toml
+ [[imports]]
+ path = "github.com/nunocoracao/blowfish/v2"
+ ```
+
+3. 运行 `hugo server` 启动你的本地服务器，本主题就会自动下载。
+
+4. 在你网站的根目录中删除由 Hugo 自动生成的 `config.toml`文件，并把主题文件夹中的`*.toml`配置文件复制到你的 `config/_default/`文件夹中
+
+ > **注** 不要覆盖之前的 `module.toml` ！
+
+ 你可在 Hugo 缓存目录中找到主题配置文件，或者也可以从[这里](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/nunocoracao/blowfish/tree/main/config/_default)下载一份。
+
+5. 按照[入门指南](https://blowfish.page/zh-cn/docs/getting-started/)来配置你的网站
+
+### Installing theme updates
+
+当新的主题版本发布，你可以在你网站的根目录使用 Hugo 命令`hugo mod get -u`来简单地把主题更新到最新版本。
+
+详细的[更新指南](https://blowfish.page/zh-cn/docs/installation/#%E6%9B%B4%E6%96%B0%E4%B8%BB%E9%A2%98)在文档中。
+
+---
+
+## 贡献
+
+Blowfish 将会持续进化。我打算不断增加功能，并按需进行修改。
+
+如有任何问题或对新功能的建议，请随时联系我。
+
+- 🐛 **Bug 问题报告** 使用 [GitHub Issues](https://github.com/nunocoracao/blowfish/issues)
+- 💡 **发表关于新功能的想法：** 在 [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions) 发起讨论
+- 🙋♀️ **一般问题：** 查看 [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
+
+如果你有能力修补 Bug 或者实现新功能，欢迎提交 PR。[了解更多](https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md).
+
+---
+
+## Star 数量统计
+
+[](https://starchart.cc/nunocoracao/blowfish)
+
+Mastodon
diff --git a/themes/blowfish/assets/css/compiled/main.css b/themes/blowfish/assets/css/compiled/main.css
index 3936000..d82a51b 100644
--- a/themes/blowfish/assets/css/compiled/main.css
+++ b/themes/blowfish/assets/css/compiled/main.css
@@ -14,7 +14,7 @@ body.zen-mode-enable {
}
}
-/*! tailwindcss v3.4.6 | MIT License | https://tailwindcss.com */
+/*! tailwindcss v3.4.10 | MIT License | https://tailwindcss.com */
/*
1. Prevent padding and border from affecting element width. (https://github.com/mozdevs/cssremedy/issues/4)
@@ -1121,7 +1121,6 @@ select {
.prose :where(table):not(:where([class~="not-prose"],[class~="not-prose"] *)) {
width:100%;
table-layout:auto;
- text-align:start;
margin-top:2em;
margin-bottom:2em;
font-size:0.875em;
@@ -1164,6 +1163,10 @@ select {
vertical-align:top
}
+.prose :where(th, td):not(:where([class~="not-prose"],[class~="not-prose"] *)) {
+ text-align:start
+}
+
.prose :where(figure > *):not(:where([class~="not-prose"],[class~="not-prose"] *)) {
margin-top:0;
margin-bottom:0
@@ -3163,6 +3166,13 @@ body button {
width:1em
}
+/* Scale SVG logos to appropriate size */
+
+.logo svg {
+ height:5rem;
+ width:5rem
+}
+
/* Search */
#search-query::-webkit-search-cancel-button,
@@ -3346,6 +3356,14 @@ code {
/* Renamed property in CSS3 draft spec */
}
+/* Fix long URLs breaking out of article bounds on mobile */
+
+a {
+ word-break: break-word;
+ word-wrap: break-word;
+ overflow-wrap: break-word;
+}
+
/* -- Chroma Highlight -- */
/* Background */
@@ -5339,6 +5357,10 @@ pre {
left:0px
}
+ .lg\:top-10 {
+ top:2.5rem
+ }
+
.lg\:top-\[140px\] {
top:140px
}
diff --git a/themes/blowfish/assets/css/main.css b/themes/blowfish/assets/css/main.css
index 7f46d01..6db6960 100644
--- a/themes/blowfish/assets/css/main.css
+++ b/themes/blowfish/assets/css/main.css
@@ -16,6 +16,11 @@ body button {
@apply h-[1em] w-[1em];
}
+/* Scale SVG logos to appropriate size */
+.logo svg {
+ @apply h-[5rem] w-[5rem];
+}
+
/* Search */
#search-query::-webkit-search-cancel-button,
#search-query::-webkit-search-decoration,
@@ -128,6 +133,13 @@ code {
overflow-wrap: break-word; /* Renamed property in CSS3 draft spec */
}
+/* Fix long URLs breaking out of article bounds on mobile */
+a {
+ word-break: break-word;
+ word-wrap: break-word;
+ overflow-wrap: break-word;
+}
+
/* -- Chroma Highlight -- */
/* Background */
.prose .chroma {
diff --git a/themes/blowfish/assets/icons/forgejo.svg b/themes/blowfish/assets/icons/forgejo.svg
new file mode 100644
index 0000000..495ac8b
--- /dev/null
+++ b/themes/blowfish/assets/icons/forgejo.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/themes/blowfish/assets/icons/gitea.svg b/themes/blowfish/assets/icons/gitea.svg
new file mode 100644
index 0000000..7985d93
--- /dev/null
+++ b/themes/blowfish/assets/icons/gitea.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/themes/blowfish/assets/js/search.js b/themes/blowfish/assets/js/search.js
index c3e7adb..bfa1a32 100644
--- a/themes/blowfish/assets/js/search.js
+++ b/themes/blowfish/assets/js/search.js
@@ -73,8 +73,6 @@ document.addEventListener("keydown", function (event) {
} else {
document.activeElement.click();
}
- }else{
- event.preventDefault();
}
}
diff --git a/themes/blowfish/assets/lib/lite-youtube-embed/lite-yt-embed.js b/themes/blowfish/assets/lib/lite-youtube-embed/lite-yt-embed.js
index 49db80e..591954b 100644
--- a/themes/blowfish/assets/lib/lite-youtube-embed/lite-yt-embed.js
+++ b/themes/blowfish/assets/lib/lite-youtube-embed/lite-yt-embed.js
@@ -46,10 +46,23 @@ class LiteYTEmbed extends HTMLElement {
this.addNoscriptIframe();
- playBtnEl.removeAttribute('href');
+ // for the PE pattern, change anchor's semantics to button
+ if(playBtnEl.nodeName === 'A'){
+ playBtnEl.removeAttribute('href');
+ playBtnEl.setAttribute('tabindex', '0');
+ playBtnEl.setAttribute('role', 'button');
+ // fake button needs keyboard help
+ playBtnEl.addEventListener('keydown', e => {
+ if( e.key === 'Enter' || e.key === ' ' ){
+ e.preventDefault();
+ this.activate();
+ }
+ });
+ }
// On hover (or tap), warm up the TCP connections we're (likely) about to use.
this.addEventListener('pointerover', LiteYTEmbed.warmConnections, {once: true});
+ this.addEventListener('focusin', LiteYTEmbed.warmConnections, {once: true});
// Once the user clicks, add the real iframe and drop our play button
// TODO: In the future we could be like amp-youtube and silently swap in the iframe during idle time
diff --git a/themes/blowfish/assets/lib/typeit/typeit.umd.js b/themes/blowfish/assets/lib/typeit/typeit.umd.js
index afd060f..453d618 100644
--- a/themes/blowfish/assets/lib/typeit/typeit.umd.js
+++ b/themes/blowfish/assets/lib/typeit/typeit.umd.js
@@ -1,2 +1,2 @@
// TypeIt by Alex MacArthur - https://typeitjs.com
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TypeIt=t()}(this,(function(){"use strict";const e=e=>Array.isArray(e),t=t=>e(t)?t:[t];const s="data-typeit-id",i="ti-cursor",r={started:!1,completed:!1,frozen:!1,destroyed:!1},n={breakLines:!0,cursor:{autoPause:!0,autoPauseDelay:500,animation:{frames:[0,0,1].map((e=>({opacity:e}))),options:{iterations:1/0,easing:"steps(2, start)",fill:"forwards"}}},cursorChar:"|",cursorSpeed:1e3,deleteSpeed:null,html:!0,lifeLike:!0,loop:!1,loopDelay:750,nextStringDelay:750,speed:100,startDelay:250,startDelete:!1,strings:[],waitUntilVisible:!1,beforeString:()=>{},afterString:()=>{},beforeStep:()=>{},afterStep:()=>{},afterComplete:()=>{}},o=`[${s}]:before {content: '.'; display: inline-block; width: 0; visibility: hidden;}`,a=e=>document.createElement(e),u=e=>document.createTextNode(e),l=(e,t="")=>{let s=a("style");s.id=t,s.appendChild(u(e)),document.head.appendChild(s)},h=t=>(e(t)||(t=[t/2,t/2]),t),d=(e,t)=>Math.abs(Math.random()*(e+t-(e-t))+(e-t));let p=e=>e/2;const c=e=>Array.from(e);let m=e=>([...e.childNodes].forEach((e=>{if(e.nodeValue)return[...e.nodeValue].forEach((t=>{e.parentNode.insertBefore(u(t),e)})),void e.remove();m(e)})),e);const f=e=>{let t=document.implementation.createHTMLDocument();return t.body.innerHTML=e,m(t.body)};function y(e,t=!1,s=!1){let r,n=e.querySelector(`.${i}`),o=document.createTreeWalker(e,NodeFilter.SHOW_ALL,{acceptNode:e=>{if(n&&s){if(e.classList?.contains(i))return NodeFilter.FILTER_ACCEPT;if(n.contains(e))return NodeFilter.FILTER_REJECT}return e.classList?.contains(i)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT}}),a=[];for(;r=o.nextNode();)r.originalParent||(r.originalParent=r.parentNode),a.push(r);return t?a.reverse():a}function g(e,t=!0){return t?y(f(e)):c(e).map(u)}const b=e=>Number.isInteger(e),P=({queueItems:e,selector:t,cursorPosition:s,to:i})=>{if(b(t))return-1*t;let r=new RegExp("END","i").test(i),n=t?[...e].reverse().findIndex((({char:e})=>{let s=e.parentElement,i=s.matches(t);return!(!r||!i)||i&&s.firstChild.isSameNode(e)})):-1;return n<0&&(n=r?0:e.length-1),n-s+(r?0:1)},C=(e,t)=>new Array(t).fill(e);let v=e=>new Promise((t=>{requestAnimationFrame((async()=>{t(await e())}))})),T=e=>e?.getAnimations().find((t=>t.id===e.dataset.tiAnimationId)),w=({cursor:e,frames:t,options:s})=>{let i=e.animate(t,s);return i.pause(),i.id=e.dataset.tiAnimationId,v((()=>{v((()=>{i.play()}))})),i},I=e=>e.func?.call(null),q=async({index:e,queueItems:t,wait:s,cursor:i,cursorOptions:r})=>{let n=t[e][1],o=[],a=e,u=n,l=()=>u&&!u.delay,h=n.shouldPauseCursor()&&r.autoPause;for(;l();)o.push(u),l()&&a++,u=t[a]?t[a][1]:null;if(o.length)return await v((async()=>{for(let e of o)await I(e)})),a-1;let d,p=T(i);return p&&(d={...p.effect.getComputedTiming(),delay:h?r.autoPauseDelay:0}),await s((async()=>{p&&h&&p.cancel(),await v((()=>{I(n)}))}),n.delay),await(({cursor:e,options:t,cursorOptions:s})=>{if(!e||!s)return;let i,r=T(e);r&&(t.delay=r.effect.getComputedTiming().delay,i=r.currentTime,r.cancel());let n=w({cursor:e,frames:s.animation.frames,options:t});return i&&(n.currentTime=i),n})({cursor:i,options:d,cursorOptions:r}),e};const S=e=>"value"in e;let N=e=>"function"==typeof e?e():e,A=(e,t=document,s=!1)=>t["querySelector"+(s?"All":"")](e);const E=(e,t)=>Object.assign({},e,t);let L={"font-family":"","font-weight":"","font-size":"","font-style":"","line-height":"",color:"",transform:"translateX(-.125em)"};return class{element;timeouts;cursorPosition;predictedCursorPosition;statuses={started:!1,completed:!1,frozen:!1,destroyed:!1};opts;id;queue;cursor;unfreeze=()=>{};constructor(e,s={}){var i;this.opts=E(n,s),this.element="string"==typeof(i=e)?A(i):i,this.timeouts=[],this.cursorPosition=0,this.unfreeze=()=>{},this.predictedCursorPosition=null,this.statuses=E({},r),this.id=Math.random().toString().substring(2,9),this.queue=function(e){let s=function(e){return t(e).forEach((e=>n.set(Symbol(e.char?.innerText),i({...e})))),this},i=e=>(e.shouldPauseCursor=function(){return Boolean(this.typeable||this.cursorable||this.deletable)},e),r=()=>Array.from(n.values()),n=new Map;return s(e),{add:s,set:function(e,t){let s=[...n.keys()];n.set(s[e],i(t))},wipe:function(){n=new Map,s(e)},done:(e,t=!1)=>t?n.delete(e):n.get(e).done=!0,reset:function(){n.forEach((e=>delete e.done))},destroy:e=>n.delete(e),getItems:(e=!1)=>e?r():r().filter((e=>!e.done)),getQueue:()=>n,getTypeable:()=>r().filter((e=>e.typeable))}}([{delay:this.opts.startDelay}]),this.#e(s),this.cursor=this.#t(),this.element.dataset.typeitId=this.id,l(o),this.opts.strings.length&&this.#s()}go(){return this.statuses.started?this:(this.#i(),this.opts.waitUntilVisible?(e=this.element,t=this.#r.bind(this),new IntersectionObserver(((s,i)=>{s.forEach((s=>{s.isIntersecting&&(t(),i.unobserve(e))}))}),{threshold:1}).observe(e),this):(this.#r(),this));var e,t}destroy(e=!0){this.timeouts=(this.timeouts.forEach(clearTimeout),[]),N(e)&&this.cursor&&this.#n(this.cursor),this.statuses.destroyed=!0}reset(e){!this.is("destroyed")&&this.destroy(),e?(this.queue.wipe(),e(this)):this.queue.reset(),this.cursorPosition=0;for(let t in this.statuses)this.statuses[t]=!1;return this.element[this.#o()?"value":"innerHTML"]="",this}is=function(e){return this.statuses[e]};type(e,t={}){e=N(e);let{instant:s}=t,i=this.#a(t),r=g(e,this.opts.html).map((e=>{return{func:()=>this.#u(e),char:e,delay:s||(t=e,/<(.+)>(.*?)<\/(.+)>/.test(t.outerHTML))?0:this.#l(),typeable:e.nodeType===Node.TEXT_NODE};var t})),n=[i[0],{func:async()=>await this.opts.beforeString(e,this)},...r,{func:async()=>await this.opts.afterString(e,this)},i[1]];return this.#h(n,t)}break(e={}){return this.#h({func:()=>this.#u(a("BR")),typeable:!0},e)}move(e,t={}){e=N(e);let s=this.#a(t),{instant:i,to:r}=t,n=P({queueItems:this.queue.getTypeable(),selector:null===e?"":e,to:r,cursorPosition:this.#d}),o=n<0?-1:1;return this.predictedCursorPosition=this.#d+n,this.#h([s[0],...C({func:()=>this.#p(o),delay:i?0:this.#l(),cursorable:!0},Math.abs(n)),s[1]],t)}exec(e,t={}){let s=this.#a(t);return this.#h([s[0],{func:()=>e(this)},s[1]],t)}options(e,t={}){return e=N(e),this.#c(e),this.#h({},t)}pause(e,t={}){return this.#h({delay:N(e)},t)}delete(e=null,t={}){e=N(e);let s=this.#a(t),i=e,{instant:r,to:n}=t,o=this.queue.getTypeable(),a=(()=>null===i?o.length:b(i)?i:P({queueItems:o,selector:i,cursorPosition:this.#d,to:n}))();return this.#h([s[0],...C({func:this.#m.bind(this),delay:r?0:this.#l(1),deletable:!0},a),s[1]],t)}freeze(){this.statuses.frozen=!0}flush(e=(()=>{})){return this.#i(),this.#r(!1).then(e),this}getQueue(){return this.queue}getOptions(){return this.opts}updateOptions(e){return this.#c(e)}getElement(){return this.element}empty(e={}){return this.#h({func:this.#f.bind(this)},e)}async#f(){this.#o()?this.element.value="":this.#y.forEach(this.#n.bind(this))}async#r(e=!0){this.statuses.started=!0;let t=t=>{this.queue.done(t,!e)};try{let s=[...this.queue.getQueue()];for(let e=0;e