Hokeylization

Chifukwa chiyani sindingathe kugwiritsa ntchito pulogalamu yanga yonse kapena tsamba lanu kudzera mu Zomasulira za Google ndikupeza zomasulira m'chinenero china?

Tsopano, mungathe!

Dzina lakuti hokeylization ndi portmanteau, kutanthauza "hokey localization"

Ndizosavuta chifukwa ndizosavuta: zimatumiza zingwe ku Zomasulira za Google

Ndipo ndi yosavuta, komanso yamphamvu kwambiri. Ili ndi chithandizo chapadera cha zolemba za HTML, HandlebarsJS zithunzi, ndi Markdown mafayilo.

Mutha kumasulira:

chinthu cha JavaScript chokhala ndi mauthenga
Mafayilo angapo kapena maulalo, omwe amayenda mobwerezabwereza

Werengani izi muchilankhulo china

Chikalata cha README.md chamasuliridwa, pogwiritsa ntchito chida cha hokeylization, kukhala chinenero chilichonse chimathandizidwa ndi Zomasulira za Google!

Ndikutsimikiza kuti sizabwino, koma ndikukhulupirira kuti nzabwino kuposa chilichonse!

🇸🇦 Chiarabu 🇧🇩 Bengali 🇩🇪 Chijeremani 🇺🇸 Chingerezi 🇪🇸 Chisipanishi 🇫🇷 Chifulenchi 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Chiindoneziya 🇮🇹 Chiitaliya 🇯🇵 Japanese 🇰🇷 Chikorea 🇮🇳 Marathi 🇵🇱 Chipolishi 🇧🇷 Chipwitikizi 🇷🇺 Russian 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 Turkish 🇵🇰 Urdu 🇻🇳 Vietnamese 🇨🇳 Chinese

📚 ... Zinenero Zonse ...

Kodi pali vuto ndi kumasulira kumeneku kwa README?

Kumasulira kwenikweniku README zitha kukhala zolakwika -- zokonza ndizolandiridwa! Chonde tumizani koka pempho pa GitHub, kapena ngati simumasuka kuchita zimenezo, tsegulani nkhani

Mukapanga nkhani yatsopano ya GitHub yokhudza kumasulira, chonde chitani:

Phatikizani ulalo watsamba (koperani / kumata kuchokera pa adilesi ya msakatuli)
Phatikizani zomwe zili zolakwika (koperani/mata kuchokera pa msakatuli)
chonde fotokozani chomwe chalakwika -- kodi kumasulira kwake ndikolakwika? Kodi masanjidwewo awonongeka mwanjira ina?
perekani mokoma mtima lingaliro la kumasulira kwabwinoko, kapena mmene malembawo ayenera kusanjidwira bwino
Zikomo!

Zamkatimu

