पर मार्कडाउन का उपयोग करने के लिए विस्तृत, विशिष्ट दस्तावेज़ीकरण नहीं मिल सकता है। मैं अपने कुछ रिपो और मेरे उपयोगकर्ता पेज पर जिथब पेज जोड़ने की प्रक्रिया में हूं। कई वेब पेजों के लिए, मैं मार्कडाउन स्वरूपण का उपयोग करना चाहता हूं।github प्रोजेक्ट और उपयोगकर्ता पेज
हालांकि, जैसा कि मुझे यह करने के बारे में जानकारी केवल vague, undetailed जानकारी मिल सकती है, मैं यह पता लगाने के लिए परीक्षण और त्रुटि कर रहा हूं कि यह कैसे काम करता है।
असली दस्तावेज़ीकरण कहां है? गॉरी विवरण?
- विशेष शाखा का नाम
gh-pagesका उपयोग एक परियोजना रेपो एक तीन लाइन के लिए एक साइट बनाने के लिए:
Here सबसे अच्छा जानकारी मैं अब तक मिल गया है, जो कहते हैं है फ़ाइल के शीर्ष पर incantation आवश्यक है:
--- title: something ---- प्रत्ययमें बदल जाता है
लेकिन मैं इस तरह के रूप विवरण के बारे में कई सवाल, साथ छोड़ रहा हूँ:
- मैं सीएसएस फ़ाइलें आयात कर सकते हैं?
- वह "शीर्षक" वास्तव में क्या करता है?
- फ़ाइलों को क्या प्रत्यय की आवश्यकता है?
आदि तो मैं वास्तव में सभी सुविधाओं के लिए विस्तृत दस्तावेज़ीकरण देखना चाहता हूं।
कृपया ध्यान दें कि इस सवाल यह है कि Markdown सिंटैक्स का उपयोग करने के बारे में नहीं है, लेकिन कैसे स्वचालित रूप से उपयोगकर्ता और परियोजना पृष्ठों के दायरे के भीतर Markdown से एचटीएमएल बनाने के लिए GitHub का जादू का दोहन करने के।
यूटीएफ 8 से क्यों बचा जाना चाहिए? –
@ मैटफ़ेनविक: यह उल्लेख करता है कि वाईएएमएल फ्रंट मैटर पेज के शीर्ष के पास: https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter। –