Hokeylization

Poukisa mwen pa ka kouri tout aplikasyon mwen an oswa sit mwen an atravè Google Translate epi jwenn yon tradiksyon debaz nan yon lòt lang?

Kounye a, ou kapab!

Non hokeylization se yon pòtay, ki vle di 'lokalizasyon hokey'.

Li se yon ti jan hokey paske li trè senp: li voye fisèl nan Google Translate

Epi li se senp, men tou trè pwisan. Li gen sipò espesyal pou dokiman HTML, HandlebarsJS modèl, ak Markdown dosye.

Ou ka tradui:

yon objè JavaScript ki gen mesaj
nenpòt ki kantite fichye oswa anyè, toujou travèse repèrtwar rekursif

Li sa nan yon lòt lang

Dokiman README.md sa a te tradui, lè l sèvi avèk zouti nan hokeylization tèt li, nan chak lang Google Translate sipòte!

Mwen sèten li pa pafè, men mwen espere ke li pi bon pase anyen!

🇸🇦 Arabe 🇧🇩 Bengali 🇩🇪 Alman 🇺🇸 Angle 🇪🇸 Panyòl 🇫🇷 Franse 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Endonezyen 🇮🇹 Italyen 🇯🇵 Japonè 🇰🇷 Koreyen 🇮🇳 Marathi 🇵🇱 Polonè 🇧🇷 Pòtigè 🇷🇺 Ris 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 Tik 🇵🇰 Oudou 🇻🇳 Vietnamese 🇨🇳 Chinwa

📚 ... Tout Lang ...

Èske gen yon pwoblèm ak tradiksyon README sa a?

Tradiksyon patikilye sa a orijinal README ka gen defo -- koreksyon yo trè akeyi! Tanpri voye yon pull demand sou GitHub, oswa si w pa konfòtab pou w fè sa, louvri yon pwoblèm

Lè ou kreye yon nouvo pwoblèm GitHub sou yon tradiksyon, tanpri fè:

enkli URL paj la (kopi/kole nan ba adrès navigatè a)
enkli tèks egzak ki mal (kopi/kole nan navigatè a)
Tanpri dekri sa ki mal -- èske tradiksyon an pa kòrèk? se fòma a kase yon jan kanmenm?
Tanpri ofri yon sijesyon pou yon pi bon tradiksyon, oswa ki jan tèks la ta dwe byen fòma
Mèsi!

Kontni

Sous
Sipò ak Finansman
Enstalasyon
Enstalasyon
Tradui yon fichye resous JavaScript
Tradui yon anyè dosye tèks
Lòt opsyon
JSON pakèt kòmandman

Sous

hokeylization sou GitHub
hokeylization sou npm

Sipò ak Finansman

Mwen eseye vin yon pwofesyonèl devlopè lojisyèl sous louvri. Mwen te travay nan endistri a lojisyèl pou anpil ane, mwen te kòmanse konpayi siksè ak vann yo bay konpayi piblik yo. Dènyèman mwen pèdi travay mwen, e mwen pa vrèman gen okenn lòt travay ki aliye

Se konsa, mwen pral eseye ekri lojisyèl itil epi wè si sa ap travay

Si ou renmen itilize lojisyèl sa a, mwen ta kontan pou resevwa menm a pi piti kontribisyon chak mwa atravè Patreon

Mèsi!

Enstalasyon

Pou itilize zouti liy lòd la, enstale lè l sèvi avèk npm oswa yarn :

npm install -g hokeylization
yarn global add hokeylization

Pou itilize kòm yon bibliyotèk, enstale vèsyon lite , ki pi piti anpil:

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

Lè sa a, gade èd pou kòmand hokey :

hokey --help
hokey -h

Ou vle wè pwodiksyon nan lang ou oswa nan yon lòt lang?

hokey eseye detekte lang nan otomatikman nan varyab anviwònman koki ou a

Ou ka fòse yon lang lè w mete varyab anviwònman LC_ALL :

LC_ALL=it hokey --help

Remake byen ke si ou te enstale hokeylization-lite , èd kòmand disponib sèlman nan lang angle

Enstalasyon

Mete varyab anviwònman GOOGLE_TRANSLATE_PROJECT_ID pou idantifye pwojè Google Translate ou a.

Mete varyab anviwònman GOOGLE_APPLICATION_CREDENTIALS sou kalifikasyon JSON ou telechaje yo. apre w fin chèche konnen ki jan otantifikasyon travay sou Google nwaj (li ka amizan)

Si w ap kouri soti nan kòd sous la, ou kapab tou mete sa yo nan yon dosye .env nan sous la anyè yo pral chaje nan kouri atravè dotenv

Tradiksyon yon fichye resous JavaScript

Tablo kòd ou a dwe nan yon fichye JavaScript nan youn nan de fòm sa yo:

Ekspòtasyon ES6:

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

Ekspòtasyon CommonJS

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

Si yo te rele fichye sa a myfile.en.js , ou ka tradui l an panyòl ak alman avèk:

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

