Орнату Және Пайдалану

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 .

Көптілді Суреттер/Сілтемелер

replace: және MarkDown дегі суреттер мен сілтемелердегі URL мекенжайлары (және ендірілген 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 префиксі және мән — ауыстыру ережесі.

Жоғарыдағы 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] Аударма жолдары мен түпнұсқа мәтін бір-біріне сәйкес келуі керек. Яғни, аударманы құрастыру кезінде жолдарды қосуға немесе жоюға болмайды. Әйтпесе, ол аударманы өңдеу кэшінде шатасуға әкеледі.

Егер бірдеңе дұрыс болмаса, шешімдер үшін жиі қойылатын сұрақтар бөлімін қараңыз.

`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