Crowdin CLI, yerelleştirme kaynaklarını yönetmenizi ve Crowdin projenizle eşitlemenizi sağlayan bir komut satırı aracıdır:
Bu bir çapraz platformdur ve Linux tabanlı ve macOS işletim sistemlerinde bir terminalde veya Windows’ta Komut İstemi’nde çalışır. Bu, ayrıca açık kaynak’tır ve kaynak kodu GitHub’da mevcuttur.
upload
komutu için daha fazla içe aktarma seçeneğidownload
komutu için daha fazla dışa aktarma seçeneğiJava 8 veya yüklü daha yeni bir sürüme sahip olup olmadığınızı denetleyin. Java sürümünü denetlemek için terminalde (Windows’da Komut İstemi) java -version
komutunu yazın. Örneğin, java version “1.8.0_212” yüklü Java 8 Update 212 sürümüne sahip olduğunuz anlamına gelir.
Eğer yüklü bir Java’ya sahip değilseniz, Oracle’ın web sitesinden indirin.
Homebrew (macOS için paket yöneticisi) ile Crowdin CLI’yı yüklemek için:
$ brew tap crowdin/crowdin
$ brew install crowdin@3
Windows için yükleyiciyi indirin ve çalıştırın.
Tüm paketlerimizi Crowdin İmzalama Anahtarıyla imzalıyoruz.
Ortak imzalama anahtarını indirin ve yükleyin:
wget -qO - https://artifacts.crowdin.com/repo/GPG-KEY-crowdin | sudo apt-key add -
Aşağıdaki komutu kullanarak, /etc/apt/sources.list.d dizininde crowdin.list dosyasını oluşturun:
echo "deb https://artifacts.crowdin.com/repo/deb/ /" > /etc/apt/sources.list.d/crowdin.list
Ve deponuz kullanıma hazır. Crowdin CLI Debian paketini aşağıdaki komut ile yükleyebilirsiniz:
sudo apt-get update && sudo apt-get install crowdin3
Crowdin CLI’yı el ile yüklemek için:
$ wget https://artifacts.crowdin.com/repo/deb/crowdin3.deb -O crowdin.deb $ sudo dpkg -i crowdin.deb
Tüm paketlerimizi Crowdin İmzalama Anahtarıyla imzalıyoruz.
Ortak imzalama anahtarını indirin ve yükleyin:
rpm --import https://artifacts.crowdin.com/repo/GPG-KEY-crowdin
RPM deposundan yükleme
/etc/yum.repos.d dizininde aşağıdakileri içeren crowdin.repo adlı bir dosya oluşturun:
[crowdin] name=Crowdin repository baseurl=https://artifacts.crowdin.com/repo/rpm gpgcheck=1 gpgkey=https://artifacts.crowdin.com/repo/GPG-KEY-crowdin enabled=1
Ve deponuz kullanıma hazır. Crowdin CLI’yı artık aşağıdaki komutlardan biriyle yükleyebilirsiniz:
sudo yum install crowdin3 sudo dnf install crowdin3
Crowdin CLI’yı el ile yüklemek için:
$ wget https://artifacts.crowdin.com/repo/rpm/crowdin3.rpm -O crowdin.rpm $ sudo rpm -U crowdin3.rpm
Arch Linux kullanıcı deposunda Crowdin CLI paket sayfasını ziyaret edin.
NPM deposundan yükleme
npm i -g @crowdin/cli
Crowdin CLI tek başına Java uygulaması olarak yüklenebilir.
crowdin
komutu eklemek için sudo hakları olan terminalde ./install-crowdin-cli.sh
komutunu çalıştırıncrowdin
komutunu eklemek için setup-crowdin.bat
komut dosyasını çalıştırınCrowdin CLI, bir proksi sunucusuyla çalışma imkanı sağlar. Bir komutu her çalıştırdığınızda, Crowdin CLI, işletim sisteminin yapılandırılmış ortam değişkenlerine sahip olup olmadığını denetler.
Desteklenen ortam değişkenleri:
HTTP_PROXY_HOST
– proksi sunucusunun bulunduğu anamakinenin adı veya IP adresi HTTP_PROXY_PORT
– proksi sunucusunun tarafından dinleme için kullanılan bağlantı noktası HTTP_PROXY_USER
– bir proksi sunucusunda kimlik doğrulaması için kullanılan kullanıcı adı HTTP_PROXY_PASSWORD
– bir proxy sunucusunda kimlik doğrulama için kullanılan parola
Uygulamayı çalıştırmak için aşağıdaki yöntemi kullanın:
$ crowdin
Alternatif yöntem:
$ java -jar crowdin-cli.jar
Crowdin CLI’yı kullanmak için bir yapılandırma dosyasına ihtiyacınız vardır. Buna crowdin.yml adını vermenizi öneririz. Aşağıdaki komutu çalıştırarak oluşturabilirsiniz:
$ crowdin init
Terminalde Crowdin CLI’yı çağırırken proje kök dizininizde olmalısınız. Aksi halde, --config
seçeneğini kullanarak bir yapılandırma dosyası yolu belirtmeniz gerekecek:
$ crowdin upload sources --config /yapılandırma/dosyanızın/yolu
Diğer komutlarla ilgili daha fazla ayrıntı almak için crowdin help
komutunu çalıştırın.
Örnek yapılandırma dosyası:
"project_id": "proje-kimliği" #proje ayarlarını açın ve API bölümüne gidin
"api_token": "kişisel-erişim-belirteci" #profil ayarlarını açın ve API > Yeni Belirteç > Oluştur’a tıklayın
"base_path": "." #yerel bir makinede proje dizininiz için yol
"base_url": "https://crowdin.com"
"preserve_hierarchy": true
"files": [
{
"source": "/en/**/*.json", #kaynak dosyalar süzgeci
"translation": "/%two_letters_code%/**/%original_file_name%" #çevirilerin saklandığı yer
}
]
Crowdin CLI’nın nasıl yapılandırıldığı hakkında daha fazla bilgi için Yapılandırma Dosyası makalesini okuyun.
Yapılandırma dosyası oluşturulduktan sonra, yerelleştirme kaynaklarınızı yönetmek ve dosya eşitlemesini otomatikleştirmek için Crowdin CLI’yı kullanmaya başlamak için hazırsınız.
Yardım bilgilerini görüntülemek için:
$ crowdin help
İskelet yapılandırma dosyası oluşturmak için:
$ crowdin init
Genel hatalarda yapılandırma dosyasını denetlemek için:
$ crowdin lint
Crowdin’e yüklenen dosyaların bir listesini görüntülemek için:
$ crowdin list project
Kaynak dosyaları Crowdin’e yüklemek için:
$ crowdin upload sources
Yapılandırma olmadan tek bir dosya yüklemek için:
$ crowdin upload sources -s dosyanızın/yolu -t dosya/dışa/aktarma/şekli -T kişisel-belirteç -i proje-kimliği --base-url https://crowdin.com
Uygun değişkenleri koymak için yer tutucular kullanın.
Crowdin’e yüklenecek olan dosyaların bir listesini görüntülemek için:
$ crowdin upload sources --dryrun
Varolan çevirileri Crowdin’e yüklemek için (çeviriler eşitlenecektir):
$ crowdin upload translations
upload
komutu hakkında ayrıntılı bilgi göstermek için:
$ crowdin upload --help
Kaynak dizgilere varolan veya yeni etiketler eklemek için:
$ crowdin upload sources -s "..." -t "..." --label "main-menu" --label "application"
Etiketler hakkında daha fazlasını okuyun.
Kaynak dosyaları Crowdin’den indirmek için:
$ crowdin download sources
Crowdin’den en son çevirileri indirmek için:
$ crowdin download
Belirli dilin (dil kodları) en son çevirilerini indirmek için:
$ crowdin download -l {language_code}
Crowdin’den gelen en son çevirilerin listesini görüntülemek için:
$ crowdin download --dryrun
download
komutu hakkında ayrıntılı bilgi göstermek için:
$ crowdin download --help
Crowdin’deki kaynak dosya biçiminden bağımsız olarak Crowdin’den belirtilen hedef dosyaya (Android XML veya iOS Strings) en son çevirileri indirme imkanı vardır.
Crowdin’den hedef dosyaya en son çevirileri indirmek için:
$ crowdin download targets <name>
targets
bölümünü crowdin.yml
yapılandırma dosyanıza aşağıdaki yapıyla ekleyin:
targets: [
{
name: "android",
files: [
{
file: "targets/%two_letters_code%/android.xml",
sources: [
"dosya.xlsx"
],
labels: [
"mobile",
"ui"
]
}
]
}
]
name
- hedefinizin adı. Belirli hedefleri indirmek için kullanılacaktır.files
- indirmeden sonra sisteminizde görünecek ortaya çıkan dosyaları tanımlayan bölüm. Her hedef, birden çok dosyanın indirilmesini destekler.file
- ortaya çıkan dosya şekli. Şu anda sadece Android XML (.xml) ve iOS Strings (.strings) dosya biçimleri desteklenir.sources
- çevirileri dışa aktarılması gereken Crowdin’deki kaynak dosyalar. Alternatif olarak, ya dalları
ya da dizinleri
belirleyebilirsiniz.labels
- dizgiler süzmek için Etiketler (İsteğe bağlı).Sonuç olarak, dosya.xlsx
çevirileri (mobile
ve ui
etiketlerine göre süzülen) targets/%two_letters_code%/android.xml
dosyasına indirilecektir.
Sözde yerelleştirilmiş çeviri dosyalarını yapılandırma ve indirme imkanı vardır.
Sözde yerelleştirilmiş çeviri dosyaları içeren bir arşivi indirmek için:
$ crowdin download --pseudo
pseudo_localization
bölümünü crowdin.yml
yapılandırma dosyanıza aşağıdaki yapıyla ekleyin:
pseudo_localization: {
length_correction: 25,
prefix: "",
suffix: "",
character_transformation: "cyrillic"
}
Sözde Yerelleştirme hakkında daha fazlasını okuyun.
Eşitleme aracı kullanılıyorsa sürüm dalları oluşturmak için belirli bir komutu çalıştırmaya gerek yoktur. Dosyaların yüklenmesi sırasında sürüm dalı otomatik olarak oluşturulacaktır.
Kaynak dosyaları belirli bir sürüm dalına yüklemek için:
$ crowdin upload sources -b {branch_name}
Çevirileri belirli bir sürüm dalına yüklemek için:
$ crowdin upload translations -b {branch_name}
Çevirileri belirli bir sürüm dalından indirmek için:
$ crowdin download -b {branch_name}
Şu dosya türleri için kaynak dizgileri yönetme (ekleme, düzenleme, silme) olasılığı vardır: CSV, RESX, JSON, Android XML, iOS strings, PROPERTIES.
Şu anki projedeki kaynak dizgilerinin listesini göstermek için (daha fazla bilgi görmek için --verbose
seçeneğini kullanın):
$ crowdin string list
Yeni bir kaynak dizgi oluşturmak için (olası tüm komut seçeneklerini görmek için -h
seçeneğini kullanın):
$ crowdin string add
Kaynak dizgiyi silmek için:
$ crowdin string delete
Varolan kaynak dizgiyi düzenlemek için:
$ crowdin string edit
Aşağıdaki komutları kullanarak bir proje için çeviri ve düzeltme okuması ilerlemesini denetleyebilirsiniz.
Bir proje için hem çeviri hem de düzeltme okuması ilerlemesini göstermek için:
$ crowdin status
Bir proje için çeviri ilerlemesini göstermek için:
$ crowdin status translation
Bir proje için düzeltme okuması ilerlemesini göstermek için:
$ crowdin status proofreading
Ayrıca, daha fazla bilgi görmek için --verbose
seçeneğini kullanabilirsiniz.
Sözlükleri yükleme ve indirme imkanı vardır.
Bir sözlükler listesi göstermek için (sözlükler için terim listelerini göstermek amacıyla --verbose
seçeneğini kullanın):
$ crowdin glossary list
Bir dosyadan (TBX dosya biçiminde) sözlüğü ya belirtilen sözlüğe ya da yeni bir sözlüğe yüklemek için:
$ crowdin glossary upload
Bir dosyadan (CSV veya XLS/XLSX dosya biçiminde) sözlüğü ya belirtilen sözlüğe ya da yeni bir sözlüğe yüklemek için:
$ crowdin glossary upload <file> --scheme term_en=0 --scheme description_en=1 --scheme partOfSpeech_en=2 --first-line-contains-header
CSV veya XLS/XLSX sözlük dosyanız için şemayı oluşturmak amacıyla aşağıdaki sabitleri kullanın:
term_{language_code}
– Sütun terimleri içerir. {column_number}
– Sütun numarası. Numaralandırma 0’dan başlar. description_{language_code}
– Sütun, terim açıklamalarını içerir. partOfSpeech_{language_code}
– Sütun, terimler için sözcük türü içerir. where {language_code}
– Belirtilen dil için dil kodu. Desteklenen Diller’in tam listesine bakın. --first-line-contains-header
– İlk satırın (başlık) içe aktarılmasını atlamak için kullanılır.
Sözlüğü belirtilen sözlükten bir dosyaya (TBX, CSV veya XLS/XLSX dosya biçiminde) indirmek için:
$ crowdin glossary download
Çeviri belleklerini yükleme ve indirme imkanı vardır.
Çeviri belleklerinin bir listesini göstermek için:
$ crowdin tm list
Bir dosyadan (TMX dosya biçiminde) çeviri belleğini ya belirtilen çeviri belleğine ya da yeni bir çeviri belleğine yüklemek için:
$ crowdin tm upload
Bir dosyadan (CSV veya XLS/XLSX dosya biçiminde) çeviri belleğini ya belirtilen çeviri belleğine ya da yeni bir çeviri belleğine yüklemek için:
$ crowdin tm upload <file> --scheme en=0 --scheme fr=1 --first-line-contains-header
CSV veya XLS/XLSX çeviri belleği dosyanız için şemayı oluşturmak amacıyla aşağıdaki sabitleri kullanın:
{language_code}
– Sütun, belirtilen dil için çeviri belleği öğelerini içerir. {column_number}
– Sütun numarası. Numaralandırma 0’dan başlar. where {language_code}
– Belirtilen dil için dil kodu. Desteklenen Diller’in tam listesine bakın. --first-line-contains-header
– İlk satırın (başlık) içe aktarılmasını atlamak için kullanılır.
Çeviri belleğini belirtilen çeviri belleğinden bir dosyaya (TMX, CSV veya XLS/XLSX dosya biçiminde) indirmek için:
$ crowdin tm download