github - मार्कडाउन फ़ाइल में गिटहब सापेक्ष लिंक




markdown github-flavored-markdown (6)

क्या यूआरएल एंकर बनाने के लिए कोई तरीका है, <a> , एक मार्कडाउन फ़ाइल के भीतर से लिंक, उसी रिपॉजिटरी और शाखा के भीतर दूसरी फाइल (वर्तमान शाखा से संबंधित एक लिंक उर्फ)?

उदाहरण के लिए, मास्टर शाखा में मेरे पास एक README.md फ़ाइल है, जिसे मैं कुछ करना चाहूंगा:

# My Project
is really really cool. My Project has a subdir named myLib, see below.

## myLib documentation
see documentation [here](myLib/README.md)

यह मुझे एक ही शाखा में एक .md से दूसरे में लिंक करने की अनुमति देगा और मुझे इस बारे में चिंता करने की ज़रूरत नहीं है कि मैं किस शाखा में हूं (एक पूर्ण यूआरएल करने से बचें जिसमें github.com शाखा का नाम शामिल है)।

मेरा मतलब यह है कि मेरा क्या मतलब है:

  1. गोटो http://github.com/rynop/testRel , लिंक काम नहीं करता है।
  2. गोटो http://github.com/rynop/testRel/blob/master/README.md , लिंक काम करता है।

इसकी उम्मीद है क्योंकि इस बिंदु पर प्रारंभिक यूआरएल शाखा में है। अब मैं भंडार की जड़ पर README.md में वर्तमान शाखा को चुनने के लिए कैसे प्राप्त करूं?

अद्यतन : मैंने इस सुविधा अनुरोध के लिए गिटहब के खिलाफ एक issue खोला।


31 जनवरी, 2013 तक गिथब मार्कडाउन फाइलों के सापेक्ष लिंक का समर्थन करता है

[a relative link](markdown_file.md)

हालांकि, कुछ कमियां हैं जिन पर इस टिप्पणी धागे में चर्चा की गई है ।

एक विकल्प के रूप में, आप भंडार में पूर्ण यूआरएल बनाने के लिए Gitdown का उपयोग कर सकते हैं और यहां तक ​​कि उन्हें शाखा को जागरूक भी बना सकते हैं, उदाहरण के लिए

{"gitdown": "gitinfo", "name": "url"} // https://github.com/gajus/gitdown
{"gitdown": "gitinfo", "name": "branch"} // master

गिटडाउन एक गिटहब मार्कडाउन प्रीप्रोसेसर है। यह एक गिटहब भंडार के लिए एक प्रलेखन पृष्ठ को बनाए रखने के साथ जुड़े सामान्य कार्यों को सुव्यवस्थित करता है, उदाहरण के लिए सामग्री की प्रसंस्करण तालिका, चर सहित, यूआरएल उत्पन्न करना और इनपुट को संसाधित करने के समय खुद को भंडार के बारे में जानकारी प्राप्त करना। गिटडाउन निर्बाध रूप से आपकी बिल्डिंग स्क्रिप्ट के साथ एकीकृत करता है।

मैं गिटडाउन लाइब्रेरी का लेखक हूं।


आप <a href=""> साथ अपने रेपो की रूट से सापेक्ष URL का उपयोग कर सकते हैं। मान लें कि आपके रेपो को testRel नाम दिया गया है, testRel/README.md में निम्न testRel/README.md :

# My Project
is really really cool. My Project has a subdir named myLib, see below.

## myLib docs
see documentation:
    * <a href="testRel/myLib">myLib/</a>
    * <a href="testRel/myLib/README.md">myLib/README.md</a>

गिटहब इसे कम से कम काम के साथ बहुत बेहतर बना सकता है। यहां एक काम है।

मुझे लगता है कि आप कुछ और चाहते हैं

[Your Title](your-project-name/tree/master/your-subfolder)

या खुद को रीडमी को इंगित करने के लिए

[README](your-project-name/blob/master/your-subfolder/README.md)

शुभ लाभ


बस इसे जोड़ना चाहता था क्योंकि ऊपर दिए गए समाधानों में से कोई भी काम नहीं करता है यदि लक्ष्य लिंक उस नाम के रिक्त स्थान के साथ निर्देशिका है। यदि लक्ष्य लिंक एक निर्देशिका है और इसमें स्थान है तो अंतरिक्ष से बचने के साथ \ Github पर लिंक प्रस्तुत नहीं करता है। मेरे लिए केवल समाधान ही काम करता है प्रत्येक स्थान के लिए %20 का उपयोग कर रहा है।

उदाहरण: यदि निर्देशिका संरचना यह है

Top_dir
|-----README.md
|-----Cur_dir1
      |----Dir A
           |----README.md
      |----Dir B
           |----README.md

Top_dir में मौजूद README.md में Dir A को लिंक करने के लिए आप यह कर सकते हैं:

[Dir 1](Cur_dir1/Dir%20A)

यदि आप गिटहब पर अपने विकी पेज के सापेक्ष लिंक चाहते हैं, तो इसका उपयोग करें:

Read here: [Some other wiki page](path/to/some-other-wiki-page)

यदि आप रिपॉजिटरी में किसी फ़ाइल के लिंक चाहते हैं, तो हम कुछ हेडर फ़ाइल को संदर्भित करने के लिए कहें, और विकी पेज विकी की जड़ पर है, इसका उपयोग करें:

Read here: [myheader.h](../tree/master/path/to/myheader.h)

आखिरी के लिए तर्क "/ wiki" पथ को "../" के साथ छोड़ना है, और रिपोजिटरी पेड़ में मास्टर शाखा में जाकर रिपोजिटरी नाम निर्दिष्ट किए बिना, जो भविष्य में बदल सकता है।


यह सवाल बहुत पुराना है, लेकिन यह अभी भी महत्वपूर्ण लगता है, क्योंकि गीथूब पर readme.md से विकी पृष्ठों से सापेक्ष संदर्भ रखना आसान नहीं है।

मैंने थोड़ा सा खेला और यह सापेक्ष लिंक बहुत अच्छी तरह से काम करता प्रतीत होता है:

[Your wiki page](../../wiki/your-wiki-page)

दो ../ हटा देंगे /blob/master/ और एक शुरुआती बिंदु के रूप में अपने आधार का उपयोग करें। मैंने गिटूब की तुलना में अन्य भंडारों पर यह कोशिश नहीं की है, हालांकि (संगतता मुद्दे हो सकते हैं)।





github-flavored-markdown