LANG nan pi wo a se espesyal - se yon mo rezève nan zouti sa a!

LANG ranplase ak kòd lang pou fichye pwodiksyon yo

Kidonk, kòmandman ki anwo a kreye dosye yo:

myfile.es.js
myfile.de.js

Opsyon -l / --languages se yon lis kòd ISO ki separe ak vigil. sipòte pa Google Translate

Si fichye pwodiksyon an deja egziste, li pral egzamine pou detèmine ki kle ki deja egziste. Kle ki egziste deja p ap tradui. Tradiksyon pou kle ki manke yo pral pwodwi epi ajoute nan fen objè JS la. Tout fichye a toujou reekri.

Pou fòse retradiksyon tout kle yo, sèvi ak -f / --force

Tradiksyon yon anyè dosye tèks

Ou ka tradui tou yon anyè dosye. hokeylization pral recursively vizite chak dosye nan anyè a epi kouri sa ki ladan l nan Google Translate, epi sove pwodiksyon an nan yon fichye ki gen menm non nan yon pye bwa anyè separe

Lè sib tradiksyon ou a se yon anyè, mòd sa a aktive

Opsyon -o / --outfile presize anyè pwodiksyon an

GWO AVÈTISMAN: Lè wap tradui anyè, PA espesifye yon anyè pwodiksyon. sa se nan anyè D' ou! Si w fè sa, w ap:

pwovoke repetisyon enfini
monte bòdwo Google ou a
ranpli disk ou a
gen mwens plezi

Men yon egzanp kisa pa fè:

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

Lè sa a kouri, dosye tradui yo ekri nan templates/es , epi konsa vin nouvo fichye sous yo tradui, paske yo anba templates/ -- pwosesis sa a ap kontinye pou tout tan, pa fè li!

Itilizasyon kòrèk

OK, an n di ou gen kèk modèl imèl nan yon anyè:

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

Pou tradui tout bagay sa yo an Panyòl ak Alman, kouri:

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

Nan pi wo a, LANG se yon mo rezève epi yo pral ranplase ak kòd lang ISO

Kisa k ap pase lè pi wo a kouri:

templates/email/es ak templates/email/de yo pral kreye (si yo pa egziste)
Chak fichye nan templates/email/en pral tradui nan Panyòl ak Alman
Fichye pwodiksyon ki deja egziste yo p ap rejenere sof si ou itilize -f / --force
Ou pral fini ak yon estrikti anyè ki idantik ak dosye nan es ak de tankou ou genyen anba en

Lòt opsyon

Kouri sèch

Pase -n / --dry-run pou montre sa ki ta dwe fè, men pa aktyèlman fè okenn apèl API oswa ekri okenn dosye.

Fòs

Pase -f / --force pou toujou rejenere tradiksyon, menm si yo deja egziste

Koresponn ak

Pase -m / --match pou limite dosye yo trete lè yo ap kouri nan mòd anyè

Ou ka pa toujou vle tradui chak fichye nan anyè sous ou a nan anyè sib ou

Valè opsyon -m / --match la se yon regex (fè atansyon sou règleman pou site kokiy!) ki presize ki fichye yo ta dwe tradui

Lè w gen dout, ou ka konbine opsyon sa a ak -n / --dry-run pou wè ki fichye yo ta tradui

Ekskli

Pafwa -m ou a matche ak twòp fichye. Sèvi ak -e / --excludes pou ekskli klèman dosye ki otreman ta matche

Ou ka lis plizyè regex, separe pa espas

Yon itilizasyon komen ta dwe: --excludes node_modules dist \.git build tmp

Guidon

Fisèl pou tradui yo ta ka genyen modèl {{ handlebars }} , swa ak de oswa twa atèl.

Ou pwobableman PA vle bagay ki anndan modèl sa yo tradui

Pase -H / --handlebars , epi nenpòt bagay ki nan {{ ... }} pa pral tradui

Markdown

Markdown pa ni tèks ni html, kidonk Google Translate gen kèk difikilte ak li

Drapo a -M / --markdown pèmèt manyen espesyal pou dosye markdown yo

Avèk dosye markdown, si ou pa sèvi ak drapo -M , ou pral pwobableman jwenn pwoblèm sa yo:

Lyen kase. Nan tradiksyon an, yon karaktè espas parèt apre yon deskripsyon lyen markdown fini (ak ] ) men anvan lyen sib li a kòmanse (avèk ( ). Sa lakòz markdown la rann mal, epi lyen an). kase lè w ap gade dokiman an.
Blòk kòd jwenn tradui. Google translate pa konnen kisa markdown konsidere kòm kòd ak sa li pa konnen
Espas ki pa kòrèk pou blòk kòd indentated. Espas difisil pou konsève nan tradiksyon
Bagay ki andedan backticks yo pral tradui, lè ou prèske toujou vle yo dwe valè literal

Lè -M / --markdown aktive:

