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




markdown github-flavored-markdown (8)

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

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

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

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

क्या यूआरएल एंकर बनाने के लिए कोई तरीका है, <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 खोला।


आप <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>

बस इसे जोड़ना चाहता था क्योंकि ऊपर दिए गए समाधानों में से कोई भी काम नहीं करता है यदि लक्ष्य लिंक उस नाम के रिक्त स्थान के साथ निर्देशिका है। यदि लक्ष्य लिंक एक निर्देशिका है और इसमें स्थान है तो अंतरिक्ष से बचने के साथ \ 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)

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

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

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

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

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

शुभ लाभ


उदाहरण के लिए, आपके पास निम्न की तरह रेपो है:

project/
    text.md
    subpro/
       subtext.md
       subsubpro/
           subsubtext.md
       subsubpro2/
           subsubtext2.md

subtext.md में text.md का सापेक्ष लिंक इस तरह text.md सकता है:

[this subtext](subpro/subtext.md)

subsubtext.md में text.md का सापेक्ष लिंक इस तरह text.md सकता है:

[this subsubtext](subpro/subsubpro/subsubtext.md)

subtext.md में subsubtext.md सापेक्ष लिंक इस तरह subsubtext.md सकते हैं:

[this subtext](../subtext.md)

subsubtext2.md में subsubtext.md सापेक्ष लिंक इस तरह subsubtext.md सकते हैं:

[this subsubtext2](../subsubpro2/subsubtext2.md)

text.md में subsubtext.md सापेक्ष लिंक इस तरह subsubtext.md सकते हैं:

[this text](../../text.md)

मुझे यकीन नहीं है कि मैं यहां यह विकल्प देखता हूं। आप बस अपने भंडार में एक /folder बना सकते हैं और इसे सीधे उपयोग कर सकते हैं:

[a relative link](/folder/myrelativefile.md)

कोई ब्लॉब या पेड़ या रिपोजिटरी नाम की आवश्यकता नहीं है, और यह एक आकर्षण की तरह काम करता है।


30 महीने , जनवरी 2013 , 16 महीने बाद अपडेट करें:

मार्कअप फाइलों में गिटहब ब्लॉग पोस्ट सापेक्ष लिंक :

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

आप लिंक परिभाषाओं के उदाहरण चाहते हैं और वे कैसे काम करते हैं? यहां आपके लिए कुछ मार्कडाउन है।
एक पूर्ण लिंक के बजाय:

[a link](https://github.com/user/repo/blob/branch/other_file.md)

... आप एक सापेक्ष लिंक का उपयोग कर सकते हैं:

[a relative link](other_file.md)

और हम सुनिश्चित करेंगे कि यह user/repo/blob/branch/other_file.md

यदि आप [a workaround link](repo/blob/master/other_file.md) जैसे वर्कअराउंड का उपयोग कर रहे थे, तो आपको नए सिंटैक्स का उपयोग करने के लिए अपने दस्तावेज़ों को अपडेट करना होगा।

इसका मतलब यह भी है कि आपका दस्तावेज़ अब गिटहब को इंगित किए बिना आसानी से खड़ा हो सकता है

20 दिसंबर, 2011 को अपडेट करें:

technoweenie मार्कअप मुद्दा 84 वर्तमान में technoweenie द्वारा बंद है, टिप्पणी के साथ:

हमने इसके लिए <base> टैग जोड़ने का प्रयास किया, लेकिन यह साइट पर अन्य सापेक्ष लिंक के साथ समस्याएं पैदा करता है।

12 अक्टूबर, 2011:

यदि आप README.md के ( README.md के README.md के कच्चे स्रोत को README.md , तो सापेक्ष पथ समर्थित नहीं लगते हैं।
आपको संदर्भ मिलेगा जैसे:

[r2h]: http://github.com/github/markup/tree/master/lib/github/commands/rest2html
[r2hc]: http://github.com/github/markup/tree/master/lib/github/markups.rb#L13

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

[a relative link](markdown_file.md)

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

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

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

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

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





github-flavored-markdown