Gwero
Thandizo ndi Ndalama
Kuyika
Kukhazikitsa
Kumasulira fayilo yachingwe cha JavaScript
Kumasulira chikwatu cha mafayilo amawu
[Njira zina](#Njira Zina)
Malamulo a gulu la JSON

Gwero

hokeylization pa GitHub
hokeylization pa npm

Thandizo ndi Ndalama

Ndikuyesera kukhala katswiri wopanga mapulogalamu otseguka. Ndakhala ndikugwira ntchito ku makampani opanga mapulogalamu kwa zaka zambiri, ndayambitsa makampani opambana ndikugulitsa kumakampani aboma. Posachedwapa ndinachotsedwa ntchito, ndipo ndilibe ntchito ina iliyonse yotsatizana

Chifukwa chake ndiyesera kulemba mapulogalamu othandiza ndikuwona ngati izi zikugwira ntchito

Ngati mumakonda kugwiritsa ntchito pulogalamuyo, ndingakhale wokondwa kulandira ngakhale zing'onozing'ono zopereka pamwezi kudzera pa Patreon

Zikomo!

Kukhazikitsa

Kuti mugwiritse ntchito chida cha mzere wolamula, yikani kugwiritsa ntchito npm kapena yarn :

npm install -g hokeylization
yarn global add hokeylization

Kuti mugwiritse ntchito ngati laibulale, yikani mtundu wa lite , womwe ndi wocheperako:

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

Kenako yang'anani thandizo la lamulo la hokey :

hokey --help
hokey -h

Mukufuna kuwona zotuluka mu chilankhulo chanu kapena chilankhulo china?

hokey amayesa kuzindikira chilankhulocho kuchokera kumitundu yosiyanasiyana ya chipolopolo chanu

Mutha kukakamiza chilankhulo poyika LC_ALL kusintha kwa chilengedwe:

LC_ALL=it hokey --help

Dziwani kuti ngati hokeylization-lite , command help ikupezeka mu Chingerezi

Khazikitsa

Khazikitsani malo a GOOGLE_TRANSLATE_PROJECT_ID kuti muzindikire pulojekiti yanu ya Zomasulira za Google

Khazikitsani zosintha za GOOGLE_APPLICATION_CREDENTIALS kukhala zotsimikizira za JSON zomwe mudatsitsa mutatha kudziwa momwe kutsimikizika kumagwirira ntchito pamtambo wa Google (zingakhale zosangalatsa)

Ngati mukugwiritsa ntchito code source, mutha kuziyikanso mu fayilo ya .env komwe kumachokera chikwatu chidzayikidwa pa nthawi yothamanga kudzera pa dotenv

Kumasulira fayilo yachingwe cha JavaScript

Tebulo lanu la zingwe ** liyenera ** kukhala mu fayilo ya JavaScript mu imodzi mwa mitundu iwiriyi:

ES6 kutumiza kunja:

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

Kutumiza kwa CommonJS

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

Ngati fayiloyi idatchedwa myfile.en.js , mutha kumasulira ku Chisipanishi ndi Chijeremani ndi:

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

The LANG yomwe ili pamwambapa ndiyapadera - ndi mawu osungidwa pachida ichi!

The LANG imasinthidwa ndi chilankhulo cha mafayilo otulutsa

Chifukwa chake lamulo ili pamwambapa limapanga mafayilo:

myfile.es.js
myfile.de.js

Chosankha cha -l / --languages ndi mndandanda wosiyanitsidwa ndi koma wa ma code a zilankhulo za ISO. mothandizidwa ndi Google Translate

Ngati fayilo yotulutsa ilipo kale, iwunikiridwa kuti muwone makiyi omwe alipo kale. Makiyi omwe alipo sadzamasuliridwa. Zomasulira za makiyi akusowa zidzapangidwa ndi kuwonjezeredwa mpaka kumapeto kwa chinthu cha JS. Fayilo yonse imalembedwanso nthawi zonse.

Kukakamiza kumasuliranso makiyi onse, gwiritsani ntchito -f / --force

Kumasulira chikwatu cha mafayilo amawu

Mukhozanso kumasulira chikwatu cha mafayilo. hokeylization idzayendera mobwerezabwereza aliyense tsegulani m'ndandanda ndikuyendetsa zomwe zili mu Google Translate, ndikusunga zomwe zatuluka ku fayilo yotchulidwa mofananamo mumtengo wosiyana wa chikwatu

Pamene cholinga cha kumasulira kwanu ndi chikwatu, njirayi imayatsidwa

Chosankha cha -o / --outfile chimatchula zotuluka

CHENJEZO LAKULU: Mukamasulira maulolezo, OSATI tchulani chikwatu chotulutsa zomwe zili mkati mwazolembera zanu! Ngati muchita izi, mudza:

yambitsani kubwereza kosatha
tsitsani ndalama zanu za Google
lembani disk yanu
sangalalani pang'ono

Nachi chitsanzo cha zomwe osachita:

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

Izi zikachitika, mafayilo omasuliridwa amalembedwa ku templates/es , motero amakhala atsopano mafayilo omasulira, popeza ali pansi pa templates/ -- ndondomekoyi ikupitilira kwanthawizonse, musachite izo!

Kugwiritsa ntchito moyenera

Chabwino, tiyerekeze kuti muli ndi ma templates a imelo mu chikwatu:

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

Kuti mumasulire zonsezi ku Chisipanishi ndi Chijeremani, thamangani:

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

Pamwambapa, LANG ndi mawu osungidwa ndipo m'malo mwake asinthidwa ndi code ya chilankhulo cha ISO

Zomwe zimachitika pamwambazi zikachitika:

Ma templates/email/es ndi templates/email/de apangidwa (ngati palibe)
Fayilo iliyonse mu templates/email/en idzamasuliridwa ku Spanish ndi German
Mafayilo omwe alipo kale sangasinthidwenso pokhapokha mutagwiritsa ntchito -f / --force
Mudzakhala ndi chikwatu chofanana ndi mafayilo mkati mwa es ndi de monga momwe muliri pansi pa en

Zosankha zina

Dry run

Pitani -n / --dry-run kuti muwonetse zomwe zingachitike, koma osayimba mafoni a API kapena kulemba mafayilo aliwonse.

Mphamvu

Pitani -f / --force kuti mumasulirenso zomasulira, ngakhale zitakhalapo kale

Zofanana

Pitani -m / --match kuti muchepetse mafayilo omwe asinthidwa mukamayendetsa

Simungafune nthawi zonse kumasulira fayilo iliyonse yomwe ili m'chikwatu chomwe mumayambira kupita ku chikwatu chomwe mukufuna

Mtengo wa njira ya -m / --match ndi regex (samalani malamulo otchula zipolopolo!) mafayilo omwe ayenera kumasuliridwa

Mukakayikira, mutha kuphatikiza izi ndi -n / --dry-run kuti muwone mafayilo omwe angamasuliridwe.

Kupatulapo

Nthawi zina -m yanu imagwirizana ndi mafayilo ochulukirapo. Gwiritsani ntchito njira ya -e / --excludes kuti musatchule mwatsatanetsatane mafayilo omwe akanafanana

Mutha kulembetsa ma regexe angapo, olekanitsidwa ndi mipata

Kugwiritsa ntchito kofala kungakhale: --excludes node_modules dist \.git build tmp

Ma Handlebar

Zingwe zomasulira zitha kukhala ndi {{ handlebars }} , zokhala ndi zingwe ziwiri kapena zitatu zopindika.

Mwina SIMUFUNA kuti zinthu zomwe zili mkati mwazithunzizo zimasuliridwe

Dulani mbendera ya -H / --handlebars , ndipo chilichonse mkati mwa {{ ... }} sichidzamasuliridwa

Kutsitsa

Markdown silemba kapena html, kotero Zomasulira za Google zimakhala ndi zovuta nazo

Mbendera ya -M / --markdown imathandizira kugwira ntchito mwapadera kwamafayilo otsitsa

Ndi mafayilo otsitsa, ngati simugwiritsa ntchito mbendera ya -M , mutha kupeza mavuto awa:

Maulalo osweka. Pomasulira, chilembo cha danga chikuwonekera pambuyo pofotokozera ulalo wotsikirako (ndi ] ) koma ulalo wake wa chandamale usanayambe (ndi ( ). Izi zimapangitsa kuti kutsika kuwoneke molakwika, ndi ulalo imasweka poyang'ana chikalatacho.
Ma code block amamasuliridwa. Zomasulira za Google sizimadziwa zomwe kutsitsa kumatengera ma code komanso zomwe sadziwa
Kutalikirana kolakwika kwa midadada yopindika. Mipata imakhala yovuta kusunga pomasulira
Zinthu zomwe zili mkati mwa backticks zimamasuliridwa, nthawi zonse mukafuna kuti zikhale zenizeni

Pamene -M / --markdown :

Ndondomeko ]( idzafupikitsidwa kukhala ]( potero kukonza maulalo osweka
Chokulunga cha "no translate" chidzayikidwa mozungulira midadada yokhazikika, kusunga ma indentation oyenera ndikuwonetsetsa kuti sikumasuliridwa.
Chopukutira cha "no translate" chidzayikidwa mozungulira mawu mkati mwa backticks kuwonetsetsa kuti asamasuliridwe

Njira-monga

Nthawi zambiri zonse zimasinthidwa kukhala mawu osavuta

Ngati zomwe muli nazo ndi HTML, zitha kusokonekera pokhapokha mutadutsa njira ya -p html / --process-as html .

Sefa

Kwa okonda: mukamakonza mafayilo mu chikwatu, mutha kudutsa njira ya -F / --filter . kusefa zotuluka zisanalembedwe ku fayilo

Mtengo wa njirayi uyenera kukhala njira yopita ku fayilo ya JS yomwe imatumiza ntchito yotchedwa filter

Ntchito ya filter iyenera kukhala async chifukwa await idzatchedwa pa iyo

Mafayilo asanalembedwe ku disk, zonse zomwe zili filter ngati chingwe

Mtengo wobwerera kuchokera filter

Choncho, muli ndi mphamvu zonse pa zomwe zidzalembedwe

Zolemba za filter m'malo otsatirawa (ndi .js zidzawonjezedwa ku fyuluta dzina, pokhapokha litatha kale mu .js )

Chikwatu chapano
Chikwatu chotchedwa .hokey-filters mkati mwa chikwatu chomwe chilipo
Chikwatu chotchedwa ${HOME}/.hokey-filters , pomwe ${HOME} ndi chikwatu chakunyumba kwa ogwiritsa ntchito pano
Zomangamanga zosefera

Zosefera Zosefera

Chingwe cha filter chikhoza kukhala mawu angapo. Pankhaniyi, mawu oyamba ndi dzina fyuluta, ndi mawu otsalawo adzaperekedwa ngati zotsutsana ku ntchito ya filter

Thandizeni

Gwiritsani ntchito -h / --help kuti muwonetse thandizo

JSON batch malamulo

Ndi njira ya -j / --json , mutha kuyendetsa malamulo angapo ogwirizana a hokey

Mwamsonkhano wapamwambayi imatchedwa hokey.json , koma mutha kutchula chilichonse chomwe mukufuna

Ngati mudutsa chikwatu monga -j mwina, hokey idzayang'ana hokey.json mu bukhuli.

Fayilo ya JSON iyenera kukhala ndi chinthu chimodzi. Mkati mwa chinthucho, mayina ake a katundu ndi ofanana ndi zosankha za mzere wamalamulo, kuphatikiza katundu wina wina wotchedwa hokey

The hokey katundu ndi mndandanda wa malamulo kuthamanga. Zomwe zalengezedwa m'malamulo awa zidzatero chepetsa mawu obwerezabwereza mu chinthu chakunja.

Muchinthu chilichonse mugulu la hokey , muyenera kutchula name , ndi mafayilo olowera ndi zotuluka.

Nachi chitsanzo cha 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"
      }
    ]
}

