Shigar Da Amfani

windows Fara Shigar git bash

windows , don Allah danna nan don saukewa kuma shigar da git bash farko .

Gudanar da ayyuka masu zuwa a cikin git bash .

Shigar

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

Sanya Alamar Fassara

Ziyarci i18n.site/token Danna don kwafi alamar

Ƙirƙiri ~/.config/i18n.site.yml , manna abin da aka kwafi a ciki, abun ciki shine kamar haka:

token: YOUR_API_TOKEN

Bugu da i18n.site/payBill , kuna buƙatar ɗaure katin kuɗi don biyan kuɗi (ba a buƙatar caji, gidan yanar gizon zai cire kudade ta atomatik bisa ga amfani, duba shafin gida don farashi ).

Amfani

Demo Aikin

Da fatan za a koma zuwa aikin github.com/i18n-site/demo.i18 don koyon tsarin fassarar i18 .

Masu amfani a China na iya clone atomgit.com/i18n/demo.i18

Bayan cloning, shigar da directory kuma gudanar da i18 don kammala fassarar.

Tsarin Shugabanci

Tsarin kundin adireshi na samfuri kamar haka

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

Fayilolin demo da aka fassara a cikin kundin adireshin en misali ne kawai kuma ana iya share su.

Gudun Fassarar

Shigar da littafin kuma gudanar da i18 don fassarawa.

Baya ga fassarar, shirin zai kuma samar da babban fayil ɗin .i18n/data , da fatan za a ƙara shi zuwa ma'ajiyar.

Bayan fassarar sabon fayil ɗin git add . za a samar da sabon fayil ɗin bayanai a cikin wannan kundin adireshi.

Fayil Na Tsari

.i18n/conf.yml shine fayil ɗin daidaitawa na kayan aikin fassarar layin umarni i18

Abinda ke ciki shine kamar haka:

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

ignore:
  - _*

& Fassara

A cikin fayil ɗin daidaitawa, mai ƙarƙashin fromTo :

en shine yaren tushe, zh ja ko de fr shine harshen da ake nufi da fassarar.

Lambar harshe gani i18n.site/i18/LANG_CODE

Misali, idan kuna son fassara Sinanci zuwa Turanci, sake rubuta wannan layin zh: en .

Idan kuna son fassara zuwa duk harsunan da aka goyan baya, da fatan za a bar komai bayan : . misali

i18n:
  fromTo:
    en:

Kuna iya saita fromTo daban-daban : manyan fayiloli daban- / .

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

A cikin wannan teburin daidaitawa, tushen harshen fassarar katalogi blog shine zh , kuma tushen harshen fassarar katalogi blog/your_file_name.md shine ja .

Hotuna/Hanyoyin Harsuna Da Yawa

Lokacin da URLs ɗin da ke cikin hotuna da haɗin kai a cikin replace: da MarkDown (da kuma halayen src da href na saka HTML ) aka saita su a cikin .i18n/conf.yml tare da wannan prefix, lambar tushe a cikin URL ɗin za a maye gurbin ta da lambar yare na fassarar ( harshe). lissafin code ).

Misali, tsarin ku shine kamar haka:

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: ƙamus ne, maɓalli shine prefix URL don maye gurbinsa, kuma ƙimar ita ce ƙa'idar maye gurbin.

Ma'anar maye gurbin doka ko de uk>ru zh-TW>zh >en a sama shine cewa ko de yana amfani da hoton lambar yarensu, zh-TW da zh suna amfani da hoton zh , uk suna amfani da hoton ru , da sauran harsuna (kamar ja ) suna amfani da hoton. na en ta tsohuwa.

Misali, Fayil ɗin asalin Faransanci ( fr ) na MarkDown shine kamar haka :

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

Fassarar Turanci ( en ) da aka fassara kuma aka samar kamar haka :

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

Anan, ana maye gurbin /en/ a cikin lambar yaren tushen da /zh/ a cikin yaren manufa.

Lura : Dole ne a sami / kafin da bayan lambar yare na rubutun da aka maye gurbinsu a cikin URL.

[!TIP] Idan an saita - / a cikin url: , hanyoyin dangi kawai za a daidaita, amma URLs da suka fara da // ba za su daidaita ba.

Idan wasu hanyoyin haɗin sunan yanki suna son maye gurbin wasu kuma ba sa so a canza su, kuna iya amfani da prefixes daban-daban kamar [x](//x.com/en/) da [x](//x.com/en/) don bambanta su.

Yi Watsi Da Fayil

Ta hanyar tsohuwa, duk fayilolin da suka fara da .md da .yml a cikin kundin adireshin tushen tushen harshe za a fassara su.

Idan kuna son yin watsi da wasu fayiloli kuma ba ku fassara su ba (kamar rubutun da ba a gama ba), kuna iya saita su tare da filin ignore .

ignore yana amfani da tsari globset kamar fayil .gitignore .

Misali, _* a cikin fayil ɗin sanyi na sama yana nufin cewa fayilolin da suka fara da _ ba za a fassara su ba.

Dokokin Fassara

Editocin Fassarar Bai Kamata Su Ƙara Ko Share Layi Ba

Ana iya gyara fassarar. Gyara ainihin rubutun kuma na'ura-fassara shi kuma, ba za a sake rubuta gyare-gyaren jagora ga fassarar ba (idan wannan sakin layi na ainihin rubutun bai canza ba).

[!WARN] Dole ne a sami rubutu ɗaya-zuwa ɗaya tsakanin layin fassarar da ainihin rubutun. Wato, kar a ƙara ko share layuka lokacin da ake haɗa fassarar. In ba haka ba, zai haifar da rudani a cikin ma'ajin gyara fassarar fassarar.

Idan wani abu ba daidai ba, da fatan za a koma zuwa FAQ don samun mafita.

YAML Fassarar

Kayan aikin layin umarni zai nemo duk fayilolin da ke ƙarewa tare da .yml a cikin tushen fayil ɗin fayil ɗin yare kuma a fassara su.

• Lura cewa suffix ɗin sunan fayil dole ne ya zama .yml (ba .yaml ba).

Kayan aikin yana fassara ƙimar ƙamus ne kawai a cikin .yml , ba maɓallan ƙamus ba.

Misali i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

za a fassara shi azaman i18n/zh/i18n.yml

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

Hakanan ana iya canza fassarar YAML da hannu (amma kar a ƙara ko share maɓalli ko layi a cikin fassarar).

Dangane da fassarar YAML , zaku iya gina hanyoyin warware matsalolin duniya cikin sauƙi don harsunan shirye-shirye daban-daban.

Babban Amfani

Fassara Subdirectory

Muddin an ƙirƙiri .i18n/conf.yml (babu buƙatar farawa daga samfurin aikin demo kowane lokaci), i18 zai yi aiki lafiya.

Kayan aikin layin umarni zai nemo saitin .i18n/conf.yml a cikin duk kundin adireshi kuma ya fassara su.

Ayyukan da ke amfani da monorepo -ginen na iya raba fayilolin harshe zuwa kundin adireshi.

Littafin Shigarwa Na Al'ada

Za a shigar da shi zuwa /usr/local/bin ta tsohuwa.

Idan /usr/local/bin ba shi da izinin rubutawa za a shigar da shi zuwa ~/.bin .

Saita canjin yanayi TO na iya ayyana jagorar shigarwa, misali :

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