Hokeylizatsiya

Nega men butun ilova yoki saytimni Google Tarjimon orqali ishga tushirib, boshqa tildagi asosiy tarjimani ololmayman?

Endi, qila olasiz!

" hokeylization " nomi portmanto bo'lib, "hokey mahalliylashtirish" degan ma'noni anglatadi.

Bu juda oddiy, chunki u Google Tarjimonga satrlarni yuboradi

Va bu oddiy, ammo ayni paytda juda kuchli. U HTML hujjatlari uchun maxsus yordamga ega, HandlebarsJS andozalari, va Markdown fayllari.

Siz tarjima qilishingiz mumkin:

xabarlarni o'z ichiga olgan JavaScript ob'ekti
har doim rekursiv ravishda kataloglarni kesib o'tuvchi istalgan miqdordagi fayllar yoki kataloglar

Buni boshqa tilda o'qing

Ushbu README.md hujjati hokeylizatsiya vositasi yordamida tarjima qilingan Google Translate tomonidan qo‘llab-quvvatlanadigan barcha tillar!

Ishonchim komilki, bu mukammal emas, lekin umid qilamanki, bu hech narsadan yaxshiroq!

🇸🇦 Arabcha 🇧🇩 Bengal 🇩🇪 Nemis 🇺🇸 Ingliz tili 🇪🇸 Ispancha 🇫🇷 Fransuzcha 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Indoneziya 🇮🇹 Italiancha 🇯🇵 Yaponcha 🇰🇷 Koreys 🇮🇳 Marathi 🇵🇱 Polsha 🇧🇷 Portugalcha 🇷🇺 Ruscha 🇰🇪 Suahili 🇵🇭 Tagalog 🇹🇷 Turkcha 🇵🇰 Urdu 🇻🇳 Vetnamcha 🇨🇳 Xitoy

📚 ... Barcha tillar ...

README tarjimasida muammo bormi?

Asl nusxaning ushbu maxsus tarjimasi README noto'g'ri bo'lishi mumkin -- tuzatishlar juda mamnuniyat bilan qabul qilinadi! Iltimos, GitHub'da tortish so'rovi yuboring, yoki buni qilish sizga mos kelmasa, muammoni oching

Tarjima haqida yangi GitHub muammosini yaratganingizda, iltimos:

sahifa URL manzilini qo'shing (brauzer manzil satridan nusxalash/joylashtirish)
noto'g'ri bo'lgan aniq matnni kiriting (brauzerdan nusxalash/joylashtirish)
nima noto'g'ri ekanligini tushuntirib bering -- tarjima noto'g'ri? formatlash qandaydir tarzda buzilganmi?
Yaxshiroq tarjima bo'yicha taklif yoki matnni qanday qilib to'g'ri formatlash kerakligini taklif qiling
Rahmat!

Tarkib

