原文地址
之前的博客有寫到過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配置: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)安裝鸿竖。
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