Hokeilizacija

Zašto ne mogu pokrenuti cijelu svoju aplikaciju ili web lokaciju putem Google Translatea i dobiti osnovni prijevod na drugom jeziku?

Sada možeš!

Naziv hokeylization je portmanteau, što znači "hokey lokalizacija"

Pomalo je zeznuto jer je vrlo jednostavno: šalje stringove Google Translateu

I jednostavan je, ali i veoma moćan. Ima posebnu podršku za HTML dokumente, HandlebarsJS predlošci, i datoteke Markdown.

Možete prevesti:

JavaScript objekat koji sadrži poruke
bilo koji broj datoteka ili direktorija, uvijek prelazeći direktorije rekurzivno

Pročitajte ovo na drugom jeziku

Ovaj README.md dokument je preveden, koristeći sam alat za hokeilizaciju, u svaki jezik podržan od strane Google prevodioca!

Siguran sam da nije savršeno, ali nadam se da je bolje nego ništa!

🇸🇦 arapski 🇧🇩 bengalski 🇩🇪 njemački 🇺🇸 engleski 🇪🇸 španski 🇫🇷 francuski 🇹🇩 Hausa 🇮🇳 hindi 🇮🇩 indonezijski 🇮🇹 talijanski 🇯🇵 japanski 🇰🇷 korejski 🇮🇳 Marathi 🇵🇱 poljski 🇧🇷 portugalski 🇷🇺 ruski 🇰🇪 Svahili 🇵🇭 Tagalog 🇹🇷 turski 🇵🇰 Urdu 🇻🇳 vijetnamski 🇨🇳 kineski

📚 ... Svi jezici ...

Postoji li problem sa ovim prijevodom README-a?

Ovaj konkretni prijevod originalnog README može biti pogrešan -- ispravke su dobrodošle! Molimo pošaljite zahtjev za povlačenje na GitHub, ili ako vam to nije ugodno, otvorite problem

Kada kreirate novi GitHub problem o prijevodu, učinite:

uključite URL stranice (kopirajte/zalijepite iz adresne trake pretraživača)
uključite tačan tekst koji je pogrešan (kopirajte/zalijepite iz pretraživača)
opišite šta nije u redu -- da li je prevod netačan? da li je formatiranje nekako pokvareno?
ljubazno ponudite prijedlog boljeg prijevoda, odnosno kako bi tekst trebao biti pravilno formatiran
Hvala ti!

Sadržaj

Izvor
Podrška i finansiranje
Instalacija
Setup
Prevođenje datoteke resursa sa JavaScript stringom
Prevođenje direktorija tekstualnih datoteka
Ostale opcije
JSON batch komande

Izvor

hokeylization na GitHub
hokeylizacija na npm

Podrška i finansiranje

Pokušavam biti profesionalni programer otvorenog koda. Ja sam radio u softverskoj industriji dugi niz godina, pokrenuo sam uspješne kompanije i prodao ih javnim preduzećima. Nedavno sam izgubio posao i nemam nikakav drugi posao u redu

Zato ću pokušati da napišem koristan softver i da vidim da li radi

Ako uživate u korištenju ovog softvera, bio bih tako sretan da dobijem čak i ovaj softver najmanji mjesečni doprinos putem Patreona

Hvala ti!

Instalacija

Da biste koristili alat naredbene linije, instalirajte koristeći npm ili yarn :

npm install -g hokeylization
yarn global add hokeylization

Da biste koristili kao biblioteku, instalirajte lite verziju, koja je mnogo manja:

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

Zatim pogledajte pomoć za naredbu hokey :

hokey --help
hokey -h

Želite li vidjeti izlaz na svom jeziku ili drugom jeziku?

hokey pokušava automatski detektirati jezik iz varijabli okruženja vaše ljuske

Možete forsirati jezik postavljanjem varijable okruženja LC_ALL :

LC_ALL=it hokey --help

Imajte na umu da ako ste instalirali hokeylization-lite , pomoć naredbi je dostupna samo na engleskom

Postaviti

Postavite varijablu okruženja GOOGLE_TRANSLATE_PROJECT_ID za identifikaciju vašeg projekta Google Translate

Postavite varijablu okruženja GOOGLE_APPLICATION_CREDENTIALS na JSON vjerodajnice koje ste preuzeli nakon što shvatite kako autentifikacija funkcionira na Google oblaku (može biti zabavno)

Ako pokrećete iz izvornog koda, možete ih također staviti u .env datoteku u izvornom kodu direktorij oni će biti učitani u vrijeme izvođenja putem dotenv

Prevođenje JavaScript datoteke resursa stringova

Vaša tabela stringova mora biti u JavaScript datoteci u jednom od ova dva oblika:

ES6 izvoz:

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

CommonJS izvoz

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

Ako je ovaj fajl nazvan myfile.en.js , možete ga prevesti na španski i nemački sa:

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

LANG u gornjem tekstu je poseban -- to je rezervirana riječ u ovom alatu!

