README.md

Hokeylization

Cén fáth nach féidir liom m'aip nó mo shuíomh iomlán a rith trí Google Translate agus bunaistriúchán a fháil i dteanga eile?

*Anois, is féidir leat!

Is portmanteau é an t-ainm hokeylization , rud a chiallaíonn 'logánú hokey'

Tá sé beagán hokey mar tá sé an-simplí: seolann sé teaghráin chuig Google Translate

Agus tá sé simplí, ach freisin an-chumhachtach. Tá tacaíocht speisialta aige do dhoiciméid HTML, HandlebarsJS teimpléid, agus comhaid Markdown.

Is féidir leat aistriúchán:

• réad JavaScript ina bhfuil teachtaireachtaí
• líon ar bith comhad nó eolairí, ag trasnú eolairí go hathchúrsach i gcónaí

Léigh é seo i dteanga eile

Aistríodh an doiciméad README.md seo, ag baint úsáide as an uirlis hokeylization féin, go gach teanga a dtacaíonn Google Translate léi!

Tá mé cinnte nach bhfuil sé foirfe, ach tá súil agam go bhfuil sé níos fearr ná rud ar bith!

🇸🇦 Araibis 🇧🇩 Beangáilis 🇩🇪 Gearmáinis 🇺🇸 Béarla 🇪🇸 Spáinnis 🇫🇷 Fraincis 🇹🇩 Hausa 🇮🇳 Hiondúis 🇮🇩 Indinéisis 🇮🇹 Iodáilis 🇯🇵 Seapáinis 🇰🇷 Cóiréis 🇮🇳 Marathi 🇵🇱 Polainnis 🇧🇷 Portaingéilis 🇷🇺 Rúisis 🇰🇪 Svahaílis 🇵🇭 Tagálaigis 🇹🇷 Tuircis 🇵🇰 Urdais 🇻🇳 Vítneamais 🇨🇳 Sínis

📚 ... Gach Teanga ...

An bhfuil fadhb leis an aistriúchán seo ar an README?

An t-aistriúchán áirithe seo ar an mbunleagan README d’fhéadfadh sé a bheith lochtach -- tá fáilte mhór roimh cheartúcháin! Seol iarratas tarraingthe ar GitHub, le do thoil. nó mura bhfuil tú compordach é sin a dhéanamh, oscail ceist

Nuair a chruthaíonn tú saincheist nua GitHub faoi aistriúchán, déan:

• cuir isteach URL an leathanaigh (cóipeáil/greamaigh ó bharra seoltaí an bhrabhsálaí)
• cuir isteach an téacs cruinn atá mícheart (cóipeáil/greamaigh ón mbrabhsálaí)
• Déan cur síos le do thoil ar a bhfuil mícheart -- an bhfuil an t-aistriúchán mícheart? an bhfuil an fhormáidiú briste ar bhealach éigin?
• go cineálta moladh a thabhairt faoi aistriúchán níos fearr, nó conas is ceart an téacs a fhormáidiú i gceart
• Go raibh maith agat!

Ábhar

