Урнаштыру Һәм Куллану

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 , сезгә түләү өчен кредит картасын бәйләргә кирәк (тулыландыру таләп ителми, сайт куллану буенча түләүләрне автоматик рәвештә алачак, бәяләр өчен баш битне карагыз ).

Куллану

Демо Проекты

Зинһар, i18 тәрҗемә конфигурациясен өйрәнү өчен демо проектына мөрәҗәгать итегез github.com/i18n-site/demo.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 сылтамалар (һәм урнаштырылган HTML src һәм href атрибутлары) бу префикс белән .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 префиксы, һәм кыйммәт - алмаштыру кагыйдәсе.

Aboveгарыдагы 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 синтаксисны .gitignore файл белән куллана globset

Мәсәлән, югарыдагы конфигурация файлындагы _* _ белән башланган файллар тәрҗемә ителмәячәк дигән сүз.

Тәрҗемә Кагыйдәләре

Тәрҗемә Редакторлары Сызыклар Өстәргә Яки Бетерергә Тиеш Түгел

Тәрҗемә редакцияләнә. Оригиналь текстны үзгәртегез һәм аны яңадан тәрҗемә итегез, тәрҗемәгә кул белән үзгәртүләр язылмаячак (әгәр төп текстның бу абзацы үзгәртелмәгән булса).

[!WARN] Тәрҗемә юллары һәм оригиналь текст берсенә туры килергә тиеш. Ягъни, тәрҗемәне төзегәндә сызыклар өстәмәгез яки бетермәгез. Otherwiseгыйсә, ул тәрҗемә редакцияләү кэшында буталчык тудырачак.

Әгәр дә берәр нәрсә дөрес булмаса, чишелешләр өчен Сорауларга мөрәҗәгать итегез.

`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

Урнаштыру Һәм Куллану

windows Башта git bash Урнаштыра