🙎 👋🏽 🖌️ मार्कडाउन में सामान्य टेबल 🧑‍🤝‍🧑 🛀🏾 🛀🏾

मार्कडाउन टेबल नारकीय हैं:

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

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

मैं आमतौर पर मार्कडाउन में ग्रंथ लिखता हूं और पंडोक का उपयोग करके लक्ष्य प्रारूप में परिवर्तित होता हूं। यह एक ऐसा कार्यक्रम है जो स्वरूपों के बीच दस्तावेजों को परिवर्तित करता है, उदाहरण के लिए, मार्कडाउन से आप HTML, और एमडी, और DOCX, और पीडीएफ की एक और बोली (30 से अधिक इनपुट और 50 से अधिक आउटपुट स्वरूप) प्राप्त कर सकते हैं। पंडोक मार्कडाउन में लिंक, फुटनोट, हस्ताक्षर, सूत्र के लिए कई सुविधाजनक एक्सटेंशन हैं।

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

हमारा फ़िल्टर एक सार प्रतिनिधित्व में सशर्त भाषा table में कोड के सार ब्लॉकों के लिए दिखेगा, उनके अंदर YAML पढ़ें और उन तालिकाओं का सार प्रतिनिधित्व उत्पन्न करें जो पंडोक खुद लक्ष्य प्रारूप में उत्पन्न करेंगे।

 pandoc --lua-filter table.lua input.md -o output.html

विकल्प क्या हैं और वे क्यों बदतर हैं?

HTML तालिकाएँ केवल Markdown में काम करती हैं और केवल HTML में परिवर्तित होती हैं; केवल कोशिकाओं में समृद्ध स्वरूपण की समस्या हल हो गई है।
टेबल जनरेटर को पाठ संपादक से स्विच करने की आवश्यकता होती है, यह उन में कोशिकाओं की सामग्री को संपादित करने के लिए असुविधाजनक है ( उदाहरण के लिए )।
संपादकों प्लगइन्स ( Emacs ऑर्ग-मोड , VIM प्लगइन्स ) सार्वभौमिक नहीं हैं और हमेशा उपलब्ध नहीं हैं।

इसके विपरीत, pandoc-crossref और सभी पंडोक बन्स सारांश तालिकाओं के लिए फिल्टर के साथ काम करते हैं। उपयुक्त आउटपुट प्रारूप को निर्दिष्ट करके मानक मार्कडाउन तालिकाओं को उत्पन्न करने के लिए फ़िल्टर का उपयोग भी किया जा सकता है। नुकसान की:

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

तालिका के विवरण में तीन भाग शामिल हैं:

तालिका संरचना

रेखांकन की एक सूची (कॉलम):
- कम से कम, कॉलम में एक शीर्षक होना चाहिए।
- डेटा को छूने के बिना स्तंभों को पुनर्व्यवस्थित करने में सक्षम होने के लिए, कॉलम ( id ) में प्रदर्शित रिकॉर्ड विशेषता को निर्दिष्ट किया जाना चाहिए।
- विशेष कॉलम में आईडी नहीं है, लेकिन उन्हें कैसे भरना है, इसका वर्णन है। सबसे पहले आपको एक सीरियल नंबर ( special: number ) चाहिए।
- स्तंभ संरेखण ( align )।
साथ ही, तालिका ऊर्ध्वाधर या क्षैतिज ( orientation ) हो सकती है। बाद के मामले में, रेखांकन पंक्तियाँ होंगी।
तालिका गुण: लिंक ( id ) और हस्ताक्षर ( caption ) के लिए id । पंडोक आपको तालिकाओं पर हस्ताक्षर करने की अनुमति देता है, लेकिन कोड के ब्लॉक नहीं।
YAML शब्दकोशों की एक सरणी के रूप में डेटा ।

संरचना कई तालिकाओं के लिए सामान्य हो सकती है, इसलिए आप इसे तालिका के साथ सीधे दोनों का वर्णन कर सकते हैं, और एक बार मेटाडेटा (सामने-मामले) में, और फिर नामित टेम्पलेट को देखें।

कार्यान्वयन योजना:

दस्तावेज़ के मेटाडेटा से हम टेम्पलेट का एक शब्दकोश बनाते हैं।
वर्ग table के साथ कोड के प्रत्येक ब्लॉक के table :
1. हम YAML तालिकाओं को पार्स करते हैं।
2. यदि कोई टेम्पलेट निर्दिष्ट किया गया है, तो हम इसे शब्दकोश से लेते हैं, अन्यथा हम YAML से टेम्पलेट को भरते हैं।
3. हम YAML से तालिका के व्यक्तिगत गुणों को भरते हैं।
4. हम YAML से तालिका प्रविष्टियां बनाते हैं (एक रिकॉर्ड एक नियमित तालिका में एक पंक्ति या क्षैतिज एक स्तंभ में है)।
5. हम एक टेम्प्लेट, गुण और रिकॉर्ड के अनुसार एक तालिका बनाते हैं।

