Geekly articles weekly

20 proyek, 20 bahasa, batas waktu kemarin. Bagian 3

Artikel terakhir tentang integrasi Serge + Smartcat . Dalam artikel ini, saya akan memberi tahu Anda bagaimana kami mengukur Serge ke seluruh perusahaan, mempertimbangkan 4 integrasi non-standar dan, sebagai bonus, berbicara tentang 2 fitur yang dapat menyederhanakan hidup Anda.

Artikel sebelumnya:

20 proyek, 20 bahasa, batas waktu kemarin
20 proyek, 20 bahasa, batas waktu kemarin. Bagian 2

Skalabilitas


Dalam artikel sebelumnya, saya berbicara tentang cara mengkonfigurasi Serge untuk repositori tunggal. Di perusahaan kami, kami memiliki beberapa lusin repositori yang membutuhkan terjemahan, sehingga server terpisah untuk pelokalan dialokasikan. Struktur file dan lingkungan di atasnya benar-benar identik dengan apa yang dijelaskan dalam artikel sebelumnya. Setiap repositori menggunakan instance Serge-nya sendiri. Agar tidak menjalankan perintah secara manual, setiap instance memiliki mahkota, yang secara berturut-turut menjalankan perintah Serge: menerima baris baru dari repositori, menerima terjemahan baru, penguraian, mengirim baris baru ke Smartcat dan mengirim terjemahan baru ke Gitlab.

Opsi integrasi


Dua set bahasa dalam satu repositori


Mari kita mulai dengan kasing paling sederhana. Bayangkan repositori Anda memiliki beberapa set file sumber daya. Sebagai contoh, string klien dan API aplikasi disimpan dalam repositori yang sama, tetapi dalam direktori yang berbeda. Klien diterjemahkan ke dalam 20 bahasa, API ke dalam 6.

Tujuan : untuk mengatur persediaan terjemahan yang independen di setiap direktori.
Solusi :

  1. Menyiapkan 2 proyek di Smartcat: dalam 6 bahasa dan dalam 20.
  2. Menyiapkan 2 proyek di server pelokalan.
  3. Pada proyek pertama, tambahkan baris $ unmerged_branch_mask = '^ (translateAPI-)' kami di file project1.cfg ; # proses cabut cabang yang tidak cocok dengan topeng ini , di mana " translateAPI- " adalah awalan nama cabang. Awalan akan menunjukkan kepada Serge bahwa cabang ini membutuhkan terjemahan di direktori API.
  4. Dalam file project1.serge.tmpl , tentukan path ke file sumber daya di direktori API di parameter source_dir .
  5. Demikian pula, untuk proyek kedua dalam file project2.cfg tambahkan baris $ unmerged_branch_mask kami = '^ (translateCLIENT-)'; # memproses cabang-cabang yang tidak digabung yang cocok dengan topeng ini , di mana " translateCLIENT " adalah awalan untuk cabang-cabang dari proyek ini. Awalan akan menunjukkan kepada Serge bahwa cabang ini membutuhkan terjemahan di direktori Klien.
  6. Dalam file project2.serge.tmpl , tentukan path ke file sumber daya di direktori CLIENT dalam parameter source_dir .

Harap dicatat bahwa awalan harus unik di antara semua proyek yang dikonfigurasi untuk satu repositori.

Secara total, kami memiliki 2 proyek di Smartcat dan 2 proyek yang sesuai di server lokalisasi. Kedua proyek melihat repositori yang sama di Gitlab, tetapi di direktori yang berbeda. Serge, menggunakan awalan cabang, mengerti baris mana yang harus dia kirim untuk terjemahan. Untuk menghitung diff, cabang-basis terjemahan yang sama digunakan.

Kesombongan Lokalisasi


Di perusahaan kami, semua produk, termasuk dokumentasi, dilokalkan. Sekarang kami memperkenalkan dokumentasi auto-generation dari angkuh, dan kami dihadapkan dengan kebutuhan untuk melokalisasikannya.
Tugas : melokalkan kesombongan dengan sedikit usaha.

Solusi : Dalam file myproject.tmpl.serge , tambahkan objek data ke objek parser dan cantumkan di dalamnya bidang-bidang yang nilainya harus diekstraksi dan dikirim untuk diterjemahkan:

parser { plugin parse_json data { path_matches \/(summary|description)$ } }

Tugas serupa : perlu menerjemahkan teks dari file, tetapi tidak semua, tetapi hanya yang legal. Teks-teks lain disediakan oleh tim pemasaran. Agar tidak menyulitkan struktur dan tidak membuat file tambahan untuk teks hukum, kunci dari semua baris hukum menerima awalan "legal":

 parser { plugin parse_json data { path_matches ^\/legal\..* } }

Seluk-beluk terjemahan hukum


Kasus lain yang menarik. Kami memiliki dokumen hukum, yang persyaratannya bervariasi dari satu negara ke negara. Tetapi, bagaimanapun, ini adalah satu aplikasi dan file sumber daya berada di direktori yang sama.

Tujuan : dalam rangka satu proyek untuk menerjemahkan beberapa dokumen, setiap dokumen harus diterjemahkan ke dalam satu bahasa tertentu.

Apa yang telah dilakukan :

  1. Direktori yang sesuai dibuat untuk setiap negara, di dalamnya terdapat file sumber bahasa Inggris yang relevan dengan negara itu.
  2. Path untuk variabel source_dir ditentukan ke direktori bersama dengan file sumber.
  3. Kami mengaktifkan pencarian untuk file sumber di semua subdirektori : source_process_subdirs YA
  4. Kami menambahkan plugin baru ke daftar yang disebut plug-in, yang memungkinkan Anda mengirim setiap file sumber daya spesifik ke bahasa yang diinginkan. Sebagai panduan, gunakan nama direktori tempat ia berada:

 callback_plugins { :feature_branch { plugin feature_branch data { master_job job.base-translate } } :limit_languages { plugin limit_languages data { # all rules are processed top to bottom; each rule can add or remove languages # so the most priority rules are placed at the bottom if { # by default, don't localize file_matches . then { exclude_all_languages YES } } if { file_matches de-au\/ then { include_languages de-AT } } if { file_matches li-LI\/ then { include_languages li } } if { file_matches pt\/ then { include_languages pt-BR } } if { file_matches zh-Hans\/ then { include_languages zh-Hans } } # and so on.. } }

Lokalisasi saat menyimpan baris dalam database


Sistem kami memiliki bagian dari kode yang menyimpan terjemahan dalam database, dan karena beberapa alasan ia tidak dapat pindah ke file sumber daya dalam repositori. Namun, kami harus dapat mengirimkan terjemahan dengan cepat dan otomatis.

Tugas : Mengatur proses pelokalan berkelanjutan jika baris tidak disimpan dalam repositori, tetapi dalam database.

Solusi :

  1. Buat repositori, kumpulkan, dan kelompokkan di dalamnya semua baris dari database sesuai dengan prinsip yang nyaman bagi kami (dengan jumlah bahasa terjemahan atau produk).
  2. Buat proyek di Smartcat.
  3. Mulai siklus standar pelokalan berkelanjutan.
  4. Gabungkan cabang terjemahan ke cabang terjemahan dasar.
  5. Dengan mahkota, periksa nilai hash dari commit terakhir di base-translate. Jika hash telah berubah, yaitu, terjemahan baru telah dihasilkan, parsing perbedaan antara hash lama dan saat ini, dan kirim baris baru / ubah ke basis data.

Fitur Bonus


Lansiran


Lansiran Smartcat dasar tidak cocok untuk kami, karena setiap tim ingin menerima pemberitahuan hanya tentang cabang-cabangnya dan hanya tentang kesiapan terjemahan yang lengkap di semua file sumber daya produk.

Diputuskan untuk membangun ketersediaan semua terjemahan dalam repositori dan, jika sudah sepenuhnya siap, kirim pemberitahuan ke messenger perusahaan, dalam kasus kami, Google Chat.

Tugas : mengatur peringatan di repositori, tempat 8 tim dapat melakukan, menduplikasi semua peringatan di saluran departemen dokumentasi teknis.

Solusi :

  1. Setuju dengan masing-masing tim bahwa nama cabang harus berisi nama tim. Masih menggunakan terjemahan awalan- untuk menunjukkan cabang yang perlu diterjemahkan.
  2. Buat pipa yang hanya berjalan untuk cabang yang diawali dengan translate-.
  3. Di jalur pipa, tentukan perintah yang dimiliki cabang, periksa keberadaan garis dengan nilai kosong, dan, jika tidak ada, kirim pemberitahuan kesiapan ke saluran yang sesuai. Karena kodenya cukup banyak, saya memasukkannya ke dalam skrip.

Ci


 check-translations: stage: check-translations image: node:8.14.0 tags: - devops script: - chmod +x ./notification.sh - ./notification.sh only: - base-translate - /^translate.*$/ when: always

Alert Script


 #!/bin/bash hangouts(){ curl -X POST --max-time 180 -H "Content-Type: application/json; charset=UTF-8" --data "{ \"cards\": [{\"header\": {\"title\": \"LOCALIZATION IS READY\",\"subtitle\": \"REPOSITORY NAME\",\"imageUrl\": \"https://avatanplus.com/files/resources/mid/5775880ee27f8155a31b7a50.png\"},\"sections\": [{\"widgets\": [{\"keyValue\": {\"topLabel\": \"Translation is finished in the branch\",\"content\": \"$1\"}}]},{\"widgets\": [{\"buttons\": [{\"textButton\": {\"text\": \"SEE COMMIT\",\"onClick\": {\"openLink\": {\"url\": \"https://gitlab.loc/common/publisher-client/commit/$2\"}}}}]}]}]}]}" "$3" || true } cd app/translations if echo "$CI_COMMIT_REF_NAME" | grep "commandname1"; then grep -rl '\:\s\"\"' *.json >> result.file if [ -s network.file ]; then echo "Translations are not ready"; cat result.file else hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_COMMAND_NAME_1 hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_DOC fi fi if echo "$CI_COMMIT_REF_NAME" | grep "commandname2"; then grep -rl '\:\s\"\"' *.json >> result.file if [ -s result.file ]; then echo "Translations are not ready"; cat result.file else hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_COMMAND_NAME_2 hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_DOC fi fi ... if echo "$CI_COMMIT_REF_NAME" | grep "commandname8"; then grep -rl '\:\s\"\"' *.json >> result.file if [ -s result.file ]; then echo "Translations are not ready"; cat result.file else hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_COMMAND_NAME_8 hangouts $CI_COMMIT_REF_NAME $CI_COMMIT_SHA $HANGOUTS_NOTIFICATIONS_DOC fi fi

Tugas Penerjemah melalui Smartcat API




Ini adalah apa yang tampak seperti manajer lokalisasi kami ketika tiba saatnya untuk menetapkan semua cabang untuk terjemahan.

Rata-rata, kami memiliki lebih dari 10 cabang dalam pekerjaan kami setiap hari. Di Smartcat, setiap pasangan bahasa adalah dokumen terpisah, dan penerjemah harus ditugaskan untuk setiap dokumen tersebut. Secara manual. Bayangkan: 40-60 janji setiap hari. Untuk menyederhanakan proses ini, kami membuat janji melalui API, dan juga memasukkannya ke dalam saluran pipa. Pekerjaan ini diluncurkan oleh tombol. Sebuah pertanyaan yang masuk akal: mengapa tidak membuat penugasan otomatis saat mengirim transfer, dan tidak menempatkan pemanggilan metode pada plugin Smartcat, dan tidak dalam pipa?

Ada beberapa alasan untuk keputusan ini:

  1. Faktor manusia. Terlepas dari kenyataan bahwa kami membangun proses dan mencoba untuk mematuhinya, baris atau garis yang belum dibaca tanpa konteks secara teratur masuk ke Smartcat. Penugasan otomatis dalam hal ini akan berarti biaya tambahan bagi kami, karena beberapa baris akan dikirim untuk terjemahan dua kali: sebelum dan setelah pengeditan.
  2. Distribusi peran. Proyek dikonfigurasikan dan dikelola di tingkat server pelokalan oleh insinyur pelokalan atau penulis teknis proyek. Janji temu dan komunikasi dengan penerjemah ditangani oleh manajer pelokalan. Dengan demikian, penugasan harus dapat dikelola, transparan, dan dapat diakses melalui GUI.

Solusi: ketika manajer lokalisasi menganggap bahwa garis-garis di cabang ini siap untuk terjemahan, ia menekan tombol di Gitlab. Seluruh tim penerjemah ditugaskan ke cabang ini. Tugas ini diambil oleh penerjemah yang merespons pertama.

Ci


 assignee: stage: assignee image: node:8.14.0 tags: - devops script: - chmod +x ./assignee.sh - ./assignee.sh only: - base-translate - /^translate.*$/ - assignee when: manual

Skrip penugasan


 #!/bin/bash if echo "$CI_COMMIT_REF_NAME" | grep "translate-"; then node -pe "JSON.parse(process.argv[1]).documents.forEach(function(elem){ if(elem.name.indexOf(\"$CI_COMMIT_REF_NAME\") !== -1) { console.log(elem.id) } });" "$(curl -XGET -H "Authorization: Basic $SMARTCAT_API_KEY" -H "Content-type: application/json" "https://smartcat.ai/api/integration/v1/project/$SMARTCAT_PROJECT_ID")" >> documents fi sed '$d' documents > documents.list while read LINE; do bash -c "curl -XPOST -H 'Authorization: Basic $SMARTCAT_API_KEY' -H "Content-type:application/json" -d '{"documentIds":[\""$LINE"\"],"stageNumber": 1}' 'https://smartcat.ai/api/integration/v1/document/assignFromMyTeam'";done < documents.list

Ini menyimpulkan seri artikel saya tentang mengintegrasikan dan mengkonfigurasi pelokalan berkelanjutan. Saya akan dengan senang hati menjawab pertanyaan Anda.

Source: https://habr.com/ru/post/id452580/

More articles:


All Articles