Skip to content

Latest commit

 

History

History
380 lines (276 loc) · 15.8 KB

README.md

File metadata and controls

380 lines (276 loc) · 15.8 KB

Hokeylization

He aha e kore e taea e au te whakahaere i taku taupānga katoa, i taku pae ranei ma te Whakamaori Google me te tiki i tetahi whakamaoritanga taketake ki tetahi atu reo?

Na, ka taea e koe!

Ko te ingoa hokeylization he portmanteau, ko te tikanga 'hokey localization'

He ahua hokey na te mea he tino ngawari: ka tuku aho ki a Google Translate

A he ngawari, engari he tino kaha. He tautoko motuhake mo nga tuhinga HTML, HandlebarsJS tauira, me nga konae Markdown.

Ka taea e koe te whakamaori:

  • he ahanoa JavaScript kei roto nga karere
  • te maha o nga konae, raarangi whaiaronga ranei, ka takahi i nga raarangi whaiaronga

Panuitia tenei ki tetahi atu reo

Kua whakamaoritia tenei tuhinga README.md, ma te whakamahi i te taputapu hokeylization ake, ki roto nga reo katoa e tautokohia ana e Google Translate!

E mohio ana ahau ehara i te mea tino tika, engari ko taku tumanako he pai ake i te kore!

🇸🇦 Arapi 🇧🇩 Bengali 🇩🇪 Tiamana 🇺🇸 Ingarihi 🇪🇸 Paniora 🇫🇷 Wīwī 🇹🇩 Hausa 🇮🇳 Hindi 🇮🇩 Initonia 🇮🇹 Itari 🇯🇵 Japanese 🇰🇷 Korean 🇮🇳 Marathi 🇵🇱 Poroni 🇧🇷 Potiti 🇷🇺 Ruhia 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 Turkish 🇵🇰 Urdu 🇻🇳 Vietnamese 🇨🇳 Hainamana

📚 ... Nga Reo Katoa ...

He raru kei tenei whakamaoritanga o te README?

