Konzol kliens (CLI)

Megjegyzés: Ha a Crowdin CLI régi verzióját használja (<= 0.5.5), akkor több információt kaphat ez ügyben itt: Crowdin Github.

Crowdin CLI egy parancssori eszköz, amely lehetővé teszi a honosítási forrásai és Crowdin projektje közötti szinkronizációt és kezelést:

  • Automatizálja a forrásfájlok frissítési folyamatát a Crowdin projektjében
  • Fordítások letöltése a Crowdinról és azokat automatikusan a megfelelő helyekre menti
  • Minden meglévő fordítását néhány perc alatt feltöltheti a Crowdinba
  • Crowdin integrálása a következőkkel: GIT, SVN, Mercurial stb…

Ez az alkalmazás több platformú és terminálban fut a Linux alapú és MacOS X operációs rendszereken, vagy a parancssori ablakban a Windowson. Továbbá nyílt forráskódú, a forráskódja elérhető itt: GitHub.

Újdonságok

  • Új típusú YAML konfiguráció
  • Konfigurációs fájl érvényesítése a lint parancs segítségével
  • Konfigurációs fájl létrehozása a generate parancs segítségével
  • Fájlok feltöltésének továbbfejlesztett folyamata
  • Egyetlen fájllal akár konfiguráció nélkül is dolgozhat
  • --dryrun opció a kezelt fájlok listájának megtekintéséhez

Követelmények

Ellenőrizze, hogy telepítve van-e a Java 7 vagy újabb verziója. Írja be a java -version parancsot a terminálba (parancssorba a Windowson), hogy ellenőrizze a Java verzióját. Például, a java version “1.7.0_55” azt jelenti, hogy az Ön gépén a Java 7 Update 55 van telepítve.

Ha nincs Java telepítve, töltse le az Oracle weboldaláról.

Telepítés

MacOS Homebrew

A Crowdin CLI telepítése homebrew használatával (a MacOS csomagkezelője):

$ brew install crowdin

Windows

Töltse le és futtassa a Windows telepítőt

Debian

Az összes csomagunkat a Crowdin Signing Key segítségével írjuk alá.

Töltse le, majd telepítse a nyilvános aláíró kulcsot:

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

Az adattár definíciót mentse ide: /etc/apt/sources.list.d/crowdin.list:

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

A Crowdin CLI Debian csomagot a következővel telepítheti:

sudo apt-get update && sudo apt-get install crowdin

A Crowdin CLI manuális telepítéséhez:

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

RPM

Az összes csomagunkat a Crowdin Signing Key segítségével írjuk alá.

Töltse le, majd telepítse a nyilvános aláíró kulcsot:

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

Telepítés az RPM adattárból

Hozzon létre egy crowdin.repo fájl az /etc/yum.repos.d könyvtárban a következő tartalommal:

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

És ha az adattára készen áll a használatra, akkor a Crowdin CLI-t az alábbi parancsok valamelyikével telepítheti:

sudo yum install crowdin
sudo dnf install crowdin

A Crowdin CLI manuális telepítéséhez:

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

Önálló változat

A Crowdin CLI-t önálló Java alkalmazásként lehet telepíteni.

Linux és macOS rendszeren való telepítés

  1. Töltse le a crowdin-cli.zip fájlt a fenti gomb segítségével
  2. Csomagolja ki
  3. A terminálban futtassa a . crowdin.sh parancsot rendszergazdai (sudo) jogokkal ahhoz, hogy a crowdin parancs a terminálban felvételre kerüljön

