chore: adopt Biome + Stylelint, modernize CI/CD, add security/support docs, minor JS fixes

- Linting/format
  - Replace ESLint/Prettier with Biome; remove old configs; add `biome.json`; update scripts
  - Tailwind-friendly `.stylelintrc.yaml`; Stylelint and Biome pass
  - Enable Biome across `modules/**`; prune legacy JS globals; ignore oversized `devicon.json`

- Code fixes
  - `hb-theme.js`: avoid assignment-in-expressions; clearer dataset updates
  - `hugoblox-slides.js`: fix inner var scope (var → let); apply formatting

- CI/CD
  - Split lint/build workflows; add path filters; Node via Corepack (pnpm from package.json)
  - Hugo pinned to env `HUGO_VERSION`; add consistency check vs `starters/academic-cv/hugoblox.yaml`
  - Nightly starters matrix build (academic-cv, landing-page); CodeQL weekly; resource caches

- Workflows/Community
  - Greeter: switch to `pull_request_target`; add Contributor Guide to PR message
  - PR labeler for path-based labels

- Repo policies/docs
  - `CODEOWNERS` for `@gcushen`
  - `SECURITY.md`, `SUPPORT.md`
  - Documented branch protection in `.github/settings.yml`
  - Move `CODE_OF_CONDUCT.md` to `.github/`

- docs(zh): update `README.zh.md` translation

Notes:
- pnpm is sourced from `package.json: packageManager` via Corepack; no hard-coded pnpm versions in CI.
This commit is contained in:
George Cushen committed 2025-09-17 03:17:38 +01:00
1 parent db8a975a9f
commit d5d2f04c2d
91 files changed
+2957 -1993

No files matched your search

+88 -72
View File
@@ -1,111 +1,127 @@
[**English**](./README.md)
[_English_](./README.md)
<p align="center"><a href="https://hugoblox.com/templates/" target="_blank" rel="noopener"><img src="./.github/media/sharing.png" alt="Hugo Blox Builder 网站构建工具"></a></p>
<p align="center">
<a href="https://hugoblox.com/start?utm_source=github&utm_medium=readme">
<img src="./.github/media/zh-hero.png" alt="用 Hugo Blox 打造世界级站点" width="100%">
</a>
</p>
[![开始使用](https://img.shields.io/badge/-开始使用-ff4655?style=for-the-badge)](https://hugoblox.com/templates/)
[![Discord](https://img.shields.io/discord/722225264733716590?style=for-the-badge)](https://discord.com/channels/722225264733716590/742892432458252370/742895548159492138)
[![GitHub 赞助者](https://img.shields.io/github/sponsors/gcushen?label=%E2%9D%A4%EF%B8%8F%20赞助&style=for-the-badge)](https://github.com/sponsors/gcushen)
[![Twitter 关注者](https://img.shields.io/twitter/follow/GetResearchDev?label=关注Twitter&style=for-the-badge)](https://twitter.com/GetResearchDev)
[![GitHub 关注者](https://img.shields.io/github/followers/gcushen?label=关注GH&style=for-the-badge)](https://github.com/gcushen)
<h1 align="center">技术/学术网站的开源王牌工具箱</h1>
# [Hugo Blox Builder](https://hugoblox.com): 全能网站构建工具
<p align="center">
<strong>效率拉满:</strong> 几分钟上线,性能和 SEO 都很能打。<br/>
<!-- 受到 250,000+ 创新者青睐(Meta、Stanford、Google、MIT、OpenAI 等)。 -->
</p>
### 加入 750,000+ 站点。零代码。轻松创建面向未来的网站✏️ 📰 🚀
<p align="center">
<a href="https://hugoblox.com/start?utm_source=github&utm_medium=readme"><b>🚀 免费开始</b></a>
&nbsp;•&nbsp;
<a href="https://hugoblox.com/pro?utm_source=github&utm_medium=readme"><b>立即升级 Pro(终身)</b></a>
<!-- &nbsp;•&nbsp;
<a href="https://discord.gg/z8wNYzb">加入 Discord</a> -->
</p>
🔥 **1. 使用 [Hugo](https://github.com/gohugoio/hugo) 引擎支持的模块,免费创建_任何_类型的网站** - 从登录页面、知识库和课程到专业简历、会议和技术博客
<p align="center">
<a href="https://discord.gg/z8wNYzb">
<img src="https://img.shields.io/discord/722225264733716590?label=%E5%8A%A0%E5%85%A5%20Discord&style=social" alt="Discord">
</a>
<a href="https://github.com/HugoBlox/hugo-blox-builder">
<img src="https://img.shields.io/github/stars/HugoBlox/hugo-blox-builder?label=%E4%B8%BA%20Hugo%20Blox%20%E5%8A%A0%E6%98%9F&style=social" alt="为 Hugo Blox 加星">
</a>
<a href="https://github.com/gcushen">
<img src="https://img.shields.io/github/followers/gcushen?label=%E5%85%B3%E6%B3%A8&style=social" alt="在 GitHub 关注">
</a>
</p>
🎨 **2. 个性化**漂亮的起始模板,享有**50+种浅色/深色主题、多语言包和模块**
---
🛋 **3. 可选地,使用基于 [Decap CMS](https://docs.hugoblox.com/getting-started/cms/decap/) 的开源内容管理系统(CMS),随时随地从沙发上或外出写作**
## 为什么选 Hugo Blox?
<p style="text-align: center"><a href="https://hugoblox.com/templates/" target="_blank" rel="noopener"><img src="./.github/media/write-from-phone.gif" alt="Decap CMS"></a></p>
- **分钟级上线,不再内耗:** 选模板 → 拖拽积木 → 发布。SaaS 落地页、在线课程、学术简历、实验室主页… 都能一把梭。
- **完全掌控内容与品牌:** 纯静态输出,无厂商锁定,轻松冲 100/100 Lighthouse 分数。内容归你,你做主。
- **技术范儿十足:** Hugo + Tailwind CSS 现代栈。支持 Markdown、Jupyter、BibTeX,出版物自动同步,工作流丝滑顺手。
- **开源且可扩展:** MIT 核心慷慨开源。可用 React “小岛”增强交互,或升级 Pro 解锁更多专业模板与积木。
[查看最新的 **演示**](https://hugoblox.com/templates/),在不到 60 秒内获取您将获得的内容,或者获得其他创作者的 [**灵感**](https://hugoblox.com/creators/)。
<p align="center">
<img src="./.github/media/templates.webp" alt="模板预览" width="900">
</p>
- 👉 [**开始使用**](https://hugoblox.com/templates/)
- 📚 [查看 **文档**](https://docs.hugoblox.com/)
- 🙋‍♀️ **有问题吗?**
- **立即在 [Discord](https://discord.gg/z8wNYzb) 上与我们聊天**,或浏览 [故障排除指南](https://docs.hugoblox.com/reference/troubleshooting/) 和 [问答论坛](https://github.com/HugoBlox/hugo-blox-builder/discussions)
- _此外,查看 [Hugo 论坛](https://discourse.gohugo.io) 解决 Hugo 相关问题,以及 [Netlify 论坛](https://answers.netlify.com/) 解答 Netlify 相关问题_
- 🐦 与社区共享您的 Hugo Blox Builder 网站:[@GetResearchDev](https://twitter.com/GetResearchDev) [@GeorgeCushen](https://twitter.com/GeorgeCushen) [#MadeWithHugoBlox](https://twitter.com/search?q=%23MadeWithHugoBlox&src=typed_query)
- 🗳 [参加调查,帮助我们改进 #开源](https://forms.gle/NioD9VhUg7PNmdCAA)
- ⬆️ **更新?** 查看 [更新指南](https://docs.hugoblox.com/reference/update/) 和 [发布说明](https://github.com/HugoBlox/hugo-blox-builder/releases)
- 🚀 [贡献改进](CONTRIBUTING.md) 或 [建议改进](https://github.com/HugoBlox/hugo-blox-builder/issues)
<p align="center">
<a href="https://hugoblox.com/templates?utm_source=github&utm_medium=readme"><b>浏览模板 →</b></a>
</p>
## 💙 我们向您恳请支持这个开源运动
---
今天我们请求您捍卫 Hugo Blox Builder 网站构建工具和主题的开源独立性 🐧
## 快速上手
我们是一个**开源和开放科学的运动**,依靠您的支持来保持在线和繁荣,但我们的 99.9% 的创作者没有做出贡献,他们只是选择置之不理 🤦🏻‍♀️
**推荐(最快、零安装):**
👉 [**浏览器里直接开干**](https://hugoblox.com/start?utm_source=github&utm_medium=readme) — 选模板、改积木、发布到 GitHub Pages。
### [😍️ 点击此处成为 GitHub 赞助者,解锁令人惊叹的特权,如 _独家模板、小部件和教程_](https://github.com/sponsors/gcushen)
**命令行选手?**
使用本地快速开始:
### 商业赞助者
```bash
# 1) 安装 Hugo Extended → https://docs.hugoblox.com/getting-started/install-hugo/#prerequisites
<div style="display: grid; column-gap: 50px; grid-template-columns: repeat(3, 1fr);">
<div style="display: flex; align-items: center;">
<a href="https://www.netlify.com/" target="_blank"><img src=".github/media/sponsors/netlify.svg" alt="" height="40" width="147" style="display: inline-block;"></a>
</div>
<div>
<a href="https://github.com/sponsors/gcushen"><img src=".github/media/sponsors/your-logo-here.png" alt="" style="display: inline-block;"></a>
</div>
</div>
# 2) 克隆一个起步模板(示例:Academic CV)- 更多模板见 https://hugoblox.com/templates
git clone https://github.com/HugoBlox/theme-academic-cv my-site
cd my-site
## 起始模板
# 3) 本地运行
pnpm install && hugo server -D
```
Hugo Blox Builder 是一个使用**小部件**创建_任何_类型网站的**零代码**框架。每个网站都是 100% 可自定义,使其成为您的专属网站!
更多指南请访问文档 [**https://docs.hugoblox.com/**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme)。
选择一个起始模板,轻松上手:
---
[![撰写技术内容](./.github/media/starters.webp)](https://hugoblox.com/templates/)
## Free vs. Pro
## 技术内容撰写的未来
Hugo Blox 自带一套用于 Hero、Features、Testimonials、FAQs 等的**免费积木**。**Pro** 为一次性捐赠,解锁**独家、专业设计的高级积木**与整站模板,助你更快更稳地上线。
使用标准化的 Markdown 和捆绑的扩展(包括数学和图表)**编写丰富、具备未来性的内容**。可以在开源 CMS 中编辑,也可以通过在线的 GitHub 编辑器、Jupyter Notebook 或 RStudio 进行编辑![了解更多](https://docs.hugoblox.com/reference/markdown/)
- 免费模板与积木:[**模板目录**](https://hugoblox.com/templates?utm_source=github&utm_medium=readme)
- Pro 目录与终身更新:[**立即升级 Pro(终身)**](https://hugoblox.com/pro?utm_source=github&utm_medium=readme)
[![撰写技术内容](https://hugoblox.com/uploads/readmes/writing-technical-content.gif)](https://academic-demo.netlify.app/post/writing-technical-content/)
---
## 特点
## 创作者怎么说
[![截图](./.github/media/academic.png)](https://hugoblox.com/templates/)
> “Hugo Blox 直接帮我省了 40+ 小时做实验室网站。BibTeX 自动同步出版物 —— **引用量提升了 3×**。”
> —— **Sarah Yang 博士**,AI 研究者
**主要特点:**- **页面构建器** - 使用[小部件](https://docs.hugoblox.com/getting-started/page-builder/)和[元素](https://docs.hugoblox.com/reference/markdown/)创建_任何东西_
- **编辑任何类型的内容** - 博客文章、出版物、演讲、幻灯片、项目等等!
- 使用 [**Markdown**](https://docs.hugoblox.com/reference/markdown/)、[**Jupyter**](https://docs.hugoblox.com/getting-started/cms/) 或 [**RStudio**](https://docs.hugoblox.com/getting-started/cms/rstudio/) 创建内容
- **插件系统** - 完全可定制的[**颜色**和**字体主题**](https://docs.hugoblox.com/getting-started/customize/#appearance)
- **显示代码和数学公式** - 支持代码高亮和[LaTeX数学](https://docs.hugoblox.com/reference/markdown/#math)
- **集成** - [Google Analytics](https://analytics.google.com)、[Disqus评论](https://disqus.com)、地图、联系表单等等!
- **美丽的网站** - 简单清爽的单页设计
- **行业领先的SEO** - 帮助您的网站在搜索引擎和社交媒体上被发现
- **媒体图库** - 在可定制的图库中显示带标题的图像和视频
- **移动友好** - 适用于各种屏幕的移动友好版本,外观令人惊艳
- **多语言** - 35+语言包,包括英文、中文和葡萄牙文
- **多用户** - 每个作者都有自己的个人资料页面
- **隐私保护套件** - 协助符合GDPR
- **脱颖而出** - 使用动画、视差背景和滚动效果使您的网站生动起来
- **一键部署** - 无需服务器、无需数据库,只有文件。
> “我们 10 分钟就把文档站点上线了。积木系统太妙了;**新同学上手时间缩短了 60%**。”
> —— **Alexandre Rodrigues**,创始人
## 主题
---
Hugo Blox Builder内置了**自动白天(浅色)和黑夜(暗色)模式**。或者,单击[Demos](https://hugoblox.com/templates/)右上角的月亮图标设置您喜欢的模式!
## 支持这个项目
为您的网站选择一个惊艳的主题,并[自定义它](https://docs.hugoblox.com/getting-started/customize/#custom-theme)以满足您的喜好:
- 💎 **Pro(一次性捐赠)** — 终身获取全部高级模板、积木与更新。
<br/>[**立即升级 Pro(终身)→**](https://hugoblox.com/pro?utm_source=github&utm_medium=readme)
[![主题](./.github/media/themes.png)](https://hugoblox.com/templates/)
- ☕️ **请我们喝杯咖啡** — 支持开源与开放科研。
<br/>[**GitHub 赞助 →**](https://github.com/sponsors/gcushen)
[浏览更多模板和主题...](https://hugoblox.com/templates/)
- 🤝 **企业赞助** — 触达成千上万开发者与研究者。你的 Logo 将展示在此 README。
<br/>[**成为合作伙伴 →**](https://github.com/sponsors/gcushen)
## 生态系统
---
- [**Academic File Converter**](https://github.com/GetRD/academic-file-converter):自动将学术出版物从BibTeX导入到Markdown文件
- [**Awesome Hugo**](https://github.com/HugoBlox/awesome-hugo):帮助将内容迁移到Hugo的新版本的脚本
## 社区
## 加入社区
欢迎加入社区提问、分享与共建。
请随意在Github上[_star_该项目](https://github.com/HugoBlox/hugo-blox-builder),在Discord上[join the community](https://discord.gg/z8wNYzb),并关注Twitter上的[@GetResearchDev](https://twitter.com/GetResearchDev),第一时间获取新功能的消息。
- 💬 [Discord](https://discord.gg/z8wNYzb)
- 📚 [文档与指南](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme)
- 🐦 [X / Twitter](https://twitter.com/GetResearchDev)
- ⭐ [为 Hugo Blox 加星](https://github.com/HugoBlox/hugo-blox-builder)
---
## 许可证
版权所有 2016-present [George Cushen](https://georgecushen.com)。
MIT © 2016–至今 [George Cushen](https://georgecushen.com?utm_source=github&utm_medium=hbb-readme) — [License 详情](./LICENSE.md)
[Hugo Blox Builder](https://github.com/HugoBlox/hugo-blox-builder/)存储库根据[MIT](https://github.com/HugoBlox/hugo-blox-builder/blob/main/LICENSE.md)许可证发布。
<p align="center">
<sub>无追踪。无锁定。你的内容,始终属于你。</sub>
</p>