स्थापित करें और उपयोग करें

विंडोज़ में सबसे पहले 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 में चित्रों और लिंक में यूआरएल (और एम्बेडेड HTML की src और href विशेषताएँ) को इस उपसर्ग के साथ .i18n/conf.yml में कॉन्फ़िगर किया जाता है, तो यूआरएल में स्रोत भाषा कोड को अनुवाद के भाषा कोड से बदल दिया जाएगा ( भाषा) कोड सूची )।

उदाहरण के लिए, आपका कॉन्फ़िगरेशन इस प्रकार है:

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 में से.

उदाहरण के लिए, MarkDown की फ़्रेंच ( fr ) स्रोत फ़ाइल इस प्रकार है :

![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] अनुवाद की पंक्तियाँ और मूल पाठ एक-से-एक मेल खाने चाहिए। अर्थात्, अनुवाद संकलित करते समय पंक्तियाँ न जोड़ें या हटाएँ। अन्यथा, यह अनुवाद संपादन कैश में भ्रम पैदा करेगा।

यदि कुछ गलत होता है, तो कृपया समाधान के लिए 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