[**English**](./README.md)

<p align="center">
  <a href="https://hugoblox.com/start?utm_source=github&utm_medium=readme&utm_content=hero_image">
    <img src="./.github/media/hero.zh.png" alt="用 HugoBlox 打造世界级站点" width="100%">
  </a>
</p>

<h1 align="center">HugoBlox: 您的开源发布栈</h1>

<p align="center">
  <strong>基于 Markdown + Jupyter 发布笔记、文档、作品集和知识库。</strong><br/>
  专为追求速度且拒绝锁定的数据科学家、AI 工程师、研究人员、实验室和科技初创公司打造：Hugo + Tailwind 核心，可选 Researcher Plan 自动化（可视化编辑、一键导入、自动修复和升级）。
</p>

<p align="center">
  <a href="https://hugoblox.com/start?utm_source=github&utm_medium=readme&utm_content=cta_start"><b>浏览器中免费试用</b></a>
  &nbsp;•&nbsp;
  <a href="https://marketplace.visualstudio.com/items?itemName=ownable.ownable"><b>获取 HugoBlox Studio (VS Code)</b></a>
</p>

<p align="center">
  <sub>
    <a href="#面向研究人员与实验室">研究人员与实验室</a>
    &nbsp;•&nbsp;
    <a href="#面向数据科学家与-ai-工程师">数据科学家与 AI 工程师</a>
    &nbsp;•&nbsp;
    <a href="#面向团队与组织">团队与组织</a>
    &nbsp;•&nbsp;
    <a href="#plans">自动化与订阅计划</a>
  </sub>
</p>

<div align="center">

<a href="https://discord.gg/z8wNYzb">
    <img src="https://img.shields.io/discord/722225264733716590?label=%E5%8A%A0%E5%85%A5%20Discord&logo=discord&logoColor=white&style=flat-square&color=5865F2" alt="Discord">
  </a>
  <a href="https://github.com/HugoBlox/kit">
    <img src="https://img.shields.io/github/stars/HugoBlox/kit?label=%E7%82%B9%E8%B5%9E%20HugoBlox&logo=github&logoColor=white&style=flat-square&color=181717" alt="GitHub Stars">
  </a>
  <a href="https://x.com/MakeOwnable">
    <img src="https://img.shields.io/twitter/follow/MakeOwnable?label=%E5%85%B3%E6%B3%A8&logo=x&logoColor=white&style=flat-square&color=000000" alt="Follow on X">
  </a>
  <a href="https://marketplace.visualstudio.com/items?itemName=ownable.ownable">
    <img src="https://img.shields.io/visual-studio-marketplace/i/ownable.ownable?label=VS%20Code%20%E5%AE%89%E8%A3%85%E9%87%8F&logo=visualstudiocode&logoColor=white&style=flat-square&color=007ACC" alt="VS Code Installs">
  </a>
  <a href="https://marketplace.visualstudio.com/items?itemName=ownable.ownable">
    <img src="https://img.shields.io/visual-studio-marketplace/stars/ownable.ownable?label=VS%20Code%20%E8%AF%84%E5%88%86&logo=visualstudiocode&logoColor=white&style=flat-square&color=007ACC" alt="VS Code Rating">
  </a>

</div>

<p align="center">
  <sub>
    源自 <strong>2016</strong> · <strong>150,000+</strong> 研究人员与科学家信赖 (Meta, Stanford, NVIDIA) · 用户评分 <strong>4.9/5</strong> (官方调研) · 被 <a href="https://research.nvidia.com/research-labs">NVIDIA Research Labs</a>, <a href="https://cai4cai.ml/">King’s College London</a>, 以及 <a href="https://www.metaconscious.org/">MIT</a> 等团队使用 · 入选 GitHub <a href="https://github.blog/open-source/release-radar-february-2019/#hugo-academic-4-0">Release Radar</a>
  </sub>
</p>

---

## ⚡️ 为什么团队选择 HugoBlox

在 AI 时代，**Markdown 就是新的源代码**。HugoBlox 赋予您现代工具的速度与静态技术栈的持久性：**Hugo + Tailwind**（支持可选的 Alpine/Svelte 模块以增强交互性）。

- **拥有您的内容**：纯净的 Markdown、YAML 和 Notebooks —— 便携、可读且对 LLM 友好。
- **无运维负担的极致性能**：静态输出，极速构建，无运行时数据库。
- **默认即美**：高质量的模板 + 积木（需要更多功能时可选 Researcher Plan）。
- **混合工作流**：代码中直接编辑，或在需要速度时使用可视化编辑器。

