আপনি যদি এখানে দেখুন: http://en.wikedia.org/wiki/Stack_Overflow
আপনি দেখতে পাবেন একটি সামান্য "বিষয়বস্তু" বিভাগ আছে, আপনি যদি লিঙ্কগুলির একটিতে ক্লিক করেন তবে এটি আপনাকে পৃষ্ঠার একটি নির্দিষ্ট বিভাগে প্রেরণ করবে।
গিটহাব উইকিতে আমি কীভাবে এটি করব? মার্কডাউন বা তারা যা কিছু ব্যবহার করে?
উত্তর:
এটি মার্কডাউন চিটশিটের সামগ্রীগুলির সারণীতে দুর্দান্তভাবে প্রদর্শিত হয়েছে ।
##### Table of Contents
[Headers](#headers)
[Emphasis](#emphasis)
...snip...
<a name="headers"/>
## Headers
আপনি যদি গিটহাব মার্কডাউন ফাইলটিতে শিরোনামের উপরে ঘোরাফেরা করেন তবে আপনি এর বাম দিকে কিছুটা সহজ লিঙ্ক দেখতে পাবেন, আপনি সেই লিঙ্কটিও ব্যবহার করতে পারেন। এই লিঙ্কটির ফর্ম্যাটটি <project URL#<header name>। <header name>সব ছোট হাতের হতে হবে।
__TOC__সরাসরি ব্যবহার করতে পারেন । স্পষ্টত অন্তর্নিহিত অটোজেনারেশন যুক্তি রয়েছে। তবে কার্যকারিতাটি তাদের মার্কডাউন সম্পাদনা শৈলীতে উন্মুক্ত বলে মনে হচ্ছে না। দুর্ভাগ্যজনক। আসুন সবাই এর জন্য বৈশিষ্ট্য অনুরোধগুলি প্রেরণ শুরু করি এবং সম্ভবত তারা এটি চালু করবে।
#Headersপরিবর্তে ব্যবহার #headers। আমি ভেবেছিলাম এটি আপনার উত্তরের একটি টাইপো। সম্ভবত আপনি এই তথ্য আপনার উত্তর যোগ করতে পারেন।
সম্ভাব্য একটি (আধা-স্বয়ংক্রিয়) সমাধান হ'ল ইউজিন কালিনিন github-markdown-toc। এই সরঞ্জামটি মূলত আপনার README.mdফাইলের মাধ্যমে ক্রুঞ্চ করে এবং #একটি টিওসি তৈরি করতে শিরোনামগুলি স্নারফস করে ।
আপনার README.mdস্ক্রিপ্টটি খাওয়ান (ইউজিনে উল্লিখিত হিসাবে)README.md )
বিড়াল README.md | বাশ গিথুব-মার্কডাউন-টোক
উত্পন্ন টিওসি কেটে পেস্ট করুন এবং এটিকে আপনার README.mdফাইলের শীর্ষে রাখুন
এটি নোট করুন bash বাস্তবায়নটি কেবল লিনাক্সে কাজ করে (আমি যা বলতে পারি তা থেকে)।
পার্শ্ব নোট হিসাবে, সেখানে একটি গোলং বাস্তবায়ন রয়েছে এবং সম্ভবত কাজ পেতে আরও ঝামেলা রয়েছে।
যেহেতু গিথুব ব্যবহার করতে পারে না TOC সরাসরি , তবে আমাদের অন্যান্য বিকল্প রয়েছে।
আপনি অনলাইন সরঞ্জামের মাধ্যমে স্বয়ংক্রিয়ভাবে TOC উত্পন্ন করতে পারবেন :
গিটিহাব মার্কডাউন বা উইকি অনলাইন থেকে টোসি টেক্সট সামগ্রী তৈরি করুন
বা স্থানীয় সরঞ্জামের মাধ্যমে :
https://github.com/jonschlinkert/markdown-toc
git clone your-repo.wiki.git( উইকির ক্লোন করার .wikiআগে ডান যুক্ত করুন.gitnpm i -g markdown-toc<!-- toc -->(কেস সংবেদনশীল) আপনার উইকি এর markdown মধ্যেmarkdown-toc -i my-wiki-markdown.md( -iএটি জায়গায় সম্পাদনা করবে)আপডেট: আমি মনে করি সম্ভবত https://github.com/thlorenz/doctoc এখন আরও জনপ্রিয়।
বর্তমানে মার্কডাউন সিনট্যাক্স ( ) ব্যবহার করে এটি করা সম্ভব নয়.md । রেন্ডার করা মার্কডাউন ফাইলগুলির মতো সামগ্রীগুলির সারণি স্বয়ংক্রিয়ভাবে সারণি তৈরির বিষয়ে অনানুষ্ঠানিক আলোচনা চলছেREADME.md যা কিছু ধারণার তালিকা করে।
তবে আরও কিছু কাজের ক্ষেত্র রয়েছে যেমন:
AsciiDocপরিবর্তে এই মন্তব্য থেকে পরামর্শ হিসাবে ব্যবহার করুন । উদাহরণ স্বরূপ:
:toc: macro
:toc-title:
:toclevels: 99
# Title
toc::[]
## A
### A2
## B
### B2
littlebits/react-popover( README.adoc) এ উদাহরণটি দেখুন ।
অনলাইন বিষয়বস্তু জেনারেটর সারণী ( raychenon / প্লে-টেবিল অফ বিষয়বস্তু )
আপনি যদি মার্কডাউনের সাথে লেগে থাকার অবস্থানে না থাকেন তবে আপনি নীচের মতো করতে পারেন:
- উপর GitHub / উইকি : সুইচ Markdown করার মিডিয়াউইকি ।
__TOC__সিনট্যাক্স ব্যবহার করুন । নমুনা দেখুন ।- উপর GitHub / রেপো : সুইচ Markdown করার AsciiDoc ।
:toc:সিনট্যাক্স ব্যবহার করুন । ডেমো দেখুন ।
তবে, গিটহাব / রেপোতে মার্কডাউন ফাইলগুলি ব্যবহার করে , আপনি উইকিপিডিয়ায় যেমন গিটহাব পৃষ্ঠায় এটি পেতে পারেন
- যখন জ্যাকিল সক্রিয় হয়, এটি ডিফল্টরূপে ক্র্যামডাউন ব্যবহার করে গিটহাব পৃষ্ঠাগুলি উত্পন্ন করে
- ক্রেমডাউন নিয়ে আসে
Table Of Content।{:toc}সিনট্যাক্স ব্যবহার করুন । ব্যাখ্যা দেখুন ।
আপনি যদি ভিজ্যুয়াল স্টুডিও কোড ব্যবহার করতে চান তবে মার্কডাউন অল ইন ওয়ান নামে সহজেই ব্যবহারযোগ্য এক্সটেনশন রয়েছে যা তাত্ক্ষণিকভাবে কোনও .md ফাইলের জন্য টোসি তৈরি করতে পারে।
খালি কমান্ড প্যালেট ( Ctrl-Shift-P) -> খুলুনMarkdown: Create Table of Contents
অতিরিক্ত টিপ হিসাবে, আপনি ব্যবহার করে "সংরক্ষণের উপর স্বয়ংক্রিয় TOC আপডেটগুলি" অফ করতে চাইবেন
"markdown.extension.toc.updateOnSave": false,
আপনার ভিজ্যুয়াল স্টুডিও সেটিংসে (কমান্ড প্যালেট -> পছন্দসমূহ: ওপেন সেটিংস (জেএসএন))।
আপনি সম্পাদনা মোড "মিডিয়াউইকি" চয়ন করতে পারেন যা শিরোনামগুলির জন্য একটি টোক উত্পন্ন করবে, যেমন
== First ==
== Second ==
এইচ 1, এইচ 2, এইচ 3, ইত্যাদিতে গিথুবের আইডি = ".." বৈশিষ্ট্য উত্পন্ন করার নিজস্ব উপায় রয়েছে এই কারণে ... মার্কডাউন প্রক্রিয়াকরণের পরে এইচটিএমএল সংস্করণে শিরোনাম (উদাহরণস্বরূপ বিটবাকেট শিরোনামের শিরোনামের সামান্য ভিন্ন প্যাটার্ন ব্যবহার করে) আইডি = "স্লাগ") চাকাটি পুনরায় উদ্ভাবন করা এবং এই প্রক্রিয়াটিকে প্রকৃত বিপরীত লাইব্রেরি ব্যবহার করা সহজ।
এই কাজের জন্য আমি একটি দুর্দান্ত লাইব্রেরি পেয়েছি যার নাম মার্কডাউন-টক ।
আমার কাছে এটি সর্বোত্তম সমাধান বলে মনে হচ্ছে কারণ আমি সর্বদা আমার মেশিনে নোড ইনস্টল করেছি।
কেবলমাত্র এনপিএক্স মার্কডাউন-টু-আই ফাইল.এমডি কার্যকর করুন ।
এবং দেখে মনে হচ্ছে এটি এই কাজের জন্য অন্যতম জনপ্রিয় একটি সরঞ্জাম - কমপক্ষে নোড.জেএস বাস্তুতন্ত্রে।
ls
cat <<EOF >> test.md | tee
## Table of Contents
<!-- toc -->
- old toc 1
- old toc 2
- old toc 3
<!-- tocstop -->
## abc
This is a b c.
## xyz
This is x y z.
EOF
ls
cat test.md
npx markdown-toc -i test.md
cat test.md
আউটপুট:
