2014-09-30 5 views
6

के साथ @example टैग का उपयोग करते समय फ़ाइलों का स्थान roxygen2 के साथ फ़ंक्शन को दस्तावेज़ करते समय उदाहरण को एक अलग फ़ाइल में रखना संभव है।roxygen2

यहाँ देखें: http://r-pkgs.had.co.nz/man.html "उदाहरण दस्तावेज में सीधे शामिल करने की बजाय, आप उन्हें अलग फ़ाइलों में डाल दिया है और उन्हें प्रलेखन में डालने के लिए @example पथ/रिश्तेदार/to/packge/जड़ उपयोग कर सकते हैं।"

और यहाँ: http://roxygen.org/roxygen2-manual.pdf

उदा

#' Add together two numbers. 
#' 
#' @param x A number. 
#' @param y A number. 
#' @return The sum of \code{x} and \code{y}. 
#' @example /path/to/example/add.R 
add <- function(x, y) { 
    x + y 
} 

मेरा प्रश्न है: उदाहरण आर फाइलों को संग्रहीत करने के लिए किस पथ का उपयोग किया जाना चाहिए?

+3

'inst/example'? – jdharrison

+0

मुझे लगता है कि पैकेज स्थापित करते समय/inst/move/move? मुझे लगता है कि इससे कोई फर्क नहीं पड़ता कि दस्तावेज पहले से ही बनाया गया है? – wannymahoots

+1

हां 'inst/example' को' उदाहरण 'पर ले जाना चाहिए और मुझे लगता है कि आप अपने दस्तावेज़ में'/example' का संदर्भ दे सकते हैं। – jdharrison

उत्तर

4

अपने roxygen में इस्तेमाल किया उदाहरण के लिए उपयुक्त स्थान है:

inst/examples/ 

roxygen लाइन तो होना चाहिए:

#' @example inst/examples/add.R 

इस अच्छा अभ्यास है? मुझे लगता है कि यह है, के बाद से:

  • यह यह आसान, चलाने को संशोधित करने और
  • विकासशील यह यह संभव (सिद्धांत रूप में, कम से कम) विभिन्न स्थानों में उदाहरण का फिर से उपयोग करने के लिए बनाता है, जबकि उदाहरण परीक्षण करने के लिए बनाता है प्रलेखन में, उदाहरण के लिए विग्नेट
+1

मुझे यह उपयोगी लगता है जब मेरे पास इंडेंटेशन के उदाहरणों के लिए कई पंक्तियां हैं जिन्हें मैं संरक्षित करना चाहता हूं। अधिकांश समय मैं अभी भी @examples का उपयोग करता हूं। – wannymahoots

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