स्थापना र प्रयोग गर्नुहोस्

विन्डोज पहिले 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 .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