Babelish 使用与技术文档

1. 安装指南

Babelish 是一个命令行工具，它可以转换不同格式的本地化字符串文件。要安装 Babelish，您可以使用以下方法：

• 使用 Ruby 的 gem 命令安装：

gem install babelish

Babelish 需要 Ruby 2.1.0 或更高版本。

• 下载最新版本的发布文件：

下载最新发布版本

• 使用 Docker：

docker run netbe/babelish babelish help

2. 项目使用说明

Babelish 可以将 CSV 文件转换为以下格式：

• .strings (iOS)
• .xml (Android)
• .json
• .php

此外，它还可以从 GoogleDrive 获取 CSV 文件。

以下是 Babelish 支持的命令：

babelish android2csv    # 将 .xml 文件转换为 CSV 文件
babelish csv2android    # 将 CSV 文件转换为 .xml
babelish csv2json       # 将 CSV 文件转换为 .json
babelish csv2php        # 将 CSV 文件转换为 .php
babelish csv2strings    # 将 CSV 文件转换为 .strings
babelish csv_download   # 从 Google Spreadsheet 下载包含翻译的 CSV 文件
babelish help [COMMAND] # 描述可用的命令或特定命令
babelish init           # 从模板创建配置文件
babelish json2csv       # 将 .json 文件转换为 CSV 文件
babelish open FILE      # 在默认编辑器中打开本地 CSV 文件或在默认浏览器中打开包含翻译的 Google Spreadsheet
babelish php2csv        # 将 .php 文件转换为 CSV 文件
babelish strings2csv    # 将 .strings 文件转换为 CSV 文件
babelish version        # 显示当前版本

您可以使用配置文件来保存所有命令行参数。在您运行命令的仓库中放置一个 .babelish 文件（YAML 格式）。如果需要重置 Google Drive 的 token，您需要删除 .babelish.token 文件。有关可能的值，请查看文档文件夹中的 .babelish.sample 文件。

注意：对于之前的 CSV-to-iOS-Localizable.strings 转换器，请将 .csvconverter 文件重命名为 .babelish。

Docker 注意：为了导出转换的输出，您需要将结果从容器中输出。例如：

docker run netbe/babelish babelish csv2json >> some_file.json

3. 项目 API 使用文档

Babelish 是一个命令行工具，不直接提供 API 调用接口。但是，它的所有功能都可以通过命令行使用。用户可以根据需要调用相应的命令并传递参数。

4. 项目安装方式

项目的安装方式已在“安装指南”一节中详细说明。主要有以下几种方式：

• 使用 Ruby gem 命令
• 下载最新版本的发布文件
• 使用 Docker

根据您的需求和环境选择合适的安装方式即可。