Vocs 1.0.0 发布:现代化文档工具的重大升级
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-indexCLI 命令,允许单独构建搜索索引,提高了大型文档站的构建效率。
样式与主题
-
主题系统增强
支持通过theme.colorScheme配置颜色方案,并增加了对代码块和内联代码字体家族的自定义支持。 -
横幅支持
新增了banner配置属性,允许在文档顶部显示自定义横幅,适合用于公告或重要提示。
Vocs 1.0.0 版本的发布标志着该项目已经成熟稳定,为技术文档的创建和维护提供了更加完善和强大的工具集。无论是个人项目还是企业级文档,Vocs 都能提供出色的支持和体验。
GLM-5智谱 AI 正式发布 GLM-5,旨在应对复杂系统工程和长时域智能体任务。Jinja00
GLM-5-w4a8GLM-5-w4a8基于混合专家架构,专为复杂系统工程与长周期智能体任务设计。支持单/多节点部署,适配Atlas 800T A3,采用w4a8量化技术,结合vLLM推理优化,高效平衡性能与精度,助力智能应用开发Jinja00
jiuwenclawJiuwenClaw 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。Python0174- QQwen3.5-397B-A17BQwen3.5 实现了重大飞跃,整合了多模态学习、架构效率、强化学习规模以及全球可访问性等方面的突破性进展,旨在为开发者和企业赋予前所未有的能力与效率。Jinja00
AtomGit城市坐标计划AtomGit 城市坐标计划开启!让开源有坐标,让城市有星火。致力于与城市合伙人共同构建并长期运营一个健康、活跃的本地开发者生态。01
snackjson新一代高性能 Jsonpath 框架。同时兼容 `jayway.jsonpath` 和 IETF JSONPath (RFC 9535) 标准规范(支持开放式定制)。Java00