साइटेशन जो साइटेशन की तरह बर्ताव करते हैं

मल्टी-सोर्स रिसर्च टेम्पलेट की एक रन ने निवेश साधनों पर एक अच्छी रिपोर्ट बनाई, और फिर उसे ख़राब तरीक़े से छापा। [^1] जैसे पंचानवे मार्कर मुख्य टेक्स्ट के बीच में थे, और [^1]: जैसी नौ लाइनें नीचे ढेर हो रही थीं। वेब पर भी और फ़ोन पर भी।

वजह यह है कि फ़ुटनोट मार्कडाउन का हिस्सा नहीं हैं। यह एक एक्सटेंशन है, और हमारे दिए दोनों मार्कडाउन रेंडरर में से — एक वेब पर, दूसरा मोबाइल पर — किसी ने इसे लागू नहीं किया। हम मॉडल से बिल्कुल यही फ़ॉर्म माँग रहे थे, और फिर इसे शाब्दिक टेक्स्ट के रूप में दिखा रहे थे।

एक फिर से लिखने वाला, दो इंजन

दोनों रेंडरर को एक ही एक्सटेंशन सिखाने की बजाय, मार्करों को दोनों में से किसी के देखने से पहले फिर से लिखा जाता है, एक सादे लिंक में जिसे दोनों पहले से ही एक जैसा रेंडर करते हैं। डेफ़िनिशन को अलग निकालकर वापस भेजा जाता है, और उनके बाद जो आता था वह डॉक्यूमेंट की पूँछ के रूप में रहता है। स्क्वेयर ब्रैकेट्स लिंक टेक्स्ट के अंदर रहते हैं, ताकि इकट्ठे साइटेशन [1][2] की तरह पढ़े जाएँ, 12 की तरह नहीं।

वेब पर साइटेशन को सुपरस्क्रिप्ट में बनाया जाता है, डेफ़िनिशन को असली एंकर के साथ एक लिस्ट के रूप में रेंडर किया जाता है, किसी एक पर क्लिक करने से वहाँ स्क्रॉल होता है और लाइन फ़्लैश होती है, और लिस्ट का नंबर वापस पहली जगह पर जाता है जहाँ इसे साइट किया गया था। ऊपर होवर करने से स्थान बदले बिना डेफ़िनिशन दिखती है। फ़ोन पर वही मार्कर एक्सेंट कलर में बनाए जाते हैं, और किसी एक को टैप करने से पैनल जुड़ी हुई लाइन तक स्क्रॉल होता है। जो लिंक साइटेशन नहीं हैं वे पहले की तरह ब्राउज़र में खुलते रहते हैं।

रिपोर्ट के नीचे के सोर्स कार्ड कभी प्रभावित नहीं हुए — वे कहीं और से आते हैं और हमेशा ठीक थे।

और डाउनलोड में

जो रिपोर्ट आप .docx, .pdf या .md के रूप में डाउनलोड करते हैं वह एक अलग कन्वर्टर से गुज़रती थी, जो कच्चे मार्करों को सीधे डॉक्यूमेंट में छापता था। किसी डॉक्यूमेंट स्पेसिफ़िकेशन में सुपरस्क्रिप्ट नहीं होता, इसलिए एक साइटेशन [3] के रूप में छपता है, और हर डेफ़िनिशन [3] से शुरू होकर अपनी लाइन खोलती है। इंडेंट की हुई कंटीन्यूएशन लाइनें अपनी डेफ़िनिशन से जुड़ जाती हैं। फ़ाइल में नंबर वही हैं जो स्क्रीन पर हैं।

पहली कोशिश एक ऐसे तरीक़े से ग़लत थी जिसके लिए हमारे पास पहले से सुरक्षा थी

पहले वर्शन ने फ़ुटनोट नंबरों को साधारण फ़्रैगमेंट लिंक बना दिया था — href="#fn-3"। सिंगल-पेज ऐप को जिस <base href="/"> की ज़रूरत होती है उसके नीचे, एक नंगा फ़्रैगमेंट साइट रूट के मुक़ाबले हल होता है, इसलिए लिंक होमपेज पर इशारा करता है। क्लिक हैंडलर नेविगेशन को कैंसल कर देता था, इसलिए यह काम कर रहा था — और तब तक करता रहता जब तक कोई हैंडलर को छू न दे।

ठीक इसी पैटर्न के लिए पहले से मौजूद एक जाँच पुश से पहले लोकल रन में लाल हो गई। नंबर अब बटन हैं; ये स्क्रॉल करते हैं, फ़ोकस मूव करते हैं, और पाठक की कम मूवमेंट की पसंद का सम्मान करते हैं।