.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 চালাতে পারেন, এবং তারপর হোমপেজে পরিবর্তনগুলি পর্যবেক্ষণ করতে ডেভেলপমেন্ট প্রিভিউ 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/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

বিষয়বস্তু আইটেম 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 পৃষ্ঠা প্রদর্শিত হবে।