linguallo-cli v1.0.13

Linguallo CLI

About

Linguallo is free Software as a Service Translation Management System (TMS). You can manage, translate and collaborate on all of your translations in one place. Linguallo's easy-to-use spreadsheets and powerful publisher help you remove Localization pains such as slow and lengthly emails, held back releases, broken files and many more.

Continuous Translation

Integrate localization process seamlessly into your development process using Linguallo CLI.

Installation

Install Nodejs and NPM

Download installer https://nodejs.org/en/download/

Or

Install with package manager https://nodejs.org/en/download/package-manager/

Install Linguallo CLI Globally

npm install -g linguallo-cli

Obtaining access token

To be able to obtain access token, please Login to Linguallo, go to your profile, on the bottom of the page in tab "Access tokens" select "New" and generate.

Please note, after you generate your access token, make sure to copy it. You won’t be able to see it again!

Usage

translate --help

Prerequisite

• Valid Linguallo Account and obtained Access Token
• Linguallo's Spreadsheet

Commands

• push - pushes new keys from local file to spreadsheet
• pull - pulls translation files from Linguallo and writes it locally
• config - sets default configuration for accessToken and spreadsheet
• open - opens spreadsheet in https://linguallo.com
• clear - clears stored configuration such as accessToken and spreadsheet

Push

You can use the linguallo push command to add new keys to spreadsheet from file:

translate push

And follow instructions.

JSON file example:

{
  "common.button.save": "Save",
  "home.message.hello": "Hello {{name}}!"
}

Note1 If you are using nested JSON file, CLI will automatically flatten JSON and add keys. Publisher has option to build nested JSON files.

Note2 You can not directly add new keys to spreadsheet's sheet, it will create new Pull Request for spreadsheet.

Example

translate push --input="./assets/i18n/messages/en.json"


Request created:
Author: <name>
You can view request by visiting link: https://linguallo.com/spreadsheet/<spreadsheet_UUID>?requestId=ZYX321&sheetId=123XYZ

Pull

You can use the linguallo pull command to get latest translation files from spreadsheet:

translate pull

And follow instructions.

Options

fileType - required - file type you wish to build, options are JSON (Default), JSON_NESTED, XML, STRINGS, PO, MO

languages - optional - comma separated language codes for example --languages="en,fr", if not provided Linguallo will build all languages

output - optional - path to where files will be saved, for example --output="./assets/i18n/messages". If not provided current directory from where command has been called will be used.

Example

translate pull --fileType=JSON --output="./assets/i18n/messages"


Getting files...
Getting files success.

Writing files:
/Users/<user>/dev/<project>/assets/i18n/messages/de.json
/Users/<user>/dev/<project>/assets/i18n/messages/en.json
/Users/<user>/dev/<project>/assets/i18n/messages/fr-CA.json
/Users/<user>/dev/<project>/assets/i18n/messages/fr.json

Files written.

Config

You can use the linguallo config command to set new or update Linguallo CLI default configuration:

translate config

And follow instructions

Open

You can use the linguallo open command to set new or update Linguallo CLI default configuration:

translate open --spreadsheet="<spreadsheet_UUID>"

or just use

translate open

And follow instructions

Clear

You can use the translate clear command to clear cache and remove Linguallo CLI default configuration:

translate clear

If you have any questions feel free to contact us at link.