Ko tenei whakamaoritanga o te [README] taketake(https://github.com/cobbzilla/hokeylization/blob/master/README.md) kei te he -- e tino manakohia nga whakatikatika! Tukuna mai he tono toia ki GitHub, ki te kore koe e pai ki te mahi i tera, whakatuwhera i tetahi take

Ina hanga e koe he take GitHub hou mo te whakamaoritanga, mahia:

  • whakauruhia te URL wharangi (kape/whakapiri mai i te pae wahitau tirotiro)
  • whakaurua te tuhinga tika e he ana (tārua/whakapiri mai i te kaitirotiro)
  • whakaahuatia mai he aha te he -- kei te he te whakamaoritanga? kua pakaru te whakatakotoranga?
  • tuku mai he whakaaro mo te whakamaoritanga pai ake, me pehea ranei te whakatakotoranga tika o te tuhinga
  • Mauruuru!

Ihirangi

Puna

Tautoko me te Putea

Kei te ngana ahau ki te noho hei kaiwhakawhanake rorohiko puna tuwhera ngaio. I mahi ahau i roto te ahumahi rorohiko mo nga tau maha, kua timata ahau i nga kamupene angitu me te hoko atu ki nga kamupene a te iwi. No tata nei ka ngaro taku mahi, a karekau he mahi ke atu i te rarangi

Na ka ngana ahau ki te tuhi i nga raupaparorohiko awhina me te kite mena ka mahi tera

Mena he pai ki a koe te whakamahi i tenei rorohiko, ka tino koa ahau ki te whiwhi i te iti rawa koha-marama ma Patreon

Mauruuru!

Tāutanga

Hei whakamahi i te taputapu raina whakahau, whakauruhia ma te whakamahi i te npm , i te yarn yarn` ranei:

npm install -g hokeylization
yarn global add hokeylization

Hei whakamahi hei whare pukapuka, whakauruhia te putanga lite , he iti ake:

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

Na ka titiro ki te awhina mo te tono hokey :

hokey --help
hokey -h

Kei te hiahia koe ki te kite i nga putanga i to reo, i tetahi atu reo ranei?

Ka ngana a hokey ki te kimi aunoa i te reo mai i nga taurangi taiao o to anga

Ka taea e koe te akiaki i tetahi reo ma te tautuhi i te taurangi taiao LC_ALL :

LC_ALL=it hokey --help

Kia mahara mena kua whakauruhia e koe te hokeylization-lite , kei te waatea noa te awhina whakahau i te reo Ingarihi

Tatūnga

Tautuhia te taurangi taiao GOOGLE_TRANSLATE_PROJECT_ID hei tautuhi i to kaupapa Whakamaori Google

Tautuhia te taurangi taiao GOOGLE_APPLICATION_CREDENTIALS ki nga taipitopito JSON i tikiakehia e koe i muri i te whakaaro me pehea te mahi motuhēhēnga i runga i te kapua Google (he ngahau)

Mena kei te rere koe mai i te waehere puna, ka taea ano e koe te whakauru i enei ki te .env ki te puna whaiaronga ka utaina i te wa whakahaere ma dotenv

Te whakamaori i te konae rauemi aho JavaScript

Ko to ripanga aho me kei roto i te konae JavaScript i tetahi o enei ahua e rua:

ES6 kaweake:

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

CommonJS kaweake

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

Mēnā i tapaina tēnei kōnae myfile.en.js , ka taea e koe te whakamāori ki te reo Pāniora me te Tiamana mā:

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

He mea motuhake te LANG kei runga ake nei -- he kupu rahui i roto i tenei taputapu!

Ka whakakapihia te LANG ki te waehere reo mo nga konae whakaputa

Na te whakahau i runga ake nei ka hanga i nga konae:

myfile.es.js
myfile.de.js

Ko te kōwhiringa -l / --languages he rarangi wehe piko o nga waehere reo ISO tautokohia e Google Translate

Mēnā kei te tīariari kē te kōnae whakaputa, ka tirohia kia mōhiotia ko ēhea ngā kī kei te noho kē. E kore e whakamaoritia nga taviri o mua. Ko nga whakamaoritanga mo nga taviri ngaro ka hangaia me te taapiri ki te mutunga o te ahanoa JS. Ka tuhia ano te katoa o nga konae.

Hei akiaki i te whakamaoritanga ki nga taviri katoa, whakamahia te kōwhiringa -f / --force

Te whakamaori i te raarangi o nga konae tuhinga

Ka taea hoki te whakamaori i te raarangi o nga konae. Ka toro atu te hokeylization ki ia tangata kōnae i roto i te whaiaronga me te whakahaere i ona ihirangi ma te Whakamaori Google, ka tiakina te putanga ki tetahi kōnae e rite ana te ingoa i roto i te rakau whaiaronga motuhake

Ina he whaiaronga te whainga o to whakamaoritanga, ka whakahohea tenei aratau

Ko te kōwhiringa -o / --outfile e tohu ana i te whaiaronga putanga

TUPATOTANGA NUI: I te wa e whakamaori ana i nga raarangi whaiaronga, ** KAUA E ** te tohu i tetahi raarangi whakaputa kei roto tena i to raarangi whakauru! Ki te mahi koe i tenei, ka:

  • whakakorikori mutunga kore
  • whakahaere i to pire Google
  • whakakiia to kōpae
  • iti ake te ngahau

Anei tetahi tauira o nga mea kaore e mahia:

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

Ina haere ana tenei, ka tuhia nga konae kua whakamaoritia ki templates/es , ka noho hou kōnae puna hei whakamaori, i te mea kei raro i te templates/ -- ka haere tonu tenei tukanga mo ake tonu atu, kaua e mahia!

Whakamahi tika

Ae, me kii kei a koe etahi tauira imeera kei roto i tetahi raarangi:

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

Hei whakamaori i enei katoa ki te reo Paniora me Tiamana, whakahaere:

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

I runga ake nei, LANG he kupu kua rahuitia ka whakakapia ki te waehere reo ISO

He aha te mea ka rere te mea i runga ake nei:

  • Ka waihangahia nga templates/email/es me te templates/email/de (mehemea karekau)
  • Ko ia konae kei roto i te templates/email/en ka whakamaoritia ki te reo Paniora me Tiamana
  • Ko nga konae putanga o naianei e kore e hanga hou mena ka whakamahi koe i te -f / --force
  • Ka mutu he hanganga whaiaronga riterite me nga konae kei roto i es me te de penei i a koe i raro i en

Ētahi atu kōwhiringa

Rere maroke

Tukuna -n / --dry-run ki te whakaatu i nga mahi ka mahia, engari kaua e waea ki te API me te tuhi i nga konae

Kaha

Tukua -f / --force ki te whakahou i nga whakamaoritanga i nga wa katoa, ahakoa kei te noho tonu

Whakataetae

Tukua -m / --match ki te whakawhāiti i nga konae ka tukatukahia ina rere ana i te aratau-whaiaro

Kaore pea koe e hiahia ki te whakamaori i nga katoa konae kei roto i to whaiaronga puna ki to raarangi whainga

Ko te uara o te kōwhiringa -m / --match he regex (kia tupato ki nga ture whakahua anga!) e tohu ana ko ēhea kōnae me whakamāori

Ki te ruarua koe, ka taea e koe te whakakotahi i tenei whiringa me te -n / --dry-run kia kite ko wai nga konae ka whakamaoritia

Karekau

I etahi wa ka rite to -m ki te maha o nga konae. Whakamahia te kōwhiringa -e / --excludes ki te whakakore rawa ko nga konae ka taurite

Ka taea e koe te whakarārangi i ngā regex maha, ka wehea e ngā mokowā

Ko te whakamahinga noa ko: --excludes node_modules dist \.git build tmp

Pae kakau

Kei roto pea i nga aho hei whakamaori he tauira {{ handlebars }} , me rua, e toru ranei nga taiapa mingimingi

Koe pea KORE e hiahia ana kia whakamaoritia nga mea kei roto i aua tauira

Tukuna te haki -H / --handlebars , a ko nga mea katoa i roto i {{ ... }} e kore e whakamaoritia

Tohutohu

Ko Markdown ehara i te tuhinga, i te html ranei, no reira he uaua a Google Translate

Ko te -M / --markdown ka taea te whakahaere motuhake mo nga konae tohu

Me nga konae tohu, ki te kore koe e whakamahi i te haki -M , ka kitea pea enei raru:

  • Nga hononga pakaru. I roto i te whakamaoritanga, ka puta he mokowhiti i muri i te mutunga o te whakamaarama hono tohu (me te ] ) engari i mua i te tiimata o tana hononga whainga (me te ( ). Na tenei ka he te whakaatu i te tohu, me te hono kua pakaru i te tiro i te tuhinga.
  • Ka whakamaoritia nga poraka waehere. Ko te whakamaori a Google kaore e mohio he aha te tohu tohu e kiia ana he waehere me nga mea kaore
  • He mokowā hē mō ngā poraka waehere nuku. He uaua ki te pupuri i te mokowhiti i te whakamaoritanga
  • Ko nga mea o roto o backticks ka whakamaoritia, ina tata ki te hiahia koe he uara mooni

Ina whakahohea te haki -M / --markdown :

  • Ko te tauira ]( ka whakapoapoa ki ]( ka whakatika i nga hononga tohu kua pakaru
  • Ka whakanohohia he takai "kore whakamaori" huri noa i nga poraka waehere kua nukuhia, kia mau te nuku tika me te whakarite kia kaua e whakamaoritia.
  • Ka whakanohoia he takai "kore whakamaori" ki te taha o te kuputuhi i roto i backticks kia kore ai e whakamaoritia

Tukanga-rite

Ko te tikanga ka tukatukahia nga mea katoa hei tuhinga noa

Mēnā he HTML tō ihirangi, ka hee ki te kore e tukuna e koe te kōwhiringa -p html / --process-as html

Tātari

Mo te hunga rikarika: i te wa e tukatuka ana i nga konae ki roto i te raarangi, ka taea e koe te tuku i te -F / --filter ki te tātari i te putanga i mua i te tuhi ki te punaha konae

Ko te uara o tenei kowhiringa he ara ki te konae JS ka kaweake i tetahi taumahi i tapaina ko te filter

Ko te mahi filter me async no te mea ka karangahia te await ki runga

I mua i te tuhi i nga konae ki te kōpae, ka tukuna katoatia nga ihirangi o nga konae ki te mahi filter hei aho

Ko te uara whakahoki mai i te mahi filter ko te mea ka tuhia ki te rokiroki

No reira, kei a koe te mana katoa mo nga mea ka tuhia

Ka rapua te tuhinga filter ki nga waahi e whai ake nei (me te .js ka apiti ki te tātari ingoa, mena ka mutu ki .js )

  • Te whaiaronga o naianei
  • He whaiaronga ko .hokey-filters i roto i te whaiaronga o naianei
  • He whaiaronga ko ${HOME}/.hokey-filters , ko ${HOME} ko te whaiaronga kainga o te kaiwhakamahi o naianei
  • Ko te whaiaronga tātari

Tawhā Tātari

Ko te aho filter he maha nga kupu. I tenei take, ko te kupu tuatahi ko te ingoa tātari, me ko nga kupu e toe ana ka tukuna hei tohenga mo te mahi filter

Awhina

Whakamahia -h / --help hei whakaatu awhina

Nga whakahau puranga JSON

Ma te kōwhiringa -j / --json , ka taea e koe te whakahaere i nga whakahau hokey maha.

Ma te tikanga ka kiia tenei konae hokey.json , engari ka taea e koe te whakaingoa ahakoa e hiahia ana koe

Mena ka tukuna e koe he whaiaronga hei whiringa hokey -j ka rapua e hokey he hokey.json i taua whaiaronga

Ko te kōnae JSON kia kotahi te ahanoa. I roto i taua ahanoa, he rite tonu ona ingoa taonga ki nga whiringa raina-whakahau, me tetahi atu taonga ko hokey

Ko te taonga hokey he huinga whakahau hei whakahaere. Ko nga taonga i whakapuakina i roto i enei whakahau ka turaki i nga whakapuakanga taarua i te ahanoa o waho.

I roto i ia ahanoa i roto i te huinga hokey , me tohu he name , me nga konae whakauru me te whakaputa

Anei he tauira o te 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"
      }
    ]
}

He maha nga konae whakauru

Tukua he huinga ara kōnae hei infiles hei utu mo te ara kotahi infile , penei i tenei tauira:

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

Taurangi

I te wa e whakamaori ana ki nga reo maha, ka taea e hokey ' te hanga i tetahi konae taurangi e whakararangi ana i nga whakamaoritanga katoa i mahia. me te whakarato hononga ki a raatau

I te wa e whakaputa ana i nga taurangi, ka taea e koe te kotahi noa te puna whakauru

Tukuna te kōwhiringa -I / --index , ko te uara ko te waahi ka puta te konae taupū, he konae pea he whaiaronga ranei. Mēnā he whaiaronga, ka whakamahia he ingoa kōnae taunoa, i runga i te tauira (tirohia ki raro)

Whakamahia te -A / --index-template ki te whakatau me pehea te whakahōputu o te putanga taupū. Ka taea e koe te tohu 'html', 'tohutohu', 'kuputuhi', te ara konae ranei ki to ake HandlebarsJS tauira

Mēnā ka whakapūtā koe i tō ake tauira, me whakapūtā hoki he kōnae (ehara i te whaiaronga) mō te -I / --index kōwhiringa

Kia ngahau ki te whakamaori i nga reo!