【轉(zhuǎn)】RStudio+Markdown+Pandoc的中文配置

原文地址
之前的博客有寫到過Markdown輕量級(jí)標(biāo)記語言衙猪,也提到過RStudio玉罐,還有神奇的Pandoc潘拨。今天就介紹一下用RStudio來搭配Markdown的寫作環(huán)境,并利用Pandoc來導(dǎo)出Word或者PDF格式的文檔季蚂。

1. Markdown

Markdown是一種輕量級(jí)標(biāo)記語言琅束,需要學(xué)習(xí)語法可以參考Markdown: Syntax,不過個(gè)人覺得沒有太大必要涩禀,畢竟不同的編輯器使用和支持的語法不太一樣,可以隨用隨學(xué)葵腹,隨學(xué)隨用屿岂。

2. R And RStudio

R是用于統(tǒng)計(jì)分析、繪圖的語言和操作環(huán)境阻肩。RStudio就是R語言的一個(gè)IDE运授。想使用RStudio來編輯Markdown首先要安裝R乔煞,可以在r-project找到R的下載地址here柒室,也可以直接直接在這里下The Comprehensive R Archive Network。下載之后安裝就好剥啤。RStudio的安裝包可以在RStudio下載不脯,最好下載最新的版本,支持比較完善防楷。我下載的是Open Source Edition版本。同樣冲簿,下載之后安裝就好亿昏。如果不安裝R直接安裝RStudio,就無法打開RStudio角钩。

3. RStudio+Markdown

用RStudio來編輯Markdown需要R的knitr包减牺,如果安裝的是新版的RStudio截碴,則應(yīng)該已經(jīng)包含了這個(gè)包了吸占。安裝新版RStudio后顽决,打開Tools->Global Options->Sweave進(jìn)行如圖1配置:
圖1:RStudio Sweave配置

其中主要是Weave Rnw files using要選擇knitr恭朗,Typeset LaTex into PDF using要選擇XeLaTex袋哼,其他部分可根據(jù)實(shí)際情況具體配置。配置完成之后涛贯,可以通過File->New File->R Markdown來新建R Markdown文件進(jìn)行編寫,如圖2
圖2:RMD文件創(chuàng)建
可以通過點(diǎn)擊工具條上的Knit HTML進(jìn)行預(yù)覽(圖3紅箭頭)骄酗,可以通過選項(xiàng)選擇是在Pane中還是獨(dú)立窗口中預(yù)覽(圖3方框)悦冀,圖3所示為在Pane中預(yù)覽效果。
圖3:RMD文件編寫
可以將Markdown文件保存為RMD格式盒蟆。關(guān)于RMD格式更多參見knitr作者yihui 的文檔:自動(dòng)化報(bào)告历等。關(guān)于RStudio+Markdown的信息也可參見陽志平的博客:Markdown寫作淺談。

4. Pandoc

前文說明了使用RStudio進(jìn)行Markdown編寫的方式寒屯,有時(shí)我們還需要將編寫好的Markdown文件轉(zhuǎn)換為別的格式。從圖3中可以看到在生成KnitHTML的地方還有Knit PDF和Knit Word兩個(gè)功能处面,此時(shí)就需要Pandoc的轉(zhuǎn)換功能菩掏。Pandoc是由John MacFarlane開發(fā)的標(biāo)記語言轉(zhuǎn)換工具,可實(shí)現(xiàn)不同標(biāo)記語言間的格式轉(zhuǎn)換或颊。Pandoc的安裝可以參考Markdown寫作進(jìn)階:Pandoc入門淺談的介紹進(jìn)行基于Haskell的安裝传于,也可以直接從Pandoc項(xiàng)目或Pandoc的官方網(wǎng)戰(zhàn)下載適合自己系統(tǒng)的安裝包醉顽,直接安裝。安裝之后可以進(jìn)入命令行(比如CMD游添、PowerShell)敲個(gè)pandoc –help看看安裝成功了沒有唆涝。Pandoc安裝成功后,Knit Word就可以使用了廊酣,可以將編寫好的Markdown文件轉(zhuǎn)為Word文件。但Knit PDF的使用還需要Latex的支持晓猛。

5. TexLive

在工欲善其事,必先利其器一文中我提到過TexLive戒职,更多的TexLive的信息可以參見維基百科——TexLive和Tex Live指南。關(guān)于TexLive的安裝過程洪燥,可以參考TeX Live 2014安裝引導(dǎo)流程——知呼專欄。TexLive安裝成功之后亲澡,無需什么特殊配置即可使用Kint PDF功能纫版。但有一個(gè)很重要的問題是此時(shí)的Kint PDF在使用XeLatex UTF-8編碼的情況下只能轉(zhuǎn)英文的PDF,PDF中的中文會(huì)消失癞己,如果需要包含中文的PDF還需要進(jìn)行一步配置梭伐。

6. RStudio 中Knitr 輸出中文的問題

Knit PDF包含中文的問題著實(shí)讓我困擾了很久,最后在knitr作者yihui的GitHub頁面上找到了解決方案糊识,參見RStudio 中Knitr 輸出中文的問題,需要安裝安裝rticles包愉耙。具體做法如下:
在RStudio中輸入devtools::install_github(“rstudio/rticles”)拌滋。此處可能需要先到這里下載并手動(dòng)安裝Rtools,之后手動(dòng)安裝devtools包等東西赌渣,由于我已經(jīng)安過一遍昌犹,不方便重現(xiàn),遇到問題的朋友可以按指導(dǎo)安裝鸿竖。

新建文件是選擇File->New File->R Markdown->From Template->CTeX Documents(如圖4),此時(shí)建立的文件轉(zhuǎn)為PDF格式時(shí)可以包含中文千贯。
圖4:CTeX Documents
此模版具有較多內(nèi)容搔谴,如果不需要,又不想每次都手動(dòng)刪除敦第,可以找到此模版配置文件,進(jìn)行更改鞠呈∮壹兀考慮到可能涉及作者knitr的版權(quán)問題什么的,此處就不描述具體做法了窘茁。還有個(gè)問題脆烟,似乎Pandoc對(duì)中文文件名支持有些問題,所以保存RMD文件時(shí)候邢羔,文件名要使用純英文。通過上述配置框冀,我們終于可以使用RStudio愉快的編寫Markdown文件署惯,并轉(zhuǎn)換Word或者PDF文檔了。

References
http://www.yangzhiping.com/tech/r-markdown-knitr.html——Markdown寫作淺談
http://www.yangzhiping.com/tech/pandoc.html——Markdown寫作進(jìn)階:Pandoc入門淺談
https://github.com/yihui/r-ninja/blob/master/11-auto-report.md——自動(dòng)化報(bào)告
http://zhuanlan.zhihu.com/LaTeX/19779481——TeX Live 2014安裝引導(dǎo)流程——知呼專欄
https://github.com/yihui/knitr/issues/889——RStudio 中Knitr 輸出中文的問題
https://github.com/rstudio/rticles——Knitr templates

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末安岂,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子咙边,更是在濱河造成了極大的恐慌,老刑警劉巖败许,帶你破解...
    沈念sama閱讀 216,496評(píng)論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件市殷,死亡現(xiàn)場離奇詭異,居然都是意外死亡醋寝,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,407評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門囱桨,熙熙樓的掌柜王于貴愁眉苦臉地迎上來舍肠,“玉大人窘面,你說我怎么就攤上這事∶窬担” “怎么了?”我有些...
    開封第一講書人閱讀 162,632評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵们童,是天一觀的道長鲸鹦。 經(jīng)常有香客問我,道長齐板,這世上最難降的妖魔是什么葛菇? 我笑而不...
    開封第一講書人閱讀 58,180評(píng)論 1 292
  • 正文 為了忘掉前任眯停,我火速辦了婚禮,結(jié)果婚禮上莺债,老公的妹妹穿的比我還像新娘签夭。我一直安慰自己椎侠,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,198評(píng)論 6 388
  • 文/花漫 我一把揭開白布慎宾。 她就那樣靜靜地躺著宣羊,像睡著了一般。 火紅的嫁衣襯著肌膚如雪之宿。 梳的紋絲不亂的頭發(fā)上苛坚,一...
    開封第一講書人閱讀 51,165評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音等缀,去河邊找鬼娇昙。 笑死,一個(gè)胖子當(dāng)著我的面吹牛噪裕,可吹牛的內(nèi)容都是我干的股毫。 我是一名探鬼主播,決...
    沈念sama閱讀 40,052評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼祭陷,長吁一口氣:“原來是場噩夢(mèng)啊……” “哼趣席!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起宣肚,我...
    開封第一講書人閱讀 38,910評(píng)論 0 274
  • 序言:老撾萬榮一對(duì)情侶失蹤钉寝,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后嵌纲,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,324評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡鸠蚪,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,542評(píng)論 2 332
  • 正文 我和宋清朗相戀三年茅信,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了墓臭。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,711評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡酌摇,死狀恐怖嗡载,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情埂息,我是刑警寧澤遥巴,帶...
    沈念sama閱讀 35,424評(píng)論 5 343
  • 正文 年R本政府宣布,位于F島的核電站吧秕,受9級(jí)特大地震影響迹炼,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜斯入,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,017評(píng)論 3 326
  • 文/蒙蒙 一刻两、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧磅摹,春花似錦霎奢、人聲如沸饼灿。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,668評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽庇忌。三九已至,卻和暖如春疏橄,著一層夾襖步出監(jiān)牢的瞬間墙基,已是汗流浹背软族。 一陣腳步聲響...
    開封第一講書人閱讀 32,823評(píng)論 1 269
  • 我被黑心中介騙來泰國打工立砸, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留初茶,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,722評(píng)論 2 368
  • 正文 我出身青樓螺戳,卻偏偏與公主長得像折汞,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子爽待,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,611評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容

  • 本文原載于 陽志平的個(gè)人網(wǎng)站鸟款,經(jīng)作者授權(quán)轉(zhuǎn)載于簡書。本文作者為 陽志平组哩。 廢話 寫作會(huì)碰到什么難題?Markdow...
    簡書閱讀 70,366評(píng)論 15 481
  • Pandoc 使用 前段時(shí)間換了電腦蛛砰,直接拷過來的MarkDownPad出了點(diǎn)問題幕袱,再加上VSCode的MarkD...
    haop閱讀 34,993評(píng)論 2 17
  • markdown現(xiàn)在已經(jīng)是一種常見的寫作方式,在CSDN等博客網(wǎng)站上都已經(jīng)有了markdown編輯模式,本人也經(jīng)常...
    會(huì)口遁的naruto閱讀 23,180評(píng)論 1 30
  • 備份自:http://blog.rainy.im/2015/05/16/rmarkdown-in-rstudio/...
    蛙聲一爿閱讀 49,719評(píng)論 1 17
  • 我們?cè)谀莻€(gè)燦爛的午陽下再遇 墻上的鐘有些慢了望迎,分針才走到“11”的位置凌外,下課鈴就響了。 老師今天沒有拖堂摄欲,...
    也琴閱讀 438評(píng)論 0 0