我刚刚完成了我自己的 LaTex 包的编写,我怎样才能使该包能够自我记录,就像来自包代码中的注释一样?
答案1
假设你已经将包写成一个.sty
文件,那么 Perl 脚本提供了一个结合源代码/文档的良好开端sty2dtx
(需要 Perl)。该脚本还适用于带有--type class
开关的文档类。
用法:
perl sty2dtx.pl < mypkg.sty > mypkg.dtx
或者
perl sty2dtx.pl mypkg.sty mypkg.dtx
请参阅自述以获取受支持选项的完整列表。
该脚本生成一个.dtx
文件,用于如何打包你的 LaTeX 包. 通过在文件上运行生成的文档中将文件中的任何注释显示为文本,生成的.dtx
形式成为一个起点。.sty
(pdf)latex
.dtx
这将为您提供一个良好的起点,让您可以开始使用文学编程风格的软件包,并生成许多 LaTeX 软件包风格的文档。从这里开始,您可以自行在 提供的基础框架内向文档添加内容sty2dtx
。