Hokeylization

Napa aku ora bisa mbukak kabeh aplikasi utawa situs liwat Google Translate lan entuk terjemahan dhasar ing basa liya?

Saiki, sampeyan bisa!

Jeneng hokeylization minangka portmanteau, tegese 'lokalisasi hokey'

Iku rada hokey amarga prasaja banget: ngirim strings menyang Google Translate

Lan prasaja, nanging uga kuat banget. Nduwe dhukungan khusus kanggo dokumen HTML, HandlebarsJS cithakan, lan Markdown file.

Sampeyan bisa nerjemahake:

obyek JavaScript sing ngemot pesen
sawetara file utawa direktori, tansah ngliwati direktori kanthi rekursif

Waca iki ing basa liya

Dokumen README.md iki wis diterjemahake, nggunakake alat hokeylization dhewe, menyang saben basa didhukung Google Terjemahan!

Aku yakin ora sampurna, nanging muga-muga luwih apik tinimbang ora ana!

🇸🇦 Arab 🇧🇩 Bengali 🇩🇪 Jerman 🇺🇸 Inggris 🇪🇸 Spanyol 🇫🇷 Prancis 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Indonesia 🇮🇹 Italia 🇯🇵 Jepang 🇰🇷 Korea 🇮🇳 Marathi 🇵🇱 Polandia 🇧🇷 Portugis 🇷🇺 Rusia 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 Turki 🇵🇰 Urdu 🇻🇳 Vietnam 🇨🇳 Cina

📚 ... Kabeh Basa ...

Apa ana masalah karo terjemahan README iki?