ऊपरी स्तर को लिखित रूप में लागू किया गया है (सभी कोड लेख के अंत में लिंक पर उपलब्ध है):

 function Pandoc(doc) local meta_templates = doc.meta['table-templates'] if meta_templates then for name, value in pairs(meta_templates) do templates[name] = parse_template(value) end end local blocks = pandoc.walk_block(pandoc.Div(doc.blocks), { CodeBlock = create_table }) return pandoc.Pandoc(blocks, doc.meta) end

parse_template() फ़ंक्शन मेटाडेटा प्रारूप को थोड़ा परिवर्तित करता है। पंडोक MetaBlock और MetaInline रूप में उनके मूल्यों का प्रतिनिधित्व करता है। या तो सरल पंक्तियाँ pandoc.utils.stringify() फ़ंक्शन (उदाहरण के लिए, ओरिएंटेशन), या विज़ुअल एलिमेंट्स (उदाहरण के लिए, स्तंभ शीर्षक में पाठ का एक ब्लॉक pandoc.utils.stringify() बनाई गई हैं।

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

मेटाडेटा को दस्तावेज़ तत्वों में परिवर्तित करने के लिए कार्य

 local function to_inlines(content) if content == nil then return {} elseif type(content) == 'string' then return {pandoc.Str(content)} elseif type(content) == 'number' then return to_inlines(tostring(content)) elseif content.t == 'MetaInlines' then inlines = {} for i, item in ipairs(content) do inlines[i] = item end return inlines end end local function to_blocks(content) if (type(content) == 'table') and content.t == 'MetaBlocks' then return content else return {pandoc.Plain(to_inlines(content))} end end

create_table() फ़ंक्शन को ट्रिपल बैकटिक्स में कोड के प्रत्येक ब्लॉक के लिए कहा जाता है।

हम केवल table "ब्लॉक" भाषा में रुचि रखते हैं:

 if not contains('table', block.classes) then return block end

एक कोड ब्लॉक के अंदर YAML को पार्स करने के लिए, हम केवल एक दस्तावेज बनाते हैं जिसमें केवल YAML मेटाडेटा होता है, इसे पंडोक के साथ पार्स करें और केवल मेटाडेटा छोड़ दें:

 local meta = pandoc.read('---\n' .. block.text .. '\n---').meta

अगला, meta टेम्प्लेट या टेबल संरचना का लिंक और एक विशिष्ट तालिका के गुणों को पढ़ा जाता है।

fill_table() फ़ंक्शन ग्राफ के विवरण में निर्दिष्ट विशेषताओं पर meta डेटा से पढ़ता है। उसी चरण में, यदि स्तंभ विशेष के रूप में चिह्नित है, तो इसकी सामग्री उत्पन्न होती है:

 local data = {} for i, serie in ipairs(template.series) do if serie.special == 'number' then data[i] = to_blocks(#datum + 1) else data[i] = to_blocks(item[serie.id]) end end

format_table() फ़ंक्शन तालिका के उन्मुखीकरण के आधार पर कोशिकाओं के परिणामस्वरूप सरणी बनाता है और एक सार तालिका ऑब्जेक्ट बनाता है। यह ध्यान दिया जाना चाहिए कि यदि चौड़ाई या हेडर सभी स्तंभों के लिए या किसी के लिए भी सेट किए जाने चाहिए, अन्यथा पंडोक बस एक तालिका नहीं बनाएगा।

तैयार स्क्रिप्ट को कहीं से भी नाम से एक्सेस करने के लिए ~/.local/share/pandoc ( ~/.local/share/pandoc डेटा डायरेक्टरी ) में रखा जा सकता है।

पुनश्च

आउटपुट स्वरूप फ़िल्टर के लिए लेखांकन के बारे में। उदाहरण के लिए, मैं इस तरह पंडोक में स्पॉइलर लिखता हूं:

 ::: {.spoiler title=""}  . :::

पंडोक दस्तावेज़ मॉडल में कोई स्पॉइलर नहीं हैं, इसलिए फ़िल्टर को लगभग निम्नलिखित तरीके से कच्चे ब्लॉकों का उत्पादन करना चाहिए। बेशक, असली कोड ( spoiler.lua ) को FORMAT चर के माध्यम से आउटपुट स्वरूप को ध्यान में रखना चाहिए, और यंत्रवत् नहीं: नीचे का टुकड़ा HTML में कच्चे ब्लॉकों का उत्पादन करता है, हालांकि आउटपुट प्रारूप मार्काडाउन है।

 function Div(el) if not el.attr or not contains('spoiler', el.attr.classes) then return el end local title = el.attr.attributes['title'] or '' table.insert(el.content, 1, pandoc.RawBlock('html', '<' .. 'spoiler title="' .. title .. '">', 'RawBlock')) table.insert(el.content, pandoc.RawBlock('html', '<' .. '/spoiler>', 'RawBlock')) return el.content end

मार्कडाउन में सामान्य टेबल

पुनश्च

संदर्भ

More articles: