中文

HugoBlox：您的开放出版技术栈

通过 Markdown + Jupyter 发布笔记本、文档、作品集和知识库。
专为数据科学家、AI 工程师、研究人员、实验室以及希望兼顾速度与灵活性的技术初创企业打造：Hugo + Tailwind，搭配可选的 Researcher Plan 自动化功能（可视化编辑、导入、修复与升级）。

在浏览器中免费开始  •  获取 Ownable CMS（VS Code）

_{研究人员与实验室  •  数据科学家与 AI 工程师  •  团队与组织  •  自动化与方案}

_{自 2016 年以来备受信赖 · 超过 15 万 名研究人员和科学家使用（Meta、斯坦福大学、NVIDIA 等）· 用户评分达到 4.9/5（官方调查）· NVIDIA Research Labs、伦敦国王学院、MIT 等团队都在使用 · GitHub Release Radar 曾重点推荐}

https://github.com/user-attachments/assets/a0be0c48-b8d5-4b40-a11b-85fedcdf89bc

---

⚡️ 为什么团队选择 HugoBlox

在 AI 时代，Markdown 就是新的源代码。HugoBlox 让您既能享受现代工具的速度优势，又能拥有静态技术栈的持久性：Hugo + Tailwind（还可选 Alpine/Svelte 组件以实现交互功能）。

• 掌控您的内容：干净的 Markdown、YAML 和笔记本——便携、易读且适合大模型处理。
• 高性能，无需运维负担：静态输出、快速构建，无需运行时数据库。
• 开箱即美：高质量模板与组件（如需更多功能，可选择 Researcher Plan）。
• 混合工作流：既可在代码中编辑，也可在需要快速推进时使用可视化编辑器。

---

针对研究人员与实验室

• 实验室网站与学术主页（人员、论文、项目、新闻）
• 可引用的成果，支持 BibTeX/DOI 工作流
• 笔记本 + LaTeX，用于真正能正确渲染的技术写作

针对数据科学家与 AI 工程师

• 项目文档和无重型 JavaScript 堆栈的技术博客
• 以笔记本优先的发布方式（.ipynb），适用于报告、教程和研究成果
• 知识库和内部文档，保持可搜索性和可维护性

针对团队与组织

• 跨团队的一致性站点，借助模板与组件实现
• 低风险升级，提供清晰的版本控制与迁移指南
• 支持选项，满足快速响应需求

---

🧠 按您喜欢的方式编辑（先代码，必要时再用可视化）

• 代码优先：Markdown/YAML + Hugo 模板，完全掌控。
• 可视化编辑（Researcher Plan）：VS Code 中的 Ownable CMS，支持拖放组件、预览及更安全的配置编辑。
• AI 自动化（Researcher Plan）：减少格式化、YAML 修复、导入和维护所需的时间。

Ownable CMS：可视化编辑与代码优先控制的完美结合。

---

🛠️ 工具集

功能	重要性
Ownable CMS（VS Code）	编辑器内的可视化 CMS。无需离开 VS Code 即可拖放组件。
笔记本与 LaTeX	原生渲染 .ipynb 文件和包含大量数学公式的页面。
BibTeX / DOI 工作流	构建论文页面和参考文献列表，无需手动格式化。
多语言支持	可用 Markdown、Jupyter、RMarkdown 或 LaTeX 数学语法编写内容。

浏览模板 →

_{想快速体验吗？挑选一个模板，借助在线助手约 60 秒内即可上线。}
立即试用模板 →

---

🚀 开始使用

方案 1：在线助手（最快）

非常适合 创始人、实验室和初创公司。几分钟内即可启动网站。

👉 在浏览器中免费开始

方案 2：Ownable CMS（最适合数据/AI 团队）

将可视化网站构建器的强大功能直接融入 VS Code。

1. 安装 Marketplace 上的 Ownable CMS。
2. 打开 任意 HugoBlox 项目文件夹。
3. 点击 菜单中的 Ownable CMS 图标，即可开始可视化编辑。

方案 3：命令行界面（适合 DevOps/开发人员）

在本地搭建新项目。

  # 需要 Hugo Extended 和 Node.js
  npm install -g hugoblox
  hugoblox create site

需要指南和最佳实践？请参阅文档：docs.hugoblox.com

---

✅ 稳定性与升级（因为你的网站不应崩溃）

• 锁定版本以保持生产环境的稳定。
• 使用迁移说明和升级指南，自信地进行升级。
• 安全自定义：尽可能使用配置和区块，而非易出错的模板覆盖。
• 及早发现配置问题（Researcher 计划）：可视化编辑 + 验证功能可减少 YAML/front matter 错误。

请参阅文档获取升级指导：docs.hugoblox.com

⚡️ 解锁自动化与高级功能

HugoBlox 采用 Open Core 模式。Free Kit 已达到生产级标准，您始终拥有自己的数据和代码。

Free Kit 包含：

• Ownable CMS 核心：可视化站点配置、主题设置和内容编辑
• 适用于作品集、实验室、文档和着陆页的 模板与区块
• 基于 Hugo + Tailwind 的 Markdown/YAML 优先工作流
• 支持技术出版的 Notebook + LaTeX
• 通过文档、GitHub Issues 和 Discord 提供的 社区支持

🤖 Pro（自动化）

当您需要自动化并降低维护负担时，可升级至 Pro 版本，使用 Ownable CMS（需登录扩展程序）：

