Hokeylisering

Hvorfor kan jeg ikke kjøre hele appen eller nettstedet mitt gjennom Google Translate og få en grunnleggende oversettelse på et annet språk?

Nå kan du!

Navnet hokeylization er et portmanteau, som betyr "hokey lokalisering"

Det er litt hektisk fordi det er veldig enkelt: det sender strenger til Google Translate

Og den er enkel, men samtidig veldig kraftig. Den har spesiell støtte for HTML-dokumenter, HandlebarsJS maler, og Markdown filer.

Du kan oversette:

et JavaScript-objekt som inneholder meldinger
et hvilket som helst antall filer eller kataloger, som alltid krysser kataloger rekursivt

Les dette på et annet språk

Dette README.md-dokumentet har blitt oversatt, ved å bruke selve hokeyliseringsverktøyet, til alle språk som støttes av Google Translate!

Jeg er sikker på at det ikke er perfekt, men jeg håper det er bedre enn ingenting!

🇸🇦 arabisk 🇧🇩 Bengali 🇩🇪 tysk 🇺🇸 engelsk 🇪🇸 spansk 🇫🇷 fransk 🇹🇩 Hausa 🇮🇳 hindi 🇮🇩 indonesisk 🇮🇹 italiensk 🇯🇵 japansk 🇰🇷 koreansk 🇮🇳 Marathi 🇵🇱 polsk 🇧🇷 portugisisk 🇷🇺 russisk 🇰🇪 Swahili 🇵🇭 Tagalog 🇹🇷 tyrkisk 🇵🇰 Urdu 🇻🇳 vietnamesisk 🇨🇳 kinesisk

📚 ... Alle språk ...

Er det et problem med denne oversettelsen av README?

Denne spesielle oversettelsen av originalen README kan være feil -- rettelser er svært velkomne! Send en pull request på GitHub, eller hvis du ikke er komfortabel med å gjøre det, åpne et problem

Når du oppretter et nytt GitHub-problem om en oversettelse, vennligst gjør:

Ta med sidens URL (kopier/lim inn fra nettleserens adresselinje)
Ta med den eksakte teksten som er feil (kopier/lim inn fra nettleseren)
beskriv hva som er galt -- er oversettelsen feil? er formateringen ødelagt på en eller annen måte?
kom gjerne med et forslag til en bedre oversettelse, eller hvordan teksten bør formateres riktig
Takk skal du ha!

Innhold

