AsciiDoc公司类似于降价:一个简单的,可转换为的可读文本标记html格式.
对于简单的报告,我很满意R降价,但对于包含很多部分的长报告,最好有一个带有浮动目录。(请参见这个例子及其AsciiDoc来源.)
降价吸引力的一个重要部分是有限的简单标记。但有时你只想多一点,比如下标(例如,在描述F时1混合动力)。你可以插入一些html代码,但使用类似的具有更丰富语法的系统,如AsciiDoc公司.
AsciiDoc的语法在风格上与Markdown相似,但有点差异;我总是混淆这两者我的例子以及AsciiDoc备忘单.
代码块分隔符
针锋相对,使用asciidoc时的主要区别是代码块以不同的方式分隔。下面是一个示例:
我们看到这是一个与+r nind(sug)+个人的交叉。有+r nphe(sug)+表型和基因型数据+r-totmar(sug)+标记物穿过+r-nchr(sug)+常染色体。基因型数据相当完整。使用+plot()+获取数据的摘要图。//begin.rcode汇总图,图高=8绘图(sug)//结束.rcode
较大的代码块用分隔//开始.rcode
和//结束.rcode
.
内联代码块用表示+第页
和+
,作为AsciiDoc使用+
标记代码,以单空格字体显示。
否则,关于代码块和块选项的一切都是与相同R降价.
浮动目录和其他内容
的顶部我的AsciiDoc示例是以下内容:
Knitr/Asciidoc文档示例==================================链接:网址:https://kbroman.org[卡尔·W·布罗曼]:toc2::编号::data-uri(数据):
:toc2:
指示包含目录,浮动在左边距。:编号:
指示对节进行编号。:data-uri(数据):
指示在html文件中嵌入图像。
桌子
你不能使用卡布尔的
或可发送的
使用AsciiDoc。相反,使用ascii公司
中的函数ascii包,它的论点数量惊人。
下面是一个简单的示例:
//begin.rcode表格,结果=“asis”,警告=FALSEx<-形式(100,10,5)y<-2*x+形式(100,0,2)输出<-lm(y~x)coeff_tab<-汇总(输出)$coeff库(ascii)ascii(coef_tab,include.rownames=TRUE,incluse.colnames=TRU,标题=真)//结束.rcode
注意使用results=“asis”
.我用过警告=假
抑制警告消息。
这里是那块会产生什么,加上一个仅包含该块的AsciiDoc文件.
安装AsciiDoc
要使用AsciiDoc,您需要安装AsciiDoc;看见此安装页.
在Mac OSX上,我建议使用自制软件; 然后是你只是键入brew安装asciidoc
.
对于asciidoc的旧版本,您需要Python 2和不是Python 3.在我的电脑上,蟒蛇
是Python 3;我以前不得不切换到Python 2在运行AsciiDoc之前。如果我忘了切换,我会得到以下结果错误消息:
文件“/usr/local/bin/asciidoc”,第101行除KeyError外,k:引发AttributeError,k^语法错误:无效语法
我还建议安装ascii包对于R(右).
将AsciiDoc转换为html
R工作室没有用于AsciiDoc的设施;您需要使用命令行工具。
你第一次使用编织
在编织机包装中处理asciidoc/编织机文件:
R-e’库(knitr);knit(“knitr_example.Rasciidoc”,“knitr _ example.asciidov”)'
然后使用阿西里多克
要将其转换为html文件: