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

前言

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

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

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

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

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

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

项目介绍

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

根据 BCP 47(Best Current Practice 47)标准规定,zh_CN 表示简体中文的意思,英文单词 documentation 可以翻译成「文档」,取其缩写 doczh_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 全域进行了屏蔽,清空了所有收录,直到前段时间经过多次申诉才解除限制,恢复了收录和权重;搜狗以及其他搜索引擎没有针对性的操作。

未来计划

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

相关推荐
爱吃肉的小鹿1 分钟前
深入剖析 Vue.js 的 nextTick 实现原理
前端
mrsk1 分钟前
看我如何用AI做一款⌈黄金矿工⌋小游戏
前端·aigc·cursor
用户5150882440531 分钟前
TypeScript00:基础数据类型
前端
木西13 分钟前
Nest.js实战:构建聊天室的群聊与私聊模块
前端·后端·nestjs
数字人直播15 分钟前
跨境电商如何选择高转化率的AI数字人直播平台?
前端·后端
天生我材必有用_吴用16 分钟前
深入理解JavaScript设计模式之代理模式
前端
华洛37 分钟前
《从0到1打造企业级AI售前机器人——实战指南五:处理用户意图的细节实现!》
javascript·vue.js·node.js
掘金安东尼1 小时前
7个【宝藏工具】从智能画图到 SSL 自动化,一应俱全
前端·面试·github
HelloGitHub1 小时前
一周 Star 破万的开源项目「GitHub 热点速览」
开源·github