Windows rendszeren való telepítés

  1. Töltse le a crowdin-cli.zip fájlt a fenti gomb segítségével
  2. Csomagolja ki a tartalmát arra a helyre, ahol a Crowdin CLI-t tárolni szeretné
  3. Nyissa meg a Parancssort rendszergazdaként
    1. Kattintson a Start gombra
    2. A Keresőmezőbe, írja be: cmd, majd nyomja meg: CTRL+SHIFT+ENTER
    3. Ha a Felhasználói fiókok felügyelete párbeszédpanel jelenik meg, ellenőrizze, hogy azt a műveletet jeleníti meg, amit szeretne, majd kattintson a Továbbra
  4. Futtassa a setup-crowdin.bat szkriptet a crowdin parancs Parancssorba való adásához
  5. Indítsa újra a Parancssort

Alkalmazás futtatása

Használja a következő módszert az alkalmazás futtatásához:

$ crowdin

Alternatív módszer:

$ java -jar crowdin-cli.jar

Konfiguráció

A Crowdin CLI használatához konfigurációs fájl szükséges. Javasoljuk, ennek a crowdin.yaml nevet adja. A következő parancs futtatásával hozhatja létre:

$ crowdin generate

Amikor a terminálban a Crowdin CLI-t hívja, akkor a projekt gyökérkönyvtárában kell lennie. Ellenkező esetben a --config opcióval meg kell adnia egy konfigurációs fájl elérési utat:

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

Futtassa a crowdin help parancsot a további parancsok megismeréséhez.

Minta konfigurációs fájl:

"project_identifier" : "your-project-identifier"
"api_key" : "your-api-key"
"base_path" : "your-base-path"

"preserve_hierarchy": true

"files": [
  {
    "source" : "/t1/**/*",
    "translation" : "/%two_letters_code%/%original_file_name%"
  }
]

A Crowdin CLI konfigurációjával kapcsolatos további információkért, nézze meg a Konfigurációs fájl cikket.

Használat

Miután létrehozta a konfigurációs fájlt, készen áll a Crowdin CLI használatára, a honosítási források kezelésére és a fájlszinkronizálás automatizálására.

Általános parancsok

A súgó információ megjelenítéséhez:

$ crowdin help

A vázlat konfigurációs fájl létrehozásához:

$ crowdin generate

A konfigurációs fájl általános hibáinak ellenőrzéséhez:

$ crowdin lint

A Crowdinba feltöltött fájlok listájának megjelenítéséhez:

$ crowdin list project

Források feltöltése

A forrásfájlok Crowdinba való feltöltéséhez:

$ crowdin upload sources

Egy fájl konfiguráció nélküli feltöltéséhez:

$ crowdin upload sources -s path/to/your/file -t file/export/pattern -k your-key -i your-identifier

Használjon helyőrzőket a megfelelő változók elhelyezésére.

A Crowdinba feltöltésre kerülő fájlok listájának megjelenítéséhez:

$ crowdin upload sources --dryrun

A meglévő fordítások Crowdinba való feltöltéséhez (a fordítások szinkronizálásra kerülnek):

$ crowdin upload translations

Az upload parancs részletes információinak megjelenítéséhez:

$ crowdin upload --help

Fordítások letöltése

A Crowdin legújabb fordításainak letöltéséhez:

$ crowdin download

A konkrét nyelv (nyelvkódok) legfrissebb fordításainak letöltéséhez:

$ crowdin download -l {language_code}

A Crowdin legújabb fordítások listájának megjelenítéséhez:

$ crowdin download --dryrun

A download parancs részletes információinak megjelenítéséhez:

$ crowdin download --help

Verziók kezelése

Nincs szükség különleges parancs futtatására verzió ágak létrehozására, ha a szinkronizálási eszközt használja. A verzió ág automatikusan létrejön a fájlok feltöltésekor.

A forrásfájlok megadott verzió-ágba való feltöltéséhez:

$ crowdin upload sources -b {branch_name}

A fordítások megadott verzió-ágba való feltöltéséhez:

$ crowdin upload translations -b {branch_name}

A fordítások megadott verzió-ágból való letöltéséhez:

$ crowdin download -b {branch_name}

Lásd még

Hasznos volt ez a cikk?