Installation
crowdin-cli peut être installé via RubyGems ou comme une application Java autonome.
Installation via RubyGems
Afin d'exécuter crowdin-cli vous devrez Ruby et RubyGems installés sur votre ordinateur. Sous Mac et Linux, Ruby est probablement déjà installé. Sinon, vous pouvez utiliser cette référence pour apprendre à les installer. Sur les machines Windows, vous pouvez utiliser Ruby Installer . Lorsque le Ruby est installé il suffit de taper dans la console:
$ gem install crowdin-cli
crowdin-cli est installé. C'est aussi simple que cela.
Installation comme une application Java
Nous avons regroupé crowdin-cli comme une application Java pour vous permettre de commencer à utiliser crowdin-cli facile. Cette méthode ne nécessite pas d'installation. Pour commencer à crowdin-cli comme une application Java, procédez comme suit:
- Télécharger crowdin-cli.jar et l'enregistrer sur votre disque dur.
- Vérifiez que vous avez installé Java 7.
- Ajouter le fichier crowdin-cli.jar à votre répertoire de projet.
Utilisez la méthode suivante pour exécuter l'application:
java-jar aide crowdin-cli.jar
Cette méthode fonctionne sur les deux machines Windows et Unix.
Configuration
En général, vous utilisez crowdin-CLI de la manière suivante:
- Créez un fichier de configuration dans votre répertoire racine du projet (nous vous recommandons le nom «crowdin.yaml").
- Utilisez le script crowdin-cli comme suit:
Crowdin-cli $ coolaction
Par défaut, crowdin-cli va chercher un fichier de configuration appelé crowdin.yaml. Le coolaction indique quelle commande à exécuter. Vous pouvez utiliser "l'aide de crowdin-cli" pour voir toutes les commandes disponibles.
Lors de l'appel `crowdin-cli` dans le terminal, vous devriez être dans votre répertoire racine du projet. Sinon, vous devrez spécifier le chemin du fichier de configuration en utilisant le C (ou --config) option. Voir `help` crowdin-cli pour plus de détails. Un fichier de configuration de l'échantillon est imprimé ci-dessous. Pour plus d'informations sur la façon de configurer crowdin-cli, consultez la section Fichier de configuration.
01 | project_identifier: votre projet identificateur |
02 | api_key: 54e01e81 - votre-api-clé - f6a2724a #can se trouve dans la page des paramètres du projet |
03 | base_path: / home / bureau / code source |
04 |
05 | fichiers: |
06 | - |
07 | source: '/_locales/en/*.json « filtre de fichiers #source |
08 | traduction: "/ _locales /% two_letters_code% /% original_file_name% ' #where traductions vivent |
09 |
10 | - |
11 | source: '/locale/en/**/*.po' |
12 | traduction: "/ locale /% two_letters_code% / LC_MESSAGES /% original_file_name% ' |
Usage
Une fois le fichier de configuration est créé, vous êtes prêt à commencer à utiliser crowdin-cli pour gérer vos ressources de localisation et d'automatiser la synchronisation de fichiers.
Voici une liste des commandes typiques que crowdin-cli est utilisé pour:
$ sources de téléchargement crowdin-cli
Envoyez vos fichiers source à Crowdin.
$ traductions de téléchargement crowdin-cli
Envoyez traductions existantes de projet Crowdin (traductions seront synchronisés).
$ Télécharger crowdin-cli
Télécharger dernières traductions de Crowdin.
$ Crowdin-cli aide téléchargement
Obtenez de l'aide sur commande `upload`.
$ sources aide téléchargement crowdin-cli
Obtenir de l'aide sur `télécharger sources` commande.
Utiliser l'aide fournie avec une application pour obtenir plus d'informations sur les commandes et les options disponibles.