LANG je zamijenjen kodom jezika za izlazne datoteke

Tako gornja komanda kreira fajlove:

myfile.es.js
myfile.de.js

Opcija -l / --languages je lista ISO jezičnih kodova razdvojena zarezima podržava Google Prevodilac

Ako izlazna datoteka već postoji, bit će ispitana kako bi se utvrdilo koji ključevi već postoje. Postojeći ključevi neće biti prevedeni. Prijevodi za ključeve koji nedostaju bit će generirani i dodati do kraja JS objekta. Cijeli fajl se uvijek prepisuje.

Za prisilno ponovno prevođenje svih ključeva, koristite opciju -f / --force

Prevođenje direktorija tekstualnih datoteka

Također možete prevesti direktorij datoteka. hokeilizacija će rekurzivno posjetiti svaki datoteku u direktoriju i pokrenite njen sadržaj kroz Google Translate i sačuvajte izlaz na identično imenovanu datoteku u zasebnom stablu direktorija

Kada je cilj vašeg prijevoda direktorij, ovaj način je omogućen

Opcija -o / --outfile specificira izlazni direktorij

VELIKO UPOZORENJE: Prilikom prevođenja direktorija, NEmojte navoditi izlazni direktorij koji se nalazi unutar vašeg ulaznog direktorija! Ako to učinite, učinit ćete:

inducirati beskonačnu rekurziju
pokrenite Google račun
napunite svoj disk
manje se zabavljajte

Evo primjera šta ne treba raditi:

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

Kada se ovo pokrene, prevedene datoteke se upisuju u templates/es i tako postaju nove izvorne datoteke za prevođenje, budući da su pod templates/ -- ovaj proces se nastavlja zauvek, ne radi to!

Ispravna upotreba

OK, recimo da imate neke šablone e-pošte u direktoriju:

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

Da biste sve ovo preveli na španski i njemački, pokrenite:

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

U gornjem tekstu, LANG je rezervirana riječ i bit će zamijenjena ISO kodom jezika

Šta se dešava kada se gore navedeno pokrene:

Direktorijumi templates/email/es i templates/email/de će biti kreirani (ako ne postoje)
Svaki fajl u templates/email/en će biti preveden na španski i nemački
Postojeći izlazni fajlovi neće biti regenerisani osim ako ne koristite -f / --force
Na kraju ćete imati identičnu strukturu direktorija i datoteke unutar es i de kao što imate pod en

Druge opcije

Suho trcanje

Prođite -n / --dry-run da prikažete šta bi bilo urađeno, ali zapravo nemojte upućivati nikakve API pozive niti pisati bilo kakve datoteke

Force

-f / --force da uvijek regenerirate prijevode, čak i ako već postoje

Match

Proslijedite -m / --match da ograničite datoteke koje se obrađuju kada se izvode u načinu rada direktorija

Možda nećete uvijek htjeti prevesti svaku datoteku u vašem izvornom direktoriju u ciljni direktorij

Vrijednost opcije -m / --match je regex (pazite na pravila navođenja ljuske!) koji specificira koje datoteke treba prevesti

Kada ste u nedoumici, možete kombinirati ovu opciju sa -n / --dry-run da vidite koje datoteke će biti prevedene

Isključuje

Ponekad vaš -m odgovara previše fajlova. Koristite opciju -e / --excludes za eksplicitno izuzimanje datoteke koje bi se inače podudarale

Možete navesti više regularnih izraza, razdvojenih razmacima

Uobičajena upotreba bi bila: --excludes node_modules dist \.git build tmp

Upravljači

Nizovi za prevođenje mogu sadržavati {{ handlebars }} šablone, bilo s dvije ili tri vitičaste zagrade

Vjerovatno NE želite da se stvari unutar tih šablona prevedu

Proslijedi -H / --handlebars zastavicu i ništa unutar {{ ... }} neće biti prevedeno

Markdown

Markdown nije ni tekst ni html, tako da Google Translate ima nekih poteškoća s tim

Oznaka -M / --markdown omogućava posebno rukovanje datotekama za smanjenje vrijednosti

Sa mardown fajlovima, ako ne koristite -M zastavicu, vjerovatno ćete pronaći ove probleme:

