Merge pull request #1621 from nunocoracao/dev

🔖 v2.75.0
nunocoracao · Aug 10, 2024 · 580f36f · 580f36f
2 parents b2c27be + 80417d4
commit 580f36f
Show file tree

Hide file tree

Showing 138 changed files with 1,978 additions and 179 deletions.
diff --git a/README.md b/README.md
@@ -1,3 +1,4 @@
+English | [简体中文](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md)
 # Blowfish
 [![Deploy Production to Firebase](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml)
 [![Deploy Production to GitHub pages](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml)
@@ -141,7 +142,7 @@ blowfish-tools new mynewsite
 
 3. Start your server using `hugo server` and the theme will be downloaded automatically.
 
-4. In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.
+4. In the root folder of your website, delete the `hugo.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.
 
    > **Note:** Do not overwrite the `module.toml` file you created above!
 

diff --git a/README.zh-cn.md b/README.zh-cn.md
@@ -0,0 +1,176 @@
+[English](https://github.com/nunocoracao/blowfish/blob/main/README.md) | 简体中文
+# Blowfish
+[![Deploy Production to Firebase](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/firebase-production.yml)
+[![Deploy Production to GitHub pages](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml/badge.svg)](https://github.com/nunocoracao/blowfish/actions/workflows/pages.yml)
+[![Minimum Hugo Version](https://img.shields.io/static/v1?label=min-HUGO-version&message=0.87.0&color=blue&logo=hugo)](https://github.com/gohugoio/hugo/releases/tag/v0.87.0)
+[![GitHub](https://img.shields.io/github/license/nunocoracao/blowfish)](https://github.com/nunocoracao/blowfish/blob/main/LICENSE)
+[![Blowfish](https://img.shields.io/badge/Hugo--Themes-@Blowfish-blue)](https://themes.gohugo.io/themes/blowfish/)
+![code-size](https://img.shields.io/github/languages/code-size/nunocoracao/blowfish)
+
+Blowfish 是一个轻量有力的 Hugo 主题。它使用 Tailwind CSS 构建，洁净而富有极简主义，是你网站内容载体的不二之选。  
+
+![blowfish screenshot](https://github.com/nunocoracao/blowfish/blob/main/images/screenshot.png?raw=true)
+
+
+🌏 [示例站点](https://blowfish.page/zh-cn/)  
+📑 [主题文档](https://blowfish.page/zh-cn/docs/)  
+💎 [周边商店](http://tee.pub/lic/qwSlWVBL5zc)  
+🐛 [Bug 问题报告](https://github.com/nunocoracao/blowfish/issues)  
+💡 [问答和功能需求](https://github.com/nunocoracao/blowfish/discussions)
+
+
+
+<a href="https://www.buymeacoffee.com/nunocoracao" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+<a target="_blank" href="http://tee.pub/lic/qwSlWVBL5zc"><img class="nozoom" src="https://img.buymeacoffee.com/button-api/?text=Merch Store &emoji=💎&slug=nunocoracao&button_colour=5F7FFF&font_colour=ffffff&font_family=Lato&outline_colour=000000&coffee_colour=FFDD00" /></a>
+
+
+
+## 特性
+
+- 使用 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 logo](https://github.com/nunocoracao/blowfish/blob/main/logo.png?raw=true)
+
+## 文档
+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 数量统计
+
+[![Stargazers over time](https://starchart.cc/nunocoracao/blowfish.svg)](https://starchart.cc/nunocoracao/blowfish)
+
+<a rel="me" href="https://masto.ai/@blowfish">Mastodon</a>
diff --git a/assets/css/compiled/main.css b/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.7 | MIT License | https://tailwindcss.com */
 
 /*
 1. Prevent padding and border from affecting element width. (https://github.com/mozdevs/cssremedy/issues/4)
@@ -3163,6 +3163,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 +3353,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 +5354,10 @@ pre {
     left:0px
   }
 
+  .lg\:top-10 {
+    top:2.5rem
+  }
+
   .lg\:top-\[140px\] {
     top:140px
   }

diff --git a/assets/css/main.css b/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/assets/icons/forgejo.svg b/assets/icons/forgejo.svg
diff --git a/assets/icons/gitea.svg b/assets/icons/gitea.svg