Modèl la ]( pral kondanse nan ]( konsa ranje lyen markdown ki kase yo
Y ap mete yon anvlòp "pa gen okenn tradiksyon" ozalantou blòk kòd indentated, prezève endentasyon apwopriye epi asire yo pa tradui.
Yo pral mete yon anvlòp "pa gen okenn tradiksyon" alantou tèks nan backticks pou asire yo pa tradui yo.

Pwosesis-kòm

Nòmalman tout bagay trete kòm tèks klè

Si kontni ou a se HTML, li pral detwi sòf si ou pase opsyon -p html / --process-as html

Filtre

Pou moun ki aventuriers: lè w ap trete fichye yo nan yon anyè, ou ka pase -F / --filter pou filtre pwodiksyon an anvan li ekri nan sistèm fichye a

Valè opsyon sa a dwe yon chemen nan yon dosye JS ki ekspòte yon fonksyon ki rele filter

Fonksyon filter dwe async paske await pral rele sou li

Anvan yo ekri fichye yo sou disk, tout sa ki nan dosye yo pral pase nan fonksyon filter kòm yon kòd.

Valè retounen nan fonksyon filter se sa ki pral aktyèlman ekri nan depo

Kidonk, ou gen total kontwòl sou sa ki pral finalman ekri

Y ap chèche script filter nan kote sa yo (yo pral ajoute .js nan filtè a non, sof si li deja fini an .js )

Anyè aktyèl la
Yon anyè ki rele .hokey-filters nan anyè aktyèl la
Yon anyè ki rele ${HOME}/.hokey-filters , kote ${HOME} se anyè lakay itilizatè aktyèl la.
Bati-an anyè filtè

Filtre paramèt

filter kapab plizyè mo. Nan ka sa a, premye mo a se non filtre a, ak mo ki rete yo pral pase kòm agiman nan fonksyon filter

Ede

Sèvi ak -h / --help pou montre èd

Kòmandman pakèt JSON

Avèk -j / --json , ou ka kouri plizyè hokey kowòdone.

Dapre konvansyon, yo rele fichye sa a hokey.json , men ou ka bay non li nenpòt sa ou vle

Si ou pase yon anyè kòm opsyon -j,hokeyap chèche yonhokey.json` nan anyè sa a.

Fichye JSON a ta dwe genyen yon sèl objè. Nan objè sa a, non pwopriyete li yo se menm jan ak opsyon liy kòmand yo, plis yon pwopriyete adisyonèl ki rele hokey

Pwopriyete hokey se yon seri kòmandman pou kouri. Pwopriyete yo te deklare nan kòmandman sa yo pral pase sou nenpòt deklarasyon kopi nan objè a deyò.

Nan chak objè nan etalaj hokey , ou ta dwe presize yon name , ak dosye yo antre ak pwodiksyon.

Men yon egzanp yon 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"
      }
    ]
}

Plizyè dosye antre

Pase yon seri chemen dosye kòm infiles olye de yon sèl chemen infile , tankou nan egzanp sa a:

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

Endis

Lè wap tradui nan plizyè lang, hokey ka kreye yon fichye endèks ki bay lis tout tradiksyon yo te fè. epi li bay lyen pou yo

Lè w ap jenere endèks, ou ka gen yon sèl sous antre

Pase -I / --index , valè a se kote dosye endèks la pral pwodwi, ki ka yon dosye oswa yon anyè. Si se yon anyè, yo pral itilize yon non fichye default, ki baze sou modèl la (gade anba a)

Sèvi ak -A / --index-template pou detèmine kijan pwodiksyon endèks la fòme. Ou ka presize 'html', 'markdown', 'tèks', oswa chemen dosye a nan pwòp modèl HandlebarsJS ou

Si ou presize pwòp modèl ou a, ou dwe tou presize yon fichye (pa yon anyè) pou -I / --index opsyon

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylization

Li sa nan yon lòt lang

📚 ... Tout Lang ...

Èske gen yon pwoblèm ak tradiksyon README sa a?

Kontni

Sous

Sipò ak Finansman

Enstalasyon

Enstalasyon

Tradiksyon yon fichye resous JavaScript

Tradiksyon yon anyè dosye tèks

Itilizasyon kòrèk

Lòt opsyon

Kouri sèch

Fòs

Koresponn ak

Ekskli

Guidon

Markdown

Pwosesis-kòm

Filtre

Filtre paramèt

Ede

Kòmandman pakèt JSON

Plizyè dosye antre

Endis

Pran yon tan amizan tradui lang yo!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylization

Li sa nan yon lòt lang

📚 ... Tout Lang ...

Èske gen yon pwoblèm ak tradiksyon README sa a?

Kontni

Sous

Sipò ak Finansman

Enstalasyon

Enstalasyon

Tradiksyon yon fichye resous JavaScript

Tradiksyon yon anyè dosye tèks

Itilizasyon kòrèk

Lòt opsyon

Kouri sèch

Fòs

Koresponn ak

Ekskli

Guidon

Markdown

Pwosesis-kòm

Filtre

Filtre paramèt

Ede

Kòmandman pakèt JSON

Plizyè dosye antre

Endis

Pran yon tan amizan tradui lang yo!