Yiii Xie, J. J. Allaire, Garrett Grolemund
2023-12-30
Huomautus: Tämä kirja on julkaissutChapman & Hall/CRC.Tämän kirjan online -versio on ilmainen lukea täältä (kiitos Chapman & Hall/CRC: lle) ja lisensoituCreative Commons Attribution-ei-kaupallinen Sharealike 4.0 International Lisenssi.
Asiakirjamuoto “R Markdown” otettiin ensimmäisen kerran käyttöönknitrpaketti(Xie 2015-2023 b-AVuoden 2012 alussa. Ajatuksena oli upottaa koodin palat (R: stä tai muille kielille) Markdown -asiakirjoihin.Itse asiassa,knitrTuki useita kirjoituskieliä alusta alkaen Markdown, mukaan lukien lateksi, HTML, AsciDoc, rakenneuudistusteksti ja tekstiili.Viiden vuoden aikana taaksepäin näyttää olevan kohtuullinen sanoa, että Markdownista on tullut suosituin asiakirjamuoto, jota odotimme.Markdownin yksinkertaisuus erottuu selvästi näistä asiakirjamuodoista.
Alkuperäinen versio MarkdownistaJohn Gruber keksinytlöydettiin usein liian yksinkertaiseksi eikä soveltuva kirjoittaa erittäin teknisiä asiakirjoja.Esimerkiksi taulukoihin, alaviitteisiin, matematiikan ilmaisuihin tai viittauksiin ei ollut syntaksia.Onneksi John MacFarlane loi upea paketti nimeltä Pandoc (http://pandoc.org) Merkintäasiakirjojen (ja monien muun tyyppisten asiakirjojen) muuttaminen monenlaisiksi lähtömuodoiksi.Vielä tärkeämpää on, että Markdown -syntaksi rikastettiin merkittävästi.Nyt voimme kirjoittaa lisää elementtityyppejä, joissa on Markdown nauttivat silti sen yksinkertaisuudesta.
Lyhyesti sanottuna r Markdown seisoo hartioillaknitrja Pandoc.Entinen suorittaa merkinnässä upotetun tietokonekoodin ja muuntaa R -merkinnän Markdowniksi.Jälkimmäinen tekee merkinnän haluamaasi lähtömuotoon (kuten PDF, HTML, Word ja niin edelleen).
Serimarkkinointipaketti(Allaire, Xie, Dervieux, McPherson, et ai.2023-Aluotiin ensimmäisen kerran vuoden 2014 alussa. Viimeisen neljän vuoden aikana siitä on jatkuvasti kehittynyt suhteellisen täydellinen ekosysteemi asiakirjojen kirjoittamiseen, joten meille on hyvä aika tarjota lopullinen opas tähän ekosysteemiin.Tässä vaiheessa on suuri määrä tehtäviä, jotka voit tehdä R -merkinnällä:
Käännä yksi R -merkinnän asiakirja raporttiin eri muodoissa, kuten PDF, HTML tai Word.
Luo muistikirjoja, joissa voit suorittaa suoraan koodikarjoja vuorovaikutteisesti.
Tee dioja esityksille (HTML5, lateksisäiliö tai PowerPoint).
Tuota kojetauluja joustavilla, vuorovaikutteisilla ja houkuttelevilla asetteluilla.
Rakenna interaktiiviset sovellukset, jotka perustuvat kiiltävään.
Kirjoita lehden artikkeleita.
Useiden lukujen kirjailijakirjat.
Luo verkkosivustoja ja blogeja.
R -merkinnän alla on perustavanlaatuinen oletus, josta käyttäjien tulisi olla tietoisia: Oletetaan, että Markdownissa tuetaan vain rajoitettua määrää ominaisuuksia."Ominaisuuksien" avulla tarkoitamme sellaisia elementtityyppejä, joita voit luoda natiivilla merkinnällä.Rajoitus on hieno ominaisuus, ei virhe.R Markdown ei välttämättä ole oikea muoto sinulle, jos löydät nämä elementit, jotka eivät riitä kirjoitukseesi: kappaleet, (osa) otsikot, estotarjoukset, koodilohkot, (numeroitu ja numeroidut) luettelot, vaakasuorat säännöt, taulukot, sisäinen muotoilu (korostava, lyönti-, ylikirjoitukset, alajaksot, sanatarkasti ja pienet korkkien teksti), lateksimatiikan lausekkeet, yhtälöt, linkit, kuvat, alaviitteet, viittaukset, lauseet, todisteet ja esimerkit.Uskomme, että tämä elementtiluettelo riittää useimpiin teknisiin ja ei-teknisiin asiakirjoihin.R -merkinnässä ei ehkä ole mahdotonta tukea muun tyyppisiä elementtejä, mutta saatat alkaa menettää merkinnän yksinkertaisuuden, jos haluat mennä niin pitkälle.
Epictetus sanoi kerran: "Vauraus ei koostu siitä, että sillä on suurta omaisuutta, vaan vain vähän halua.”Henki heijastuu myös Markdownissa.Jos pystyt hallitsemaan huolenaiheitasi tyypitysominaisuuksien harjoittamisessa, sinun tulee olla paljon tehokkaampi sisällön kirjoittamisessa ja siitä voi tulla tuottelias kirjailija.On täysin mahdollista menestyä yksinkertaisuudella.Jung Jae-sung oli legendaarinen sulkapalloilija, jolla oli huomattavan yksinkertainen pelityyli: hän ei näyttänyt lahjakkaalta pelaajalta ja oli hyvin lyhyt verrattuna muihin pelaajiin, joten suurimman osan ajasta näet hänen hyppäävän kolmen jalan päässä maasta jaSärky kuin ukkonen uudestaan ja uudestaan takatuomioistuimessa, kunnes hän lyö vastustajiaan.
Älä aliarvioi R -merkinnän muokattavuutta sen syntaksin yksinkertaisuuden vuoksi.Erityisesti PANDOC -mallit voivat olla yllättävän tehokkaita, kunhan ymmärrät taustalla olevat tekniikat, kuten lateksit ja CSS, ja olet valmis investoimaan aikaa lähtöasiakirjojen (raportit, kirjat, esitykset ja/tai verkkosivustot) esiintymiseen.Yhtenä esimerkkinä voit tarkistaaPDF -raporttiniistäVuoden 2017 työnantajan terveysetujen tutkimus.Se näyttää melko hienostuneelta, mutta se tosiasiallisesti tuotettiinkirja (Xie 2016-A, mikä on R -merkinnän jatke.Tämän raportin luomiseen käytettiin mukautettua lateksimallia ja paljon lateksia temppuja.Ei ole yllättävää, että tämä juuri nyt lukemasi kirja on kirjoitettu myös R Markdownissa, ja sen koko lähde on julkisesti saatavana GitHub -arkistossahttps://github.com/rstudio/rmarkdown-book.
R Markdown -asiakirjat ovat usein kannettavia siinä mielessä, että ne voidaan koota monen tyyppisiin lähtömuotoihin.Tämä johtuu jälleen pääasiassa tekijänkielen yksinkertaistetusta syntaksista, Markdown.Mitä yksinkertaisemmat asiakirjasi elementit ovat, sitä todennäköisemmin asiakirja voidaan muuntaa eri muodoiksi.Samoin, jos räätälöit voimakkaasti R -merkinnän tiettyyn lähtömuotoon (esim. Lateksi), menetät todennäköisesti siirrettävyyden, koska kaikki muodossa olevat ominaisuudet eivät toimi toisessa muodossa.
Viimeisenä, mutta ei vähäisimpänä, laskentatuloksesi ovat todennäköisemmin toistettavissa, jos käytät R -merkintää (tai muutaknitr-pohjaiset lähdeasiakirjat) verrattuna manuaaliseen leikkaus- ja paste-lähestymistapaan.Tämä johtuu siitä, että tulokset luodaan dynaamisesti tietokoneen lähdekoodista.Jos jokin menee pieleen tai se on päivitettävä, voit vain korjata tai päivittää lähdekoodin, kääntää asiakirja uudelleen ja tulokset päivitetään automaattisesti.Voit nauttia toistettavuudesta ja mukavuudesta samanaikaisesti.
Viitteet
Allaire, JJ, Yiii Xie, Christophe Dervieux, Jonathan McPherson, Javier Luraschi, Kevin Ushey, Aron Atkins, et ai.2023.Rmarkdown: R -dynaamiset asiakirjat R: lle.https://github.com/rstudio/rmarkdown.
X Eli, Y I Hui.Dynaamiset asiakirjatR -ja Knitr.2. painos.Boca Raton, Florida: Chapman;Hall/CRC.https://yihui.name/knitr/.
———.2016.BookDown: Kirjat ja tekniset asiakirjatR -Merkintä.Boca Raton, Florida: Chapman;Hall/CRC.https://github.com/rstudio/bookdown.
———.2023 b.Knitr: Yleiskäyttöinen paketti dynaamiseen raportin luomiseen R: ssä.https://yihui.org/knitr/.
