Consola do Cliente (CLI)

Crowdin CLI is a command line tool that allows you to manage and synchronize localization resources with your Crowdin project:

  • Automatizar o processo de atualização dos teus ficheiros de origem no teu projeto do Crowdin
  • Transfere as traduções do Crowdin e automaticamente, guarda-as nos locais corretos
  • Enviar todas as traduções existentes para o Crowdin em minutos
  • Integrate Crowdin with GIT, SVN, Mercurial, and more.
Note: If you are using the old version of Crowdin CLI (2.0.31 or less) read the article CLI v2 for full details.

Este é uma multiplataforma e é executado num terminal em sistemas operacionais baseados em Linux e MacOS ou nas Linhas de Comando (Command Prompt) no Windows. It’s also open-source and it’s source code available at GitHub.

Novidades

  • Multithreading for source and translation files upload
  • UX improvements: process indicators, loading states, emojis
  • Interactive generation of a configuration file
  • Bash/Zsh command completion
  • Improved help screen for commands
  • Improved configuration file validation
  • More import options for upload command
  • More export options for download command
  • Based on the new RESTful Crowdin API v2
  • Bug fixes and other improvements

Requisitos

Verifica que tens Java 8 ou mais recente, instalado. Digita o comando java -version no terminal (Linha de Comando (Command Prompt) no Windows) para verificar a versão do Java. Por exemplo, java version “1.8.0_212” significa que tens Java 8 Update 212 instalado.

Se não tiveres o Java instalado, transfere-o do site do Oracle.

Instalação

Homebrew para macOS

To install the Crowdin CLI with homebrew (the package manager for macOS):

$ brew tap crowdin/crowdin
$ brew install crowdin@3

Windows

Download and run installer for Windows.

Debian

Assinámos todos os pacotes com a Chave de Assinatura do Crowdin.

Transfere e instala a chave de assinatura pública:

wget -qO - https://artifacts.crowdin.com/repo/GPG-KEY-crowdin | sudo apt-key add -

Using the following command, create the crowdin.list file in the /etc/apt/sources.list.d directory:

echo "deb https://artifacts.crowdin.com/repo/deb/ /" > /etc/apt/sources.list.d/crowdin.list

And your repository is ready for use. Podes instalar o pacote do Debian do Crowdin CLI com:

sudo apt-get update && sudo apt-get install crowdin3

Para instalar o Crowdin CLI, manualmente:

$ wget https://artifacts.crowdin.com/repo/deb/crowdin3.deb -O crowdin.deb $ sudo dpkg -i crowdin.deb

RPM

Assinámos todos os pacotes com a Chave de Assinatura do Crowdin.

Transfere e instala a chave de assinatura pública:

rpm --import https://artifacts.crowdin.com/repo/GPG-KEY-crowdin

Instalção do repositório RPM

Create a file called crowdin.repo in the /etc/yum.repos.d directory containing:

[crowdin] name=Repositório do Crowdin baseurl=https://artifacts.crowdin.com/repo/rpm gpgcheck=1 gpgkey=https://artifacts.crowdin.com/repo/GPG-KEY-crowdin enabled=1

And your repository is ready for use. You can now install Crowdin CLI with one of the following commands:

sudo yum install crowdin3 sudo dnf install crowdin3

Para instalar o Crowdin CLI, manualmente:

$ wget https://artifacts.crowdin.com/repo/rpm/crowdin3.rpm -O crowdin.rpm $ sudo rpm -U crowdin3.rpm

Versão Autónoma (Standalone)

O Crowdin CLI pode ser instalado como uma aplicação autónoma de Java.

Instalação no Linux e macOS

  1. Transfere o crowdin-cli.zip ao usar o botão acima
  2. Descompacta-o
  3. Run ./install-crowdin-cli.sh in the terminal with sudo rights in order to add crowdin command to your terminal

Instalação no Windows

  1. Transfere o crowdin-cli.zip ao usar o botão acima
  2. Extrai o conteúdo para o local onde queres que o Crowdin CLI seja armazenado
  3. Abre as Linhas de Comando como Administrador (botão direito do mouse)
    1. Clica Iniciar
    2. In the Start Search box, type cmd, and then press Ctrl+Shift+Enter
    3. Se a caixa de diálogo Controlo de Conta de Utilizador (User Account Control), aparecer, confirma que a ação exibida é a desejada e, em seguida, clica em Continuar
  4. Executa o script setup-crowdin.bat para adicionar o comando crowdin para a Linha de Comando
  5. Reinicia a tua Linha de Comando

