问题标签 [literate-programming]

我正在使用 knitr 生成 HTML 报告，并且我想包含作者和生成日期元标记。

我的 Rhtml 页面看起来像这样。

不幸的是，在我之后knit("test.Rhtml")，knitr 生成的 HTML 是

这不是有效的 HTML。我真正想要生成的是

我可以生成没有code包装标签的 R 代码吗？还是有另一种方法来指定标签属性（如这些内容属性）？

到目前为止，我最糟糕的计划是使用readLines/ str_replace/手动修复内容writeLines，但这似乎相当笨拙。

我目前正在写很多小报告。其中大多数只是带有一些图表和说明性评论的价值转储。

是否有一个有文化的编程环境，让我以简单的格式（最好是 markdown/latex 和 haskell）编写我的报告，然后转换为包含在原始文件中完成的计算结果的某种输出格式（最好是 pdf）？

我知道 Haskell 支持识字编程，但我不认为可以捕获输出（可能还有整个图像）。

我教了一门课，让学生使用我写的包。现在课程即将结束，我想为他们提供每个函数的代码，这些代码与函数的文档内联。我可以设置一个全局标志来完成此操作吗？某种代码破解？

在尝试为自己找到关于这个问题的解决方案的同时，我发现自己陷入了尝试编写有效的 Rd 标记的过程中。我想要的是添加一个名为的部分并将Raw Function Code函数的代码放在它下面。通过编写脚本来修改 Rd 文件以包含

但是，即使我在 .Rd 文件中手动正确分隔文本（使用空格或制表符），每行的初始空白似乎也会被剥离，留下一个不受欢迎的功能。我注意到，如果我在空白之前提供一个起始字符，则会保留空白。但是，我不想提供起始字符，因为我希望人们能够直接从生成的 PDF 中复制和粘贴。

我已经查看了parseRd，并且我知道有三种类型的文本 LaTeX-like、R-like 和 verbatim。我试图将我的函数代码放在 \code 和 \verb 中，但似乎都没有产生预期的结果。我能做些什么来保持我最初的空白？

我正在尝试做这样的事情：

我想要发生的是在评估块以产生导出输出时，将 <<defs>> 扩展为缠结样式。实际发生的是 <<defs>> 被逐字评估并导致语法错误。

当将这样的块与输出文件纠缠在一起时，一切正常，但是当我导出缓冲区时，我不知道如何做同样的事情。

建议？

我正在从knitr::spin 标记的文档生成 html 报告

1）它可以执行以下操作

.md通过单击“预览 HTML”按钮，然后单击“使用系统 Web 浏览器查看网页”按钮，在 Rstudio 中处理生成的文件。

2）但是，spin('document.R')直接生成的html文件不显示LaTeX方程。

这是因为 (1) 生成 MathJax 脚本标签，但 (2) 不生成。

有什么想法为什么不呢？

I'm writing a program in a .lhs file which contains code in Haskell (I'm specifying this because I want it to be clear that it's not only for rendering a pdf but it's also for being execute with runhaskell or ghci). I'm rendering the code with lstlisting like this:

Anyway, the code itself require some modules that I have to import, but I don't want the imports to appear in the resulting pdf. So, I've tried to put the code without the lstlisting block, like this:

But it's not working and the resulting PDF renders those lines only not as code like lstlisting would do. What should I do to write the import code only for being execute but not to be showed in the PDF itself?

有没有办法在 .lhs 文件中执行代码并将结果放在生成的 PDF 中代码本身的正下方？

例如：

我有一个识字的 haskell 文件，想使用条件编译。我使用文学编程的小鸟风格。以下代码不起作用。

我需要 cabal 1.14.0 的解决方案

编辑：

cpphs有一个选项 --unlit 可以取消有文字的源代码，但我不知道如何将此选项传递给 cabal 中的 cpphs。

是否可以在使用 Maven 的 Java（多模块）项目上运行Marginalia ？

或者有没有其他类似于 Marginalia 或Docco的替代方案可以做到这一点？

对我来说重要的是能够将它作为一些公共 Maven 存储库的依赖项添加并立即使用它，而无需为 Docco 安装任何其他东西，例如 Node.js - 这是合理的，因为它是一个 Java 项目。