.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 යනු තනි Markdown අච්චුවක් විදැහුම් කරන Toc අච්චුවක් භාවිතයෙන් විදැහුම්කරණයයි.

TOC යනු Table of Contents හි කෙටි යෙදුමයි. මෙම අච්චුව විදැහුම් කළ විට, මෙම ගොනු Markdown හි දළ සටහන පැති තීරුවේ දර්ශනය වේ.

url: Markdown හි ගොනු මාර්ගය නියෝජනය කරයි ( / මූල නාමාවලිය /README.md ට අනුරූප වේ, මෙම ගොනු නාමයට විශාල අකුරු උපසර්ගයක් සහ කුඩා අකුරු උපසර්ගයක් අවශ්ය වේ).

0 දළ සටහන් නොමැතිව 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: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 හි අගයට පෙරනිමි වේ. මෙම නියමය අනෙකුත් සැකිලි සඳහාද බලාත්මක වේ.

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 ට අනුරූප වේ, news/begin.md Our Product is Online ! ට අනුරූප වේ

දළ සටහනේ ධූරාවලි සම්බන්ධය, බහු මට්ටමේ ඉන්ඩෙන්ටේෂන් සඳහා සහය දැක්වීම සහ # න් ආරම්භ වන රේඛා විවරණ දැක්වීමට ගොනු TOC ක් එබ්බවා ඇත.

මාපිය මට්ටම ලියන්නේ මාතෘකාව පමණක් මිස අන්තර්ගතය නොවේ.

ඉන්ඩෙන්ටේෂන් මට්ටම් කිහිපයක් ඇති විට, මාපිය මට්ටම ලියන්නේ මාතෘකාව පමණක් වන අතර අන්තර්ගතය නොවේ. එසේ නොවුවහොත්, මුද්රණ ශිල්පය අවුල් වනු ඇත.

ව්යාපෘතිය README.md

en/demo2/README.md වැනි අයිතම 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 පිටුව පෙන්වනු ඇත.