.i18n/conf.yml

i18n.site खातिर कॉन्फ़िगरेशन फाइल .i18n/conf.yml बा आ सामग्री निम्नलिखित बा :

i18n:
  fromTo:
    en:
upload:
  ext:
    - md
nav:
  - i18n: home
    use: Toc
    url: /
  - i18n: doc
    menu: NB demo1,demo2
    use: Doc
  - i18n: blog
    use: Blog
addon:
  - i18n.addon/toc

इनहन में से upload से ext: कॉन्फ़िगरेशन आइटम के मतलब बा कि प्रकाशन के समय खाली .md अपलोड होखी।

शीर्ष नेविगेशन नव के बा

nav: कॉन्फ़िगरेशन विकल्प, होमपेज के ऊपर नेविगेशन मेनू के अनुरूप।

इनहन में से i18n: home en/i18n.yml में home: Home से मेल खाला (जहाँ en प्रोजेक्ट अनुवाद के स्रोत भाषा हवे)।

en/i18n.yml सामग्री नेविगेशन मेनू में देखावल गइल पाठ हवे, जेकर अनुवाद कॉन्फ़िगरेशन में fromTo के अनुसार कइल जाई, उदाहरण खातिर, zh/i18n.yml में अनुवाद कइल जाई।

अनुवाद पूरा भइला के बाद, रउआँ अनुवाद yml के मान में संशोधन क सकत बानी, बाकी अनुवाद yml के कुंजी के ना जोड़ल भा हटाईं।

0रूपरेखा के साथ use: Toc दस्तावेज टेम्पलेट बा

nav :

  - i18n: home
    use: Toc
    url: /

use: Toc मतलब होला Toc टेम्पलेट के इस्तेमाल से रेंडर कइल, जवन एकही Markdown टेम्पलेट के रेंडर कर रहल बा।

TOC Table of Contents के संक्षिप्त रूप हवे जब ई टेम्पलेट रेंडर कइल जाई तब एह Markdown फाइल के रूपरेखा साइडबार में देखावल जाई।

url: Markdown के फाइल पथ के प्रतिनिधित्व करे ला ( / रूट डाइरेक्टरी /README.md से मेल खाला, एह फाइल नाँव खातिर बड़हन उपसर्ग आ छोट अक्षर के प्रत्यय के जरूरत होला)।

0बिना रूपरेखा के use: Md दस्तावेज टेम्पलेट

Md टेम्पलेट आ Toc टेम्पलेट एकही होला आ दुनों के इस्तेमाल एकही Markdown फाइल के रेंडर करे खातिर होला। लेकिन Md टेम्पलेट साइडबार में रूपरेखा ना देखावेला।

रउआँ उपर दिहल कॉन्फ़िगरेशन में use: Toc use: Md में संशोधित क सकत बानी, md डाइरेक्टरी में i18n.site दोबारा चला सकत बानी, आ फिर होमपेज पर बदलाव के निरीक्षण करे खातिर बिकास पूर्वावलोकन यूआरएल पर जा सकत बानी।

use: Blog ब्लॉग टेम्पलेट बा

ब्लॉग टेम्पलेट में प्रकाशन के समय के क्रम में लेख (शीर्षक आ सार) के लिस्ट देखावल जाला।

→ विशिष्ट कॉन्फ़िगरेशन के बारे में जाने खातिर इहाँ क्लिक करीं

use: Doc फाइल दस्तावेज टेम्पलेट बा

कॉन्फ़िगरेशन फाइल में:

  - i18n: doc
    menu: NB demo1,demo2
    use: Doc

टेम्पलेट रेंडरिंग खातिर Doc इस्तेमाल के संकेत देला।

Doc टेम्पलेट एकल या कई गो प्रोजेक्ट सभ खातिर दस्तावेज रूपरेखा पैदा करे खातिर कई गो MarkDown एकीकरण के सपोर्ट करे ला।

कई गो प्रोजेक्ट आ कई गो फाइल

