在我看来,通过为宏添加一些颜色,可以提高macrocode
使用系统环境中 l3 层代码的可读性。我编写了一些代码来执行此操作,并在图像中播下了输出的示例。我还做了另外两处更改。宏名称未打印在边缘,而是内联在定义顶部。任何变体都打印在行末的方括号中。此外,在代码块的末尾,说“name1、name2 的结束定义”等是多余的,这从代码块标题中可以明显看出。如果它们已被记录,可以在此处提供链接。尽管如果标题中的宏列表可以点击,即使是这样也是多余的。doc/docstrip
[variants]
着色基于模块前缀。目的是提供对比度以增强可读性。LaTeX/TeX 代码仅部分着色。i 仅对用作构造函数的宏着色,例如\newcommand
。
我的问题是,我还能对这个概念做出哪些改进?有多少代码应该被着色?欢迎提出任何其他想法和建议。