Kilde
Support and Funding
Installasjon
Oppsett
Oversette en JavaScript-strengressursfil
[Oversette en katalog med tekstfiler](#Oversette-en-katalog med tekstfiler)
Andre alternativer
JSON batch-kommandoer

Kilde

hokeylization på GitHub
hokeylization on npm

Støtte og finansiering

Jeg prøver å være en profesjonell programvareutvikler med åpen kildekode. Jeg har jobbet i programvareindustrien i mange år, har jeg startet suksessfulle selskaper og solgt dem til offentlige selskaper. Nylig mistet jeg jobben min, og jeg har egentlig ikke noe annet arbeid på rad

Så jeg skal prøve å skrive nyttig programvare og se om det fungerer

Hvis du liker å bruke denne programvaren, vil jeg være så glad for å motta selv minste månedlig bidrag via Patreon

Takk skal du ha!

Installasjon

For å bruke kommandolinjeverktøyet, installer med npm eller yarn :

npm install -g hokeylization
yarn global add hokeylization

For å bruke som et bibliotek, installer lite versjonen, som er mye mindre:

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

Se så på hjelpen for hokey -kommandoen:

hokey --help
hokey -h

Vil du se utdata på ditt språk eller et annet språk?

hokey prøver å oppdage språket automatisk fra skallets miljøvariabler

Du kan tvinge et språk ved å sette LC_ALL :

LC_ALL=it hokey --help

Merk at hvis du har installert hokeylization-lite , er kommandohjelp kun tilgjengelig på engelsk

Oppsett

Angi GOOGLE_TRANSLATE_PROJECT_ID " for å identifisere Google Translate-prosjektet ditt

Angi miljøvariabelen GOOGLE_APPLICATION_CREDENTIALS " til JSON-legitimasjonen du lastet ned etter å ha funnet ut hvordan autentisering fungerer på Google Cloud (det kan være morsomt)

Hvis du kjører fra kildekoden, kan du også legge disse i en .env -fil i kilden katalogen blir de lastet inn under kjøring via dotenv

Oversettelse av en JavaScript-strengressursfil

Din strengtabell må være i en JavaScript-fil i en av disse to formene:

ES6 eksport:

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

CommonJS eksport

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

Hvis denne filen ble kalt myfile.en.js , kan du oversette den til spansk og tysk med:

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

LANG i det ovenstående er spesielt -- det er et reservert ord i dette verktøyet!

LANG erstattes med språkkoden for utdatafilene

Dermed oppretter kommandoen ovenfor filene:

myfile.es.js
myfile.de.js

Alternativet -l / --languages er en kommadelt liste over ISO-språkkoder støttet av Google Translate

Hvis utdatafilen allerede eksisterer, vil den bli undersøkt for å finne ut hvilke nøkler som allerede eksisterer. Eksisterende nøkler vil ikke bli oversatt. Oversettelser for manglende nøkler vil bli generert og lagt til til slutten av JS-objektet. Hele filen skrives alltid om.

For å tvinge alle nøkler på nytt, bruk alternativet -f / --force

Oversette en katalog med tekstfiler

Du kan også oversette en katalog med filer. hokeylisering vil rekursivt besøke hver fil i katalogen og kjør innholdet gjennom Google Translate, og lagre utdataene til en identisk navngitt fil i et eget katalogtre

Når målet for oversettelsen din er en katalog, er denne modusen aktivert

Alternativet -o / --outfile spesifiserer utdatakatalogen

STOR ADVARSEL: Når du oversetter kataloger, IKKE spesifiser en utdatakatalog som er i inndatakatalogen din! Hvis du gjør dette, vil du:

indusere uendelig rekursjon
kjør Google-regningen din
fyll opp disken din
ha mindre moro

Her er et eksempel på hva ikke å gjøre:

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

Når dette kjører, blir oversatte filer skrevet til templates/es , og blir dermed nye kildefiler som skal oversettes, siden de er under templates/ -- denne prosessen fortsetter for alltid, ikke gjør det!

Riktig bruk

OK, la oss si at du har noen e-postmaler i en katalog:

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

For å oversette alle disse til spansk og tysk, kjør:

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

I det ovenstående er LANG et reservert ord og vil bli erstattet med ISO-språkkoden

Hva skjer når ovenstående kjører:

templates/email/es ' og templates/email/de katalogene vil bli opprettet (hvis de ikke eksisterer)
Hver fil i templates/email/en vil bli oversatt til spansk og tysk
Eksisterende utdatafiler vil ikke bli regenerert med mindre du bruker -f / --force
Du vil ende opp med en identisk katalogstruktur og filer innenfor es og de som du har under en

Andre muligheter

Tørrløp

Pass -n / --dry-run for å vise hva som ville bli gjort, men ikke foreta noen API-kall eller skrive noen filer

Kraft

Pass -f / --force for alltid å gjenskape oversettelser, selv om de allerede eksisterer

Kamp

Pass -m / --match for å begrense filene som behandles når du kjører i katalogmodus

Du vil kanskje ikke alltid oversette hver fil i kildekatalogen din til målkatalogen

Verdien av -m / --match -alternativet er et regulært uttrykk (pass opp for shell-siteringsregler!) som spesifiserer hvilke filer som skal oversettes

Når du er i tvil, kan du kombinere dette alternativet med -n / --dry-run for å se hvilke filer som vil bli oversatt

Ekskluderer

Noen ganger samsvarer din -m for mange filer. Bruk alternativet -e / --excludes for å eksplisitt ekskludere filer som ellers ville ha samsvart

Du kan liste opp flere regexes, atskilt med mellomrom

En vanlig bruk vil være: --excludes node_modules dist \.git build tmp

Styre

Strengene som skal oversettes kan inneholde {{ handlebars }} -maler, enten med to eller tre krøllete klammeparenteser

Du vil sannsynligvis IKKE at tingene i disse malene skal oversettes

Pass på -H / --handlebars , og alt innenfor {{ ... }} vil ikke bli oversatt

Markdown

Markdown er verken tekst eller html, så Google Translate har noen problemer med det

-M / --markdown flagget muliggjør spesiell håndtering av markdown-filer

Med markdown-filer, hvis du ikke bruker -M -flagget, vil du sannsynligvis finne disse problemene:

Ødelagte lenker. I oversettelsen vises et mellomromstegn etter at en beskrivelse av markdown-lenker slutter (med ] ) men før målkoblingen begynner (med ( ). Dette fører til at markdown-en blir feil gjengitt, og koblingen er ødelagt når du ser på dokumentet.
Kodeblokker blir oversatt. Google translate vet ikke hva markdown anser kode og hva den ikke gjør
Feil mellomrom for innrykkede kodeblokker. Avstand er vanskelig å bevare i oversettelse
Ting inne i backticks blir oversatt når du nesten alltid vil at de skal være bokstavelige verdier

Når flagget -M / --markdown er aktivert:

Mønsteret ]( vil bli komprimert til ]( og fikser dermed de ødelagte markdown-lenkene
En "no translate"-omslag vil bli plassert rundt innrykkede kodeblokker, for å bevare riktig innrykk og sikre at de ikke blir oversatt
En "no translate"-omslag vil bli plassert rundt tekst innenfor backticks for å sikre at de ikke blir oversatt

Behandle-som

Normalt behandles alt som ren tekst

Hvis innholdet ditt er HTML, vil det bli ødelagt med mindre du passerer alternativet -p html / --process-as html

Filter

For de eventyrlystne: når du behandler filer i en katalog, kan du passere alternativet -F / --filter for å filtrere utdata før det skrives til filsystemet

Verdien av dette alternativet må være en bane til en JS-fil som eksporterer en funksjon kalt filter

filter funksjonen må være async fordi await vil bli kalt på den

Før filer skrives til disk, vil hele filinnholdet bli sendt til filter -funksjonen som en streng

Returverdien fra filter -funksjonen er det som faktisk vil bli skrevet til lagring

Dermed har du total kontroll over hva som til slutt skal skrives

filter skriptet vil bli sett etter på følgende steder (med .js vil bli lagt til filteret navn, med mindre det allerede slutter på .js )

Gjeldende katalog
En katalog kalt .hokey-filters i gjeldende katalog
En katalog kalt ${HOME}/.hokey-filters , der ${HOME} er gjeldende brukers hjemmekatalog
Den innebygde filterkatalogen

Filterparametere

filter strengen kan være flere ord. I dette tilfellet er det første ordet filternavnet, og de resterende ordene vil bli sendt som argumenter til filter -funksjonen

Hjelp

Bruk -h / --help for å vise hjelp

JSON batch-kommandoer

Med alternativet -j / --json kan du kjøre flere koordinerte hokey kommandoer

Ved konvensjon kalles denne filen hokey.json , men du kan navngi den hva du vil

Hvis du sender en katalog som -j -alternativet, vil hokey se etter en hokey.json i den katalogen

JSON-filen skal inneholde ett objekt. Innenfor dette objektet er egenskapsnavnene de samme som kommandolinjealternativene, pluss en ekstra egenskap kalt hokey

hokey egenskapen er en rekke kommandoer som skal kjøres. Egenskapene deklarert innenfor disse kommandoene vil overstyre eventuelle dupliserte erklæringer i det ytre objektet.

Innenfor hvert objekt i hokey matrisen bør du spesifisere et name og inndata- og utdatafilene

Her er et eksempel på en 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"
      }
    ]
}

