Instalirajte I Koristite

windows Prvo Instalira git bash

windows Sustav, prvo kliknite ovdje da preuzmete i instalirate git bash .

Pokreni sljedeće operacije u git bash .

Instalirati

bash <(curl -sS https://i.i18n.site) i18

Konfigurirajte Prevoditeljski Token

Posjetite i18n.site/token Kliknite za kopiranje tokena

Stvorite ~/.config/i18n.site.yml , zalijepite kopirani sadržaj u njega, sadržaj je sljedeći:

token: YOUR_API_TOKEN

i18n.site/payBill , trebate vezati kreditnu karticu za plaćanje (nije potrebna nadoplata, web-mjesto će automatski oduzeti naknade prema korištenju, pogledajte početnu stranicu za cijene ).

Koristiti

Demo Projekt

Molimo pogledajte demo projekt github.com/i18n-site/demo.i18 biste naučili konfiguraciju i18 prijevoda.

Korisnici u Kini mogu klonirati atomgit.com/i18n/demo.i18

Nakon kloniranja unesite direktorij i pokrenite i18 da dovršite prijevod.

Struktura Imenika

Struktura imenika skladišta predloška je sljedeća

┌── .i18n
│  └── conf.yml
└── en
   ├── _IgnoreDemoFile.md
   ├── i18n.yml
   └── README.md

Prevedene demo datoteke u direktoriju en samo su primjer i mogu se izbrisati.

Pokreni Prijevod

Unesite imenik i pokrenite i18 za prijevod.

Osim prijevoda, program će također generirati mapu .i18n/data , dodajte je u repozitorij.

Nakon prevođenja nove datoteke, nova podatkovna datoteka bit će generirana u ovom direktoriju. Ne zaboravite dodati git add . .

Konfiguracijska Datoteka

.i18n/conf.yml je konfiguracijska datoteka alata za prevođenje naredbenog retka i18

Sadržaj je sljedeći:

i18n:
  fromTo:
    en: zh ja ko de fr
    # en:

ignore:
  - _*

Izvorni Jezik & Jezik Prijevoda

U konfiguracijskoj datoteci, podređeni od fromTo :

en je izvorni jezik, zh ja ko de fr je ciljni jezik prijevoda.

Vidi kod jezika i18n.site/i18/LANG_CODE

Na primjer, ako želite prevesti kineski na engleski, prepišite ovaj redak zh: en .

Ako želite prevoditi na sve podržane jezike, ostavite prazno nakon : . na primjer

i18n:
  fromTo:
    en:

Možete konfigurirati različite fromTo za različite poddirektorije / Demonstracija je napisana na sljedeći način :

i18n:
  fromTo:
    en:
  path:
    blog:
      fromTo:
        zh:
    blog/your_file_name.md:
      fromTo:
        ja:

U ovoj konfiguracijskoj tablici, izvorni jezik prijevoda kataloga blog je zh , a izvorni jezik prijevoda kataloga blog/your_file_name.md je ja .

Višejezične Slike/Veze

Kada su URL-ovi na slikama i poveznicama u replace: i MarkDown (i atributi src i href ugrađenog HTML ) konfigurirani u .i18n/conf.yml s ovim prefiksom, kôd izvornog jezika u URL-u bit će zamijenjen jezičnim kodom prijevoda ( jezik popis kodova ).

Na primjer, vaša konfiguracija je sljedeća:

i18n:
  fromTo:
    fr: ko de en zh zh-TW uk ru ja
  replace:
    https://fcdoc.github.io/img/ : ko de uk>ru zh-TW>zh >en

replace: je rječnik, ključ je URL prefiks koji treba zamijeniti, a vrijednost je pravilo zamjene.

Značenje zamjene pravila ko de uk>ru zh-TW>zh >en iznad je da ko de koristi sliku vlastitog jezičnog koda, zh-TW i zh koriste sliku zh , uk koristi sliku ru , a drugi jezici (kao što je ja ) koriste sliku od en prema zadanim postavkama.

Na primjer, francuska ( fr ) izvorna datoteka MarkDown je sljedeća :

![xx](//i18n-img.github.io/fr/1.avif)
<video src="https://i18n-img.github.io/fr/1.mp4"></video>
[xx](//i18n-img.github.io/fr/README.md)
<a style="color:red" href="https://i18n-img.github.io/fr/i18n.site.gz">xx</a>

Prevedena i generirana engleska ( en ) datoteka je sljedeća :

![xx](//i18n-img.github.io/en/1.avif)
<video src="https://i18n-img.github.io/en/1.mp4"></video>
[xx](//i18n-img.github.io/en/README.md)
<a style="color:red" href="https://i18n-img.github.io/en/i18n.site.gz">xx</a>

Ovdje su /en/ u kodu izvornog jezika zamijenjene /zh/ u ciljnom jeziku.

Napomena : Mora postojati / prije i poslije koda jezika zamijenjenog teksta u URL-u.

[!TIP] Ako je - / konfiguriran u url: , samo će se relativne staze podudarati, ali URL-ovi koji počinju s // neće se podudarati.
Ako neke veze naziva domene želite zamijeniti, a neke ne želite zamijeniti, možete koristiti različite prefikse kao što su [x](//x.com/en/) i [x](//x.com/en/) da ih razlikujete.

Ignoriraj Datoteku

Prema zadanim postavkama, sve datoteke koje počinju s .md i .yml u direktoriju izvornog jezika bit će prevedene.

Ako želite ignorirati određene datoteke i ne prevoditi ih (kao što su nedovršene skice), možete to konfigurirati s poljem ignore .

ignore koristi istu sintaksu globset kao i datoteka .gitignore .

Na primjer, _* u gornjoj konfiguracijskoj datoteci znači da datoteke koje počinju s _ neće biti prevedene.

Pravila Prevođenja

Urednici Prijevoda Ne Bi Trebali Dodavati Ili Brisati Retke

Prijevod se može uređivati. Izmijenite izvorni tekst i ponovno ga strojno prevedite, ručne izmjene prijevoda neće biti prebrisane (ako ovaj odlomak izvornog teksta nije izmijenjen).

[!WARN] Redci prijevoda i izvornog teksta moraju odgovarati jedan prema jedan. To jest, nemojte dodavati niti brisati retke prilikom sastavljanja prijevoda. U protivnom će izazvati zabunu u predmemoriji za uređivanje prijevoda.

Ako nešto pođe po zlu, molimo pogledajte FAQ za rješenja.

`YAML` Prijevoda

Alat naredbenog retka pronaći će sve datoteke koje završavaju s .yml u direktoriju datoteka izvornog jezika i prevesti ih.

Imajte na umu da sufiks naziva datoteke mora biti .yml (ne .yaml ).

Alat samo prevodi vrijednosti rječnika u .yml , a ne ključeve rječnika.

Na primjer i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

bit će prevedeno kao i18n/zh/i18n.yml

apiToken: 接口令牌
defaultToken: 默认令牌

Prijevod YAML također se može modificirati ručno (ali nemojte dodavati ili brisati ključeve ili retke u prijevodu).

Na temelju YAML prijevoda možete jednostavno izgraditi međunarodna rješenja za različite programske jezike.

Napredno Korištenje

Poddirektorij Prijevoda

Sve dok se kreira .i18n/conf.yml (nema potrebe svaki put pokretati od predloška demo projekta), i18 će dobro funkcionirati.

Alat naredbenog retka pronaći će .i18n/conf.yml konfiguracija u svim poddirektorijima i prevesti ih.

Projekti koji koriste arhitekturu monorepo mogu podijeliti jezične datoteke u poddirektorije.

Prilagođeni Instalacijski Direktorij

Instalirat će se na /usr/local/bin prema zadanim postavkama.

Ako /usr/local/bin nema dozvolu pisanja, bit će instaliran na ~/.bin .

Postavljanje varijable okoline TO može definirati instalacijski direktorij, na primjer :

TO=/bin sudo bash <(curl -sS https://i.i18n.site) i18