i18n:doc में .i18n/conf.yml के कॉन्फ़िगरेशन मल्टी-प्रोजेक्ट मल्टी-फाइल रेंडरिंग मोड हवे।

इहाँ, menu: NB demo1,demo2 , के मतलब होला ड्रॉप-डाउन मेनू के रेंडर करे खातिर NB टेम्पलेट के इस्तेमाल कइल।

NB , जवन Name Breif के संक्षिप्त रूप हवे, मतलब ई बा कि ड्रॉप-डाउन मेनू में प्रोजेक्ट के नाँव आ नारा देखावल जा सके ला।

NB के बाद पैरामीटर demo1,demo2 ओकरा के पास कइल जाला।

नोट : ** में अल्पविराम , demo1,demo2 पहिले आ बाद में ** रिक्त स्थान ना होखे के चाहीं .

उपर दिहल पैरामीटर सभ खातिर, संबंधित डाइरेक्टरी इंडेक्स फाइल बा:

• en/demo1/TOC
• en/demo2/TOC

एकल प्रोजेक्ट कई गो फाइल के बा

अगर रउरा लगे खाली एगो प्रोजेक्ट बा त ओकरा के निम्नलिखित तरीका से कॉन्फ़िगर कर सकेनी.

  - i18n: doc
    url: flashduty
    use: Doc

[!WARN] कई गो फाइल वाला एकल प्रोजेक्ट url रूट पथ / के रूप में कॉन्फ़िगर करे के समर्थन ना करेला अगर conf.yml → nav: कवनो रूट पथ कॉन्फ़िगर ना भइल होखे त वेबसाइट के होमपेज तक पहुँचत घरी nav: कॉन्फ़िगरेशन के तहत पहिला यूआरएल पर स्वचालित रूप से दोबारा लिखल जाई। ई डिजाइन डाइरेक्टरी के माध्यम से प्रोजेक्ट डॉक्यूमेंट, ब्लॉग आ अउरी सामग्री के बेहतर तरीका से अलग करे खातिर बा। एकही फाइल आ एकही पन्ना के होमपेज के रूप में इस्तेमाल करे के सलाह दिहल जाला।

[!TIP] अगर url ना लिखल गइल होखे तब url डिफ़ॉल्ट रूप से i18n के मान पर हो जाला ई नियम अन्य टेम्पलेट सभ खातिर भी प्रभावी होला।

टीओसी सामग्री तालिका सूचकांक के बा

अगर कॉन्फ़िगरेशन में टेम्पलेट use: Doc सक्षम बा, त कृपया .i18n/conf.yml में प्लग-इन i18n.addon/toc सक्षम करीं कॉन्फ़िगरेशन निम्नलिखित बा :

addon:
  - i18n.addon/toc

i18n.site स्वचालित रूप से एह प्लग-इन के इंस्टॉल आ निष्पादित करी, डाइरेक्टरी इंडेक्स फाइल के पढ़ी TOC आ डाइरेक्टरी आउटलाइन json जनरेट करी।

अगर ई कई गो फाइल वाला एकही प्रोजेक्ट होखे तब रूट डाइरेक्टरी TOC स्रोत भाषा डाइरेक्टरी में url: से मेल खाए वाला डाइरेक्टरी होला उदाहरण खातिर, अगर स्रोत भाषा चीनी होखे: url: flashduty से मेल खाए वाला फाइल zh/flashduty/TOC होला।

अगर ई कई गो प्रोजेक्ट आ कई गो फाइल होखे तब url: कॉन्फ़िगर करे के जरूरत नइखे TOC के रूट डाइरेक्टरी i18n के मान से मेल खाए वाला डाइरेक्टरी हवे।

विस्तृत सामग्री के व्याख्या कइल गइल बा

en/blog/TOC सामग्री निम्नलिखित बा :

README.md

news/README.md
  news/begin.md

स्तर के इंगित करे खातिर इंडेंटेशन के इस्तेमाल करीं

ऊपर en/blog/TOC के पहिली पंक्ति में README.md नीचे दिहल तस्वीर में i18n.site से मेल खाला, जवन प्रोजेक्ट के नाँव हवे।

