Pasang Sareng Dianggo

windows Mimiti Masang git bash

windows , mangga klik di dieu pikeun ngundeur tur masang git bash munggaran .

Jalankeun operasi saterusna dina git bash .

Pasang

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

Konpigurasikeun Token Tarjamah

Didatangan i18n.site/token Klik pikeun nyalin token

Jieun ~/.config/i18n.site.yml , paste eusi disalin kana eta, eusina kieu:

token: YOUR_API_TOKEN

Salaku i18n.site/payBill , anjeun kedah ngabeungkeut kartu kiridit kanggo mayar (henteu ngecas deui, halaman wéb bakal otomatis ngirangan biaya dumasar kana pamakean, tingali halaman utama pikeun harga ).

Ngagunakeun

Proyék Demo

Mangga tingal proyék demo github.com/i18n-site/demo.i18 pikeun neuleuman konfigurasi i18 tarjamahan.

Pamaké di Cina tiasa clone atomgit.com/i18n/demo.i18

Saatos kloning, lebetkeun diréktori sareng jalankeun i18 pikeun ngarengsekeun tarjamahan.

Struktur Diréktori

Struktur diréktori gudang template nyaéta kieu

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

File demo anu ditarjamahkeun dina diréktori en ngan ukur conto sareng tiasa dihapus.

Jalankeun Tarjamahan

Lebetkeun diréktori sareng ngajalankeun i18 pikeun narjamahkeun.

Salian tarjamahan, program ogé bakal ngahasilkeun folder .i18n/data , mangga tambahkeun kana gudang.

Saatos narjamahkeun file anyar git add . file data anyar bakal dihasilkeun dina diréktori ieu.

File Konfigurasi

.i18n/conf.yml nyaéta file konfigurasi tina alat panarjamahan baris paréntah i18

eusina kieu:

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

ignore:
  - _*

Basa Sumber &

Dina file konfigurasi, bawahan fromTo :

en nyaéta basa sumber, zh ja ko de fr nyaéta basa sasaran tarjamahan.

Kode basa tingali i18n.site/i18/LANG_CODE

Contona, upami anjeun hoyong narjamahkeun basa Cina kana basa Inggris, tuliskeun deui baris ieu zh: en .

Upami anjeun hoyong narjamahkeun ka sadaya basa anu dirojong, mangga kosongkeun saatos : . salaku conto

i18n:
  fromTo:
    en:

: tiasa ngonpigurasikeun fromTo anu béda pikeun subdirektori anu béda /

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

Dina tabel konfigurasi ieu, basa sumber tarjamahan katalog blog nyaéta zh , sareng basa sumber tarjamahan katalog blog/your_file_name.md nyaéta ja .

Gambar / Tumbu Multibasa

Nalika URL dina gambar sareng tautan dina replace: sareng MarkDown (sareng atribut src sareng href tina HTML dipasang) dikonpigurasi dina .i18n/conf.yml sareng awalan ieu, kode basa sumber dina URL bakal diganti ku kode basa tarjamahan ( basa). daptar kode ).

Contona, konfigurasi anjeun nyaéta kieu:

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: nyaéta kamus, koncina nyaéta awalan URL anu bakal diganti, sareng nilaina nyaéta aturan ngagantian.

Anu dimaksud ngagantikeun aturan ko de uk>ru zh-TW>zh >en di luhur nyaéta ko de ngagunakeun gambar kode basana sorangan, zh-TW jeung zh maké gambar zh , uk maké gambar ru , jeung basa séjén (saperti ja ) maké gambar. ti en sacara standar.

Contona, file sumber Perancis ( fr ) MarkDown nyaéta kieu :

![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 anu ditarjamahkeun sareng dibangkitkeun ( en ) nyaéta kieu :

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

Di dieu, /en/ dina kode basa sumber diganti ku /zh/ dina basa sasaran.

Catetan : Kudu aya / saméméh jeung sanggeus kode basa téks diganti dina URL.

[!TIP] Upami - / dikonpigurasi dina url: , ngan ukur jalur relatif anu bakal cocog, tapi URL anu dimimitian ku // moal cocog.

Upami sababaraha tautan tina nami domain hoyong diganti sareng sababaraha anu henteu hoyong diganti, anjeun tiasa nganggo awalan anu béda sapertos [x](//x.com/en/) sareng [x](//x.com/en/) pikeun ngabédakeunana.

Malire File

Sacara standar, sadaya file anu dimimitian ku .md sareng .yml dina diréktori basa sumber bakal ditarjamahkeun.

Upami anjeun hoyong teu malire sababaraha file sareng henteu narjamahkeunana (sapertos draf anu teu acan réngsé), anjeun tiasa ngonpigurasikeunana sareng kolom ignore .

ignore ngagunakeun sintaksis anu globset sareng file .gitignore .

Contona, _* dina file konfigurasi luhur hartina file dimimitian ku _ moal ditarjamahkeun.

Aturan Tarjamahan

Éditor Tarjamahan Teu Kedah Nambihan Atanapi Mupus Garis

Tarjamahan tiasa diédit. Ngarobah téks aslina tur mesin-narjamahkeun deui, modifikasi manual kana tarjamahan moal overwritten (lamun ayat ieu téks aslina teu acan dirobah).

[!WARN] Baris-baris tarjamahan jeung téks aslina kudu saluyu jeung hiji. Nyaéta, ulah nambihan atanapi mupus garis nalika nyusun tarjamahan. Upami teu kitu, éta bakal ngabalukarkeun kabingungan dina cache éditan terjemahan.

Upami aya anu lepat, mangga tingal FAQ kanggo solusi.

YAML Tarjamahan

Alat baris paréntah bakal mendakan sadaya file anu ditungtungan ku .yml dina diréktori file basa sumber sareng narjamahkeunana.

• Catet yén sufiks nami file kedah .yml (sanés .yaml ).

Alatna ngan ukur narjamahkeun nilai kamus dina .yml , sanés konci kamus.

Contona i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

bakal ditarjamahkeun jadi i18n/zh/i18n.yml

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

Tarjamahan YAML ogé tiasa dirobih sacara manual (tapi ulah nambihan atanapi mupus konci atanapi garis dina tarjamahan).

Dumasar kana YAML tarjamahan, anjeun tiasa gampang ngawangun solusi internasional pikeun sababaraha basa program.

Pamakéan Canggih

Subdirektori Tarjamahan

Salami .i18n/conf.yml dijieun (teu kudu mimitian ti template proyék demo unggal waktu), i18 bakal dianggo rupa.

Alat baris paréntah bakal mendakan .i18n/conf.yml konfigurasi dina sadaya subdirektori sareng narjamahkeunana.

Proyék anu ngagunakeun arsitéktur monorepo bisa ngabagi file basa kana subdirektori.

Diréktori Instalasi Custom

Éta bakal dipasang ka /usr/local/bin sacara standar.

Upami /usr/local/bin teu gaduh idin nyerat éta bakal dipasang ka ~/.bin .

Netepkeun variabel lingkungan TO bisa nangtukeun diréktori instalasi, contona :

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