Hokeylization

Sei ndisingakwanisi kushandisa app yangu yese kana saiti kuburikidza neGoogle Translate kuti ndiwane shanduro yemumwe mutauro?

Zvino, unogona!

Zita rekuti hokeylization is a portmanteau, zvichireva kuti 'hokey localization'.

Yakati hokey nekuti iri nyore: inotumira tambo kuGoogle Translate

Uye iri nyore, asi ine simba kwazvo. Iine rutsigiro rwakakosha kune zvinyorwa zveHTML, HandlebarsJS zvidhori, uye Markdown mafaera.

Unogona kushandura:

chinhu cheJavaScript chine mameseji
chero nhamba yemafaira kana madhairekitori, anogara achiyambuka madhairekitori achidzokororwa

Verenga izvi mune mumwe mutauro

Gwaro iri README.md rakashandurwa, pachishandiswa hokeylization turusi pachayo, kupinda mitauro yese inotsigirwa neGoogle Translate!

Ndine chokwadi kuti haina kukwana, asi ndinovimba iri nani pane hapana!

🇸🇦 Arabic 🇧🇩 Chibengali 🇩🇪 ChiGerman 🇺🇸 Chirungu 🇪🇸 Spanish 🇫🇷 French 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Indonesian 🇮🇹 Italian 🇯🇵 Japanese 🇰🇷 Korean 🇮🇳 Marathi 🇵🇱 Polish 🇧🇷 Chiputukezi 🇷🇺 Russian 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 Turkish 🇵🇰 Urdu 🇻🇳 Vietnamese 🇨🇳 Chinese

📚 ... Mitauro Yose ...

Pane dambudziko here neshanduro iyi yeREADME?

Iyi chaiyo shanduro yepakutanga README inogona kunge isina kukanganisa -- kugadzirisa kunogamuchirwa! Ndokumbira utumire kudhonza chikumbiro paGitHub, kana kuti kana usina kusununguka kuita izvozvo, vhura nyaya

Kana iwe ukagadzira itsva GitHub nyaya nezve dudziro, ndapota ita:

sanganisira iyo URL peji (kopi/namira kubva kubrowser kero bar)
sanganisira iwo chaiwo mameseji asiri iwo (kopi/namira kubva kubrowser)
ndapota tsanangura kuti chii chakaipa -- shanduro haina kururama here? iyo fomati yakatyoka neimwe nzira?
nemutsa ipa zano reshanduro iri nani, kana kuti mashoko acho anofanira kurongwa zvakanaka sei
Ndatenda!

Zviri mukati

Kwakabva
Kutsigira uye Mari
Kuiswa
Setup
Kushandura faira renziyo yeJavaScript
Kushandura dhairekitori remafaira ezvinyorwa
Dzimwe sarudzo
JSON batch commands

Source

hokeylization paGitHub
hokeylization pa npm

Tsigiro uye Mari

Ndiri kuyedza kuve nyanzvi yakavhurika sosi software yekuvandudza. Ndanga ndichishanda mu indasitiri yemasoftware kwemakore mazhinji, ndakatanga makambani akabudirira uye ndikaatengesa kumakambani eruzhinji. Munguva ichangopfuura ndakarasikirwa nebasa rangu, uye handina chaizvoizvo rimwe basa ripi neripi rakarongwa

Saka ndichaedza kunyora software inobatsira uye kuona kana izvo zvinoshanda

Kana iwe uchinakidzwa nekushandisa iyi software, ndingafara kwazvo kugamuchira kunyange iyo diki mupiro wepamwedzi nePatreon

Ndatenda!

Kuiswa

Kuti ushandise chirairo chekuraira, isa uchishandisa npm kana yarn :

npm install -g hokeylization
yarn global add hokeylization

Kuti ushandise seraibhurari, isa iyo lite , iyo idiki kwazvo:

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

Wobva watarisa rubatsiro hokey command:

hokey --help
hokey -h

Unoda kuona kubuda mumutauro wako kana mumwe mutauro?

hokey inoedza kuona mutauro wacho kubva kumamiriro ekunze egoko rako

