Instalējiet Un Lietojiet

windows Vispirms Instalējiet git bash

windows , lūdzu , noklikšķiniet šeit, lai vispirms lejupielādētu un instalētu git bash .

Palaidiet nākamās darbības git bash .

Instalējiet

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

Konfigurēt Tulkošanas Pilnvaru

Apmeklējiet i18n.site/token

Izveidojiet ~/.config/i18n.site.yml , ielīmējiet tajā nokopēto saturu, saturs ir šāds:

token: YOUR_API_TOKEN

i18n.site/payBill , lai veiktu maksājumu, ir jāiesaista kredītkarte (nav jāveic papildmaksa, vietne automātiski ieturēs maksu atbilstoši lietojumam, cenu noteikšanu skatiet mājaslapā ).

Izmantot

Demo Projekts

Lūdzu, skatiet demonstrācijas projektu github.com/i18n-site/demo.i18 lai uzzinātu i18 tulkojuma konfigurāciju.

Lietotāji Ķīnā var klonēt atomgit.com/i18n/demo.i18

Pēc klonēšanas ievadiet direktoriju un palaidiet i18 , lai pabeigtu tulkojumu.

Direktoriju Struktūra

Veidnes noliktavas direktorija struktūra ir šāda

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

Tulkotie demonstrācijas faili direktorijā en ir tikai piemērs, un tos var izdzēst.

Palaist Tulkošanu

Ievadiet direktoriju un palaidiet i18 , lai tulkotu.

Papildus tulkojumam programma ģenerēs arī mapi .i18n/data , lūdzu, pievienojiet to repozitorijai.

Pēc jaunā faila tulkošanas šajā direktorijā tiks ģenerēts jauns datu fails. Atcerieties pievienot git add . .

Konfigurācijas Fails

.i18n/conf.yml ir i18 komandrindas tulkošanas rīka konfigurācijas fails

Saturs ir šāds:

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

ignore:
  - _*

Avota & Tulkošanas Valoda

Konfigurācijas failā fromTo pakārtotais:

en ir avota valoda, zh ja ko de fr ir tulkojuma mērķa valoda.

Valodas kodu skat i18n.site/i18/LANG_CODE

Piemēram, ja vēlaties tulkot ķīniešu valodu angļu valodā, pārrakstiet šo rindiņu zh: en .

Ja vēlaties tulkot visās atbalstītajās valodās, pēc : atstājiet lauku tukšu. piemēram

i18n:
  fromTo:
    en:

/ apakšdirektorijiem var konfigurēt dažādus fromTo Demonstrācija ir uzrakstīta šādi :

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

Šajā konfigurācijas tabulā blog kataloga tulkojuma avota valoda ir zh , bet blog/your_file_name.md kataloga tulkojuma avota valoda ir ja .

Daudzvalodu Attēli/Saites

Ja URL attēlos un saitēs replace: un MarkDown (un iegultā HTML atribūtiem src un href ) ir konfigurēti .i18n/conf.yml ar šo prefiksu, avota valodas kods vietrādī URL tiks aizstāts ar tulkojuma valodas kodu ( valoda kodu saraksts ).

Piemēram, jūsu konfigurācija ir šāda:

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: ir vārdnīca, atslēga ir URL prefikss, kas jāaizstāj, un vērtība ir aizstāšanas kārtula.

Iepriekš minētā noteikuma ko de uk>ru zh-TW>zh >en aizstāšanas nozīme ir tāda, ka ko de izmanto sava valodas koda attēlu, zh-TW un zh izmanto zh attēlu, uk izmanto ru attēlu un citas valodas (piemēram, ja ) izmanto attēlu. no en pēc noklusējuma.

Piemēram, franču ( fr ) avota fails ar MarkDown ir šāds :

![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>

Tulkotais un ģenerētais angļu ( en ) fails ir šāds :

![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>

Šeit /en/ avota valodas kodā tiek aizstāti ar /zh/ mērķa valodā.

Piezīme : Vietrādī URL ir jābūt / pirms un pēc aizstātā teksta valodas koda.

[!TIP] Ja - / ir konfigurēts url: , tiks saskaņoti tikai relatīvie ceļi, bet URL, kas sākas ar // netiks saskaņoti.
Ja dažas domēna vārda saites vēlas aizstāt, bet dažas nevēlas aizstāt, varat izmantot dažādus prefiksus, piemēram, [x](//x.com/en/) un [x](//x.com/en/) , lai tās atšķirtu.

Ignorēt Failu

Pēc noklusējuma visi faili, kas sākas ar .md un .yml avota valodas direktorijā, tiks tulkoti.

Ja vēlaties ignorēt noteiktus failus un netulkot tos (piemēram, nepabeigtos melnrakstus), varat to konfigurēt, izmantojot lauku ignore .

ignore izmanto to globset sintaksi kā .gitignore fails.

Piemēram, _* iepriekš minētajā konfigurācijas failā nozīmē, ka faili, kas sākas ar _ netiks tulkoti.

Tulkošanas Noteikumi

Tulkošanas Redaktoriem Nevajadzētu Pievienot Vai Dzēst Rindas

Tulkojums ir rediģējams. Pārveidojiet oriģinālo tekstu un mašīntulkojiet to vēlreiz, manuālās tulkojuma izmaiņas netiks pārrakstītas (ja šī oriģinālā teksta rindkopa nav mainīta).

[!WARN] Tulkojuma un oriģinālā teksta rindiņām jāatbilst vienai pret vienu. Tas ir, nepievienojiet un nedzēsiet rindiņas, apkopojot tulkojumu. Pretējā gadījumā tas radīs neskaidrības tulkojuma rediģēšanas kešatmiņā.

Ja kaut kas noiet greizi, lūdzu, skatiet risinājumus FAQ.

`YAML` Tulkojumu

Komandrindas rīks avota valodas failu direktorijā atradīs visus failus, kas beidzas ar .yml un iztulkos tos.

Ņemiet vērā, ka faila nosaukuma sufiksam ir jābūt .yml (nevis .yaml ).

Šis rīks tulko tikai vārdnīcas vērtības .yml , nevis vārdnīcas taustiņus.

Piemēram, i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

tiks tulkots kā i18n/zh/i18n.yml

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

YAML tulkojumu var mainīt arī manuāli (taču nepievienojiet un nedzēsiet tulkojumā taustiņus vai rindiņas).

Balstoties uz YAML tulkojumu, jūs varat viegli izveidot starptautiskus risinājumus dažādām programmēšanas valodām.

Uzlabota Lietošana

Tulkošanas Apakšdirektorijs

Kamēr ir izveidots .i18n/conf.yml (nav nepieciešams katru reizi sākt no demonstrācijas projekta veidnes), i18 darbosies labi.

Komandrindas rīks visos apakšdirektorijos atradīs .i18n/conf.yml konfigurācijas un pārtulkos tās.

Projekti, kas izmanto monorepo , var sadalīt valodu failus apakšdirektorijos.

Pielāgots Instalācijas Direktorijs

Pēc noklusējuma tas tiks instalēts uz /usr/local/bin .

Ja /usr/local/bin nav rakstīšanas atļaujas, tas tiks instalēts ~/.bin .

Vides mainīgā TO iestatījums var definēt instalācijas direktoriju, piemēram :

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