अगिला दू गो लाइन नीचे दिहल स्क्रीनशॉट में देखावल गइल बा.

news/README.md 1 , News से मेल खाला। news/begin.md Our Product is Online ! से मेल खाला

TOC फाइल के इंडेंट कइल जाला ताकि रूपरेखा के पदानुक्रमित संबंध के संकेत दिहल जा सके, बहु-स्तरीय इंडेंटेशन के समर्थन कइल जा सके, आ # से शुरू होखे वाली लाइन टिप्पणी।

अभिभावक स्तर खाली शीर्षक लिखेला, सामग्री ना.

जब इंडेंटेशन के कई स्तर होखे तब पैरेंट लेवल खाली टाइटिल लिखे ला आ सामग्री ना। ना त टाइपोग्राफी में गड़बड़ी हो जाई.

परियोजना README.md के बा

सामग्री आइटम README.md में लिखल जा सकेला , जइसे कि en/demo2/README.md .

ध्यान दीं कि एह फाइल के सामग्री में सामग्री के रूपरेखा ना लउके ला, एह से लंबाई के सीमित कइल आ छोट परिचय लिखल सलाह दिहल जाला।

परियोजना के नारा बा

रउआँ देख सकत बानी कि Deme Two आपन प्रोजेक्ट टैगलाइन ड्रॉप-डाउन मेनू आ कैटलॉग रूपरेखा प्रोजेक्ट के नाम Your Project slogan नीचे बा :

ई en/demo2/README.md के पहिला पंक्ति से मेल खाला :

# Demo Two : Your Project slogan

प्रोजेक्ट README.md के पहिला स्तर के टाइटिल के पहिला कोलन : के बाद के सामग्री के प्रोजेक्ट नारा मानल जाई।

चीन, जापान आ कोरिया के प्रयोगकर्ता लोग, कृपया ध्यान दीं कि रउआँ के पूरा चौड़ाई वाला कोलन के बजाय आधा चौड़ाई वाला कोलन : इस्तेमाल करे के चाहीं।

थोक में टीओसी के कइसे ले जाइल जाला?

TOC फाइल के स्रोत भाषा के डाइरेक्टरी में रखे के जरूरत बा।

उदाहरण खातिर, अगर स्रोत भाषा चीनी होखे तब ऊपर के TOC zh/blog/TOC होला।

अगर स्रोत भाषा में संशोधन कइल गइल होखे तब रउआँ के प्रोजेक्ट में कौनों खास भाषा के TOC फाइल सभ के दुसरा भाषा में बैच ले जाए के पड़ी।

रउआँ निम्नलिखित कमांड सभ के संदर्भ दे सकत बानी:

rsync -av --remove-source-files --include='*/' \
--include='TOC' --exclude='*' en/ zh/

कृपया उपर दिहल कमांड में en/ आ zh/ अपना भाषा कोड में संशोधित करीं।

बिना कॉन्फ़िगरेशन पथ के डिफ़ॉल्ट लोडिंग

पहुँचल जा रहल कौनों खास पथ खातिर, अगर पथ उपसर्ग nav: में कॉन्फ़िगर ना कइल गइल होखे तब पथ से मेल खाए वाला MarkDown फाइल के डिफ़ॉल्ट रूप से लोड कइल जाई आ Md टेम्पलेट के इस्तेमाल से रेंडर कइल जाई।

उदाहरण खातिर, अगर /test के एक्सेस कइल जाय आ nav: एह पथ के उपसर्ग के बिना कॉन्फ़िगर कइल जाय, आ वर्तमान ब्राउजिंग भाषा अंगरेजी (कोड en ) होखे, /en/test.md डिफ़ॉल्ट रूप से लोड हो जाई आ टेम्पलेट Md इस्तेमाल से रेंडर कइल जाई।

अगर /en/test.md ई फाइल मौजूद नइखे, डिफ़ॉल्ट 404 पन्ना देखावल जाई।