मुझे यह सटीक समस्या टाइपकार्ड के साथ आई। README.md ने काम किया लेकिन मेरे डॉक्स स्ट्रिंग्स द्वारा उत्पन्न वास्तविक डॉक्स में से कोई भी प्रदर्शित नहीं हुआ, मुझे सिर्फ 404 गितूब पेज स्क्रीन मिली।
इसे ठीक करने के लिए, अपनी / डॉक्स निर्देशिका (या जहाँ भी आप अपना डॉक्स जेनरेट करते हैं) में एक खाली फ़ाइल रखें और इसे कॉल करें .nojekyll
पुष्टि करने के लिए, आपकी फ़ाइल संरचना अब दिखनी चाहिए:
./docs/.nojekyll # plus all your generated docs
इसे अपने दूरस्थ Github रेपो में पुश करें और आपके लिंक आदि को अब काम करना चाहिए।
यह भी सुनिश्चित करें कि आपने अपनी गितुब सेटिंग्स में चयन किया है:
Settings -> Github Pages -> Source -> master brach /docs folder
अपने डॉक्टर फ्रेमवर्क के आधार पर, संभवतः आपको हर बार जब आप अपने डॉक्स को अपडेट करते हैं, तो इस फाइल को फिर से बनाना होगा, यह टाइपकाड्स का उपयोग करने और हर बार एक पैकेज में एक .nojekyll फ़ाइल बनाने का एक उदाहरण है ।json फाइल:
# package.json
"scripts": {
"typedoc": "typedoc --out docs src && touch docs/.nojekyll"
},