Instal Lan Nggunakake

windows Pisanan Nginstal git bash

windows , mangga klik ing kene kanggo ngundhuh lan nginstal git bash dhisik .

Jalanake operasi sakteruse ing git bash .

Instal

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

Konfigurasi Token Terjemahan

Dolan maring i18n.site/token Klik kanggo nyalin token

Nggawe ~/.config/i18n.site.yml , paste isi sing disalin menyang, isine kaya ing ngisor iki:

token: YOUR_API_TOKEN

i18n.site/payBill , sampeyan kudu ngubungake kertu kredit kanggo pambayaran (ora perlu diisi ulang, situs web bakal nyuda biaya kanthi otomatis miturut panggunaan, deleng homepage kanggo rega ).

Nggunakake

Proyek Demo

Mangga deleng proyek demo github.com/i18n-site/demo.i18 sinau konfigurasi i18 terjemahan.

Pangguna ing China bisa kloning atomgit.com/i18n/demo.i18

Sawise kloning, ketik direktori lan mbukak i18 kanggo ngrampungake terjemahan.

Struktur Direktori

Struktur direktori gudang cithakan kaya ing ngisor iki

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

File demo sing diterjemahake ing direktori en mung minangka conto lan bisa dibusak.

Run Terjemahan

Ketik direktori lan mbukak i18 kanggo nerjemahake.

Saliyane terjemahan, program kasebut uga bakal ngasilake folder .i18n/data , mangga ditambahake menyang repositori.

Sawise nerjemahake file anyar, file data anyar bakal digawe ing direktori iki Elinga nambah git add . .

File Konfigurasi

.i18n/conf.yml minangka file konfigurasi saka alat terjemahan baris perintah i18

Isine kaya ing ngisor iki:

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

ignore:
  - _*

Basa Sumber &

Ing file konfigurasi, subordinate fromTo :

en minangka basa sumber, zh ja ko de fr minangka basa sasaran terjemahan.

Kode basa ndeleng i18n.site/i18/LANG_CODE

Contone, yen sampeyan pengin nerjemahake Cina menyang Inggris, tulis maneh baris iki zh: en .

Yen sampeyan pengin nerjemahake menyang kabeh basa sing didhukung, kosongake sawise : . contone

i18n:
  fromTo:
    en:

: bisa ngatur macem-macem fromTo kanggo macem-macem subdirektori File /

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

Ing tabel konfigurasi iki, basa sumber terjemahan katalog blog yaiku zh , lan basa sumber terjemahan katalog blog/your_file_name.md yaiku ja .

Gambar / Pranala Multibasa

Nalika URL ing gambar lan pranala ing replace: lan MarkDown (lan atribut src lan href ditempelake HTML ) dikonfigurasi ing .i18n/conf.yml kanthi awalan iki, kode basa sumber ing URL bakal diganti karo kode basa terjemahan ( basa daftar kode ).

Contone, konfigurasi sampeyan kaya ing ngisor iki:

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: minangka kamus, kuncine yaiku awalan URL sing bakal diganti, lan nilai kasebut minangka aturan panggantos.

Tegese ngganti paugeran ko de uk>ru zh-TW>zh >en ing dhuwur yaiku ko de nggunakake gambar kode basane dhewe, zh-TW lan zh nggunakake gambar zh , uk nggunakake gambar ru , lan basa liyane (kayata ja ) nggunakake gambar. saka en minangka standar.

Contone, file sumber Prancis ( fr ) MarkDown kaya ing ngisor iki :

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

File basa Inggris ( en ) sing diterjemahake lan digawe kaya ing ngisor iki :

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

Ing kene, /en/ ing kode basa sumber diganti karo /zh/ ing basa target.

Cathetan : Mesthi ana / sadurunge lan sawise kode basa teks sing diganti ing URL.

[!TIP] Yen - / dikonfigurasi ing url: , mung path relatif sing bakal dicocogake, nanging URL sing diwiwiti karo // ora bakal cocog.

Yen sawetara pranala saka jeneng domain pengin diganti lan sawetara ora pengin diganti, sampeyan bisa nggunakake prefiks beda kayata [x](//x.com/en/) lan [x](//x.com/en/) kanggo mbedakake.

Nglirwakake File

Kanthi gawan, kabeh file sing diwiwiti karo .md lan .yml ing direktori basa sumber bakal diterjemahake.

Yen sampeyan pengin nglirwakake file tartamtu lan ora nerjemahake (kayata draf sing durung rampung), sampeyan bisa ngatur nganggo kolom ignore .

ignore nggunakake sintaks sing globset karo file .gitignore .

Contone, _* ing file konfigurasi ndhuwur tegese file sing diwiwiti karo _ ora bakal diterjemahake.

Aturan Terjemahan

Editor Terjemahan Ngirim Ora Nambah Utawa Mbusak Baris

Terjemahan bisa diowahi. Ngowahi teks asli lan mesin-terjemahake maneh, modifikasi manual kanggo terjemahan ora bakal ditimpa (yen paragraf teks asli iki durung diowahi).

[!WARN] Baris terjemahan lan teks asli kudu cocog siji-siji. Yaiku, aja nambah utawa mbusak baris nalika nyusun terjemahan. Yen ora, bakal nyebabake kebingungan ing cache panyuntingan terjemahan.

Yen ana masalah, deleng FAQ kanggo solusi.

YAML Terjemahan

Alat baris perintah bakal nemokake kabeh file sing diakhiri karo .yml ing direktori file basa sumber lan nerjemahake.

• Elinga yen sufiks jeneng berkas kudu .yml (ora .yaml ).

Alat kasebut mung nerjemahake nilai kamus ing .yml , dudu tombol kamus.

Contone i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

bakal diterjemahake dadi i18n/zh/i18n.yml

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

Terjemahan YAML uga bisa diowahi kanthi manual (nanging aja nambah utawa mbusak tombol utawa garis ing terjemahan).

Adhedhasar YAML terjemahan, sampeyan bisa kanthi gampang nggawe solusi internasional kanggo macem-macem basa pamrograman.

Panggunaan Majeng

Subdirektori Terjemahan

Anggere .i18n/conf.yml digawe (ora perlu kanggo miwiti saka demo project Cithakan saben wektu), i18 bakal bisa nggoleki.

Alat baris perintah bakal nemokake .i18n/conf.yml konfigurasi ing kabeh subdirektori lan nerjemahake.

Proyek sing nggunakake arsitektur monorepo bisa misahake file basa dadi subdirektori.

Direktori Instalasi Khusus

Iku bakal diinstal menyang /usr/local/bin minangka standar.

Yen /usr/local/bin ora duwe ijin nulis, bakal diinstal menyang ~/.bin .

Setelan variabel lingkungan TO bisa nemtokake direktori instalasi, contone :

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