• Foinse
• Tacaíocht agus Maoiniú
• Suiteáil
• Socrú
• Comhad acmhainne teaghrán JavaScript a aistriú
• Eolaire comhaid téacs a aistriú
• Roghanna eile
• [orduithe baisc JSON](# JSON-batch-commands)

Foinse

• hokeylization ar GitHub
• hokeylization ar npm

Tacaíocht agus Maoiniú

Tá mé ag iarraidh a bheith i mo fhorbróir bogearraí foinse oscailte gairmiúil. Tá mé ag obair i an tionscal bogearraí le blianta fada anuas, tá cuideachtaí rathúla tosaithe agam agus dhíol mé iad le cuideachtaí poiblí. Chaill mé mo phost le déanaí, agus níl aon obair eile ar bun agam i ndáiríre

Mar sin táim chun iarracht a dhéanamh bogearraí cabhrach a scríobh agus féachaint an n-oibríonn sin

Má bhaineann tú taitneamh as na bogearraí seo a úsáid, bheinn chomh sásta fiú na bogearraí seo a fháil ranníocaíocht mhíosúil trí Patreon

Go raibh maith agat!

Suiteáil

Chun an uirlis líne ordaithe a úsáid, suiteáil le npm nó yarn :

npm install -g hokeylization
yarn global add hokeylization

Chun é a úsáid mar leabharlann, suiteáil an leagan lite , atá i bhfad níos lú:

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

Ansin féach ar chabhair don ordú hokey :

hokey --help
hokey -h

An bhfuil fonn ort aschur i do theanga nó i dteanga eile a fheiceáil?

Déanann hokey iarracht an teanga a bhrath go huathoibríoch ó athróga timpeallachta do bhlaoscáin

Is féidir leat teanga a bhrú tríd an athróg timpeallachta LC_ALL a shocrú:

LC_ALL=it hokey --help

Tabhair faoi deara, má tá hokeylization-lite suiteáilte agat, nach bhfuil cabhair ordaithe ar fáil ach i mBéarla

Socrú

Socraigh an athróg timpeallachta GOOGLE_TRANSLATE_PROJECT_ID chun do thionscadal Google Translate a shainaithint

Socraigh an athróg timpeallachta GOOGLE_APPLICATION_CREDENTIALS chuig na dintiúir JSON a d'íoslódáil tú tar éis duit a fháil amach conas a oibríonn fíordheimhniú ar Google cloud (is féidir leis a bheith spraoi)

Má tá tú ag rith ón gcód foinseach, is féidir leat iad seo a chur i gcomhad .env san fhoinse freisin eolaire déanfar iad a lódáil ag am rite trí dotenv

Comhad acmhainne teaghrán JavaScript a aistriú

Caithfidh do tábla teaghrán **** a bheith i gcomhad JavaScript i gceann den dá fhoirm seo:

Easpórtáil ES6:

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

Easpórtáil CommonJS

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

Má tugadh myfile.en.js ar an gcomhad seo, is féidir leat é a aistriú go Spáinnis agus Gearmáinis le:

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

Tá an LANG thuas speisialta -- is focal forchoimeádta é san uirlis seo!

Cuirtear an cód teanga do na comhaid aschuir in ionad an LANG

Mar sin cruthaíonn an t-ordú thuas na comhaid:

myfile.es.js
myfile.de.js

Is éard atá sa rogha -l / --languages ná liosta camóg-scartha de chóid teanga ISO tacaithe ag Google Translate

Má tá an comhad aschuir ann cheana féin, scrúdófar é chun a fháil amach cé na heochracha atá ann cheana féin. Ní aistreofar eochracha atá ann cheana féin. Ginfear agus cuirfear aistriúcháin le haghaidh eochracha in easnamh orthu go dtí deireadh an réad JS. Athscríobhtar an comhad iomlán i gcónaí.

Chun gach eochair a athaistriú a bhrú, úsáid an -f / --force

Eolaire de chomhaid téacs a aistriú

Is féidir leat eolaire comhaid a aistriú freisin. Beidh hokeylization cuairt athchúrsach ar gach comhad san eolaire agus rith a bhfuil ann trí Google Translate, agus sábháil an t-aschur chuig comhad atá ainmnithe mar an gcéanna i gcrann eolaire ar leith

Nuair is eolaire é sprioc d'aistriúcháin, tá an mód seo cumasaithe

Sonraíonn an rogha -o / --outfile an t-eolaire aschuir

RABHADH MÓR: Agus eolaire á aistriú, NÁ sonraigh eolaire aschuir is é sin laistigh de do eolaire ionchuir! Má dhéanann tú é seo, déanfaidh tú:

• atarlú gan teorainn a aslú
• rith suas do bhille Google
• líon suas do dhiosca
• níos lú spraoi a bheith agat

Seo sampla de na rudaí gan déanamh:

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

Nuair a bheidh sé seo ar siúl, scríobhtar comhaid aistrithe chuig templates/es , agus déantar iad dá réir sin nua foinse comhaid le haistriú, ós rud é go bhfuil siad faoi templates/ -- leanann an próiseas seo ar aghaidh go deo, ná déan é!

Úsáid cheart

Ceart go leor, abair go bhfuil roinnt teimpléid ríomhphoist agat in eolaire:

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

Chun iad seo go léir a aistriú go Spáinnis agus Gearmáinis, rith:

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

San alt thuas, is focal forchoimeádta é LANG agus cuirfear an cód teanga ISO ina ionad

Cad a tharlaíonn nuair a ritheann an méid thuas:

• Cruthófar na templates/email/es agus templates/email/de eolaire (mura bhfuil siad ann)
• Aistreofar gach comhad i templates/email/en go Spáinnis agus Gearmáinis
• Ní dhéanfar comhaid aschuir atá ann cheana a athghiniúint mura n-úsáideann tú -f / --force
• Ar deireadh beidh struchtúr eolaire comhionann agat agus comhaid laistigh de es agus de mar atá agat faoi en

Roghanna eile

Rith tirim

Pas -n / --dry-run chun cad a dhéanfaí a thaispeáint, ach ná déan aon ghlaonna API ná scríobh comhaid ar bith

fhórsa

Pas -f / --force chun aistriúcháin a athghiniúint i gcónaí, fiú má tá siad ann cheana féin

Meaitseáil

Pas -m / --match chun teorainn a chur leis na comhaid a phróiseáiltear agus iad ag rith sa mhód eolaire

B’fhéidir nár mhaith leat i gcónaí gach comhad i do eolaire foinse a aistriú go dtí do sprioc-eolaire

Is é luach na -m / --match ná regex (tabhair aire do rialacha luaigh an bhlaosc!) a shonraíonn cé na comhaid ba chóir a aistriú

Nuair a bhíonn amhras ort, is féidir an rogha seo a chomhcheangal le -n / --dry-run féachaint cé na comhaid a aistreofaí

Ní áirítear

Uaireanta meaitseálann do -m iomarca comhad. Úsáid an -e / --excludes chun eisiamh go sainráite comhaid a bheadh meaitseáilte murach sin

Is féidir leat regexes iolracha a liostú, scartha le spásanna

Úsáid choiteann is ea: --excludes node_modules dist \.git build tmp

Barra Láimhe

Seans go mbeidh teimpléid {{ handlebars }} sna teaghráin le haistriú, bíodh dhá nó trí shreang chatach ann

Is dócha NÍ mian leat an stuif taobh istigh de na teimpléid sin a aistriú

Cuir an -H / --handlebars ar aghaidh, agus ní aistreofar aon rud laistigh de {{ ... }}

Marcáil síos

Ní téacs ná html é Markdown, mar sin tá roinnt deacrachtaí ag Google Translate leis

Cumasaíonn an bhratach -M / --markdown láimhseáil speisialta do chomhaid marcála síos

Le comhaid marcála síos, mura n-úsáideann tú an bhratach -M , is dócha go bhfaighidh tú na fadhbanna seo:

• Naisc briste. San aistriúchán, feictear carachtar spáis nuair a chríochnaíonn cur síos ar nasc marcála síos (le ] ) ach sula gcuirtear tús lena nasc sprice (le ( ). Fágann sé seo go bhfuil an marc síos le rindreáil mícheart, agus an nasc briste nuair a bhreathnaítear ar an doiciméad.
• Aistrítear bloic chóid. Níl a fhios ag Google Translate cad a mheasann cód a mharcáil síos agus cad nach bhfuil
• Spásáil mhícheart do bhloic chóid eangaithe. Is deacair an spásáil a chaomhnú san aistriúchán
• Aistreofar rudaí taobh istigh de backticks , nuair is mian leat beagnach i gcónaí gur luachanna litriúla iad

Nuair atá an -M / --markdown cumasaithe:

• Beidh an patrún ]( comhdhlúite go ]( mar sin ag socrú na naisc briste marcála síos
• Cuirfear fillteán "gan aistriú" thart ar bhlocanna cód eangaithe, ag caomhnú eangú cuí agus ag cinntiú nach n-aistrítear iad.
• Cuirfear fillteán "gan aistriú" thart ar an téacs laistigh de backticks lena chinntiú nach n-aistrítear iad

Próiseas-mar

De ghnáth déantar gach rud a phróiseáil mar ghnáth-théacs

Más HTML é d'inneachar, manglófar é mura n-éiríonn leat an rogha -p html / --process-as html

Scagaire

Don eachtrúil: agus comhaid á bpróiseáil in eolaire, is féidir leat pas a fháil sa -F / --filter chun an t-aschur a scagadh sula scríobhtar chuig an gcóras comhad é

Caithfidh luach na rogha seo a bheith ina chonair chuig comhad JS a easpórtálann feidhm darb ainm filter

Ní mór filter a bheith san fheidhm async toisc go nglaofar await air

Sula scríobhtar comhaid ar diosca, cuirfear inneachar iomlán an chomhaid ar aghaidh chuig an bhfeidhm filter mar theaghrán

Is é an luach aischuir ón bhfeidhm filter an méid a scríobhfar chuig an stóras

Mar sin, tá smacht iomlán agat ar an méid a scríobhfar ar deireadh

Lorgófar an script filter seo a leanas (le .js cuirfear i gceangal leis an scagaire ainm, ach amháin má chríochnaíonn sé cheana féin i .js )

• An eolaire reatha
• Comhadlann darb ainm .hokey-filters laistigh den eolaire reatha
• Comhadlann darb ainm ${HOME}/.hokey-filters , arb é ${HOME} eolaire baile an úsáideora reatha
• An [eolaire scagairí] ionsuite (https://github.com/cobbzilla/hokeylization/tree/master/util/filter)

Scag Paraiméadair

Is féidir focail iolracha a bheith sa teaghrán filter . Sa chás seo, is é an chéad fhocal an t-ainm scagaire, agus cuirfear na focail atá fágtha ar aghaidh mar argóintí don fheidhm filter

Cabhrú

Úsáid -h / --help chun cabhair a thaispeáint

orduithe baisce JSON

Leis an -j / --json , is féidir leat hokey comhordaithe a rith

De réir an ghnáis tugtar hokey.json ar an gcomhad seo, ach is féidir leat cibé rud is mian leat a ainmniú

Má éiríonn leat eolaire mar an rogha hokey -j lorgóidh hokey.json san eolaire sin

Ba cheart go mbeadh réad amháin i gcomhad JSON. Laistigh den réad sin, is ionann a ainmneacha maoine agus na roghanna ordú-líne, móide airí breise amháin darb ainm hokey

Is éard atá sa mhaoin hokey ná sraith orduithe le rith. Déanfaidh na hairíonna a dhearbhaítear laistigh de na horduithe seo aon dearbhuithe dúblacha sa réad seachtrach a shárú.

Laistigh de gach réad san eagar hokey , ba cheart duit name a shonrú, agus na comhaid ionchuir agus aschuir

Seo sampla de 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"
      }
    ]
}

Comhaid ionchuir iolracha

Cuir raon de chonairí comhaid ar aghaidh mar infiles in ionad conair aonair infile , mar atá sa sampla seo:

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

Innéacsanna

Agus é á aistriú go dtí go leor teangacha, is féidir le hokey comhad innéacs a chruthú a liostaíonn na haistriúcháin go léir a rinneadh agus cuireann sé naisc ar fáil dóibh

Agus innéacsanna á ngin agat, ní féidir ach foinse ionchuir amháin a bheith agat

Pas an -I / --index -- index`, is é an luach a ghinfear an comhad innéacs, is féidir a bheith ina chomhad nó eolaire. Más eolaire é, úsáidfear ainm réamhshocraithe comhaid, bunaithe ar an teimpléad (féach thíos)

Úsáid an -A / --index-template chun a fháil amach conas a fhormáidítear an t-aschur innéacs. Is féidir leat 'html' a shonrú, 'markdown', 'text', nó cosán an chomhaid chuig do theimpléad HandlebarsJS

Má shonraíonn tú do theimpléad féin, ní mór duit comhad a shonrú freisin (ní eolaire) don -I / --index rogha

##Bíodh am spraoi agat ag aistriú teangacha!