Flere inndatafiler

Send en rekke filbaner som infiles stedet for en enkelt bane infile , som i dette eksemplet:

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

Indekser

Når du oversetter til mange språk, kan hokey lage en indeksfil som viser alle oversettelsene som er gjort og gir lenker til dem

Når du genererer indekser, kan du bare ha én inngangskilde

Pass på -I / --index , verdien er der indeksfilen vil bli generert, som kan være en fil eller en katalog. Hvis det er en katalog, vil et standard filnavn bli brukt, basert på malen (se nedenfor)

Bruk -A / --index-template for å bestemme hvordan indeksutdataene er formatert. Du kan spesifisere 'html', 'markdown', 'text' eller filbanen til din egen HandlebarsJS mal

Hvis du spesifiserer din egen mal, må du også spesifisere en fil (ikke en katalog) for -I / --index alternativ

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeylisering

Les dette på et annet språk

📚 ... Alle språk ...

Er det et problem med denne oversettelsen av README?

Innhold

Kilde

Støtte og finansiering

Installasjon

Oppsett

Oversettelse av en JavaScript-strengressursfil

Oversette en katalog med tekstfiler

Riktig bruk

Andre muligheter

Tørrløp

Kraft

Kamp

Ekskluderer

Styre

Markdown

Behandle-som

Filter

Filterparametere

Hjelp

JSON batch-kommandoer

Flere inndatafiler

Indekser

Ha det gøy med å oversette språk!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeylisering

Les dette på et annet språk

📚 ... Alle språk ...

Er det et problem med denne oversettelsen av README?

Innhold

Kilde

Støtte og finansiering

Installasjon

Oppsett

Oversettelse av en JavaScript-strengressursfil

Oversette en katalog med tekstfiler

Riktig bruk

Andre muligheter

Tørrløp

Kraft

Kamp

Ekskluderer

Styre

Markdown

Behandle-som

Filter

Filterparametere

Hjelp

JSON batch-kommandoer

Flere inndatafiler

Indekser

Ha det gøy med å oversette språk!