Насб Ва Истифода

windows Аввал git bash -Ро Насб Кунед

windows , лутфан ин ҷоро клик кунед, то аввал git bash зеркашӣ ва насб кунед .

Амалҳои минбаъдаро дар git bash иҷро кунед.

Насб Кунед

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

Токени Тарҷумаро Танзим Кунед

Боздид кунед i18n.site/token токенро нусхабардорӣ кунед

~/.config/i18n.site.yml эҷод кунед, мундариҷаи нусхабардориро ба он часбонед, мундариҷа чунин аст:

token: YOUR_API_TOKEN

i18n.site/payBill , ба шумо лозим аст, ки корти кредитиро барои пардохт бибандед (пуркунӣ талаб карда намешавад, вебсайт ба таври худкор пардохтҳоро мувофиқи истифода тарҳ мекунад, барои нархгузорӣ ба саҳифаи хонагӣ нигаред ).

Истифода Бурдан

Лоиҳаи Намоишӣ

Лутфан ба лоиҳаи намоишӣ муроҷиат кунед github.com/i18n-site/demo.i18 то конфигуратсияи тарҷумаи i18 -ро омӯзед!

Истифодабарандагон дар Чин метавонанд клон кунанд atomgit.com/i18n/demo.i18

Пас аз клонкунӣ, директорияро ворид кунед ва i18 иҷро кунед, то тарҷумаро анҷом диҳед.

Сохтори Директория

Сохтори феҳристи анбори шаблон чунин аст

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

Файлҳои намоишии тарҷумашуда дар феҳристи en танҳо як мисоланд ва онҳоро нест кардан мумкин аст.

Тарҷумаро Иҷро Кунед

Феҳристро ворид кунед ва барои тарҷума i18 иҷро кунед.

Илова ба тарҷума, барнома инчунин ҷузвдони .i18n/data ро тавлид мекунад, лутфан онро ба анбор илова кунед.

Пас аз тарҷумаи файли нав, дар ин феҳрист файли нави маълумот тавлид мешавад, ки git add . илова кунед.

Файли Конфигуратсия

.i18n/conf.yml файли конфигуратсияи абзори тарҷумаи сатри фармони i18 мебошад

Мазмуни он чунин аст:

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

ignore:
  - _*

Забони Тарҷума &

Дар файли конфигуратсия, тобеи fromTo :

en забони сарчашма, zh ja ko de fr забони мавриди ҳадафи тарҷума мебошад.

Рамзи забонро бубинед i18n.site/i18/LANG_CODE

Масалан, агар шумо хоҳед, ки хитоиро ба англисӣ тарҷума кунед, ин сатри zh: en -ро аз нав нависед.

Агар шумо хоҳед, ки ба ҳамаи забонҳои дастгиришаванда тарҷума кунед, лутфан пас аз : холӣ гузоред. барои намуна

i18n:
  fromTo:
    en:

Шумо метавонед fromTo ро барои зеркаталогҳои гуногун танзим кунед Намоиш ба таври зерин навишта шудааст : /

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

Дар ин ҷадвали конфигуратсия забони аслии тарҷумаи каталоги blog zh ва забони аслии тарҷумаи каталоги blog/your_file_name.md ja аст.

Тасвирҳо/Пайвандҳои Бисёрзабона

Вақте ки URL-ҳои тасвирҳо ва истинодҳо дар replace: ва MarkDown (ва атрибутҳои src ва href и дохилшуда HTML ) бо ин префикс дар .i18n/conf.yml танзим карда мешаванд, рамзи забони сарчашма дар URL бо рамзи забони тарҷума ( забон) иваз карда мешавад. Рӯйхати рамзҳо ).

Масалан, конфигуратсияи шумо чунин аст:

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: луғат аст, калид префикси URL-и ивазшаванда аст ва арзиш қоидаи ивазкунӣ мебошад.

Маънои иваз кардани қоидаи ko de uk>ru zh-TW>zh >en дар боло ин аст, ки ko de тасвири рамзи забони худро истифода мебарад, zh-TW ва zh расми zh , uk тасвири ru ро истифода мебарад ва забонҳои дигар (ба мисли ja ) расмро истифода мебаранд аз en бо нобаёнӣ.

Масалан, файли манбаи фаронсавии ( fr ) MarkDown чунин аст :

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

Файли тарҷума ва тавлидшудаи англисӣ ( en ) чунин аст :

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

Дар ин ҷо /en/ дар рамзи забони ибтидоӣ бо /zh/ дар забони мавриди ҳадаф иваз карда мешаванд.

Эзоҳ : Дар URL пеш ва пас аз рамзи забони матни ивазшуда бояд / бошад.

[!TIP] Агар - / дар url: танзим шуда бошад, танҳо роҳҳои нисбӣ мувофиқ карда мешаванд, аммо URL-ҳои аз // саршаванда мувофиқат намекунанд.
Агар баъзе истинодҳои номи домен иваз кардан мехоҳанд ва баъзеҳо иваз кардан нахоҳанд, шумо метавонед префиксҳои гуногунро ба мисли [x](//x.com/en/) ва [x](//x.com/en/) барои фарқ кардани онҳо истифода баред.

Файлро Нодида Гиред

Бо нобаёнӣ, ҳама файлҳое, ки аз .md ва .yml дар директорияи забони сарчашма сар мешаванд, тарҷума карда мешаванд.

Агар шумо хоҳед, ки баъзе файлҳоро сарфи назар кунед ва онҳоро тарҷума накунед (масалан, лоиҳаҳои нотамом), шумо метавонед онро бо майдони ignore танзим кунед.

ignore globset .gitignore -ро истифода мебарад.

Масалан, _* дар файли конфигуратсияи дар боло зикршуда маънои онро дорад, ки файлҳои аз _ саршуда тарҷума карда намешаванд.

Қоидаҳои Тарҷума

Муҳаррирони Тарҷума Набояд Сатрҳоро Илова Ё Нест Кунанд

Тарҷума таҳриршаванда аст. Матни аслиро тағир диҳед ва онро дубора бо мошин тарҷума кунед, тағиротҳои дастӣ ба тарҷума дубора навишта намешаванд (агар ин параграфи матни аслӣ тағир дода нашуда бошад).

[!WARN] Сатрҳои тарҷума ва матни аслӣ бояд як ба як мувофиқат кунанд. Яъне ҳангоми тартиб додани тарҷума сатрҳоро илова ва нест накунед. Дар акси ҳол, он боиси нофаҳмиҳо дар кэши таҳрири тарҷума мегардад.

Агар чизе хато кунад, лутфан ба FAQ барои ҳалли мушкилот муроҷиат кунед.

`YAML` Тарҷума

Асбоби сатри фармон ҳамаи файлҳоеро, ки бо .yml тамом мешаванд, дар феҳристи файли забони сарчашма пайдо мекунад ва онҳоро тарҷума мекунад.

Дар хотир доред, ки суффикси номи файл бояд .yml бошад (на .yaml ).

Восита танҳо арзишҳои луғатро дар .yml тарҷума мекунад, на калидҳои луғат.

Масалан i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

ҳамчун i18n/zh/i18n.yml тарҷума карда мешавад

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

Тарҷумаи YAML низ метавонад ба таври дастӣ тағир дода шавад (аммо калидҳо ё сатрҳоро дар тарҷума илова ё нест накунед).

Дар асоси тарҷумаи YAML , шумо метавонед ба осонӣ қарорҳои байналмилалӣ барои забонҳои гуногуни барномасозӣ созед.

Истифодаи Пешрафта

Зеркаталоги Тарҷума

То он даме, ки .i18n/conf.yml сохта шудааст (ҳар вақт аз қолаби лоиҳаи намоишӣ оғоз кардан лозим нест), i18 хуб кор мекунад.

Асбоби сатри фармон .i18n/conf.yml конфигуратсияро дар ҳама зеркаталогҳо пайдо мекунад ва онҳоро тарҷума мекунад.

Лоиҳаҳое, ки меъмории monorepo истифода мебаранд, метавонанд файлҳои забонро ба зеркаталогҳо тақсим кунанд.

Феҳристи Насби Фармоишӣ

Он бо нобаёнӣ ба /usr/local/bin насб карда мешавад.

Агар /usr/local/bin иҷозати навиштан надошта бошад, он ба ~/.bin насб карда мешавад.

Танзими тағирёбандаи муҳити TO метавонад директорияи насбкуниро муайян кунад, масалан :

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