.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

nav: ترتیب کولو اختیارونه، د کور پاڼې په سر کې د نیویګیشن مینو سره مطابقت لري.

د دوی په منځ کې، i18n: home په en/i18n.yml کې home: Home سره مطابقت لري (چیرې چې en د پروژې ژباړې سرچینه ژبه ده).

en/i18n.yml منځپانګه د نیویګیشن مینو کې ښودل شوي متن دی، کوم چې په ترتیب کې fromTo سره سم ژباړل کیږي، د بیلګې په توګه، zh/i18n.yml ته ژباړل کیږي.

د ژباړې بشپړیدو وروسته، تاسو کولی شئ د ژباړې ارزښت yml بدل کړئ، مګر د ژباړې yml کیلي مه اضافه یا حذف کړئ.

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 ته تعدیل کړئ، i18n.site بیا په md ډایرکټر کې چل کړئ، او بیا د کور پاڼې بدلونونو لیدلو لپاره د پرمختیا مخکتنې URL ته لاړ شئ.

use: Blog د بلاګ ټیمپلیټونه

د بلاګ ټیمپلیټ د خپرونې وخت په ترتیب سره د مقالو لیست (سرلیکونه او خلاصې) ښیې.

→ د ځانګړي ترتیب په اړه د زده کړې لپاره دلته کلیک وکړئ

use: Doc د څو فایلونو سند ټیمپلیټونه

د ترتیب کولو فایل کې:

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

د ټیمپلیټ رینډینګ لپاره Doc کارولو اشاره کوي.

Doc ټیمپلیټ د یو یا څو پروژو لپاره د سند خاکې رامینځته کولو لپاره د ډیری MarkDown ادغام ملاتړ کوي.

ډیری پروژې او ډیری فایلونه

د .i18n/conf.yml په 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.addon/toc په .i18n/conf.yml کې فعال کړئ. ترتیب په لاندې ډول دی :

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 سره مطابقت لري 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 فایلونه بلې ژبې ته انتقال کړئ.

تاسو کولی شئ لاندې امرونو ته مراجعه وکړئ:

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 پاڼه به ښکاره شي.