问题标签 [literate-programming]

我一直在尝试用 Python 进行文学编程的各种方法。我喜欢noweb，但我有两个主要问题：首先，很难在 Windows 上构建，我花了大约一半的开发时间；其次，它要求我缩进每一块代码，就像它在最终程序中一样——我不一定知道我什么时候写的。我不想用 Leo，因为我对 Emacs 很执着。

有没有一个好的读写编程工具：

1. 在 Windows 上运行
2. 允许我在使用时设置块的缩进，而不是在写入时
3. 仍然让我在 Emacs 中工作

谢谢！

更正：noweb 确实允许我稍后缩进 --- 我误读了我在上面找到的论文。

默认情况下，notangle在扩展块时保留空格并保持缩进。因此，它可以与 Miranda 和 Haskell 等语言一起使用，其中缩进很重要

这让我只剩下“在 Windows 上运行”的问题。

我正在努力寻找一个好的识字编程工具。让我们说这不是一个容易的决定。（通用的太笼统，具体的太具体:)）

其中，我已经noweb启动并运行，但我无法像我预期的那样获得输出。维基noweb 百科页面有一个最小的例子，可以正确构建

但是每个块的末尾没有交叉引用。例如，CWEB具有诸如“此代码用于第 12 节”之类的指针。和“另见第 5 节和第 7 节。” 这个功能是简单地从编译中丢失noweb还是我错过了编译中的一个步骤？

我在这个问题上的意图不是迂腐，而是探索一个重要主题（空白的使用）的一个被忽视的轴。在使用水平空格、在条件后缩进、if 和括号之间的空格等方面已经进行了很多辩论和关注。事实上，这个问题被认为是如此重要和有争议，以至于一些公司不仅有规则和标准，但有些公司甚至有禁止讨论的规则。

考虑到水平空白的状态，为什么对垂直空白的讨论是一个死问题？为什么x比y更重要？前几天注意到，我在阅读代码时，经常会不假思索地调整语句的垂直分组。现在阅读了其他人的代码，着眼于垂直空白，我注意到了几种模式，所以我问 stackoverflow：

• 您对垂直空白应用了哪些硬性和软性规则？
• 是否有任何通常被认为非常糟糕或非常好的做法的垂直空白使用？
• 您是否发现阅读带有“正确”垂直空格的代码有助于理解它？
• 除了排版师和我，还有其他人在乎吗？

我昨天看到了这篇博文，它再次让我想尝试一下文学编程。

有没有其他人尝试过为 C# 进行识字编程？我想知道尝试Lyx + noweb，但想知道您是否有其他经验或建议。

我最近开始使用Sweave * 创建使用 R 运行的分析报告，现在我希望对我的 python 脚本做同样的事情。

我在 Sweave 文档中找到了对嵌入 python 的引用，但这似乎有点像 hack。有没有人想出一个更好的解决方案，或者有没有我不知道的 python 的等价物？

* Sweave 是一个允许嵌入 R 代码以在乳胶文档中进行完整数据分析的工具

我有一篇正在审查的科学论文，一位审稿人要求将我的 R 代码作为 Sweave 文档提供。我以前从未听说过 Sweave，你知道有什么更好的方法吗？

非常感谢 ：-）

我的函数的一个参数的默认值包含一个“%”。这似乎是 roxygen 的一个问题，它会在尝试构建乳胶文档时产生很多警告并且 R CMD 检查失败。

我怎样才能使这个功能（及其文档）工作？使用 %% 或 \% 而不是 % 没有帮助。

目前我只使用 Haddock，但在看到一些真正有趣的 Haskell 示例（例如this gist）后，我有兴趣在项目中尝试它。

我得到的问题是：

• 你写什么作为黑线鳕评论，你在文学部分写什么？

• 您如何将文学编程扩展到多个文件？谁能给我举一个例子，在一个包含多个模块的包中使用文学编程？您在较大的软件包中使用文学编程的经验是什么？

• 识字的 Haskell 的哪种口味（markdown、latex、...）是首选？

• 你为什么要使用识字的 Haskell 或普通的 Haskell 编程？您是否同时使用这两种风格进行编程，如果是，为什么？

• 你更喜欢块式（\begin{code}）还是鸟式（>）？为什么？

您是否知道任何具有特别有趣/编写良好的单元测试的开放软件项目？

编写单元测试对我来说常常感觉很奇怪，因为它似乎太随机、太密集、太稀疏……阅读一些真实世界的示例（而不是书籍、库示例代码等）会很棒。

我正在尝试创建一个包含使用 ggplot2 完成的一些图形的 sweave 报告。虽然我正在寻找一些长期的环境——我在这里只使用一个简单的 .Rnw 文件，它只包含代码和情节

不幸的是，没有创建图表，我只得到一个损坏的 .pdf 和 .eps 文件。虽然我得到了一个不错的 .tex 文件，除了图形之外它似乎可以工作。我使用以下基本代码来创建它：

我刚刚在网上发现了一些较旧的帖子，讨论了透明度和 sweave / ggplot2 的问题，但没有任何帮助。我还尝试了轻松的套餐，但也没有帮助。顺便说一句，有没有关于 decumar 包的消息？