Vocs 1.0.0 发布：现代化文档工具的重大升级

2025-07-03 13:35:30作者：魏侃纯Zoe

Minimal Docs for Agents & Humans.

项目地址：https://gitcode.com/gh_mirrors/vo/vocs

Vocs 是一个现代化的文档工具，它基于 React 和 MDX 构建，提供了优雅的文档编写体验和强大的功能特性。最新发布的 1.0.0 版本标志着该项目已经趋于稳定，并带来了一系列重要的改进和新功能。

核心升级内容

React 19 支持
1.0.0 版本将 React 和 React DOM 的依赖要求升级到了 19 版本，这意味着开发者可以享受到 React 最新版本带来的性能优化和新特性。
Tailwind CSS v4 集成
新版本增加了对 Tailwind CSS v4 的支持，提供了更现代化的样式处理方案。开发者现在可以更方便地自定义文档样式。
元数据管理改进
移除了 vocs/head 入口点，转而支持使用 React 原生的 <head> 组件来管理文档的元数据，这使元数据处理更加直观和符合 React 的开发模式。

代码高亮与交互增强

Shiki 高亮引擎升级
1.0.0 版本从 rehype-pretty-code 迁移到了 rehype-shiki，并升级到了 Shiki 1.0.0-beta，带来了更稳定和高效的代码高亮体验。
Twoslash 集成改进
对 TypeScript 代码示例的交互支持进行了优化，现在默认会在语法错误时抛出异常，同时支持 // @noErrors 标记来禁用这一行为。
代码片段功能增强
新增了"虚拟文件"代码片段支持，并引入了区域标记功能，使代码示例的组织更加灵活。

用户体验优化

搜索功能改进
修复了索引页搜索问题，并增加了对包含相对导入页面的搜索支持，使文档搜索更加全面准确。
导航体验提升
优化了侧边栏的交互逻辑，现在可点击的侧边栏项在被点击时会自动展开，提高了导航的便利性。
移动端适配
针对小屏幕设备优化了顶部导航栏的文本换行，确保在各种设备上都能获得良好的阅读体验。

构建与部署

Vercel 构建输出兼容
新版本遵循 Vercel 的构建输出 API，实现了零配置的 Vercel 部署支持。
子路径支持
增加了 basePath 配置属性，使文档能够部署在子路径下（如 GitHub Pages 等场景）。
独立搜索索引构建
新增了 search-index CLI 命令，允许单独构建搜索索引，提高了大型文档站的构建效率。

样式与主题

主题系统增强
支持通过 theme.colorScheme 配置颜色方案，并增加了对代码块和内联代码字体家族的自定义支持。
横幅支持
新增了 banner 配置属性，允许在文档顶部显示自定义横幅，适合用于公告或重要提示。

Vocs 1.0.0 版本的发布标志着该项目已经成熟稳定，为技术文档的创建和维护提供了更加完善和强大的工具集。无论是个人项目还是企业级文档，Vocs 都能提供出色的支持和体验。

Minimal Docs for Agents & Humans.

项目地址：https://gitcode.com/gh_mirrors/vo/vocs

登录后查看全文

项目优选

收起

ops-transformer

本项目是CANN提供的transformer类大模型算子库，实现网络在NPU上加速计算。

本项目是CANN提供的神经网络类计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

flutter_flutter

本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本，由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用，3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。

CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。

openJiuwen agent-studio提供零码、低码可视化开发和工作流编排，模型、知识库、插件等各资源管理能力

华为昇腾面向大规模分布式训练的多模态大模型套件，支撑多模态生成、多模态理解。