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文件:

asciidoc针织品示例.asciidoc