Manba
[Yordam va moliyalashtirish](#Yordam va moliyalashtirish)
O'rnatish
Sozlash
JavaScript string manba faylini tarjima qilish
[Matnli fayllar katalogini tarjima qilish](#Matnli fayllar katalogini tarjima qilish)
[Boshqa variantlar](#Boshqa variantlar)
JSON ommaviy ish buyruqlari

Manba

GitHub-da hokeylizatsiya
npm da hokeylizatsiya

Qo'llab-quvvatlash va moliyalashtirish

Men professional ochiq kodli dasturiy ta'minot ishlab chiqaruvchisi bo'lishga harakat qilaman. Men ishlaganman ko'p yillar davomida dasturiy ta'minot sanoatida men muvaffaqiyatli kompaniyalarni ishga tushirdim va ularni ommaviy kompaniyalarga sotdim. Yaqinda men ishimni yo'qotdim va boshqa ishim yo'q

Shuning uchun men foydali dasturiy ta'minot yozishga harakat qilaman va bu ishlayotganligini tekshiraman

Agar siz ushbu dasturiy ta'minotdan foydalanishni yoqtirsangiz, men hatto uni olishdan juda xursand bo'laman eng kichik Patreon orqali oylik hissa

Rahmat!

O'rnatish

Buyruqlar qatori vositasidan foydalanish uchun " npm yoki yarn " yordamida o'rnating:

npm install -g hokeylization
yarn global add hokeylization

Kutubxona sifatida foydalanish uchun ancha kichikroq lite versiyasini o'rnating:

npm install -g hokeylization-lite
yarn global add hokeylization-lite

Keyin " hokey buyrug'i uchun yordamga qarang:

hokey --help
hokey -h

O'z tilingizda yoki boshqa tilda chiqishni ko'rishni xohlaysizmi?

" hokey " sizning qobiq muhit o'zgaruvchilaridan tilni avtomatik ravishda aniqlashga harakat qiladi

“ LC_ALL muhit oʻzgaruvchisini oʻrnatish orqali tilni majburlashingiz mumkin:

LC_ALL=it hokey --help

E'tibor bering, agar siz " hokeylization-lite " ni o'rnatgan bo'lsangiz, buyruq yordami faqat ingliz tilida mavjud

Sozlash; o'rnatish

Google Translate loyihangizni aniqlash uchun GOOGLE_TRANSLATE_PROJECT_ID muhit oʻzgaruvchisini oʻrnating

“ GOOGLE_APPLICATION_CREDENTIALS ” muhit oʻzgaruvchisini siz yuklab olgan JSON hisob maʼlumotlariga oʻrnating autentifikatsiya Google bulutida qanday ishlashini aniqlagandan so'ng (bu qiziqarli bo'lishi mumkin)

Agar siz manba kodidan ishlayotgan bo'lsangiz, ularni manbadagi " .env " fayliga ham qo'yishingiz mumkin katalogga ular ish vaqtida [dotenv] orqali yuklanadi (https://www.npmjs.com/package/dotenv)

JavaScript string resurs faylini tarjima qilish

Sizning string jadvalingiz kerak quyidagi ikki shakldan birida JavaScript faylida bo'lishi kerak:

ES6 eksporti:

export default {
  string_key: "some value",
  another_key: "another value",
  ... more keys ...
}

CommonJS eksporti

module.exports = {
  string_key: "some value",
  another_key: "another value",
  ... more keys ...
}

Agar bu fayl myfile.en.js deb nomlangan boʻlsa, uni ispan va nemis tillariga quyidagi bilan tarjima qilishingiz mumkin:

hokey -l es,de -o myfile.LANG.js myfile.en.js

Yuqoridagi LANG maxsus -- bu vositada ajratilgan so'z!

“ LANG ” chiqish fayllari uchun til kodi bilan almashtiriladi

Shunday qilib, yuqoridagi buyruq fayllarni yaratadi:

myfile.es.js
myfile.de.js

-l / --languages varianti ISO til kodlarining vergul bilan ajratilgan ro`yxatidir. Google Translate tomonidan qo'llab-quvvatlanadi

Agar chiqish fayli allaqachon mavjud bo'lsa, u qaysi kalitlar mavjudligini aniqlash uchun tekshiriladi. Mavjud kalitlar tarjima qilinmaydi. Yo'qolgan kalitlar uchun tarjimalar yaratiladi va qo'shiladi JS ob'ektining oxirigacha. Butun fayl har doim qayta yoziladi.

Barcha kalitlarni qayta tarjima qilishga majburlash uchun “ -f / “ --force opsiyasidan foydalaning

Matnli fayllar katalogini tarjima qilish

Siz fayllar katalogini ham tarjima qilishingiz mumkin. hokeylizatsiya har biriga rekursiv tashrif buyuradi faylni katalogga kiriting va uning mazmunini Google Translate orqali ishga tushiring va natijani saqlang alohida katalog daraxtidagi bir xil nomdagi faylga

Tarjimangizning maqsadi katalog bo'lsa, bu rejim yoqiladi

-o / --outfile opsiyasi chiqish katalogini belgilaydi

KATTA OGOHLANTIRISH: Kataloglarni tarjima qilishda, MAG** chiqish katalogini ko'rsating. bu sizning kirish katalogingizda! Agar buni qilsangiz, siz:

cheksiz rekursiyani keltirib chiqaradi
Google hisobingizni oshiring
diskingizni to'ldiring
kamroq zavqlaning

Bu erda nima qilmaslik kerakligi haqidagi misol:

hokey -l es -o templates/es templates # <--- DON'T DO THIS!

Bu ishga tushganda, tarjima qilingan fayllar templates/es ga yoziladi va shu bilan yangi bo'ladi tarjima qilish uchun manba fayllar, chunki ular " templates/ " ostida -- bu jarayon davom etadi abadiy, buni qilmang!

To'g'ri foydalanish

OK, deylik, katalogda elektron pochta shablonlari mavjud:

templates/email/en/welcome.txt
templates/email/en/welcome.html
templates/email/en/verify-account.txt
templates/email/en/verify-account.html
templates/email/en/reset-password.txt
templates/email/en/reset-password.html

Bularning barchasini ispan va nemis tillariga tarjima qilish uchun quyidagilarni bajaring:

hokey -l es,de -o templates/email/LANG templates/email/en

Yuqoridagi LANG ajratilgan so'z bo'lib, ISO til kodi bilan almashtiriladi

Yuqoridagilar bajarilganda nima bo'ladi:

templates/email/es va templates/email/de kataloglari yaratiladi (agar ular mavjud bo'lmasa)
templates/email/en har bir fayl ispan va nemis tillariga tarjima qilinadi
Mavjud chiqish fayllari -f / --force ishlatilmaguningizcha qayta tiklanmaydi.
Siz en ostida bo'lgani kabi es va de ichida bir xil katalog tuzilmasi va fayllarga ega en .

Boshqa variantlar

Quruq yugurish

Nima qilish kerakligini ko'rsatish uchun -n / --dry-run ni o'tkazing, lekin aslida hech qanday API qo'ng'iroqlarini qilmang yoki hech qanday fayl yozmang

Kuch

Tarjimalarni, hatto ular allaqachon mavjud boʻlsa ham, har doim qayta tiklash uchun -f / --force ” tugmalarini oʻtkazing

Moslik

Katalog rejimida ishlayotgan fayllarni qayta ishlashni cheklash uchun -m / --match ni o'tkazing

Siz har doim ham manba katalogingizdagi har bir faylni maqsadli katalogingizga tarjima qilishni xohlamasligingiz mumkin

-m / --match parametrining qiymati regexdir (qobiq iqtibos qoidalariga ehtiyot bo`ling!) qaysi fayllarni tarjima qilish kerak

Agar shubhangiz bo'lsa, qaysi fayllar tarjima qilinishini ko'rish uchun ushbu parametrni -n / --dry-run bilan birlashtira olasiz.

Istisno

Ba'zan -m juda ko'p fayllarga mos keladi. Aniq istisno qilish uchun -e / --excludes variantidan foydalaning aks holda mos keladigan fayllar

Siz bo'sh joylar bilan ajratilgan bir nechta regexlarni ro'yxatga olishingiz mumkin

Umumiy foydalanish: --excludes node_modules dist \.git build tmp

Tutqichlar

Tarjima qilinadigan satrlar ikki yoki uchta jingalak {{ handlebars }} shablonlarini o'z ichiga olishi mumkin.

Siz oʻsha andozalar ichidagi maʼlumotlar tarjima qilinishini istamaysiz

-H / --handlebars bayrog'ini o'tkazing va {{ ... }} ichidagi hech narsa tarjima qilinmaydi

Belgilanish

Markdown matn ham, html ham emas, shuning uchun Google Tarjimonda u bilan ba'zi qiyinchiliklar mavjud

-M / --markdown markdown fayllari uchun maxsus ishlov berish imkonini beradi

Markdown fayllari bilan " -M bayrog'idan foydalanmasangiz, ehtimol siz quyidagi muammolarni topasiz:

Buzilgan havolalar. Tarjimada belgilash havolasi tavsifi tugagandan so'ng bo'sh joy belgisi paydo bo'ladi ( ] bilan), lekin maqsadli havola boshlanishidan oldin ( ( ) bilan). Bu belgining notoʻgʻri koʻrsatilishiga olib keladi va havola hujjatni ko'rishda buziladi.
Kod bloklari tarjima qilinadi. Google tarjimoni markdown nima kod deb hisoblanishini va nima emasligini bilmaydi
Chiqib ketgan kod bloklari uchun noto'g'ri oraliq. Tarjimada intervallarni saqlash qiyin
" backticks " ichidagi narsalar deyarli har doim tom ma'noda bo'lishini xohlasangiz, tarjima qilinadi.

-M / --markdown bayrog'i yoqilganda:

]( naqsh ]( ]( qisqartiriladi, shu bilan buzilgan belgilash havolalarini tuzatadi.
"Tarjima qilinmagan" o'rami chuqurlashtirilgan kod bloklari atrofida joylashtiriladi, bu to'g'ri chekinishni saqlaydi va ular tarjima qilinmasligini ta'minlaydi.
"Tarjima qilinmagan" o'rami matnning tarjima qilinmasligiga ishonch hosil qilish uchun " backticks " ichidagi matn atrofida joylashtiriladi.

Jarayon sifatida

Odatda hamma narsa oddiy matn sifatida qayta ishlanadi

Agar kontentingiz HTML bo'lsa, -p html / --process-as html opsiyasidan o'tmasangiz, u buziladi.

Filtr

Sarguzashtlar uchun: katalogdagi fayllarni qayta ishlashda siz -F / --filter opsiyasidan o`tishingiz mumkin. chiqish fayl tizimiga yozilgunga qadar filtrlash uchun

Ushbu parametr qiymati filter nomli funksiyani eksport qiluvchi JS fayliga yoʻl boʻlishi kerak

" filter " funksiyasi " async " bo'lishi kerak, chunki u " await " ni chaqiradi

Fayllar diskka yozilishidan oldin butun fayl mazmuni " filter funksiyasiga satr sifatida uzatiladi.

" filter funktsiyasidan qaytariladigan qiymat aslida saqlashga yoziladigan narsadir

Shunday qilib, siz oxirida nima yozilishini to'liq nazorat qilasiz

" filter " skripti quyidagi joylarda qidiriladi (filtrga " .js " bilan qo'shiladi) nomi, agar u .js bilan tugamasa)

Joriy katalog
Joriy katalog ichidagi .hokey-filters nomli katalog
${HOME}/.hokey-filters , bu yerda ${HOME} joriy foydalanuvchining uy katalogi
O'rnatilgan filtrlar katalogi

Filtr parametrlari

" filter " qatori bir nechta so'zlardan iborat bo'lishi mumkin. Bunday holda, birinchi so'z filtr nomi va qolgan so'zlar " filter funksiyasiga argument sifatida uzatiladi

Yordam bering

Yordamni ko'rsatish uchun -h / --help dan foydalaning

JSON ommaviy buyruqlari

-j / --json opsiyasi bilan siz bir nechta muvofiqlashtirilgan hokey buyruqlarini bajarishingiz mumkin

An'anaga ko'ra, bu fayl " hokey.json " deb ataladi, lekin siz uni xohlaganingizcha nomlashingiz mumkin

Agar siz katalogni “-j” varianti sifatida hokey , “hokey” ushbu katalogdan “ -j ” ni hokey.json .

JSON faylida bitta ob'ekt bo'lishi kerak. Ushbu ob'ekt ichida uning mulk nomlari bir xil buyruq qatori parametrlari, shuningdek, " hokey " nomli qo'shimcha xususiyat

“ hokey ” xossasi bajariladigan buyruqlar majmuasidir. Ushbu buyruqlar ichida e'lon qilingan xususiyatlar bo'ladi tashqi ob'ektdagi har qanday takroriy deklaratsiyalarni bekor qilish.

" hokey " massividagi har bir ob'ekt ichida siz " name " va kirish va chiqish fayllarini belgilashingiz kerak.

Bu yerda “ hokey.json ” ga misol

{
    "inputLanguage": "en",
    "languages": "es,fr,ja", # can also be an array of strings
    "force": false,
    "match": null,
    "processAs": null,
    "excludes": ["exclude-1", "exclude-2"],
    "handlebars": false,
    "markdown": false,
    "regular": false,
    "dryRun": false,
    "filter": "theFilter.js",
    "hokey": [
      {
        "name": "locale names",
        "infile": "messages/locales_en.js",
        "outfile": "messages/locales_LANG.js",
        "handlebars": true
      },
      {
        "name": "CLI messages",
        "infile": "messages/en_messages.js",
        "outfile": "messages/LANG_messages.js",
        "handlebars": true
      },
      {
        "name": "README",
        "infile": "README.md",
        "outfile": "lang/LANG/",
        "excludes": ["lang/", "node_modules/", "\\.git/", "tmp/"],
        "filter": "relativizeMarkdownLinks lang",
        "markdown": true,
        "index": "lang/README.md"
      }
    ]
}

Bir nechta kirish fayllari

Ushbu misoldagi kabi bitta yo'l infile infiles o'rniga fayl yo'llari qatorini infiles sifatida o'tkazing:

{
  ... [
    {
      "name": "my docs",
      "infiles": ["README.md", "INSTALL.md", "TUTORIAL.md"],
      "outfile": "docs/LANG/",
      "markdown": true
  ]
}

indekslar

Ko'p tillarga tarjima qilishda " hokey " qilingan barcha tarjimalar ro'yxatini ko'rsatadigan indeks faylini yaratishi mumkin. va ularga havolalar beradi

Indekslarni yaratishda siz faqat bitta kirish manbasiga ega bo'lishingiz mumkin

-I / --index opsiyasini otkazing, qiymat indeks fayli yaratiladigan joy, bu fayl bolishi mumkin yoki katalog. Agar bu katalog bo'lsa, shablonga asoslangan standart fayl nomi ishlatiladi (pastga qarang)

Indeks chiqishi qanday formatlanganligini aniqlash uchun -A / --index-template foydalaning. Siz "html" ni belgilashingiz mumkin, 'markdown', 'matn' yoki o'zingizning HandlebarsJS shabloniga fayl yo'li

Agar siz o'zingizning shabloningizni belgilasangiz, -I / --index uchun faylni (katalog emas) ham ko'rsatishingiz kerak. variant

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylizatsiya

Buni boshqa tilda o'qing

📚 ... Barcha tillar ...

README tarjimasida muammo bormi?

Tarkib

Manba

Qo'llab-quvvatlash va moliyalashtirish

O'rnatish

Sozlash; o'rnatish

JavaScript string resurs faylini tarjima qilish

Matnli fayllar katalogini tarjima qilish

To'g'ri foydalanish

Boshqa variantlar

Quruq yugurish

Kuch

Moslik

Istisno

Tutqichlar

Belgilanish

Jarayon sifatida

Filtr

Filtr parametrlari

Yordam bering

JSON ommaviy buyruqlari

Bir nechta kirish fayllari

indekslar

Tillarni tarjima qilishdan zavqlaning!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylizatsiya

Buni boshqa tilda o'qing

📚 ... Barcha tillar ...

README tarjimasida muammo bormi?

Tarkib

Manba

Qo'llab-quvvatlash va moliyalashtirish

O'rnatish

Sozlash; o'rnatish

JavaScript string resurs faylini tarjima qilish

Matnli fayllar katalogini tarjima qilish

To'g'ri foydalanish

Boshqa variantlar

Quruq yugurish

Kuch

Moslik

Istisno

Tutqichlar

Belgilanish

Jarayon sifatida

Filtr

Filtr parametrlari

Yordam bering

JSON ommaviy buyruqlari

Bir nechta kirish fayllari

indekslar

Tillarni tarjima qilishdan zavqlaning!