Iki terjemahan khusus saka [README] asli (https://github.com/cobbzilla/hokeylization/blob/master/README.md) bisa uga ana cacat -- koreksi banget ditampa! Kirimi panyuwunan tarik ing GitHub, utawa yen sampeyan ora kepenak nglakoni, mbukak masalah

Nalika sampeyan nggawe masalah GitHub anyar babagan terjemahan, mangga tindakake:

kalebu URL kaca (salinan / tempel saka bilah alamat browser)
Lebokna teks pas sing salah (salin/tempel saka browser)
monggo katrangan apa sing salah -- apa terjemahane salah? format rusak piye wae?
nyuwun saran terjemahan sing luwih apik, utawa carane teks kudu diformat kanthi bener Matur nuwun!

Isi

Sumber
Dhukungan lan Pendanaan
Pasang
Setup
Nerjemahake file sumber daya string JavaScript
Nerjemahake direktori file teks
Opsi liyane
JSON batch printah

Sumber

hokeylization ing GitHub
hokeylization ing npm

Dhukungan lan Pendanaan

Aku nyoba dadi pangembang piranti lunak sumber terbuka profesional. Aku wis kerja ing industri lunak kanggo akèh taun, Aku wis miwiti perusahaan sukses lan didol menyang perusahaan umum. Bubar iki aku kelangan pegaweyan, lan aku ora duwe gaweyan liyane

Dadi aku bakal nyoba nulis piranti lunak sing migunani lan ndeleng manawa bisa digunakake

Yen sampeyan seneng nggunakake piranti lunak iki, Aku bakal dadi seneng nampa malah ing paling cilik kontribusi saben wulan liwat Patreon

Matur nuwun!

Instalasi

Kanggo nggunakake alat baris perintah, instal nggunakake npm utawa yarn :

npm install -g hokeylization
yarn global add hokeylization

Kanggo digunakake minangka perpustakaan, instal versi lite , sing luwih cilik:

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

Banjur goleki pitulung kanggo perintah hokey :

hokey --help
hokey -h

Pengin ndeleng output ing basa utawa basa liyane?

hokey nyoba ndeteksi basa kanthi otomatis saka variabel lingkungan cangkang sampeyan

Sampeyan bisa meksa basa kanthi nyetel variabel lingkungan LC_ALL :

LC_ALL=it hokey --help

Elinga yen sampeyan wis nginstal hokeylization-lite , bantuan printah mung kasedhiya ing basa Inggris

Setup

Setel variabel lingkungan GOOGLE_TRANSLATE_PROJECT_ID kanggo ngenali proyek Google Translate sampeyan

Setel variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS menyang kredensial JSON sing diundhuh sawise ngerteni cara otentikasi ing awan Google (bisa nyenengake)

Yen sampeyan mbukak saka kode sumber, sampeyan uga bisa nyelehake iki ing file .env ing sumber kasebut direktori bakal dimuat nalika runtime liwat dotenv

Nerjemahake file sumber string JavaScript

Tabel string kudu ana ing file JavaScript ing salah siji saka rong formulir iki:

Ekspor ES6:

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

Ekspor CommonJS

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

Yen file iki dijenengi myfile.en.js , sampeyan bisa nerjemahake menyang Spanyol lan Jerman nganggo:

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

LANG ing ndhuwur iku khusus - iki minangka tembung sing dilindhungi ing piranti iki!

LANG diganti karo kode basa kanggo file output

Mangkono printah ing ndhuwur nggawe file:

myfile.es.js
myfile.de.js

-l / --languages minangka dhaptar kode basa ISO sing dipisahake koma didhukung Google Terjemahan

Yen file output wis ana, bakal ditliti kanggo nemtokake kunci sing wis ana. Tombol sing ana ora bakal diterjemahake. Terjemahan kanggo kunci sing ilang bakal digawe lan ditambahake kanggo mburi obyek JS. Kabeh file tansah ditulis maneh.

Kanggo meksa terjemahan maneh kabeh tombol, gunakake -f / --force

Nerjemahake direktori file teks

Sampeyan uga bisa nerjemahake direktori file. hokeylization bakal recursively ngunjungi saben file ing direktori lan mbukak isine liwat Google Translate, lan simpen output menyang file kanthi jeneng sing padha ing wit direktori sing kapisah

Yen target terjemahan sampeyan yaiku direktori, mode iki diaktifake

-o / --outfile nemtokake direktori output

PÈNGET BESAR: Nalika nerjemahake direktori, Aja nemtokake direktori output sing ana ing direktori input sampeyan! Yen sampeyan nindakake iki, sampeyan bakal:

ngindhuksi rekursi tanpa wates
mbukak tagihan Google sampeyan
ngisi disk sampeyan *kurang seneng

Iki minangka conto * sing ora kudu ditindakake *:

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

Nalika iki mlaku, file terjemahan ditulis menyang templates/es , lan dadi anyar file sumber kanggo nerjemahake, amarga ana ing templates/ -- proses iki terus ing salawas-lawase, aja nglakoni!

Panggunaan sing bener

OK, umpamane sampeyan duwe sawetara template email ing direktori:

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

Kanggo nerjemahake kabeh iki menyang Spanyol lan Jerman, bukak:

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

Ing ndhuwur, LANG minangka tembung sing dilindhungi lan bakal diganti karo kode basa ISO

Apa sing kedadeyan nalika ndhuwur mlaku:

templates/email/es lan templates/email/de bakal digawe (yen ora ana)
Saben file ing templates/email/en bakal diterjemahake menyang Spanyol lan Jerman
File output sing ana ora bakal digawe maneh kajaba sampeyan nggunakake -f / --force
Sampeyan bakal entuk struktur direktori lan file sing padha ing es lan de kaya sing sampeyan duwe en

Pilihan liyane

Lari garing

Lulus -n / --dry-run kanggo nampilake apa sing bakal ditindakake, nanging aja nggawe panggilan API utawa nulis file apa wae

Paksa

-f / --force kanggo tansah ngasilake terjemahan, sanajan terjemahan kasebut wis ana

Cocokake

-m / --match kanggo mbatesi file sing diproses nalika mlaku ing mode direktori

Sampeyan bisa uga ora mesthi pengin nerjemahake saben file ing direktori sumber menyang direktori target

Nilai saka -m / --match yaiku regex (ati-ati aturan ngutip cangkang!) sing nemtokake file sing kudu diterjemahake

Yen ragu, sampeyan bisa gabungke pilihan iki karo -n / --dry-run kanggo ndeleng file sing bakal diterjemahake

Ora kalebu

Kadhangkala -m cocog karo akeh file. Gunakake -e / --excludes kanggo ngilangi kanthi jelas file sing digunakake bakal cocog

Sampeyan bisa dhaptar macem-macem regex, dipisahake kanthi spasi

Panggunaan umum yaiku: --excludes node_modules dist \.git build tmp

Setang

String sing arep diterjemahake bisa uga ngemot cithakan {{ handlebars }} , kanthi rong utawa telung kurung kriting.

Sampeyan mbokmenawa * ORA * pengin barang sing ana ing cithakan kasebut diterjemahake

Lewati gendéra -H / --handlebars , lan apa wae ing {{ ... }} ora bakal diterjemahake

Markdown

Markdown dudu teks utawa html, mula Google Translate duwe sawetara kesulitan

-M / --markdown mbisakake penanganan khusus kanggo file markdown

Kanthi file markdown, yen sampeyan ora nggunakake gendera -M , sampeyan bakal nemokake masalah iki:

Link rusak. Ing terjemahan, karakter spasi katon sawise deskripsi link markdown rampung (karo ] ) nanging sadurunge pranala target diwiwiti (karo ( ). Iki nyebabake markdown dadi salah, lan link rusak nalika ndeleng dokumen.
Blok kode diterjemahake. Google nerjemahake ora ngerti apa markdown dianggep kode lan apa ora
Spasi salah kanggo pamblokiran kode indented. Spasi angel dilestarekake ing terjemahan
Bab-bab backticks bakal diterjemahake, yen sampeyan pengin dadi nilai harfiah

Nalika -M / --markdown diaktifake:

Pola ]( bakal dikondensasi dadi ]( saéngga ndandani pranala markdown sing rusak
Bungkus "ora ana terjemahake" bakal diselehake ing saubengé blok kode indentasi, njaga indentasi sing tepat lan mesthekake yen ora diterjemahake
Bungkus "ora ana terjemahake" bakal diselehake ing sakubenge teks ing backticks kanggo mesthekake yen ora diterjemahake

Proses-minangka

Biasane kabeh diproses minangka teks biasa

Yen konten sampeyan HTML, bakal rusak kajaba sampeyan ngliwati -p html / --process-as html

Filter

Kanggo petualang: nalika ngolah file ing direktori, sampeyan bisa ngliwati pilihan -F / --filter kanggo nyaring output sadurunge ditulis menyang filesystem

Nilai pilihan iki kudu dadi path menyang file JS sing ngekspor fungsi sing jenenge filter

Fungsi filter kudu async amarga await bakal diarani

Sadurunge file ditulis menyang disk, kabeh isi file bakal diterusake menyang fungsi filter minangka string

Nilai bali saka fungsi filter yaiku apa sing bakal ditulis ing panyimpenan

Mangkono, sampeyan duwe kontrol total babagan apa sing bakal ditulis

Skrip filter bakal digoleki ing lokasi ing ngisor iki (karo .js bakal ditambahake menyang filter jeneng, kajaba wis dipungkasi nganggo .js )

Direktori saiki
Direktori sing jenenge .hokey-filters ing direktori saiki
Direktori ${HOME}/.hokey-filters , ing ngendi ${HOME} minangka direktori ngarep pangguna saiki
Dibangun ing direktori saringan

Parameter Filter

String filter bisa dadi pirang-pirang tembung. Ing kasus iki, tembung pisanan jeneng Filter, lan tembung sing isih ana bakal diterusake minangka argumen menyang fungsi filter

Bantuan

Gunakake -h / --help kanggo nuduhake pitulung

Prentah kumpulan JSON

Kanthi -j / --json , sampeyan bisa nglakokake sawetara perintah hokey

Miturut konvènsi berkas iki diarani hokey.json , nanging sampeyan bisa menehi jeneng apa wae sing dikarepake

Yen sampeyan ngliwati direktori minangka opsi -j,hokeybakal nggolekihokey.json` ing direktori kasebut

File JSON kudu ngemot siji obyek. Ing obyek kasebut, jeneng properti padha karo opsi baris printah, plus siji properti tambahan jenenge hokey

Properti hokey minangka susunan perintah sing kudu ditindakake. Properti sing diumumake ing printah kasebut bakal ngilangi deklarasi duplikat ing obyek njaba.

Ing saben obyek ing hokey , sampeyan kudu nemtokake name , lan file input lan output.

Punika conto hokey.json

{
    "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"
      }
    ]
}

Akeh file input

Lewati array path file minangka infiles tinimbang path infile , kaya ing conto iki:

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

Indeks

Nalika nerjemahake menyang akeh basa, hokey bisa nggawe file indeks sing nampilake kabeh terjemahan sing digawe lan menehi pranala menyang wong-wong mau

Nalika ngasilake indeks, sampeyan mung bisa duwe siji sumber input

Lewati opsi -I / --index , nilai kasebut ing ngendi file indeks bakal diasilake, sing bisa dadi file utawa direktori. Yen direktori, jeneng berkas standar bakal digunakake, adhedhasar cithakan (ndeleng ngisor)

Gunakake -A / --index-template kanggo nemtokake cara format output indeks. Sampeyan bisa nemtokake 'html', 'markdown', 'text', utawa path file menyang cithakan HandlebarsJS sampeyan dhewe

Yen sampeyan nemtokake cithakan sampeyan dhewe, sampeyan uga kudu nemtokake file (dudu direktori) kanggo -I / --index pilihan

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylization

Waca iki ing basa liya

📚 ... Kabeh Basa ...

Apa ana masalah karo terjemahan README iki?

Isi

Sumber

Dhukungan lan Pendanaan

Instalasi

Setup

Nerjemahake file sumber string JavaScript

Nerjemahake direktori file teks

Panggunaan sing bener

Pilihan liyane

Lari garing

Paksa

Cocokake

Ora kalebu

Setang

Markdown

Proses-minangka

Filter

Parameter Filter

Bantuan

Prentah kumpulan JSON

Akeh file input

Indeks

Seneng nerjemahake basa!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylization

Waca iki ing basa liya

📚 ... Kabeh Basa ...

Apa ana masalah karo terjemahan README iki?

Isi

Sumber

Dhukungan lan Pendanaan

Instalasi

Setup

Nerjemahake file sumber string JavaScript

Nerjemahake direktori file teks

Panggunaan sing bener

Pilihan liyane

Lari garing

Paksa

Cocokake

Ora kalebu

Setang

Markdown

Proses-minangka

Filter

Parameter Filter

Bantuan

Prentah kumpulan JSON

Akeh file input

Indeks

Seneng nerjemahake basa!