Mafayilo olowetsa angapo

Dulani njira zingapo zamafayilo monga infiles m'malo mwa njira imodzi infile , monga mu chitsanzo ichi:

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

Indexes

Pomasulira ku zilankhulo zambiri, hokey amatha kupanga fayilo yolozera yomwe imalemba zomasulira zonse zomwe zapangidwa ndipo amapereka maulalo kwa iwo

*Mukapanga ma index, mutha kukhala ndi gwero limodzi lolowera *

Pitani njira ya -I / --index , mtengo wake ndi pomwe fayilo yolozera idzapangidwa, yomwe ikhoza kukhala fayilo. kapena chikwatu. Ngati ndi chikwatu, dzina lafayilo losakhazikika lidzagwiritsidwa ntchito, kutengera template (onani pansipa)

Gwiritsani ntchito -A / --index-template kuti muwone momwe zotulutsazo zimapangidwira. Mutha kutchula 'html', 'markdown', 'text', kapena njira yamafayilo yofikira HandlebarsJS template yanu

Ngati mutchula template yanu, muyeneranso kufotokoza fayilo (osati chikwatu) cha -I / --index mwina

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylization

Werengani izi muchilankhulo china

📚 ... Zinenero Zonse ...

Kodi pali vuto ndi kumasulira kumeneku kwa README?

