首页
/ Babelish 使用与技术文档

Babelish 使用与技术文档

2024-12-26 11:34:22作者:翟萌耘Ralph

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

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

登录后查看全文
热门项目推荐