টাইপডকস নিয়ে আমার এই সঠিক সমস্যা ছিল। README.md কাজ করেছে কিন্তু আমার ডক স্ট্রিং দ্বারা উত্পন্ন প্রকৃত ডক্সগুলির মধ্যে একটিও প্রদর্শিত হয়নি, আমি মাত্র একটি 404 গিথুব পৃষ্ঠাগুলি পর্দা পেয়েছি।
এটি ঠিক করার জন্য, কেবল আপনার / ডক্স ডিরেক্টরিতে (বা যেখানেই আপনি নিজের ডক্স তৈরি করেন) একটি ফাঁকা ফাইল রাখুন এবং কল করুন .nojekyll
নিশ্চিত করার জন্য, আপনার ফাইলের গঠনটি এখন দেখতে হবে:
./docs/.nojekyll # plus all your generated docs
আপনার রিমোট গিথুব রেপোতে এটি চাপ দিন এবং আপনার লিঙ্কগুলি এখন কাজ করা উচিত।
আপনার গিথুব সেটিংসে আপনি নির্বাচন করেছেন তা নিশ্চিত করুন:
Settings -> Github Pages -> Source -> master brach /docs folder
আপনার ডক ফ্রেমওয়ার্কের উপর নির্ভর করে, আপনি প্রতিবার আপনার ডক্স আপডেট করার সময় আপনাকে সম্ভবত এই ফাইলটি পুনরায় তৈরি করতে হবে, এটি টাইপডোকস ব্যবহার এবং প্যাকেজ.জসন ফাইলটিতে প্রতিবার .nojekyll ফাইল তৈরি করার একটি উদাহরণ:
# package.json
"scripts": {
"typedoc": "typedoc --out docs src && touch docs/.nojekyll"
},