mirror of
https://github.com/tiennm99/HugoBlox-kit.git
synced 2026-10-11 12:11:45 +00:00
257 lines
12 KiB
Markdown
257 lines
12 KiB
Markdown
[**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>
|
||
•
|
||
<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>
|
||
•
|
||
<a href="#面向数据科学家与-ai-工程师">数据科学家与 AI 工程师</a>
|
||
•
|
||
<a href="#面向团队与组织">团队与组织</a>
|
||
•
|
||
<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) • [**升级到 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>
|