CONTEXT 的代码文档自动生成是如何工作的?

CONTEXT 的代码文档自动生成是如何工作的?

与 LaTeX 的核心不同,CONTEXT 核心宏具有相当易读的代码,特别是在某些命令缺乏最新文档的情况下,只需阅读代码本身及其提供的文档就可以学到很多东西。这也是学习如何编写 CONTEXT 宏的一个很好的来源。

事实上,有一种方法可以直接从代码本身生成文档,将提供的注释与实际代码一起添加到 PDF 输出中。根据花园,这是通过以下命令行完成的。

context --ctx=s-mod core-con.mkiv

这会生成一个core-con.mkiv.prep文件并将其编译成一个漂亮的 PDF 输出。

相同的功能如何适用于 Lua 文件?Garden 上的同一页面建议如下。

context --ctx=x-ldx core-con.lua

这会生成一个core-con.lua.prep文件core-con.lua.prep.prep,但不是所需的 HTML 文档。 问题:我在这里做错了什么?

问题\module:除了顶部的定义和索引机制之外,\macros我们还可以在注释中使用哪些标签%D(在 MkIV 源中)?(我知道我们可以使用任何 TeX 代码;我问的是有哪些特殊宏可用。)我还注意到%C版权声明有一个特殊标签,但不知道它有什么作用。还有其他特殊的注释代码吗?

问题:Lua 文件中的标签呢?这些标签更加神秘且稀少。为什么这些是 HTML 标签,而不是 TeX 宏?

答案1

它应该在测试版中修复,请参阅 CONTEXT 分布 - 测试版

相关内容