È possibile includere un'immagine nella documentazione generata da roxygen? Ho un certo numero di funzioni che sono essenzialmente wrapper per ggplot() che mi piacerebbe documentare mostrando un esempio dell'output.Includere un'immagine utilizzando la documentazione di roxygen
risposta
Come per la lista passaggio da l'annuncio di R 2.14:
Rd markup ha un nuovo tag \ figura, in modo che i dati possono essere inclusi in pagine di aiuto una volta convertito in HTML o LaTeX. Ci sono esempi su le pagine di aiuto per par() e points().
Da: http://cran.r-project.org/doc/manuals/R-exts.html#Figures
Per includere figure in pagine della guida, utilizzare il \ figura di markup. Ci sono tre forme.
Le due forme semplici comunemente utilizzate sono \ figure {nomefile} e \ figura {nomefile} {testo alternativo}. Ciò includerà una copia della figura in output HTML o LaTeX. Nell'output di testo, verrà invece visualizzato il testo alternativo. (Quando viene omesso il secondo argomento, verrà utilizzato il nome file). Sia il nome file che il testo alternativo verranno analizzati verbatim e non dovrebbero includere caratteri speciali significativi in HTML o LaTeX.
La forma dell'esperto è \ figure {nomefile} {opzioni: stringa}. (La parola "opzioni:" deve essere digitata esattamente come mostrato e seguito da almeno uno spazio.) In questo modulo, la stringa viene copiata nel tag HTML img come attributi che seguono l'attributo src o nel secondo argomento di \ Figura macro in LaTeX, che per impostazione predefinita viene utilizzata come opzioni per una chiamata \ includegraphics. Poiché è improbabile che una singola stringa sia sufficiente per entrambe le modalità di visualizzazione, la forma dell'esperto verrebbe normalmente racchiusa in condizionali. Spetta all'autore assicurarsi che venga utilizzato HTML/LaTeX legale. Ad esempio, per includere un logo sia in HTML (utilizzando il modulo semplice) e LaTeX (utilizzando il modulo esperto), potrebbe essere utilizzato il seguente:
\if{html}{\figure{logo.jpg}{Our logo}}
\if{latex}{\figure{logo.jpg}{options: width=0.5in}}
I file contenenti i dati devono essere conservati in l'uomo directory/figure. I file con estensioni .jpg, .pdf, .png e .svg da quella directory verranno copiati nella directory help/figures al momento dell'installazione. (Le figure in formato PDF non verranno visualizzate nella maggior parte dei browser HTML, ma potrebbero essere la scelta migliore nei manuali di riferimento.) Specificare il nome file relativo a man/figure nella direttiva \ figure.
- 1. Documentazione delle equazioni con deqn e roxygen
- 2. Come includere la cartella nella documentazione doxygen?
- 3. Come sfuggire% nella programmazione di ROxygen literate?
- 4. Utilizzando Appledocs per generare la documentazione
- 5. Includere immagini nei file di documentazione R-package (.Rd)
- 6. Come posso documentare i set di dati con roxygen?
- 7. Come posso includere sottoclassi nella documentazione dell'API Swagger usando Swashbuckle?
- 8. Dov'è la documentazione di Fragment.onCreateAnimator()?
- 9. Come generare la documentazione msdn da javascript? preferibilmente utilizzando sandcastle
- 10. Comprendere la removeRange (_ :) documentazione
- 11. Come ereditare la documentazione di KDoc?
- 12. Documenta setAs() e setOldClass() con Roxygen
- 13. Can Roxygen ignora le funzioni non utente?
- 14. dataset di documentazione con roxygen2
- 15. Escaping "@" nella documentazione in stile Roxygen2
- 16. Dove scaricare la documentazione dell'ultima versione di API?
- 17. MVC4 utilizzando le sezioni per includere javascript
- 18. Uso brace sbilanciato in Roxygen/Rd esempio di codice
- 19. snippet di roxygen pre-processo o post-processo
- 20. Scorciatoia da tastiera per l'inserimento di roxygen # 'commento start
- 21. Dove posso trovare la documentazione di PythonMagick?
- 22. Utilizzo di dub per compilare la documentazione
- 23. Come condividere la documentazione di Swagger
- 24. Suggerimenti per la documentazione di classe
- 25. Dov'è la documentazione di JetBrains IntelliJ openapi?
- 26. Dove posso trovare la documentazione di Hpricot?
- 27. Dov'è la documentazione dell'API di Bouncy Castle?
- 28. Dov'è la documentazione dell'API String di Swift?
- 29. Come leggo la documentazione java?
- 30. Includere i file .properties durante la creazione di un progetto utilizzando la formica
Basta usare la consueta sintassi Rd – hadley
Se potessi trovarlo, non avrei chiesto. L'unico elenco completo di sintassi che sono riuscito a trovare era il bioconducter ... e non includeva la sintassi per includere un'immagine. –
E anche in "Scrivi R Estensioni". –