.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 अपलोड् भविष्यति ।

Top Navigation nav

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 सङ्गच्छते , अस्य सञ्चिकानामस्य कृते बृहत्-उपसर्गस्य लघु-अक्षर-प्रत्ययस्य च आवश्यकता वर्तते) ।

use: Md टेम्पलेट्

Md टेम्पलेट् Toc टेम्पलेट् च समानौ स्तः तथा च एकां Markdown सञ्चिकां रेण्डर् कर्तुं द्वयोः उपयोगः भवति । परन्तु Md टेम्पलेट् पार्श्वपट्टिकायां रूपरेखां न दर्शयति ।

उपरिष्टाद् विन्यासे use: Toc use: Md इति परिवर्तयितुं, पुनः md निर्देशिकायां i18n.site चालयितुं, ततः मुखपृष्ठे परिवर्तनं अवलोकयितुं विकासपूर्वावलोकन-URL -इत्यत्र गन्तुं शक्नोति ।

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

ब्लॉग् टेम्पलेट् प्रकाशनसमयस्य क्रमेण लेखानाम् (शीर्षकाणां साराणां च) सूचीं प्रदर्शयति ।

→ विशिष्टविन्यासस्य विषये ज्ञातुं अत्र क्लिक् कुर्वन्तु

use: Doc टेम्पलेट्

विन्याससञ्चिकायां : १.

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

टेम्पलेट् रेण्डरिंग् कृते Doc उपयोगं सूचयति ।

Doc टेम्पलेट् एकस्य वा बहुविधपरियोजनानां कृते दस्तावेजरूपरेखां जनयितुं बहुविधं MarkDown एकीकरणस्य समर्थनं करोति ।

बहुविधाः परियोजनाः बहुविधाः च सञ्चिकाः

.i18n/conf.yml in i18n:doc इत्यस्य विन्यासः बहु-प्रकल्प-बहु-सञ्चिका-प्रतिपादन-विधिः अस्ति ।

अत्र 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: विन्यासस्य अन्तर्गतं प्रथमे URL मध्ये पुनः लिखितं भविष्यति । एषः डिजाइनः परियोजनादस्तावेजानां, ब्लोग्स् इत्यादीनां सामग्रीनां निर्देशिकानां माध्यमेन उत्तमरीत्या भेदं कर्तुं भवति । एकां सञ्चिकां एकं पृष्ठं च मुखपृष्ठरूपेण उपयोक्तुं शस्यते ।

[!TIP] यदि url न लिखितम् अस्ति तर्हि url पूर्वनिर्धारितरूपेण i18n इत्यस्य मूल्यं भवति ।अन्यसारूप्यानां कृते अपि एषः नियमः प्रभावी भवति ।

TOC सामग्रीसारणी अनुक्रमणिका

यदि विन्यासे टेम्पलेट् 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 News , 10000000 स्य अनुरूपः भवति । 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 सञ्चिकाः स्रोतभाषायाः निर्देशिकायां स्थापयितुं आवश्यकाः सन्ति ।

यथा, यदि स्रोतभाषा चीनी अस्ति तर्हि उपरि TOC zh/blog/TOC भवति ।

यदि स्रोतभाषा परिवर्तिता अस्ति तर्हि परियोजनायां कस्यापि भाषायाः TOC सञ्चिकाः अन्यभाषायां batch move करणीयम् ।

भवन्तः निम्नलिखित आदेशान् द्रष्टुं शक्नुवन्ति ।

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

कृपया उपर्युक्ते आदेशे en/ तथा zh/ स्वभाषासङ्केते परिवर्तनं कुर्वन्तु ।

विन्यासमार्गं विना पूर्वनिर्धारितं लोडिंग्

अभिगम्यमानस्य कस्यचित् मार्गस्य कृते, यदि मार्ग-उपसर्गः nav: मध्ये विन्यस्तः नास्ति, तर्हि मार्गस्य अनुरूपं MarkDown सञ्चिका पूर्वनिर्धारितरूपेण लोड् भविष्यति, Md टेम्पलेट् इत्यस्य उपयोगेन च रेण्डर् भविष्यति

उदाहरणार्थं, यदि /test अभिगम्यते तथा च nav: अस्य मार्गस्य उपसर्गं विना विन्यस्तं भवति, तथा च वर्तमानं ब्राउजिंग् भाषा आङ्ग्लभाषा (code en ) अस्ति, तर्हि /en/test.md पूर्वनिर्धारितरूपेण लोड् भविष्यति तथा च टेम्पलेट् Md उपयोगेन रेण्डर् भविष्यति

यदि /en/test.md एषा सञ्चिका नास्ति तर्हि पूर्वनिर्धारितं 404 पृष्ठं प्रदर्शितं भविष्यति ।