Executar a Aplicação

Usa o seguinte método para executar a aplicação:

$ crowdin

Método alternativo:

$ java -jar crowdin-cli.jar

CLI

Configuração

To use Crowdin CLI you need to have a configuration file. We recommend to name it crowdin.yaml. You can create it running the command:

$ crowdin init

When calling Crowdin CLI in terminal you should be in your project root directory. Otherwise, you will have to specify a configuration file path using the --config option:

$ crowdin upload sources --config /path/to/your/config/file

Executa crowdin help para obter mais detalhes sobre outros comandos.

Exemplo de ficheiro de configuração:

"project_id": "projectId"                     #open project settings and go to API section 
"api_token": "personal-access-token"          #open profile settings and go to API & SSO > New Token > create Token
"base_path": "/project-base-path"
"base_url": "https://crowdin.com"
"preserve_hierarchy": true

"files": [
  {
      "source": "/en/**/*.json",                                          #source files filter
      "translation": "/%two_letters_code%/**/%original_file_name%"        #where translations are stored
  }
]

For more information on how to configure Crowdin CLI, read the Configuration File article.

Utilização

Assim que o ficheiro de configuração tiver sido criado, estás pronto para começar a usar o Crowdin CLI para gerir os teus recursos de localização e automatizar a sincronização de ficheiros.

Comandos Gerais

Para exibir informações de ajuda:

$ crowdin help

Para gerar um esqueleto de ficheiro de configuração:

$ crowdin init

Para verificar o ficheiro de configuração por erros gerais:

$ crowdin lint

Para exibir uma lista de ficheiros enviados ao Crowdin:

$ crowdin list project

Enviar Recursos

Para enviar ficheiros de origem para o Crowdin:

$ crowdin upload sources

Para enviar um único ficheiro sem configuração:

$ crowdin upload sources -s path/to/your/file -t file/export/pattern -T personal-token -i project-id --base-url https://crowdin.com

Use placeholders to put appropriate variables.

Para exibir uma lista de ficheiros que serão enviados ao Crowdin:

$ crowdin upload sources --dryrun

Para enviar traduções existentes para o Crowdin (as traduções serão sincronizadas):

$ crowdin upload translations

Para mostrar informações detalhadas sobre o comando upload:

$ crowdin upload --help

Transferir Traduções

Para transferir as traduções mais recentes do Crowdin:

$ crowdin download

Para transferir as traduções mais recentes para o idioma especificado (códigos de idioma):

$ crowdin download -l {language_code}

Para exibir uma lista das traduções mais recentes do Crowdin:

$ crowdin download --dryrun

Para mostrar informações detalhadas sobre o comando download:

$ crowdin download --help

Gestão de Versões

There is no need to run a specific command to create version branches if synchronization tool is used. The version branch will be created automatically during the files upload.

Para enviar ficheiros de origem para a ramificação de versão especificada:

$ crowdin upload sources -b {branch_name}

Para enviar traduções para a ramificação de versão especificada:

$ crowdin upload translations -b {branch_name}

Para transferir as traduções da ramificação de versão especificada:

$ crowdin download -b {branch_name}

Source Strings Management

There is a possibility to manage (add, edit, delete) source strings for the following file types: CSV, RESX, JSON, Android XML, iOS strings, PROPERTIES.

To show a list of source strings in the current project (use the --verbose option to see more information):

crowdin string list

To create a new source string (use -h option to see all possible command options):

crowdin string add

To delete source string:

crowdin string delete

To edit existing source string:

crowdin string edit

Translation and Proofreading Progress

You can check the translation and proofreading progress for a project using the following commands.

To show both translation and proofreading progress for a project:

crowdin status

To show translation progress for a project:

crowdin status translation

To show proofreading progress for a project:

crowdin status proofreading

Also, you can use the --verbose option to see more information.

Ver Também

Este artigo foi útil?