Iwe unogona kumanikidza mutauro nekuisa iyo LC_ALL nharaunda shanduko:

LC_ALL=it hokey --help

Ziva kuti kana wakaisa hokeylization-lite , command help inowanikwa muChirungu chete

Gadzirira

Seta GOOGLE_TRANSLATE_PROJECT_ID shanduko yemamiriro ekunze kuti uone chirongwa chako cheGoogle Translate

Seta GOOGLE_APPLICATION_CREDENTIALS shanduko yemamiriro ekunze kuti uenderane nemagwaro eJSON awadhaunirodha. mushure mekufungidzira kuti chokwadi chinoshanda sei paGoogle gore (zvinogona kunakidza)

Kana uchimhanya kubva kusource code, unokwanisawo kuisa izvi mu .env faira mutsime dhairekitori ichaiswa panguva yekumhanya kuburikidza nedotenv

Kushandura faira reJavaScript tambo

Tafura yako yetambo ** inofanira kunge iri muJavaScript faira mune imwe yeaya mafomu maviri:

ES6 kutumira kunze kwenyika:

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

CommonJS kunze kwenyika

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

Kana faira iri rakanzi myfile.en.js , unogona kurishandura kuchiSpanish nechiGerman ne:

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

Iyo LANG iri pamusoro yakakosha - ishoko rakachengetwa muchishandiso ichi!

Iyo LANG inotsiviwa nekodhi yemutauro yemafaira ekubuda

Saka murairo uri pamusoro unogadzira mafaira:

myfile.es.js
myfile.de.js

Iyo -l / --languages sarudzo ndeye yakapatsanurwa nemakoma runyorwa rwe ISO mutauro macode. inotsigirwa neGoogle Translate

Kana iyo yakabuda faira yatovepo, inozoongororwa kuona kuti ndeapi makiyi aripo. Makiyi aripo haashandurwe. Shanduro dzemakiyi asipo dzichagadzirwa dzowedzerwa kusvika kumagumo echinhu cheJS. Iyo faira yese inogara ichinyorwa patsva.

Kumanikidza kududzirazve makiyi ese, shandisa iyo -f / --force sarudzo

Kushandura dhairekitori remavara mafaira

Unogonawo kushandura dhairekitori remafaira. hokeylization ichadzokorora kushanyira yega yega faira mudhairekitori uye womhanyisa zvirimo kuburikidza neGoogle Translate, uye chengetedza zvabuda kune faira rakafanana rine zita mune yakaparadzana dhairekitori muti

Kana chinangwa cheshanduro yako chiri dhairekitori, modhi iyi inobatidzwa

Iyo -o / --outfile sarudzo inotsanangura yakabuda dhairekitori

** YAKAMBIRO YAKURU**: Pakushandura madhairekitori, USAITA tsanangura dhairekitori rinobuda iri mukati medhairekitori rako rekuisa! Kana ukaita izvi, iwe ucha:

kurudzira kudzokorora kusingagumi
mhanyisa bhiri rako reGoogle
Zadza dhisiki yako
kunakidzwa zvishoma

Heino muenzaniso wezvisingaite *:

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

Kana izvi zvaita, mafaera akaturikirwa anonyorwa ku templates/es , zvobva zvaita zvitsva kunobva mafaera ekushandura, sezvo ari pasi pe templates/ -- maitiro aya anoenderera mberi nokusingaperi, usazviita!

Kushandiswa chaiko

Zvakanaka, ngatiti une mamwe matemplate eemail mune dhairekitori:

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

Kuturikira zvese izvi kuchiSpanish nechiGerman, mhanya:

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

Mune zviri pamusoro, LANG ishoko rakachengetwa uye richatsiviwa neiyo ISO mutauro kodhi

Chii chinoitika kana zviri pamusoro apa zvinomhanya:

Iwo templates/email/es uye templates/email/de achagadzirwa (kana asipo)
Yese faira mu templates/email/en ichashandurirwa kuSpanish neGerman
Mafaira aripo anobuda haagadzirwe kunze kwekunge washandisa -f / --force
Iwe unozopedzisira uine yakafanana dhairekitori chimiro uye mafaera mukati me es uye de pasi pe en

