.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 ৰ চাবি যোগ বা মচি পেলাব নালাগে।

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 পুনৰায় চলাব পাৰে, আৰু তাৰ পিছত হোমপেজত পৰিবৰ্তনসমূহ পৰ্যবেক্ষণ কৰিবলে বিকাশ পূৰ্বদৰ্শন 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 ৰূট পথ / হিচাপে বিন্যাস কৰাটো সমৰ্থন নকৰে nav:__ __conf.yml 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 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 ফাইলসমূহ উৎস ভাষাৰ পঞ্জিকাত স্থাপন কৰিব লাগিব।

উদাহৰণস্বৰূপে, যদি উৎস ভাষা চীনা হয়, তেন্তে ওপৰৰ 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 পৃষ্ঠা প্ৰদৰ্শিত হব ।