r आर मार्केडाउन, निट्र, पंडोक और बुकडाउन के बीच संबंध



knitr r-markdown (1)

आर मार्केडाउन, नाइट्र, पंडोक और बुकडाउन की कार्यक्षमता के बीच क्या संबंध है?

विशेष रूप से एम्बेडेड आर कोड (जैसे .Rnw या .Rmd ) के साथ मार्कअप दस्तावेजों को अंतिम आउटपुट में (उदाहरण के लिए .pdf या .html ) में बदलने के लिए इन पैकेजों के बीच 'श्रम का विभाजन' क्या है? और अगर नाइट्र का उपयोग RMarkdown को संसाधित करने के लिए किया जाता है, तो rmarkdown पैकेज क्या करता है और यह rmarkdown पैकेज के लिए अलग कैसे है?


Pandoc

पंडोक एक दस्तावेज़ कनवर्टर है। यह कई अलग-अलग मार्कअप प्रारूपों से कई अन्य प्रारूपों में परिवर्तित हो सकता है, जैसे .doc , .pdf आदि।

पंडोक एक कमांड लाइन टूल है जिसमें कोई GUI नहीं है। यह एक स्वतंत्र सॉफ्टवेयर है, जो R से अलग है। हालांकि, यह R स्टूडियो से rmarkdown क्योंकि rmarkdown इसे दस्तावेज़ रूपांतरण के लिए निर्भर करता है।

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

आर मार्कडाउन

आर मार्कडाउन मार्कडाउन पर आधारित है:

मार्कडाउन (मार्कअप भाषा)

मार्काडाउन एक हल्की मार्कअप लैंग्वेज है जिसमें प्लेन टेक्स्ट फॉर्मेटिंग सिंटैक्स डिज़ाइन किया गया है ताकि इसे HTML और कई अन्य फॉर्मेट में बदला जा सके। एक मार्कडाउन फ़ाइल एक सादा पाठ फ़ाइल है जिसे आम तौर पर एक्सटेंशन .md दिया जाता है।

HTML और लेटेक्स जैसी अन्य मार्कअप भाषाओं की तरह, यह R से पूरी तरह से स्वतंत्र है।

कोई स्पष्ट रूप से परिभाषित मार्कडाउन मानक नहीं है। इससे विखंडन हुआ है क्योंकि विभिन्न विक्रेताओं ने खामियों को ठीक करने या लापता सुविधाओं को जोड़ने के लिए भाषा के अपने स्वयं के संस्करण लिखे हैं।

मार्कडाउन (आर पैकेज)

markdown एक R पैकेज है जो धर्मान्तरित करता है। HTML में फ़ाइलों को .Rmd । यह rmarkdown का पूर्ववर्ती है, जो बहुत अधिक कार्यक्षमता प्रदान करता है। यह अब उपयोग के लिए अनुशंसित नहीं है।

आर मार्केडाउन (मार्कअप भाषा)

मार्कडाउन मार्कडाउन सिंटैक्स का एक विस्तार है। .Rmd फाइलें सादी पाठ फाइलें होती हैं जिनमें आमतौर पर फाइल एक्सटेंशन .Rmd । वे मार्कडाउन सिंटैक्स के एक एक्सटेंशन का उपयोग करके लिखे गए हैं जो आर कोड को उन तरीकों से एम्बेड करने में सक्षम बनाता है जिन्हें बाद में निष्पादित किया जा सकता है।

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

आर मार्कडाउन (पैकेज)

आर पैकेज rmarkdown एक पुस्तकालय है जो कई अलग-अलग स्वरूपों में कई फाइलों में परिवर्तित और परिवर्तित .Rmd है।

मुख्य कार्य rmarkdown::render जो पैंडो के कंधों पर खड़ा है । यह फ़ंक्शन 'इनपुट फ़ाइल को पंडोक का उपयोग करके निर्दिष्ट आउटपुट प्रारूप में प्रस्तुत करता है। यदि इनपुट में बुनाई की आवश्यकता होती है तो knitr::knit निट को पंडोक से पहले कहा जाता है।

RMarkdown पैकेज का उद्देश्य पंडोक विकल्पों को अनुकूलित करने के लिए यथोचित रूप से अच्छी चूक और एक आर-अनुकूल इंटरफेस प्रदान करना है।