Dzimwe sarudzo

Dry run

Pfuura -n / --dry-run kuratidza zvaizoitwa, asi usaite chero maAPI mafoni kana kunyora chero mafaera.

Simba

Pfuura -f / --force kuti ugare uchivandudza shanduro, kunyange dzagara dziriko

Match

Pfuura -m / --match kana achimhanya mudhairekitori-modhi

Iwe haugone kugara uchida kududzira ese faira mune yako sosi dhairekitori kune yako yaunoda dhairekitori

Kukosha kweiyo -m / --match sarudzo ndeye regex (chenjererai goko rekutaura mitemo!) inotsanangura mafaira api anofanira kushandurwa

Kana usina chokwadi, unogona kusanganisa sarudzo iyi ne -n / --dry-run kuti uone mafaera angashandurwa.

Hazvibatanidzi

Dzimwe nguva -m inofananidzira mafaera akawandisa. Shandisa iyo -e / --excludes sarudzo yekusabvisa zvakajeka mafaira angadai akaenderana

Iwe unogona kunyora akawanda regexes, akaparadzaniswa nenzvimbo

Kushandiswa kwakajairika kungave: --excludes node_modules dist \.git build tmp

Handlebars

Tambo dzekushandura dzinogona kunge dziine {{ handlebars }} matemplate, ane maviri kana matatu akamonana-brace

Iwe unogona kunge HAUDI unoda kuti zvinhu zviri mukati mematemplate iwayo zvishandurwe

Pfuura -H / --handlebars mureza, uye chero chiri mukati me {{ ... }} hachizoshandurirwe

Markdown

Markdown haisi mavara kana html, saka Google Translate ine zvimwe zvinonetsa nazvo

Iyo -M / --markdown mureza inogonesa yakakosha kubata kwemafaera ekumaka

Nemafaera ekumaka, kana -M mureza, ungangowana aya matambudziko:

Zvisungo zvakaputsika. Mushanduro, mavara emuchadenga anooneka mushure mekunge tsananguro yelinkdown yapera (ne ] ) asi pamberi pekuti chinongedzo chayo chisati chatanga (ne ( ). yakaputsika pakuona gwaro.
Mabhuroki ekodhi anoshandurwa. Google kuturikira haizive kuti chiratidzo chinotariswa sei nekodhi uye zvachisingazive
Nzvimbo isiriyo yemabhuraki ekodhi. Kupatsanura kwakaoma kuchengetedza mukududzira
Zvinhu zviri mukati me backticks zvinoshandurwa, kana iwe uchinge wagara uchida kuti zvive chaizvo zvakakosha

Kana iyo -M / --markdown mureza inogoneswa:

Iyo pateni ]( ichapfupikiswa kuita ]( nokudaro kugadzirisa akatyoka mamakidown link
A "hapana dudziro" wrapper ichaiswa yakatenderedza indented code block, inochengetedza indentation chaiyo uye nekuona kuti haina kududzirwa.
Kapetera ka "hapana kuturikira" ichaiswa mukati memashoko mukati me backticks kuti zvionekwe kuti haashandurwe

Maitiro-se

Kazhinji zvinhu zvese zvinogadziriswa semavara akajeka

Kana zvirimo zviri HTML, zvinozonetsa kunze kwekunge wapfuura iyo -p html / --process-as html sarudzo.

Sefa

Kune iyo inodakadza: kana uchigadzira mafaera mudhairekitori, unogona kupfuura iyo -F / --filter sarudzo. kusefa zvinobuda zvisati zvanyorwa kune iyo filesystem

Kukosha kweiyi sarudzo inofanira kunge iri nzira yeJS faira inotumira kunze basa rakanzi filter

The filter basa rinofanira kuva async nekuti await pairi

Mafaira asati anyorwa kudhisiki, zvese zviri mukati mefaira zvichapfuudzwa kune filter basa setambo

Iko kukosha kwekudzoka kubva ku filter basa ndiyo inozonyorwa kudura

Nokudaro, une simba rose pane zvichazonyorwa pakupedzisira

filter achatsvakwa munzvimbo dzinotevera (ine .js zita, kunze kwekunge zvatopera muna .js )

Iyo yazvino dhairekitori
Dhairekitori rine zita .hokey-filters mukati medhairekitori razvino
Dhairekitori rine zita ${HOME}/.hokey-filters , uko ${HOME} ndiro dhairekitori remusha remushandisi
Iyo yakavakirwa-mukati mafirita dhairekitori

Sefa Parameters

filter inogona kuva mazwi akawanda. Muchiitiko ichi, izwi rekutanga ndiro zita resefa, uye mazwi asara achapfuudzwa senharo ku filter basa

Batsira

Shandisa -h / --help kuratidza rubatsiro

JSON batch mirairo

Neyo -j / --json sarudzo, unogona kumhanya akawanda akarongeka hokey mirairo.

Nekusangana faira iri rinonzi hokey.json , asi unogona kuripa chero chaunoda

Kana ukapasa dhairekitori sekuti -j sarudzo, hokey hokey.json iroro.

Iyo JSON faira inofanira kunge iine chinhu chimwe chete. Mukati mechinhu ichocho, mazita ayo epfuma akafanana ne iyo yekuraira-mutsara sarudzo, pamwe neimwe yekuwedzera pfuma inonzi hokey

Iyo hokey pfuma ine hurongwa hwemirairo yekumhanya. Zvinhu zvakaziviswa mukati memirairo iyi zvichave pfuura chero duplicate zvirevo muchinhu chekunze.

Mukati mechinhu chimwe nechimwe chiri mu hokey array, iwe unofanirwa kutsanangura name , uye yekuisa uye inobuda mafaera.

Heino muenzaniso we 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"
      }
    ]
}

