Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Chinese version of vitejs documentation. #1350

Closed
wants to merge 31 commits into from
Closed

docs: Chinese version of vitejs documentation. #1350

wants to merge 31 commits into from

Conversation

ShenQingchuan
Copy link
Member

@ShenQingchuan ShenQingchuan commented Jan 4, 2021

中文翻译版本起稿:

  1. 该版翻译中针对 bundle 根据场景、语境采用了两种译法:“构建” 和 ”打包“,对 build 统一采用了 “构建”。
  2. 中文 /zh/ 目录下的所有对本站文档的链接均指向了 /zh/xx 而不会跳到 / 引发错乱。
  3. 其他更多问题请 @yyx990803 过目审阅。

翻译工作较为仓促,虽然极力求格式规整、意思信达雅,但我本人水平有限,还请协作者中的中文使用者多多建议、修改。🙏

此外在翻译过程中提了一个 vitepress 的 issue,内含一些亟待解决的 bug 👉详情见此

对其中的 HomeHero 文字修改语言环境无变化的问题:详见 此 PR

望早日 resolve !

@yyx990803
Copy link
Member

感觉有些地方还是略微有些生硬,@antfu@Jinjiang 可以一起帮忙审阅一下。

docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
默认情况下,代码中所有静态可分析的 `import` 请求都被静态地视为转换管道的一部分。然而,如果你使用完整的动态导入来导入非 js 文件类型,例如:

```js
// dynamicPath 是一个非 JS 文件类型,例如 "./foo.gql"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// dynamicPath 是一个非 JS 文件类型,例如 "./foo.gql"
// dynamicPath 不是一个 js 类型,例如 "./foo.gql"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里建议还是保留 “文件类型” 这个意思吧

docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
docs/zh/config/index.md Outdated Show resolved Hide resolved
@ShenQingchuan
Copy link
Member Author

ShenQingchuan commented Jan 5, 2021

关于文档中链接🔗 格式的讨论:

@yyx990803 @Jinjiang @antfu

关于文档中的链接,针对以下两种 Markdown 书写:

<!-- 链接前后带空格  -->
Vite 支持了一套 [通用插件 API](./api-plugin) 扩展了 Rollup 的插件接口

<!-- 链接前后不带空格 -->
Vite 支持了一套[通用插件 API](./api-plugin)扩展了 Rollup 的插件接口

Vitepress 和 Vuepress 中对以上两种写法的渲染视觉效果为:

链接前后带空格

image

链接前后不带空格

image

不带空格的形式 与 带空格相比,没有那么突出。

同样这类情况还包括 Markdown 中的斜体字:

这是一个_斜体_尝试 <!-- Vitepress 和 Vuepress 中无效!  -->

这是一个*斜体*尝试 <!-- 前后无空格 -->

这是一个 _斜体_ 尝试 <!-- 前后有空格 -->

下面是效果,不带空格的情况看上去中文字体的笔画之间会接在一起,变得很拥挤,观感较差。

image

结论与建议

是否在此之后可以采用 前后带空格的方式 书写 链接、斜体 等容易造成文字拥挤的特殊标签?

@zhangyuang
Copy link
Contributor

-。-尴尬了,写到一半才发现已经有这个pr了

@ShenQingchuan
Copy link
Member Author

-。-尴尬了,写到一半才发现已经有这个pr了

😂没事啦,一起翻译吧

@zhangyuang
Copy link
Contributor

-。-尴尬了,写到一半才发现已经有这个pr了

😂没事啦,一起翻译吧

可以加个微信 yuuangC
我之前写了vite1.0的文档翻译和源码分析
https://github.com/zhangyuang/vite-design
现在准备跟进2.0的源码分析,有兴趣可以一起编写

@ShenQingchuan
Copy link
Member Author

@yyx990803 可以为本 PR 指定一位 Reviewer 吗?

@yyx990803
Copy link
Member

@ShenQingchuan 链接和斜体加空格 +1

@ShenQingchuan
Copy link
Member Author

ShenQingchuan commented Jan 8, 2021

随 Commits 更新 —— Tag 北京时间 2021/1/8 下午2:33:19

@yyx990803 yyx990803 mentioned this pull request Jan 8, 2021
@ShenQingchuan
Copy link
Member Author

ShenQingchuan commented Jan 10, 2021

随 Commits 更新 —— Tag 北京时间 2021/1/10 下午1:59:37

@ShenQingchuan
Copy link
Member Author

ShenQingchuan commented Jan 11, 2021

@CHOYSEN 这两天湖南长沙旅游ing...😓 预计15号返回继续维护中文文档,可否麻烦兄台帮我review 润色下其中其他章节?不胜感激!

@CHOYSEN
Copy link
Contributor

CHOYSEN commented Jan 12, 2021

@ShenQingchuan 嗯有空我看看

docs/zh/guide/features.md Outdated Show resolved Hide resolved
docs/zh/guide/api-hmr.md Outdated Show resolved Hide resolved
docs/zh/guide/api-hmr.md Outdated Show resolved Hide resolved
@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 2021/1/21下午11:04:34

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 2021/1/25上午12:22:05

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 "2021/1/26上午1:07:15"

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 "2021/1/27下午2:03:38"

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 "2021/1/31上午3:49:57"

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 "2021/2/3上午2:34:42"

@ShenQingchuan
Copy link
Member Author

随 Commits 更新 —— Tag 北京时间 "2021/2/4上午1:55:04"

  • 添加了 zh/guide/ssr.md
  • 添加了 zh/guide/assets.md

@ShenQingchuan
Copy link
Member Author

@yyx990803

想要申请 https://cn.vitejs.dev 来存放单独的 zh 文档

目前我可以根据 vitejs/vite 的 docs 文件夹的更改 Hisotry 来获取更新,
虽然工作流暂时比较简陋,但基本可行。

最快每三天内可以做到一次更新。
想要申请加入 Vite 的 docs Contributers。

@yyx990803
Copy link
Member

我邀请你到 org 了,然后开了这个仓库:https://github.com/vitejs/docs-cn
你可以直接推到这个仓库,然后我来部署域名。

@ShenQingchuan
Copy link
Member Author

我邀请你到 org 了,然后开了这个仓库:https://github.com/vitejs/docs-cn
你可以直接推到这个仓库,然后我来部署域名。

OK👌🏻,感谢尤大的支持。
我将整理文档为一个 VItepress 项目,于北京时间明晚凌晨推送。
相关的 CI/CD actions 交由您来操作。

@ShenQingchuan
Copy link
Member Author

中文文档仓库已建立,此pr自动废弃。

@Ivocin
Copy link

Ivocin commented Feb 18, 2021

的形式 与 带空格相比,没有那么突出。

同样这类情况还包括 Markdown 中的斜体字:

中文文档斜体可以使用加粗替代,可以参考译文排版规则指北

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants