2,5Merkinnän syntaksi
R -merkinnän asiakirjan teksti on kirjoitettu Markdown -syntaksin avulla.Tarkalleen ottaen se on Pandocin merkintä.Eri ihmisten keksimiä merkintämakuja on monia makuja, ja Pandocin maku on tietomme kattavin.Löydät täydellisen dokumentoinnin Pandocin merkinnästä osoitteessahttps://pandoc.org/MANUAL.html.Suosittelemme, että luet tämän sivun ainakin kerran, jotta tiedät kaikki mahdollisuudet Pandocin Markdownilla, vaikka et käytä niitä kaikkia.Tämä osa on mukautettuKohta 2.1-Xie(2016-Aja kattaa vain pienen osajoukon Pandocin Markdown -syntaksista.
2.5.1Inline -muotoilu
Inline -teksti onkursivoituJos ympäröivät alaviivat tai tähdet, esim._teksti_
tai*teksti*
.RohkeaTeksti tuotetaan käyttämällä paria kaksinkertaista tähtiä (**teksti**
).Pari Tildes (~ ~
) Käännä teksti alaindeksi (esim.H ~ 3 ~ po ~ 4 ~
Renders H3Jälkeen4).Pari Caretsia (^
) tuotantopisteen (esim.Cu^2+^
tehdä2+).
Merkitä tekstiä nimelläsisäinen koodi
, käytä paria backicksia, esim.`koodi`
.Sisältää\ (n \)Kirjaimelliset backicks, käytä ainakin\ (n+1 \)BackTicks ulkopuolella, esim. Voit säilyttää kolme backtickiä kolme takaosaa:`` `` `` `koodi```` `` ``
, joka tehdään`` `koodi``
.
Hyperlinkit luodaan syntaksin avulla[teksti] (linkki)
, esim.[Rstudio] (https://www.rstudio.com)
.Kuvien syntaksi on samanlainen: Lisää vain huutomerkki, esim.! [Alt -teksti tai kuvan otsikko] (polku/to/kuva)
.Alaviitteet laitetaan neliömäisten kiinnikkeiden sisäpuolelle caretin jälkeen^[[]
, esim.^[Tämä on alaviite.]
.
Sitaatteja on useita tapoja lisätä, ja suosittelemme, että käytät BIBTEX -tietokantoja, koska ne toimivat paremmin, kun lähtömuoto on lateksi/pdf.Kohta 2.8-Xie(2016-Aon selittänyt yksityiskohdat.Keskeinen idea on, että kun sinulla on BIBTEX-tietokanta (tavallinen tekstin tiedosto tavanomaisella tiedostonimi-laajennuksella.ruokalappu
) se sisältää merkintöjä, kuten:
@Manual{R --pohja- otsikko= {R: Tilastollisen kieli ja ympäristöTietojenkäsittely}, kirjoittaja= {{R ydinjoukkue}}, organisaatio= {R Tilastollisen tietojenkäsittelyn säätiö}, osoite= {Wien, Itävalta}, vuosi= {2017}, URL -osoite= {https://www.r-project.org/},}
Voit lisätä kentän nimeltäbibliografia
YAML -metatietoihin ja aseta sen arvo BIBTEX -tiedoston polulle.Sitten voit käyttää Markdownissa@R-Base
(joka tuottaa ”R -ydinjoukkue(2023-A”) Tai[@R-Base]
(joka tuottaa ”(R Core Team 2023-A”) Bibtex -merkinnän viittaaminen.Pandoc luo automaattisesti luettelon viitteistä asiakirjan lopussa.
2.5.2Lohkotason elementit
Osaston otsikot voidaan kirjoittaa useiden punnan merkkejä, esim.
# Ensimmäisen tason otsikko## Toisen tason otsikko### kolmannen tason otsikko
Jos et halua tietyn otsikon numeroitavan, voit lisätä{-}
tai{.UNTUMPUD}
otsikon jälkeen, esim.
# Esipuhe {-}
Järjestämättömät luettelokohteet alkavat*
--
taiTai
, ja voit pistää yhden luettelon toiseen luetteloon sisennyttämällä alaluettelon, esim.
-yksi kohde-yksi kohde-yksi kohde-vielä yksi kohde-vielä yksi kohde-vielä yksi kohde
Lähtö on:
- yksi kohde
- yksi kohde
- yksi kohde
- vielä yksi kohde
- vielä yksi kohde
- vielä yksi kohde
Tilatut luettelokohteet alkavat numeroilla (voit myös pese luettelot luetteloissa), esim.
1.ensimmäinen kohde2.toinen kohde3.Kolmas kohta-yksi järjestämätön tuote-yksi järjestämätön tuote
Lähtö ei näytä liian paljon erilaiselta merkinnän lähteen kanssa:
- ensimmäinen kohde
- toinen kohde
- Kolmas kohta
- yksi järjestämätön tuote
- yksi järjestämätön tuote
Blockquotes on kirjoitettu-
, esim.
> "Hyväksyn perusteellisesti kaksintaisteluja. Jos miehen pitäisi haastaa minut,Ottaisin hänet ystävällisesti ja anteeksiantavasti kädessä ja johtaisin häntähiljaiseen paikkaan ja tappaa hänet. "-> --- Mark Twain
Varsinainen lähtö (räätälöimme tämän kirjan blockquotes -tyyliä):
”Hyväksyn perusteellisesti kaksintaisteluja.Jos mies haastaa minut, ottaisin hänet ystävällisesti ja anteeksiantavasti kädestä ja johtaisin häntä hiljaiseen paikkaan ja tappamaan hänet. "
- Mark Twain
Tavalliset koodilohkot voidaan kirjoittaa kolmen tai useamman takaosan jälkeen, ja voit myös sisentää lohkot neljällä välilyönnillä, esim.
`` `Tämä teksti näytetään sanatarkasti / esimuotoiltu`` `Tai sisennys neljällä tilalla:Tämä teksti näytetään sanatarkasti / esimuotoiltu
Yleensä sinun on parempi jättää ainakin yksi tyhjä viiva vierekkäisten, mutta erilaisten elementtien, esimerkiksi otsikon ja kappaleen välillä.Tämän tarkoituksena on välttää epäselvyyttä Markdown -renderoijalle.Esimerkiksi "Hio
”Ilmoita alla oleva otsikko?
R: ssä, hahmo# osoittaa kommentin.
Ja tekee "-
”Tarkoitatko alla olevaa luodinpistettä?
Tulos 5-3 on 2.
Merkitsemisen eri maut voivat tuottaa erilaisia tuloksia, jos tyhjiä viivoja ei ole.
2.5.3Matematiikan ilmaisut
Inline -lateksiyhtälöt voidaan kirjoittaa pariksi dollarimerkkeinä lateksisyntaksilla, esim.$ f (k) = {n \ valitse k} p^{k} (1-p)^{n-k} $
(Varsinainen lähtö:\ (f (k) = {n \ valitse k} p^{k} (1-p)^{n-k} \))Näyttötyylin matematiikan ilmaisut voidaan kirjoittaa parina kaksinkertaisen dollarin merkkejä, esim.$$ f (k) = {n \ valitse k} p^{k} (1-p)^{n-k} $$
, ja lähtö näyttää tältä:
\ [f \ vasen (k \ oikea) = \ binom {n} {k} p^k \ vasen (1-p \ oikea)^{n-k} \]
Voit käyttää myös matematiikkaympäristöjä$ $
tai$$ $$
, esim.
$$\alkaa{matriisi}{CCC}x_ {11} & x_ {12} & x_ {13}\\x_ {21} & x_ {22} & x_ {23}\{matriisi}$$
\ [\ aloita {array} {ccc} x_ {11} & x_ {12} & x_ {13} \\ x_ {21} & x_ {22} & x_ {23} \ end {Array} \]
$$ x =\alkaa{bmatrix}1 & x_ {1}\\1 & x_ {2}\\1 & x_ {3}\{bmatrix}$$
\ [X = \ aloita {bmatrix} 1 & x_ {1} \\ 1 & x_ {2} \\ 1 & x_ {3} \ end {bmatrix} \]
$$\ Theta=\alkaa{pmatrix}\ alfaJa\beeta\\\gammaJa\delta\{pmatrix}$$
\ [\ Theta = \ aloita {pMatrix} \ alfa & \ beeta \\\ gamma & \ Delta \ end {pMatrix} \]
$$\alkaa{vmatrix}A & B\\c & d\{vmatrix}= AD-BC $$
\ [\ aloita {vMatrix} a & b \\ c & d \ end {vMatrix} = ad-bc \]
Viitteet
R ydinjoukkue.2023.R: Kieli ja ympäristö tilastolliselle tietojenkäsittelylle.Wien, Itävalta: R Tilastollisen tietojenkäsittelyn säätiö.https://www.R-project.org/.
———.2016.BookDown: Kirjat ja tekniset asiakirjatR -Merkintä.Boca Raton, Florida: Chapman;Hall/CRC.https://github.com/rstudio/bookdown.