Mafaira ekuisa akawanda

Pfuura nzira dzemafaira se infiles pachinzvimbo cheimwe nzira infile , semumuenzaniso uyu:

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

Indexes

Kana uchiturikira kumitauro yakawanda, hokey inogona kugadzira index file inonyora shanduro dzese dzakaitwa uye inopa zvinongedzo kwavari

Paunenge uchigadzira indexes, unogona kuva negiyo imwe chete yekupinza

Pfuura iyo -I / --index sarudzo, kukosha ndiko kuchagadzirwa iyo index file, inogona kunge iri faira. kana dhairekitori. Kana iri dhairekitori, zita refaira rekutanga richashandiswa, zvichibva pane template (ona pazasi)

Shandisa iyo -A / --index-template kuona kuti index inobuda yakarongwa sei. Unogona kutsanangura 'html', 'markdown', 'text', kana nzira yefaira kune yako HandlebarsJS template

Kana iwe ukatsanangura yako template, iwe unofanirwawo kutsanangura faira (kwete dhairekitori) ye -I / --index sarudzo

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylization

Verenga izvi mune mumwe mutauro

📚 ... Mitauro Yose ...

Pane dambudziko here neshanduro iyi yeREADME?

Zviri mukati

Source

Tsigiro uye Mari

Kuiswa

Gadzirira

Kushandura faira reJavaScript tambo

Kushandura dhairekitori remavara mafaira

Kushandiswa chaiko

Dzimwe sarudzo

Dry run

Simba

Match

Hazvibatanidzi

Handlebars

Markdown

Maitiro-se

Sefa

Sefa Parameters

Batsira

JSON batch mirairo

Mafaira ekuisa akawanda

Indexes

Iva nenguva inonakidza kushandura mitauro!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylization

Verenga izvi mune mumwe mutauro

📚 ... Mitauro Yose ...

Pane dambudziko here neshanduro iyi yeREADME?

Zviri mukati

Source

Tsigiro uye Mari

Kuiswa

Gadzirira

Kushandura faira reJavaScript tambo

Kushandura dhairekitori remavara mafaira

Kushandiswa chaiko

Dzimwe sarudzo

Dry run

Simba

Match

Hazvibatanidzi

Handlebars

Markdown

Maitiro-se

Sefa

Sefa Parameters

Batsira

JSON batch mirairo

Mafaira ekuisa akawanda

Indexes

Iva nenguva inonakidza kushandura mitauro!