GitHub- फ्लेवर्ड मार्कडाउन में फुटनोट्स को कैसे जोड़ा जाए?

273

मैं सिर्फ अपने GitHub Gist में फुटनोट्स जोड़ने की कोशिश कर रहा हूं , लेकिन यह काम नहीं करता है:

Some long sentence. [^footnote]

[^footnote]: Test, [Link](https://google.com).

मैं इस गाइड का अनुसरण कर रहा हूं और मुझे नहीं लगता कि मैं कुछ गलत कर रहा हूं। क्या कोई मेरी गलती को इंगित कर सकता है?

markdown github-flavored-markdown multimarkdown

— एनरिको सुसात्यो
स्रोत

1

fletcher.github.io/peg-multimarkdown नोट: वर्तमान में, Github wiki सॉफ्टवेयर मार्कडाउन का समर्थन करता है, लेकिन मल्टीमैर्कडाउन नहीं है जहां यह दस्तावेज है कि यह काम करने वाला है?

— ta.speot.is 7

1

@EnricoSusatyo सादे निशान में नहीं है, लेकिन उदाहरण के लिए पंडोक इसका समर्थन करता है

— mb21

2

दिलचस्प बात यह है कि, GitLab के मार्कडाउन [^footnote]सिंटैक्स का समर्थन करता है , इससे पहले कि यह आधिकारिक तौर पर प्रलेखन में जोड़ा गया है

— hmijail शोक इस्तीफा देने वाले

1

@ मिजिल आप गीतालाब के फुटनोट का जिक्र कर रहे हैं, न कि गितूब का जैसा कि ओपी पूछ रहा था।

— दिव्य

1

@Devy, हाँ, यही कारण है कि मैंने "गिटलैब का मार्कडाउन" कहा। अभी भी उपयोगी हो सकता है, यह देखते हुए कि GitLab का स्वाद कार्यान्वयन GitHub स्वाद पर आधारित लगता है, और सामान्य मार्कडाउन में, इसका स्वाद और इसके कार्यान्वयन एक अपवित्र गड़बड़ हैं। सारांश: "बस के मामले में यह भी प्रयास करें"।

— हमीजेल

218

GitHub Flavoured Markdown फुटनोट्स का समर्थन नहीं करता है, लेकिन आप यूनिकोड वर्ण या सुपरस्क्रिप्ट टैग के साथ मैन्युअल रूप से नकली कर सकते हैं, उदा 1।

Responsibleअब यह आदर्श नहीं है, क्योंकि अब आप अपने फुटनोट की संख्या को बनाए रखने के लिए जिम्मेदार हैं। यह काफी अच्छी तरह से काम करता है यदि आपके पास केवल एक या दो हैं, हालांकि।

— क्रिस
स्रोत

धन्यवाद, मुझे यह भी पसंद है कि अन्य साइटों में क्लिक करने योग्य फुटनोट लिंक कैसे हैं, लेकिन मुझे लगता है कि यह GitHub में ऐसा करने का एकमात्र तरीका हो सकता है।

— एनरिको सुसात्यो

6

आप वर्ग कोष्ठक [1] में संलग्न नियमित संख्याओं का भी उपयोग कर सकते हैं, जो मेरे अनुभव में प्लेनटेक्स्ट फुटनोट्स के लिए एक बहुत ही स्थापित सम्मेलन है। (गोश डारनिट मैं टिप्पणियों में लाइन ब्रेक क्यों नहीं बना सकता।) [1] जैसे कि पंडोक मैंडोक फुटनोट की देखभाल करते हैं।

— गिल्डनस्टर्न 20

342

पिछले उत्तर पर थोड़ा विस्तार करते हुए, आप फुटनोट लिंक को यहां क्लिक करने योग्य बना सकते हैं। सबसे पहले इस तरह के तल पर फुटनोट को परिभाषित करें

<a name="myfootnote1">1</a>: Footnote content goes here

फिर इसे इस तरह से दस्तावेज़ में किसी अन्य स्थान पर देखें

<sup>[1](#myfootnote1)</sup>

— suryasankar
स्रोत

2

यह एक अच्छा मध्य-भूमि का उत्तर है। यह IMO के बिना इरादे को स्पष्ट करता है, स्वरूपण के लिए बहुत अधिक प्रस्फुटित होता है।

— kayleeFrye_onDeck

3

गैर-अंकीय संदर्भ का उपयोग करना अनुक्रमिक सांख्यिक संदर्भ को बनाए रखने की उपर्युक्त मुद्दा अनावश्यक - Example [[TPL]](#TPL)... #### Notes...<a name="TPL">[TPL]</a> footnote template

— रान्डेल व्हिटमैन

4

नीचे @ माटेयो के उत्तर में भाग 2 को याद न करें। मैं इस जवाब (धन्यवाद) के साथ बहुत प्रभावित हुआ था कि मैंने नीचे स्क्रॉल करने की जहमत नहीं उठाई। । ।

— वार्ड

180

पिछले उत्तरों पर और भी विस्तार करते हुए, आप idअपने फुटनोट के लिंक में एक विशेषता जोड़ सकते हैं :

 Bla bla <sup id="a1">[1](#f1)</sup>

फिर फुटनोट के भीतर से, इसे वापस लिंक करें।

<b id="f1">1</b> Footnote content here. [↩](#a1)

यह ↩आपके फ़ुटनोट की सामग्री के अंत में थोड़ा जोड़ देगा , जो आपके पाठकों को फ़ुटनोट के लिंक वाली पंक्ति में वापस ले जाता है।

— Matteo
स्रोत

8

ऊपर @ माटेयो की प्रतिक्रिया में एक मामूली सुधार जोड़कर, मुझे फुटनोट के लिए कॉल के nameबजाय उपयोग करना पड़ा id। Ie Bla bla [1](#f1)

— oldfartdeveloper

2

साभार @oldfartdeveloper ऐसा लगता है कि दोनों nameऔर idgithub.com पर README फ़ाइलों के लिए काम करते हैं .. हालांकि जेंट्स का परीक्षण नहीं किया है।

— Matteo

1

सर्का 2020 में इस प्रश्नोत्तर को खोजने वालों के लिए: यह उत्तर GitHub पर काम करता है, इसके अतिरिक्त इसकी अतिरिक्त विशेषता है: रिटर्न-टू-द-फुटनोट-लिंक- यू -क्लिक । मुझे एक मामूली कैविएट (यहां समझाया गया है) मिला है , लेकिन यह उत्तर उत्तर है ।

— सीमस

13

मैं सूर्या और मैटियो के समाधान के लिए काम करने में सक्षम नहीं था। उदाहरण के लिए, "(# f1)" को केवल पाठ के रूप में प्रदर्शित किया गया था, और लिंक नहीं बना। हालांकि, उनके समाधान मुझे थोड़ा अलग समाधान की ओर ले गए। (मैंने फुटनोट और लिंक को मूल सुपरस्क्रिप्ट में थोड़ा अलग रूप में स्वरूपित किया है।)

पाठ के मुख्य भाग में:

Yadda yadda<a href="#note1" id="note1ref"><sup>1</sup></a>

दस्तावेज़ के अंत में:

<a id="note1" href="#note1ref"><sup>1</sup></a>Here is the footnote text.

मूल पाठ में सुपरस्क्रिप्ट के लिए फ़ुटनोट रिटर्न में सुपरस्क्रिप्ट पर क्लिक करना।

— मंगल ग्रह
स्रोत

दिलचस्प। आपने HTML का उपयोग किया है जहां @Matteo ने GFM का उपयोग किया है। मैं काम करने के लिए उसका समाधान प्राप्त करने में सक्षम था, लेकिन इसके लिए थोड़ी फिजूलखर्ची की आवश्यकता थी । क्या आपको लगता है कि यह GitHub के रेंडरिंग इंजन में एक क्विक है?

— सीमस

मुझे कुछ पता नहीं है, @ सीमस। जैसा कि मुझे याद है, जब मैं इसका पता लगाने की कोशिश कर रहा था, तब थोड़ा परीक्षण और त्रुटि हुई थी।

— मंगल

1

यह एक चतुर उपाय है। और हाँ - यही वह जगह है जहाँ हम आज हैं - परीक्षण और त्रुटि :)

— सीमस

12

हालाँकि मुझे इस बात की जानकारी नहीं है कि यह आधिकारिक तौर पर कहीं भी प्रलेखित है, आप गितुब में पाद लेख नोट कर सकते हैं।

उस जगह को चिह्नित करें जहां आप वर्ग कोष्ठक, आईई में संलग्न संख्या के साथ पाद लेख लिंक करना चाहते हैं [1]
पोस्ट के नीचे, गिने हुए मार्कर का संदर्भ लें और उसके बाद एक कोलन और लिंक, IE [1]: http://www.example.com/link1

और एक बार जब आप इसका पूर्वावलोकन कर लेते हैं, तो इसे पोस्ट की बॉडी में गिने हुए लिंक के रूप में प्रस्तुत किया जाएगा।

— Devy
स्रोत

5

हालांकि यह आपके दस्तावेज़ के अंत में लिंक की एक सूची उत्पन्न नहीं करता है। जैसे विकिपीडिया के पन्नों पर।

— मिल्सा

वर्ग कोष्ठक के बाद एक बृहदान्त्र होना चाहिए?

— सागिनागा

17

यह कोई फुटनोट नहीं है, यह एक कड़ी है।

— डेविड मोल्स

कदम #1github markdown (Dec 2018) पर एक लिंक के रूप में काम नहीं किया।

— ruhong डिक

7

छोटे नोटों के लिए, शीर्षक विशेषता के साथ एक एंकर तत्व प्रदान करना एक "टूलटिप" बनाता है।

<a title="Note text goes here."><sup>n</sup></a>

अन्यथा, अधिक शामिल नोटों के लिए, ऐसा लगता है कि आपका सर्वश्रेष्ठ दांव मैन्युअल रूप से नामित लिंक बनाए रख रहा है।

— रिच ट्रूब
स्रोत

1

यह एक GitHub एंटरप्राइज़ 2.8

— मार्काडाउन

4

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

blablabla [1](#1)ब्लाब्लाब्ला

फुटनोट्स: ब्लोबैब्ला का संदर्भ <a class="anchor" id="1"></a>

— aerijman
स्रोत

3

मैंने माटेओ के समाधान के एक संस्करण का उपयोग किया। मैं इसका उपयोग Rmd फ़ाइलों में एक Jekyll संचालित वेबसाइट के लिए github फ्लेवर्ड मार्कडाउन (gfm) में लिखा था, लेकिन उसी Rmd फ़ाइलों का उपयोग विभिन्न संदर्भों में pdfs के उत्पादन के लिए किया जा रहा है। Rmd फाइलें गणित की भारी होती हैं और गणित को वेबसाइट पर MathJax के साथ प्रदर्शित किया जाता है। तो मुझे एक समाधान की आवश्यकता थी जो जेफाइल के माध्यम से संसाधित होने वाले gfm के साथ काम करता है, pandoc-> pdflatex के साथ काम करता है, और MathJax के साथ संगत है।

Rmd फ़ाइल से स्निपेट (जो gfm है)

Here is a paragraph with an footnote <span id="a1">[[1]](#f1)</span>.

Footnotes
=========

1. <span id="f1"></span> This is a footnote. [$\hookleftarrow$](#a1)

$\hookleftarrow$ लेटेक्स है, जो मेरे लिए काम करता है क्योंकि मेरे पास हमेशा मैथजैक्स सक्षम है। मैं यह सुनिश्चित करने के लिए उपयोग करता हूं कि यह मेरे pdfs में सही ढंग से दिखाई दे। मैंने अपने वर्ग-वर्ग कोष्ठक में रखा है क्योंकि अगर मैं कुछ इनलाइन गणित पर एक फुटनोट डाल रहा हूं तो सुपरस्क्रिप्ट को भ्रमित किया जाता है।

यहाँ यह कार्रवाई में है: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

इन नोटों को Rmd में कहीं भी रखा जा सकता है। मैं अंत में एक सूची में डाल रहा हूं ताकि वे तकनीकी रूप से अंतिम नोट हों।

— एली होम्स
स्रोत

ओपी के प्रश्न के हल्के से सामंजस्यपूर्ण लेकिन अंततः मुझे आपका "समाधान पसंद है जो जेफिल के माध्यम से संसाधित होने वाले gfm के साथ काम करता है, pandoc-> pdflatex के साथ काम करता है, और MathJax के साथ संगत है"। नीट उदाहरण।

— boweeb

0

यहाँ एली होम्स के उत्तर की भिन्नता है जो लेटेक्स का उपयोग किए बिना मेरे लिए काम करता है:

Text<span id="a1">[¹](#1)</span>

<span id="1">¹</span> Footnote.[⏎](#a1)<br>

उदाहरण

— स्कॉट गार्डनर
स्रोत

0

हालाँकि यह सवाल GitHub के फ्लेवर्ड मार्कडाउन के बारे में है, मुझे लगता है कि यह ध्यान देने योग्य है कि 2013 के अनुसार , GitHub AsciiDoc का समर्थन करता है जिसमें यह फीचर बिलिन है । आपको केवल .adocएक्सटेंशन और उपयोग के साथ अपनी फ़ाइल का नाम बदलना होगा :

A statement.footnote:[Clarification about this statement.]

A bold statement!footnote:disclaimer[Opinions are my own.]

Another bold statement.footnote:disclaimer[]

अंतिम परिणाम के साथ प्रलेखन यहाँ है ।

— डोरोन बेहार
स्रोत