Käännökset (PDF)
- Hollantilainen
- Saksalainen
- Italialainen
- Japanilainen
- Korealainen
- Espanjalainen
- Turkkilainen
- vietnam
Mikä on rmarkdown?
- .RMD -tiedostot:Kehitä koodi ja ideoitasi rinnakkain yhdellä asiakirjalla.Suorita koodi yksittäisinä paloina tai koko asiakirjana.
- Dynaamiset asiakirjat:Neulo toisiinsa, taulukot ja tulokset narratiivisella tekstillä.Työskentele monille muotoille, kuten HTML, PDF, MS Word tai MS PowerPoint.
- Toistettava tutkimus:Lataa, linkittää tai liitä raportti jaettavaksi.Kuka tahansa voi lukea tai suorittaa koodisi toistaaksesi työsi.
Työnkulku
Avaauusi .rmd -tiedostoRStudio IDE: ssä menemälläTiedosto> Uusi tiedosto> R Markdown.
Upottaa koodipaloissa.Suorita koodi linjalla, Chunk tai kaikki kerralla.
Kirjoittaa tekstiäja lisää taulukot, kuvat, kuvat ja viittaukset.Muoto Markdown Syntaxilla tai RStudio Visual Markdown -editorilla.
Aseta tulostusmuodot ja asetuksetYaml -otsikossa.Mukauta teemoja tai lisää parametreja suorittaaksesi tai lisätäksesi interaktiivisuutta kiiltävän kanssa.
Pelastaa ja tehdäkoko asiakirja.Neulo ajoittain esikatsellaksesi työtäsi kirjoittaessasi.
Jaa työsi!
Lähdeeditori
Laajenna lukemaan lähdeeditorin ominaisuuksista
Ominaisuudet lähdeeditorissa
- Uusi tiedosto
- Upottaa koodi
- Kirjoittaa tekstiä
- Aseta tulostusmuodot ja asetukset
- Pelastaa ja tehdä
- Jakaa
- Aseta esikatselupaikka
- Aseta koodi
- Siirry koodiin
- Suorita koodipalat (t)
- Näytä ääriviivat
- Muokkaa Chunk -asetuksia
- Suorita kaikki aiemmat palat
- Suorittaa virta
- Vaihda visuaaliseen editoriin
Visuaalinen editori
Laajenna lukemaan visuaalisen editorin ominaisuuksista
Ominaisuudet visuaalisessa editorissa
- Lisätä viittauksia
- Tyylivaihtoehdot
- Lisää/muokkaa määritteitä
- Vaihda lähdeeditoriin
Tulos
Laajenna lukeaksesi renderoidun lähtöikkunan ominaisuuksista
Ominaisuudet renderoidussa lähtöikkunassa
- Tiedostopolku tulostusasiakirjaan
- Etsi asiakirja
- Julkaise osoitteeseen rpubs.com, Shinyapps.io, Posit Connect
- Lataa uudelleen
Upota koodi knitriin
Koodipalat
Surround Code -palat`` `{r}ja`` `tai käytä insert -koodi -chunk -painiketta.Lisää chunk -etiketti ja/tai chunk -vaihtoehdot kiharauhojen sisäänr -.
`` `{r chunk-label, sisällytä = false}`` `Aseta globaalit asetukset
Aseta asetukset koko asiakirjalle ensimmäisessä kappaleessa.
`` `{R sisältää = false}knitr :: opts_chunk $ set (viesti = false)`` `Sisäinen koodi
Lisätä`r tekstiosiksi.Koodi arvioidaan renderöinnissä ja tulokset näkyvät tekstinä.
Merkintäteksti
Rakennettu `r getrversion ()`Tekee tulostetiedoston ”rakennettuna 4.4.0: lla”.
Chunk -vaihtoehdot
| Vaihtoehto | Laiminlyönti | Vaikutukset |
|---|---|---|
kaiku | TOTTA | Näytä koodi tulostusasiakirjassa |
virhe | Väärennetty | True (näytä virheilmoitukset Docissa), väärä (lopeta renderöinti, kun virhe tapahtuu) |
arvioida | TOTTA | Suorita koodi Chunkissa |
sisältää | TOTTA | Sisällytä Chunk Dociin juoksemisen jälkeen |
viesti | TOTTA | Näytä koodiviestit asiakirjassa |
Varoitus | TOTTA | Näytä koodivaroitukset asiakirjassa |
tulokset | "Markup" | "ASIS"(läpäistä tulosten läpi),"piilottaa"(Älä näytä tuloksia),"Pidä"(Laita kaikki tulokset kaikki koodi) |
kuvio | "Oletus" | "Vasen"-"Oikein"tai"keskusta" |
Kuvio | Tyhjä | Alt -teksti figuurille |
kuvio | Tyhjä | Kuvan kuvateksti merkkijonona |
kuvio | "Kuva/" | Etuliite tiedostopolkujen luomiseen |
Kuva leveys ja kuva | 7 | Tontin mitat tuumina |
leveys | Rescales -lähtöleveys, esim."75%"-"300px" | |
romahdus | Väärennetty | Kytke kaikki lähteet ja lähtö yhdeksi lohkoksi |
kommentti | "##" | etuliite jokaiselle tuloslinjalle |
lapsi | Tyhjä | Tiedosto (t) neuloa ja sisällyttää sitten |
pusers | TOTTA | sisällyttää tai sulje pois koodipalat poimia lähdekoodiaKnitr :: Purl () |
Katso lisää vaihtoehtoja ja oletusarvoja käyttämällästr (knitr :: opts_chunk $ get ()).
Lisätä viittauksia
Luo viittauksia bibliografiatiedostosta, Zotero -kirjastosta tai DOI -viitteistä.
Rakenna bibliografia
Lisää BIBTEX- tai CSL -bibliografiat Yaml -otsikkoon.
---otsikko- "Asiakirjani"bibliografia-Viitteet.BIBlinkkien ja- TOTTA---Jos Zotero on asennettu paikallisesti, pääkirjasto on automaattisesti käytettävissä.
Lisää DOI: n viittauksia etsimällä “from doi”Lisäysviittausvuoropuhelu.
Lisätä viittauksia
- PääsyLisätä viittauksiavalintaikkuna visuaalisessa editorissa napsauttamalla@ @Symboli työkalurivissä tai napsauttamallaLisää> viittaus.
- Lisää viittauksia merkinnän syntaksilla kirjoittamalla
[@cite]tai@Cite.
Lisätä taulukot
Lähtötietokehykset taulukoina käyttävätKable (tiedot, kuvateksti).
`` `{r}Tiedot <- uskollisia [1: 4,]knitr :: kable (data, caption = "taulukot kable")`` `Muita pöytäpaketteja ovatflextable-GTjakaapeli.
Kirjoita Markdownilla
Vasemmalla puolella oleva syntaksi tuottaa lähtöä oikealla.
| Tavallinen teksti. | ||||||||||||||||
| Lopeta viiva, jossa on kaksi tilaa Aloita uusi kappale. | ||||||||||||||||
| Lopeta myös linja backslashilla tehdä uusi linja. | ||||||||||||||||
| kursivointijarohkea | ||||||||||||||||
| ylikirjoitus2/ala2 | ||||||||||||||||
| |||||||||||||||||
| pakenematon: * _ \ | ||||||||||||||||
| Ajela: -, Em Dash: - | ||||||||||||||||
| |||||||||||||||||
| Otsikko 2 | ||||||||||||||||
| Niin | ||||||||||||||||
| Otsikko 6 | ||||||||||||||||
|
| ||||||||||||||||
|
| ||||||||||||||||
| https://posit.co/ | ||||||||||||||||
| Tämä on linkki. | ||||||||||||||||
| Tämä on toinen linkki. | ||||||||||||||||
|
| ||||||||||||||||
| sanatarkka koodi | ||||||||||||||||
| | ||||||||||||||||
|
| ||||||||||||||||
| yhtälö:\ (e ^ {i \ p) + 1 = 0 \) | ||||||||||||||||
| yhtälölohko: \ [E = mc^{2} \] | ||||||||||||||||
| Vaaka -sääntö: | ||||||||||||||||
|
| ||||||||||||||||
HTML -välilehdet | Tulokset |
Aseta lähtömuodot ja niiden vaihtoehdot Yamlissa
Aseta asiakirjan YAML -otsikkolähtömuotoja räätälöidä sitälähtövaihtoehdot.Sisennän muoto 2 merkkiä, sisennysvaihtoehdot 4 merkkiä.
---otsikko- "Asiakirjani"kirjoittaja- "Kirjailijan nimi"tulos- html_document- toc- totta ToC-sijainti-vasen---Lähtömuototaulukko
| Lähtömuoto | Luo |
|---|---|
html_document | .html |
pdf_document1 | |
Word_document | Microsoft Word (.docx) |
Powerpoint_presentation | Microsoft PowerPoint (.pptx) |
ODT_Document | OpenDocument -teksti |
rtf_document | Rikas tekstimuoto |
md_document | Merkintä |
github_document | GitHubin merkintä |
iOSlides_presentation | iOSlides HTML -dioja |
slidy_presentation | Liukumäki liukuu |
beamer_presentation2 | Palkki liukuu |
Katso myösflexdashboard-kirja-tislatajablogin.
Lähtöasetukset -taulukko
| Tärkeät vaihtoehdot | Kuvaus | HTML | MS -sana | MS PPT | |
|---|---|---|---|---|---|
| ankkuri | Näytä hiiren hoverin ankkurit (tosi tai väärä) | X | |||
| Citation_package | Latex -paketti viittausten käsittelemiseksi (“oletus”, “Natbib”, Biblatex ”) | ||||
| Code_download | Anna lukijoille mahdollisuus ladata .rmd -lähdekoodi (tosi tai väärä) | X | |||
| koodi | Anna lukijoiden vaihtaa R -koodin näyttö (“Ei mitään”, “Piilota” tai “Show”) | X | |||
| CSS | CSS tai SCSS -tiedosto, jota käytetään asiakirjan muotoiluun (esim. “Style.css”) | X | |||
| kehitys | Grafiikkalaite, jota käytetään kuvan lähtöön (esim. “PNG”, “PDF”) | X | X | ||
| df_print | Menetelmä tietokehysten tulostamiseen (“oletus”, “Kable”, “Tibble”, “Page”) | X | X | X | X |
| Fig_Caption | Pitäisikö luvut tehdä kuvatekstejä (totta tai vääriä) | X | X | X | X |
| kohokohta | Syntaksin korostaminen (“Tango”, “Pygments”, “Kate”, “Zenburn”, “Textmate”) | X | X | X | |
| sisältää | Sisällön tiedosto, joka sijoitetaan asiakirjaan (“in_header”, “ennen_body”, “jälkikäteen”) | X | X | ||
| säilyttää | Pidä Markdown .md -tiedosto luotu neulomalla (tosi tai väärä) | X | X | X | X |
| Keep_tex | Pidä keskitason TEX -tiedosto, jota käytetään muuntamiseen PDF: ksi (tosi tai väärä) | X | |||
| lateksi | Latex -moottori PDF -lähtö (“Pdflatex”, “Xelatex” tai “LuLalatex”) tuottaa PDF -lähtö | X | |||
| reference_docx/_doc | Docx/PPTX -tiedosto, joka sisältää tyylejä, jotka kopioidaan tulehduksessa (esim. “File.docx”, “File.pptx”) | X | X | ||
| teema | Teemavaihtoehdot (katso alla | X | |||
| toc | Lisää sisältötaulukko asiakirjan alussa (tosi tai väärä) | X | X | X | X |
| TOC_DEPTH | Alin otsikkotaso lisätä sisältötaulukkoon (esim .2, 3) | X | X | X | X |
| toc_float | Kellu sisältötaulukko pääasiakirjan sisällön vasemmalla puolella (tosi tai väärä) | X |
Käyttää? Jos haluat nähdä kaikki muodon vaihtoehdot, esim.? html_document
Lisää otsikkovaihtoehtoja
Parametrit
Parametroida asiakirjat, jotta voit huijuttaa uusilla tuloilla (esim .data, arvot jne.).
Lisää parametrejaotsikossa
parametri.---parametri- osavaltio- "Havaiji"---Soita parametritkoodissa
params $ nimi.`` `{r}Tiedot <- df [, params $ tila]Yhteenveto (tiedot)`` `Aseta parametritneulottuilla parametreilla tai parametrien argumentilla
Render ().
Uudelleenkäytettävät mallit
Luo uusi pakettiInst/rmarkdown/malli -hakemistolla.
Lisää kansiosisältäenmalli.yaml(alla) jaluuranko.rmd(Mallisisältö).
---nimi- "Mallini"---AsentaaPaketti pääsymalliin menemälläTiedosto> Uusi R Markdown> Template.
Bootswatch -teemat
Mukauta HTML -asiakirjoja bootwatch -teemoillabslibpaketti teeman lähtövaihtoehto käyttämällä.KäyttääBSLIB :: bootwatch_themes ()Luettelo käytettävissä olevista teemoista.
---otsikko- "Asiakirjani"kirjoittaja- "Kirjailijan nimi"tulos- html_document- teema- bookat-aurinko----Mukautetut teemat
Mukauta yksittäisiä HTML -elementtejä käyttämällä BSLIB -muuttujia.Käyttää? BS_THEMEnähdä lisää muuttujia.
---tulos- html_document- teema- BG- "#121212" FG- "#E4E4E4" base_font- google- "Nopea"---Enemmänbslibathttps://pkgs.rstudio.com/bslib/.
Muotoilu CSS: n ja SCSS: n kanssa
Lisää CSS ja SCSS asiakirjoihisi lisäämällä polku tiedostoonCSSvaihtoehto Yaml -otsikossa.
---otsikko- "Asiakirjani"kirjoittaja- "Kirjailijan nimi"tulos- html_document- CSS- "Style.css"---Käytä CSS -tyyliä kirjoittamalla HTML -tunnisteita suoraan tai:
Käytä Markdownia soveltaa tyyli -määritteitä sisäinen.
Haaroitettu span
A [vihreä] {. My-Color} -sana.tekee nimellä "avihreäsana."Aidattu div
::: {. My-Color} Kaikki nämä sanat ovat vihreitä :::::antaa jklle
Kaikki nämä sanat
ovat vihreitä.
Käytä visuaalista editoria.Mennä jhkMuoto> div/spanja lisää CSS -muotoilu suoraan muokkausominaisuuksilla.
Interaktiivisuus
Muuta raportti interaktiiviseksi kiiltäväksi asiakirjaksi 4 vaiheessa:
Lisätä
Runtime: kiiltäväYaml -otsikkoon.---tulos-html_documentajonaika-kiiltävä---Kutsu kiiltäviä syöttötoimintoja upottamiseen syöttöobjekteihin.
Soita kiiltävät lähtötoiminnot upottamaan reaktiivisen ulostulon.
`` {r echo = false}NumeriNput ("n", "kuinka monta autoa?", 5)Renderstable ({pää (autot, syöttö $ n)})`` `Tehdä jtk
rmarkdown :: Run ()tai napsautaAsiakirjaRSTUDIO IDE.
Katso myös kiiltävä ennakkoon paremman suorituskyvyn suhteen.https://rmarkdown.rstudio.com/authoring_shiny_prerendered.
Upota täydellinen kiiltävä sovellus asiakirjaasikiiltävä :: shinyappdir ().Enemmänhttps://bookdown.org/yihui/rmarkdown/shiny-embedded.html.
Tehdä
Kun teet asiakirjan, rmarkdown:
- Suorittaa koodin ja upottaa tulokset ja teksti .md -tiedostoon KNITR: llä.
- Muuntaa .md -tiedoston tulostusmuotoon PANDOC: lla.
Tallentaa,sittenNeuloaasiakirjan lähdön esikatselu.Tuloksena oleva HTML/PDF/MS Word/jne.Asiakirja luodaan ja tallennetaan samaan hakemistoon kuin .rmd -tiedosto.
Käyttäärmarkdown :: render ()tehdä/neuloa R -konsolissa.Nähdä?Käytettävissä olevat vaihtoehdot.
Alaviitteet
PDFS ja Beamer Diat vaativat lateksia, käytä
tinytex :: install_tinytex ().↩︎PDFS ja Beamer Diat vaativat lateksia, käytä
tinytex :: install_tinytex ().↩︎
