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

前言

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

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

之前在给 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 全域进行了屏蔽,清空了所有收录,直到前段时间经过多次申诉才解除限制,恢复了收录和权重;搜狗以及其他搜索引擎没有针对性的操作。

未来计划

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

相关推荐
一城烟雨_2 小时前
vue3 实现将html内容导出为图片、pdf和word
前端·javascript·vue.js·pdf
树懒的梦想2 小时前
调整vscode的插件安装位置
前端·cursor
PPIO派欧云3 小时前
PPIO X OWL:一键开启任务自动化的高效革命
运维·人工智能·自动化·github·api·教程·ppio派欧云
低代码布道师4 小时前
第二部分:网页的妆容 —— CSS(下)
前端·css
涵信4 小时前
第九节:性能优化高频题-首屏加载优化策略
前端·vue.js·性能优化
前端小巷子4 小时前
CSS单位完全指南
前端·css
SunTecTec5 小时前
Flink Docker Application Mode 命令解析 - 修改命令以启用 Web UI
大数据·前端·docker·flink
吾日三省吾码5 小时前
GitHub Copilot (Gen-AI) 很有用,但不是很好
人工智能·github·copilot
软件技术NINI5 小时前
html css js网页制作成品——HTML+CSS甜品店网页设计(4页)附源码
javascript·css·html