Gosod a Defnyddio

Mae windows Yn Gosod git bash Yn Gyntaf

windows , cliciwch yma i lawrlwytho a gosod git bash yn gyntaf .

Rhedeg gweithrediadau dilynol yn git bash .

Gosod

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

Ffurfweddu Tocyn Cyfieithu

Ymwelwch i18n.site/token Cliciwch i gopïo tocyn

Creu ~/.config/i18n.site.yml , gludwch y cynnwys wedi'i gopïo iddo, mae'r cynnwys fel a ganlyn:

token: YOUR_API_TOKEN

Yn i18n.site/payBill , mae angen i chi rwymo cerdyn credyd ar gyfer taliad (nid oes angen ad-daliad, bydd y wefan yn didynnu ffioedd yn awtomatig yn ôl defnydd, gweler yr hafan ar gyfer prisio ).

Defnydd

Prosiect Demo

Cyfeiriwch at y prosiect demo github.com/i18n-site/demo.i18 ddysgu cyfluniad i18 cyfieithiad.

Gall defnyddwyr yn Tsieina glonio atomgit.com/i18n/demo.i18

Ar ôl clonio, rhowch y cyfeiriadur a rhedeg i18 i gwblhau'r cyfieithiad.

Strwythur Cyfeiriadur

Mae'r templed strwythur cyfeiriadur warws fel a ganlyn

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

Mae'r ffeiliau demo wedi'u cyfieithu yn y cyfeiriadur en yn enghraifft yn unig a gellir eu dileu.

Rhedeg Cyfieithu

Rhowch y cyfeiriadur a rhedeg i18 i gyfieithu.

Yn ogystal â'r cyfieithiad, bydd y rhaglen hefyd yn cynhyrchu'r ffolder .i18n/data , os gwelwch yn dda ei ychwanegu at y gadwrfa.

Ar ôl cyfieithu'r ffeil newydd, bydd ffeil ddata newydd yn cael ei chynhyrchu yn y cyfeiriadur hwn Cofiwch atodi git add . .

Ffeil Ffurfweddu

.i18n/conf.yml yw ffeil ffurfweddu'r offeryn cyfieithu llinell orchymyn i18

Mae'r cynnwys fel a ganlyn:

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

ignore:
  - _*

Iaith Ffynhonnell &

Yn y ffeil ffurfweddu, mae'r isradd o fromTo :

en yw'r iaith ffynhonnell, zh ja ko de fr yw iaith darged y cyfieithiad.

Cod iaith gweler i18n.site/i18/LANG_CODE

Er enghraifft, os ydych chi am gyfieithu Tsieinëeg i'r Saesneg, ailysgrifennwch y llinell hon zh: en .

Os ydych chi eisiau cyfieithu i'r holl ieithoedd a gefnogir, gadewch yn wag ar ôl : . er enghraifft

i18n:
  fromTo:
    en:

Gallwch chi ffurfweddu fromTo gwahanol ar gyfer / is-gyfeiriaduron Mae arddangosiad wedi'i ysgrifennu fel a ganlyn :

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

Yn y tabl cyfluniad hwn, iaith ffynhonnell cyfieithu catalog blog yw zh , a ja yw iaith ffynhonnell cyfieithu catalog blog/your_file_name.md .

Delweddau/Dolenni Amlieithog