• 减少调试 YAML 的时间（Fix-it Bot + 更安全的配置编辑）
• 减少格式化引用的时间（Magic Import + 出版物自动化）
• 减少处理升级的时间（引导式维护流程）
• 提升开发速度（在 VS Code 中进行可视化编辑和预览）

功能	Free Kit（开源）	Pro（自动化）
站点所有权	✅ 100% 归您所有	✅ 100% 归您所有
可视化页面编辑器	❌	✅ 包含
AI 助手	⏳ 试用	✅ 包含
与 GitHub 自动同步	❌	✅ 包含
AI “Fix-It” Bot（自动修复 YAML）	❌	✅ 无限次
Magic Import（BibTeX/DOI -> 页面）	⏳ 试用	✅ 无限次
简历生成器（站点 -> PDF 简历）	❌	✅ 包含
私密 Discord	❌	✅
支持开放研究	💜	🏆 英雄地位

👉 查看完整功能矩阵  •  升级至 Pro

“Ownable CMS 为我的实验室网站节省了 40 多个小时。可视化编辑 + BibTeX 自动更新让我引用量提升了 3 倍。”
—— Sarah Yang 博士，人工智能研究员

🎨 HugoBlox Premium

获取完整套件。 即刻访问高级模板、区块以及社区支持，助您更快上线。

功能	开源	HugoBlox Premium
核心框架	✅	✅
高级模板（SaaS、实验室）	❌	✅ 包含
高级区块	❌	✅ 包含
移除署名？	❌	✅ 包含
私密 Discord	❌	✅
支持开放研究	💜	🏆 英雄地位

👉 获取 Premium 模板包

“我用内置文档在 10 分钟 内就上线了我的创业网站。高级区块系统太巧妙了，入职时间缩短了 60%。”
—— Alexandre Rodrigues，创始人

---

🏢 企业级准备（无企业臃gument）

• 随处部署：静态输出可与您现有的基础设施无缝对接。
• 降低运维面：无需修补运行时应用。
• 便于采购的选项：在需要时提供优先支持和商业特性。

---

🗣️ 社区与支持

我们是一个由 15 万多名研究人员、工程师和创作者组成的社区。

• 需要帮助？ 加入 Discord 服务器 或查阅 文档。
• 发现 Bug？ 请在 GitHub 仓库 中提交一个 [Issue]。
• 想贡献代码？ 请阅读我们的 贡献指南。

赞助商

帮助我们维持开源项目的可持续发展。

❤️ 在 GitHub 上赞助 | 🏢 成为合作伙伴

---

许可证

版权所有 © 2016 至今 Lore Labs。根据 MIT 许可证 发布。

_{HugoBlox™ 是 Lore Labs 的商标。}

HugoBlox (kit) 快速上手指南

HugoBlox 是一个基于 Hugo 和 Tailwind CSS 的开源发布栈，专为数据科学家、AI 工程师和研究团队设计。它支持直接从 Markdown 和 Jupyter Notebook (.ipynb) 构建高性能的静态网站，适用于个人主页、实验室网站、技术文档和知识库。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux。
• 核心依赖：
  • Hugo Extended：必须安装 "Extended" 版本以支持 Sass/SCSS 编译（Tailwind CSS 所需）。
  • Node.js：用于管理前端依赖包（建议 LTS 版本）。
  • Git：用于版本控制和模板克隆。
• 编辑器（可选但推荐）：Visual Studio Code。若需可视化编辑功能，可安装 Ownable CMS 插件。

提示：国内用户若遇到 npm 或 GitHub 连接缓慢，建议配置淘宝镜像源或使用加速代理。

安装步骤

您可以通过命令行工具快速初始化一个新项目。

1. 安装 HugoBlox CLI 工具 使用 npm 全局安装官方命令行工具：

   npm install -g hugoblox
   

2. 创建新项目 运行以下命令脚手架一个新的站点，按提示输入项目名称即可：

   hugoblox create site
   

3. 进入项目目录并启动服务

   cd <your-project-name>
   hugoblox server
   

   启动后，终端会显示本地访问地址（通常为 http://localhost:1313），在浏览器中打开即可查看效果。

基本使用

HugoBlox 采用“代码优先”的工作流，内容即代码。

1. 撰写内容

所有页面内容均位于 content/ 目录下。您可以直接使用 Markdown 编写文章，或直接放入 Jupyter Notebook 文件。

• 创建博客文章： 在 content/post/ 下新建 .md 文件，例如 my-first-post.md：

  ---
  title: "我的第一篇技术博客"
  date: 2024-05-20
  draft: false
  ---
  
  这是正文内容。支持 **Markdown** 语法和 $LaTeX$ 数学公式。
  

• 发布 Notebook： 直接将 .ipynb 文件复制到 content/post/ 或 content/tutorial/ 目录，HugoBlox 会自动将其渲染为包含代码块和执行结果的网页。

2. 可视化编辑（可选）

如果您安装了 VS Code 和 Ownable CMS 插件：

1. 在 VS Code 中打开项目文件夹。
2. 点击侧边栏的 Ownable CMS 图标。
3. 即可通过拖拽组件和可视化表单修改页面配置，无需手动编辑 YAML 头信息。

3. 构建与部署

当内容准备就绪，生成静态文件：

hugoblox build

生成的静态文件将输出到 public/ 目录。您可以将该目录部署到任何静态托管服务（如 GitHub Pages, Vercel, Netlify 或自有服务器）。