Zamkatimu

Gwero

Thandizo ndi Ndalama

Kukhazikitsa

Khazikitsa

Kumasulira fayilo yachingwe cha JavaScript

Kumasulira chikwatu cha mafayilo amawu

Kugwiritsa ntchito moyenera

Zosankha zina

Dry run

Mphamvu

Zofanana

Kupatulapo

Ma Handlebar

Kutsitsa

Njira-monga

Sefa

Zosefera Zosefera

Thandizeni

JSON batch malamulo

Mafayilo olowetsa angapo

Indexes

Khalani ndi nthawi yosangalatsa yomasulira zilankhulo!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylization

Werengani izi muchilankhulo china

📚 ... Zinenero Zonse ...

Kodi pali vuto ndi kumasulira kumeneku kwa README?

Zamkatimu

Gwero

Thandizo ndi Ndalama

Kukhazikitsa

Khazikitsa

Kumasulira fayilo yachingwe cha JavaScript

Kumasulira chikwatu cha mafayilo amawu

Kugwiritsa ntchito moyenera

Zosankha zina

Dry run

Mphamvu

Zofanana

Kupatulapo

Ma Handlebar

Kutsitsa

Njira-monga

Sefa

Zosefera Zosefera

Thandizeni

JSON batch malamulo

Mafayilo olowetsa angapo

Indexes

Khalani ndi nthawi yosangalatsa yomasulira zilankhulo!