2012-02-13 10 views
39

उदाहरण के लिए, @details अनुभाग में roxygen2 में एक आइटमीकृत सूची जोड़ने के लिए उपयुक्त वाक्यविन्यास क्या है? क्या मैं लेटेक्स सूची वातावरण बना सकता हूं?जब Roxygen में दस्तावेज़ांकन: मैं @details में एक आइटमीकृत सूची कैसे बना सकता हूं?

ऐसा लगता है कि पंक्ति विराम बस अनदेखी कर रहे हैं अर्थात

#' @details text describing parameter inputs in more detail 
#' 
#' parameter 1: stuff 
#' 
#' parameter 2: stuff 

धन्यवाद!

+2

आर एक्सटेंशन मैन्युअल काम के रूप में {\ '{' '{itemize {}' {{'{{' {item'} {'' {item'} {? –

+1

@ बेन हाँ वे – hadley

उत्तर

53

यहां आपकी समस्या फॉर्मूलेशन के बाद एक roxygen2 उदाहरण है।

##' 
##' @details text describing parameter inputs in more detail. 
##' \itemize{ 
##' \item{"parameter 1"}{Stuff} 
##' \item{"parameter 2"}{Stuff} 
##' } 
##' 

इससे आपको विवरण अनुभाग में आइटम का उपयोग करने की अनुमति मिल जाएगी। आप इसे @param सेक्शन में भी इस्तेमाल कर सकते हैं।

उम्मीद है कि इससे मदद मिलती है।

+2

क्या आप मुझे दस्तावेज में इंगित कर सकते हैं जहां आपको यह मिला? मुझे रॉक्सीजन में लेटेक्स सुविधाओं में से कुछ के लिए वाक्यविन्यास का पता लगाने में कठिनाई हो रही है। –

+1

@ जेफअलेन मैंने बस "लेखन आर एक्सटेंशन" मैनुअल के http://cran.r-project.org/doc/manuals/R-exts.html#Lists-and-tables अनुभाग को देखा और इसे Roxygen में आज़माया, जो मेरे लिए ठीक काम करता है। क्या आपके पास कोई विशिष्ट समस्या है? –

+3

@ जेफअलेन ध्यान दें कि यह सूचियों के लिए मानक आर डॉक (आरआरडी) शैली है, जो केवल लाटेक्स शैली है। दोनों रॉक्सीजन और आरआरडी के साथ परेशानी यह है कि भविष्यवाणी करना मुश्किल हो सकता है कि टेक्सास में जो कुछ काम करता है, वह आरडी में काम करेगा, और जब आरडी में क्या काम करता है तो रॉक्सीजन में काम करेगा ... – cboettig

12

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

#' @details text describing parameter inputs in more detail. 
#' * parameter 1 stuff 
#' * parameter 2 stuff 
#' @md 

पूरे पैकेज के लिए पर markdown देते हैं या एक एकल फाइल करने के लिए @md टैग को जोड़ने के लिए अपने विवरण में यह या तो शामिल Roxygen: list(markdown = TRUE) का उपयोग करें।

+0

प्रलेखन: [मार्कडाउन में आर प्रलेखन लिखें] (गैबर Csardi द्वारा https://cran.r-project.org/web/packages/roxygen2/vignettes/markdown.html#lists)। "ध्यान दें कि आपने सूची से पहले एक खाली रेखा नहीं छोड़ी है। यह कुछ मार्कडाउन पार्सर्स से अलग है।" –

संबंधित मुद्दे