دانان و بەکارهێنان

ویندۆز سەرەتا 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 ی embedded 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] دێڕەکانی وەرگێڕانەکە و دەقی ئەسڵی دەبێت یەک بە یەک بگونجێت. واتە لە کاتی کۆکردنەوەی وەرگێڕانەکەدا دێڕەکان زیاد مەکەن یان مەسڕنەوە. ئەگەرنا دەبێتە هۆی سەرلێشێواوی لە کاشی دەستکاریکردنی وەرگێڕان.

ئەگەر شتێک هەڵە بوو، تکایە سەردانی پرسیارە بەردەوامەکان بکە بۆ چارەسەرەکان.

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