本仓库是 v8.dev, V8 官方网站 的中文翻译。
所有文章的原始版权归原文章作者所有,文中提到的 V8 的 logo 和商标归 Google 所有。
- 克隆本仓库
git clone https://github.com/justjavac/v8.js.cn.git
- 进入项目目录
cd v8.js.cn
- 使用期望的 Node.js 版本
nvm use
- 安装依赖包
npm install
运行 npm run
可以查看支持的脚本。一些常用的脚本:
npm run build
构建网站并输出到dist
.npm run watch
构建网站并输出到dist
,然后监听文件的更改npm start
启动一个本地 HTTP server
npm run
会触发某些 Unix 风格的命令。如果你正在 Windows 系统中使用类 linux 风格的环境,例如 git bash、msys2 或者 Cygwin,可以修改 npm 的配置文件以使用 linux 终端。如果你没有配置,那么默认使用的是 cmd.exe
。下面是一个修改配置的例子:
npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"
或者:
npm config set script-shell "C:\\msys64\\usr\\bin\\sh.exe"
当你翻译完一篇文章后,请在 markdown 文件的 meta 信息中添加译者信息。格式如下:
cn:
author: '迷渡 ([@justjavac](https://github.com/justjavac)),会写代码'
avatars:
- justjavac
tweet: 'xxxxxx'
以上内容都是可选的。
如果你想展示头像,那么你需要在 src/_img/avatars/
放 2 张 .jpg
格式的图片。尺寸为:
file-name.jpg
96 * 96file-name@2x.jpg
192 * 192
推荐:当你决定翻译某篇文章时,你应该 fork 本仓库,然后新建一个语义明确的分支,然后向本仓库马上发起一个 Pull Request,在标题中使用 WIP
开头,以标识这是一个 Work In Progress 工作。之所以马上提交一个 pr 也是为了防止不同的开发者翻译了同一个文件。
- 请注意中英文标点的使用
- 英文单词和中文直接保留一个空格
- 由于 markdown 格式对中文的解析不够友好,因此需要手动在标题后面标注上锚点链接(参考:src/blog/v8-release-71.md)