成立一周年!开源的本土化中文文档知识库

前言

众所周知,在编程开发领域中,英语常常作为国际通用语言,许多开源项目都只提供英文开发者文档,导致英语基础不扎实的开发者在阅读开发文档时会遇到语言障碍。

可能有人会提出疑问,现在的浏览器翻译插件不是已经很成熟了吗?不可否认,浏览器自带的翻译功能确实可以解决大部分的文档阅读问题,但在一些格式较为复杂的场景,浏览器翻译会出现不可控的格式错误,严重的时候甚至会影响文档语义。

之前在给 Vue.js 中文文档贡献翻译时就在想,大多数开源项目的文档也是开源的,可不可以 Fork 一份到我的仓库来进行翻译,然后部署来提供中文文档的访问。

在去年的四月份,当时在辽宁出差,客户现场停产的时候,连续好几天在酒店里带薪摸鱼,正好有时间开始做这件事情,于是便创建第一个仓库,有了第一个 Commit 提交。

最初只是想着翻译文档来帮助自己学习使用,所以文档也只是部署到了自己的域名上面,直到我开始翻译第二个项目的时候,想着能不能给所有流行的开源项目提供一个可以持续发展的中文文档生态,利用庞大的开源社区来共同维护本土化的中文文档翻译。

于是,便有了今天要介绍的开源项目------简中文档!

项目介绍

2024 年 4 月 29 日,从辽宁出差回来的第二天,我注册了用户名为 zhcndoc 的 Github 组织,同时也注册了 zhcndoc.com 域名作为项目的主要入口,因此将这一天当作项目的成立时间。

根据 BCP 47(Best Current Practice 47)标准规定,zh_CN 表示简体中文的意思,英文单词 documentation 可以翻译成「文档」,取其缩写 doc 与 zh_CN 结合,拼起来可以变成 zhcndoc,表示「简体中文文档」的意思,简称为「简中文档」。

项目官网:www.zhcndoc.com

项目仓库:github.com/zhcndoc

截止目前,简中文档总共维护着 25 个开源项目的中文文档,其中 7 个是作为官方文档的镜像,Nuxt 中文文档是最多开发者访问的,下面是一些推荐的中文文档:

项目 链接
Nuxt nuxt.zhcndoc.com
Tailwind CSS tailwindcss.zhcndoc.com
VueUse vueuse.zhcndoc.com
UnoCSS unocss.zhcndoc.com
Deno deno.zhcndoc.com
Nuxt I18n nuxt-i18n.zhcndoc.com

详情可以查看简中文档官网的项目探索。

一周年

在过去的一年里,我没有公开宣传过简中文档项目,仅仅只是在 issues 中稍微提起,以及在微信群里交流时推荐给群友查阅,但依靠搜索引擎的自然流量,也给简中文档带来了一些知名度。

2024 年 5 月集成了 Umami 数据统计之后,截止目前总共收获了 45.4w 浏览量和 7.5w 访问次数,累计访客大约 4 万人,其中 83% 的流量来自于百度,12% 的流量来自于 Bing。

在网站 SEO 方面,根据站长工具查询,截止目前百度权重 2,搜狗和必应权重 1。

百度作为中文互联网最大的搜索引擎,自从收录之后一直保持稳定的关键词排名和收录;Google 对新网站的收录不太友好,目前没有太多的曝光;Bing 在去年 11 月对 zhcndoc.com 全域进行了屏蔽,清空了所有收录,直到前段时间经过多次申诉才解除限制,恢复了收录和权重;搜狗以及其他搜索引擎没有针对性的操作。

未来计划

尽管简中文档已经诞生一周年,但我认为它仍是一个处于建设初期的项目,还有很多翻译中的规范没有制定,以及贡献翻译的流程没有完善。本着集思广益的理念,欢迎大家加入简中文档,一起出谋划策,构建一个更好的本土化中文文档知识库。

相关推荐
Autumn_ing7 小时前
Design.md生成UI怎么验收?举例运营后台的颜色、状态和数据核对
前端·ui·ai·设计系统·paico·ai生成ui·design.md
远离UE47 小时前
UE5 Substrate Thin Film 源码拆析
开发语言·javascript·ue5
keyipatience8 小时前
JavaScript学习(1)书写位置,变量、数据类型、运算符
开发语言·前端·javascript·css·学习
朱涛的自习室8 小时前
我给 Gemini 4 和 DeepSeek 搞了套「末位淘汰」,AI 干活会更猛吗?(Day 3)
android·前端·后端
java1234_小锋10 小时前
【技术专题】HTML5 网页技术 - HTML5简介 & HTML5 文档结构
前端·html·html5
u13013010 小时前
GitHub 热榜项目:日榜(2026-10-15)
人工智能·github
鶴哥只手遮天11 小时前
Vue 3 核心源码深度剖析系列(v3.5.44)-第 1 章 项目全景:monorepo 架构与工程化体系
前端·vue.js·开源
流星。。方11 小时前
小团队官网SEO落地:前端语义化与静态生成的工程实践
前端·状态模式
用户5304297657911 小时前
盘点危化品搬运诊断的6类工具与自处理边界判断
前端
张不净11 小时前
【Git 基础命令】从混乱到稳定的日常工作流
github