RMarkdown फ़ाइलों के शीर्ष पर देखी जाने वाली YAML मेटाडेटा विशिष्ट रूप से rmarkdown::render करने के विकल्पों को पास करने के rmarkdown::render , बिल्ड प्रक्रिया का मार्गदर्शन करने के लिए।

ध्यान दें कि RMarkdown केवल markdown syntax के साथ कार्य करता है। यदि आप एक .Rhtml या a .Rnw फ़ाइल को कनवर्ट करना चाहते हैं, तो आपको Knitr में निर्मित सुविधा कार्यों का उपयोग करना चाहिए, जैसे कि knitr::knit2html और knitr:knit2pdf

Knitr

Knitr एम्बेडेड कोड के साथ एक सादा पाठ दस्तावेज़ लेता है, कोड निष्पादित करता है और दस्तावेज़ में परिणाम वापस करता है।

उदाहरण के लिए, यह रूपांतरित होता है

कोर फ़ंक्शन knitr::knit और डिफ़ॉल्ट रूप से यह इनपुट डॉक्यूमेंट को देखेगा और कोशिश करेगा और अनुमान लगाएगा कि यह किस प्रकार का है - आरएनडब्ल्यू, आरएमडी आदि।

यह मुख्य कार्य तीन भूमिकाएँ करता है: - एक स्रोत पार्सर, जो इनपुट दस्तावेज़ को देखता है और पता लगाता है कि कौन से कोड हैं जिन्हें उपयोगकर्ता मूल्यांकन करना चाहता है। - एक कोड मूल्यांकनकर्ता, जो इस कोड का मूल्यांकन करता है - एक आउटपुट रेंडरर, जो दस्तावेज़ के मूल्यांकन के परिणामों को एक प्रारूप में वापस लिखता है जो कच्चे आउटपुट प्रकार द्वारा व्याख्या योग्य है। उदाहरण के लिए, यदि इनपुट फ़ाइल एक .Rmd , तो आउटपुट रेंडर .md प्रारूप में कोड मूल्यांकन के आउटपुट को चिह्नित करता है।

दस्तावेज़ स्वरूपों के बीच परिवर्तित

Knitr दस्तावेज़ स्वरूपों के बीच परिवर्तित नहीं होता है - जैसे कि .md को .html में बदलना। हालांकि, यह करने के लिए अन्य पुस्तकालयों का उपयोग करने में आपकी सहायता के लिए कुछ सुविधा प्रदान करता है। यदि आप rmarkdown पैकेज का उपयोग कर रहे हैं, तो आपको इस कार्यक्षमता को नजरअंदाज करना चाहिए क्योंकि यह rmarkdown::render द्वारा rmarkdown::render किया गया है।

एक उदाहरण है knitr:knit2pdf जो होगा: 'इनपुट Rnw या Rrst डॉक्युमेंट को बुनें, और texi2pdf या rst2pdf का उपयोग करके पीडीएफ को संकलित करें'।

भ्रम का एक संभावित स्रोत knitr::knit2html , जो "HTML को परिणाम बदलने के लिए इनपुट मार्कडाउन स्रोत और कॉल markdown::markdownToHTML कॉल करने के लिए एक सुविधा कार्य है।" यह अब विरासत की कार्यक्षमता है क्योंकि rmarkdown पैकेज को rmarkdown पैकेज द्वारा rmarkdown किया गया है। इस नोट को देखें।

Bookdown

बुकडाउन पैकेज आर मार्केडाउन के शीर्ष पर बनाया गया है, और मार्कडाउन सिंटैक्स की सादगी को विरासत में मिला है, साथ ही कई प्रकार के आउटपुट प्रारूपों (पीडीएफ / एचटीएमएल / वर्ड /…) की संभावना भी है।

यह बहु-पृष्ठ HTML आउटपुट, नंबरिंग और क्रॉस-रेफ़रिंग के आंकड़े / टेबल / सेक्शन / समीकरण, पुर्ज़े / पुर्ज़े सम्मिलित करने और GitBook स्टाइल ( https://www.gitbook.com ) को सुरुचिपूर्ण और आकर्षक HTML बनाने के लिए प्रदान करता है। पुस्तक पृष्ठ।





bookdown