Pan fo'r URLau yn y lluniau a'r dolenni yn replace: a MarkDown (a phriodweddau src a href wedi'u mewnosod HTML ) wedi'u ffurfweddu yn .i18n/conf.yml gyda'r rhagddodiad hwn, bydd cod iaith ffynhonnell yr URL yn cael ei ddisodli gan god iaith y cyfieithiad ( iaith rhestr cod ).

Er enghraifft, mae eich ffurfweddiad fel a ganlyn:

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

Geiriadur yw replace: , yr allwedd yw'r rhagddodiad URL i'w ddisodli, a'r gwerth yw'r rheol amnewid.

Ystyr disodli rheol ko de uk>ru zh-TW>zh >en uchod yw bod ko de yn defnyddio llun eu cod iaith eu hunain, mae zh-TW a zh yn defnyddio llun zh , uk yn defnyddio llun ru , ac mae ieithoedd eraill (fel ja ) yn defnyddio’r llun o en yn ddiofyn.

Er enghraifft, mae ffeil ffynhonnell Ffrangeg ( fr ) o MarkDown fel a ganlyn :

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

Mae'r ffeil Saesneg ( en ) wedi'i chyfieithu a'i chynhyrchu fel a ganlyn :

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

Yma, mae'r /en/ yn y cod iaith ffynhonnell yn cael eu disodli gan /zh/ yn yr iaith darged.

Sylwch : Rhaid cael / cyn ac ar ôl cod iaith y testun newydd yn yr URL.

[!TIP] Os yw - / wedi'i ffurfweddu yn url: , dim ond llwybrau cymharol fydd yn cael eu paru, ond ni fydd URLs sy'n dechrau gyda // yn cael eu paru.

Os yw rhai dolenni o enw parth am gael eu disodli ac nad yw rhai am gael eu disodli, gallwch ddefnyddio rhagddodiaid gwahanol fel [x](//x.com/en/) ac [x](//x.com/en/) i'w gwahaniaethu.

Anwybyddu Ffeil

Yn ddiofyn, bydd pob ffeil sy'n dechrau gyda .md ac .yml yn y cyfeiriadur iaith ffynhonnell yn cael ei chyfieithu.

Os ydych chi am anwybyddu rhai ffeiliau a pheidio â'u cyfieithu (fel drafftiau anorffenedig), gallwch ei ffurfweddu gyda'r maes ignore .

Mae ignore yn defnyddio'r globset gystrawen â'r .gitignore ffeil.

Er enghraifft, mae _* yn y ffeil ffurfweddu uchod yn golygu na fydd ffeiliau sy'n dechrau gydag _ yn cael eu cyfieithu.

Rheolau Cyfieithu

Ni Ddylai Golygyddion Cyfieithu Ychwanegu Na Dileu Llinellau

Mae modd golygu'r cyfieithiad. Addaswch y testun gwreiddiol a'i gyfieithu â pheiriant eto, ni fydd yr addasiadau â llaw i'r cyfieithiad yn cael eu trosysgrifo (os nad yw'r paragraff hwn o'r testun gwreiddiol wedi'i addasu).

[!WARN] Rhaid i linellau'r cyfieithiad a'r testun gwreiddiol gyfateb un i un. Hynny yw, peidiwch ag ychwanegu neu ddileu llinellau wrth lunio'r cyfieithiad. Fel arall, bydd yn achosi dryswch yn y storfa golygu cyfieithu.

Os aiff rhywbeth o'i le, cyfeiriwch at y Cwestiynau Cyffredin am atebion.

YAML Gyfieithiad

Bydd yr offeryn llinell orchymyn yn dod o hyd i bob ffeil sy'n gorffen â .yml yn y cyfeiriadur ffeiliau iaith ffynhonnell ac yn eu cyfieithu.

Dim ond mewn .yml y mae'r offeryn yn cyfieithu gwerthoedd y geiriadur, nid bysellau'r geiriadur.

Er enghraifft i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

yn cael ei gyfieithu fel i18n/zh/i18n.yml

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

Gall y cyfieithiad o YAML hefyd gael ei addasu â llaw (ond peidiwch ag ychwanegu neu ddileu allweddi neu linellau yn y cyfieithiad).

Yn seiliedig ar YAML cyfieithiad, gallwch yn hawdd adeiladu atebion rhyngwladol ar gyfer ieithoedd rhaglennu amrywiol.

Defnydd Uwch

Is-Gyfeiriadur Cyfieithu

Cyn belled â bod .i18n/conf.yml yn cael ei greu (nid oes angen dechrau o dempled prosiect demo bob tro), bydd i18 yn gweithio'n iawn.

Bydd yr offeryn llinell orchymyn yn dod o hyd i .i18n/conf.yml ffurfwedd ym mhob is-gyfeiriadur ac yn eu cyfieithu.

Gall prosiectau sy'n defnyddio'r bensaernïaeth monorepo rannu ffeiliau iaith yn is-gyfeiriaduron.

Cyfeiriadur Gosod Personol

Bydd yn cael ei osod i /usr/local/bin yn ddiofyn.

Os nad oes gan /usr/local/bin ganiatâd ysgrifennu bydd yn cael ei osod i ~/.bin .

Gall gosod newidyn amgylchedd TO ddiffinio'r cyfeiriadur gosod, er enghraifft :

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