Phabricator 简体中文翻译项目技术文档

Phabricator 简体中文翻译项目技术文档

1. 安装指南

1.1 环境准备

• Node.js: 确保你的系统上已安装 Node.js。你可以通过运行 node -v 来检查是否已安装。如果没有安装，请访问 Node.js 官网 下载并安装。
• Phabricator: 确保你已经安装了 Phabricator 项目。如果没有，请参考 Phabricator 官方安装指南 进行安装。

1.2 下载项目

从 GitHub 仓库下载 Phabricator 简体中文翻译项目：

$ git clone https://github.com/your-repo/phabricator-translation.git
$ cd phabricator-translation

1.3 安装依赖

在项目目录下运行以下命令安装所需的依赖包：

$ npm install

2. 项目的使用说明

2.1 启动翻译工具

在项目目录下运行以下命令启动翻译工具：

$ npm start

启动后，打开浏览器访问 http://localhost:3000 即可使用翻译工具。

2.2 编译翻译文件和 README 文件

在项目目录下运行以下命令编译翻译文件和 README 文件：

$ npm run compile

编译完成后，你将得到以下文件：

1. Phabricator 简体中文翻译文件：dist/<version>/PhabricatorSimplifiedChineseTranslation.php
2. 重新排序后的翻译数据文件：data/translations.json
3. 包含最新摘要信息的 README 文件：README.md
4. 翻译规则列表文件：Rules.md
5. 术语表文件：Terminology.md

2.3 本地化 Phabricator

将编译生成的 dist/<version>/PhabricatorSimplifiedChineseTranslation.php 文件拷贝到 Phabricator 项目的 phabricator/src/extensions 目录中。然后调整个人设置，进入 Personal Settings 的 Account，在 Translation 选项中选择 Chinese (Simplified)，保存后界面即切换为简体中文。

3. 项目API使用文档

3.1 提取最新 Phabricator 国际化字典资源

当 Phabricator 项目更新时，需要提取新的国际化字典资源。如果 Phabricator 项目和本项目处于同级目录，可以直接运行以下命令：

$ npm run update

手动操作步骤如下：

1. 拉取最新的 Phabricator 和 libphutil 源码。
2. 在 Phabricator 项目路径下执行：

   $ ./bin/i18n extract
   $ ./bin/i18n extract ../libphutil
   

3. 拷贝生成的 i18n_files.json 文件到本项目的 data/phabricator 和 data/libphutil 目录。

4. 项目安装方式

4.1 通过 Git 安装

$ git clone https://github.com/your-repo/phabricator-translation.git
$ cd phabricator-translation
$ npm install

4.2 通过 npm 安装

$ npm install phabricator-translation

通过以上步骤，你可以顺利安装并使用 Phabricator 简体中文翻译项目。