---

## 面向研究人员与实验室

- **实验室站点与学术主页**（人员、出版物、项目、新闻）
- **可引用的输出**，支持 BibTeX/DOI 工作流
- **Notebooks + LaTeX**，让技术写作完美渲染

## 面向数据科学家与 AI 工程师

- **项目文档**与无需繁重 JavaScript 栈的技术博客
- **Notebook 优先发布** (`.ipynb`)，用于报告、教程和结果展示
- **知识库**与内部文档，保持可搜索与可维护

## 面向团队与组织

- **一致的站点**，通过模板 + 积木实现跨团队统一
- **低风险升级**，提供清晰的版本控制 + 迁移指南
- **支持选项**，当您需要快速解答时

---

## 🧠 随心所欲地编辑（代码优先，亦可可视化）

- **代码优先**：Markdown/YAML + Hugo 模板，掌控全局。
- **可视化编辑 (Researcher Plan)**：VS Code 中的 **HugoBlox Studio**，提供拖拽式积木、实时预览和更安全的配置编辑。
- **AI 自动化 (Researcher Plan)**：减少在格式调整、YAML 修复、导入和维护上花费的时间。

<p align="center">
  <img src="./.github/media/studio/slide-1.webp" alt="HugoBlox Studio 实战" width="100%">
</p>
<p align="center"><em>HugoBlox Studio: 可视化编辑与代码优先掌控的完美结合。</em></p>

---

## 🛠️ 工具箱

| **功能** | **核心价值** |
| :--- | :--- |
| **HugoBlox Studio (VS Code)** | 编辑器内的可视化 CMS。无需离开 VS Code 即可拖拽积木。 |
| **Notebooks & LaTeX** | 原生渲染 `.ipynb` 和重数学公式页面。 |
| **BibTeX / DOI 工作流** | 构建出版物页面和参考文献，无需手动格式化。 |
| **多语言支持** | 使用 Markdown, Jupyter, RMarkdown, 或 LaTeX Math 写作。 |

<p align="center">
  <img src="./.github/media/templates.webp" alt="模板预览" width="900">
</p>

<p align="center">
  <a href="https://hugoblox.com/templates?utm_source=github&utm_medium=readme&utm_content=templates"><b>浏览模板 →</b></a>
</p>

<p align="center">
  <sub>想看它快速运行？选择一个模板，使用 Online Copilot 在约 60 秒内发布。</sub><br/>
  <a href="https://hugoblox.com/start?utm_source=github&utm_medium=readme&utm_content=cta_template_start"><b>立即尝试模板 →</b></a>
</p>

---

## 🚀 快速开始

### 选项 1：在线 Copilot（最快）
适合 **创始人、实验室和初创公司**。几分钟内上线站点。

👉 [**浏览器中免费试用**](https://hugoblox.com/start?utm_source=github&utm_medium=readme&utm_content=get_started_browser)

### 选项 2：HugoBlox Studio（适合数据/AI 团队）
可视化网站构建器的力量，直接集成在 VS Code 中。

1. **安装** [VS Code 市场中的 HugoBlox Studio](https://marketplace.visualstudio.com/items?itemName=ownable.ownable).
2. **打开** 任意 HugoBlox 项目文件夹。
3. **点击** 菜单中的 HugoBlox Studio 图标开始可视化编辑。

### 选项 3：命令行 CLI（适合 DevOps/工程师）
在本地搭建新项目骨架。

```bash
  # 需要 Hugo Extended & Node.js
  npm install -g hugoblox
  hugoblox create site
```

需要指南和最佳实践？查看文档：[**docs.hugoblox.com**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme&utm_content=docs)

---

## ✅ 稳定性与升级（您的站点不应崩溃）

- **锁定版本** 以保持生产环境稳定。
- **自信升级**，使用迁移说明和升级指南。
- **安全定制**：尽可能优先使用配置和积木，而非脆弱的模板覆盖。
- **尽早发现配置问题 (Researcher Plan)**：可视化编辑 + 验证减少 YAML/Front Matter 错误。

查看文档获取升级指导：[**docs.hugoblox.com**](https://docs.hugoblox.com/?utm_source=github&utm_medium=readme&utm_content=upgrade_guidance)

<a name="plans"></a>
## ⚡️ 解锁自动化与 Premium

HugoBlox 采用 **Open Core** 模式。**免费套件 (Free Kit)** 达到生产级标准，您将永远拥有您的数据和代码。

免费套件包含：

- **[HugoBlox Studio](https://marketplace.visualstudio.com/items?itemName=ownable.ownable) 核心**：可视化站点配置、主题设置和内容编辑
- **模板 + 积木**，用于作品集、实验室、文档和落地页
- **Markdown/YAML 优先工作流**，具备 Hugo + Tailwind 性能
- **Notebook + LaTeX 支持**，用于技术发布
- **社区支持**，通过文档、GitHub Issues 和 Discord

### 🤖 Researcher Plan (自动化)

当您需要自动化和更低的维护开销时，升级到 [HugoBlox Studio](https://marketplace.visualstudio.com/items?itemName=ownable.ownable) 的 **Researcher Plan (研究员计划)**（需登录扩展）：

- **更少时间调试 YAML** (自动修复机器人 + 更安全的配置编辑)
- **更少时间格式化引用** (魔法导入 + 出版物自动化)
- **更少时间处理升级** (引导式维护工作流)
- **更高速度** (VS Code 中的可视化编辑 + 预览)


| 功能 | **免费套件** (开源) | **Researcher Plan** (自动化) |
| :--- | :---: | :---: |
| **站点所有权** | ✅ 100% 归您所有 | ✅ 100% 归您所有 |
| **可视化页面编辑器** | ❌ | **✅ 包含** |
| **AI 助手** | ⏳ 试用 | **✅ 包含** |
| **GitHub 自动同步** | ❌ | **✅ 包含** |
| **AI "自动修复" 机器人** (自动修复 YAML) | ❌ | **✅ 无限** |
| **魔法导入** (BibTeX/DOI -> 页面) | ⏳ 试用 | **✅ 无限** |
| **CV 生成器** (站点 -> PDF 简历) | ❌ | **✅ 包含** |
| **私有 Discord** | ❌ | ✅ |
| **支持开放科研** | 💜 | **🏆 Hero 身份** |

👉 [**查看完整功能矩阵**](https://hugoblox.com/pricing?utm_source=github&utm_medium=readme&utm_content=pricing_matrix) &nbsp;•&nbsp; [**升级到 Researcher Plan**](https://hugoblox.com/pricing?utm_source=github&utm_medium=readme&utm_content=cta_pro)

> "HugoBlox Studio 帮我的实验室网站节省了 **40+ 小时**。可视化编辑 + BibTeX 自动更新 = **引用量提升了 3 倍**。"
> <br/>— **Dr. Sarah Yang**, AI 研究员

### 🎨 HugoBlox Premium

**获取完整套件。** 即刻访问高级模板、高级积木和社区支持，助您更快上线。

| 功能 | 开源版 | **HugoBlox Premium** |
| :--- | :---: | :---: |
| **核心框架** | ✅ | ✅ |
| **高级模板** (SaaS, 实验室) | ❌ | **✅ 包含** |
| **高级积木** | ❌ | **✅ 包含** |
| **移除归属声明?** | ❌ | **✅ 包含** |
| **私有 Discord** | ❌ | ✅ |
| **支持开放科研** | 💜 | **🏆 Hero 身份** |

👉 [**获取 Premium 模板包**](https://hugoblox.com/premium?utm_source=github&utm_medium=readme&utm_content=cta_premium)

> "用了不到 **10 分钟** 就上线了我的初创公司网站和文档。高级积木系统太天才了；新手上手时间缩短了 60%。"
> <br/>— **Alexandre Rodrigues**, 创始人

---

## 🏢 企业级就绪（拒绝臃肿）

- **随处部署**：静态输出适用于您现有的基础设施。
- **更低的运维面**：无需修补运行时应用漏洞。
- **采购友好的选项**：按需提供优先支持和商业功能。

---

## 🗣️ 社区与支持

我们是一个由 150,000+ 研究人员、工程师和创作者组成的社区。

- **需要帮助？** 加入 [Discord 服务器](https://discord.gg/z8wNYzb) 或搜索 [文档](https://docs.hugoblox.com/)。
- **发现 Bug？** 提交 [Issue](https://github.com/HugoBlox/kit/issues)。
- **想要贡献？** 阅读我们的 [贡献指南](./CONTRIBUTING.md)。

### 赞助商
帮助我们维持开源的可持续性。

[**❤️ 在 GitHub 上赞助**](https://github.com/sponsors/gcushen) | [**🏢 成为合作伙伴**](https://github.com/sponsors/gcushen)

---

## 许可证

Copyright © 2016-Present [**Lore Labs**](https://lore.tech/?utm_source=github&utm_medium=readme).
Released under the [MIT License](./LICENSE.md).

<p align="center">
  <sub>Lore™ is a trademark of Lore Labs.</sub>
</p>