Neispravne veze. U prijevodu, razmak se pojavljuje nakon što se završi opis linka za smanjenje (sa ] ), ali prije nego počne njegova ciljna veza (sa ( ). Ovo uzrokuje da se umanjenje neispravno renderira, a veza je pokvaren prilikom pregledavanja dokumenta.
Blokovi koda se prevode. Google prevodilac ne zna šta markdown smatra kodom, a šta ne
Neispravan razmak za uvučene blokove koda. Razmak je teško sačuvati u prijevodu
Stvari unutar backticks će se prevesti kada skoro uvijek želite da budu doslovne vrijednosti

Kada je omogućena zastavica -M / --markdown :

Uzorak ]( će se sažeti u ]( čime se popravljaju pokvarene veze za smanjenje vrijednosti
Omot "bez prevođenja" bit će postavljen oko uvučenih blokova koda, čuvajući ispravno uvlačenje i osiguravajući da nisu prevedeni
Omotač "bez prevođenja" bit će postavljen oko teksta unutar backticks kako bi se osiguralo da nisu prevedeni

Proces-as

Obično se sve obrađuje kao običan tekst

Ako je vaš sadržaj HTML, bit će oštećen osim ako ne prođete opciju -p html / --process-as html

Filter

Za avanturiste: kada obrađujete datoteke u direktoriju, možete proslijediti opciju -F / --filter za filtriranje izlaza prije nego što se upiše u sistem datoteka

Vrijednost ove opcije mora biti put do JS datoteke koja izvozi funkciju pod nazivom filter

Funkcija filter mora biti async jer će await biti pozvana na njoj

Prije nego što se datoteke zapišu na disk, cijeli sadržaj datoteke će biti proslijeđen funkciji filter kao niz

Povratna vrijednost iz funkcije filter je ono što će zapravo biti zapisano u memoriju

Dakle, imate potpunu kontrolu nad onim što će konačno biti napisano

Skripta filter će se tražiti na sljedećim lokacijama (sa .js će biti dodat filteru ime, osim ako se već završava na .js )

Trenutni direktorij
Direktorij pod nazivom .hokey-filters unutar trenutnog direktorija
Direktorij pod nazivom ${HOME}/.hokey-filters , gdje ${HOME} početni direktorij trenutnog korisnika
Ugrađeni direktorij filtera

Parametri filtera

filter može biti više riječi. U ovom slučaju, prva riječ je naziv filtera i preostale riječi će biti proslijeđene kao argumenti funkciji filter

Pomoć

Koristite -h / --help za prikaz pomoći

JSON skupne naredbe

Sa -j / --json , možete pokrenuti više koordinisanih hokey komandi

Po konvenciji se ovaj fajl zove hokey.json , ali ga možete imenovati kako god želite

Ako prosledite direktorijum kao opciju -j , hokey će tražiti hokey.json u tom direktoriju

JSON fajl treba da sadrži jedan objekat. Unutar tog objekta, imena njegovih svojstava su ista kao opcije komandne linije, plus jedno dodatno svojstvo pod nazivom hokey

Svojstvo hokey je niz naredbi za pokretanje. Svojstva deklarisana unutar ovih naredbi će nadjačati sve duple deklaracije u vanjskom objektu.

Unutar svakog objekta u nizu hokey , trebali biste navesti name i ulazne i izlazne datoteke

Evo primjera 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"
      }
    ]
}

Višestruki ulazni fajlovi

Proslijedite niz putanja datoteka kao infiles umjesto jedne staze infile , kao u ovom primjeru:

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

Indeksi

Prilikom prevođenja na mnoge jezike, hokey može kreirati indeksni fajl koji navodi sve prijevode napravljene i pruža veze do njih

Prilikom generisanja indeksa, možete imati samo jedan izvor unosa

Prenesite opciju -I / --index , vrijednost je mjesto gdje će se generirati indeksna datoteka, što može biti datoteka ili imenik. Ako je to direktorij, koristit će se zadani naziv datoteke, na osnovu predloška (pogledajte dolje)

Koristite -A / --index-template da odredite kako je formatiran izlaz indeksa. Možete odrediti 'html', 'markdown', 'text' ili putanja datoteke do vašeg vlastitog HandlebarsJS predloška

Ako navedete svoj vlastiti predložak, također morate navesti datoteku (ne direktorij) za -I / --index opcija

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Hokeilizacija

Pročitajte ovo na drugom jeziku

📚 ... Svi jezici ...

Postoji li problem sa ovim prijevodom README-a?

Sadržaj

Izvor

Podrška i finansiranje

Instalacija

Postaviti

Prevođenje JavaScript datoteke resursa stringova

Prevođenje direktorija tekstualnih datoteka

Ispravna upotreba

Druge opcije

Suho trcanje

Force

Match

Isključuje

Upravljači

Markdown

Proces-as

Filter

Parametri filtera

Pomoć

JSON skupne naredbe

Višestruki ulazni fajlovi

Indeksi

Zabavite se prevodeći jezike!

Files

README.md

Latest commit

History

README.md

File metadata and controls

Hokeilizacija

Pročitajte ovo na drugom jeziku

📚 ... Svi jezici ...

Postoji li problem sa ovim prijevodom README-a?

Sadržaj

Izvor

Podrška i finansiranje

Instalacija

Postaviti

Prevođenje JavaScript datoteke resursa stringova

Prevođenje direktorija tekstualnih datoteka

Ispravna upotreba

Druge opcije

Suho trcanje

Force

Match

Isključuje

Upravljači

Markdown

Proces-as

Filter

Parametri filtera

Pomoć

JSON skupne naredbe

Višestruki ulazni fajlovi

Indeksi

Zabavite se prevodeći jezike!