'javadoc' 看起来很像，使用解析器生成器？

Question

我将为我主要使用的语言创建一个类似于 javadoc 的外观，但我想知道 - 是否值得为此使用解析器生成器？使用解析器生成器的主要想法是因为我可以为 HTML 代码使用模板，然后可以导出。如果需要，我也可以使用 PDF 模板。

谢谢，

威廉诉多恩案

Answer 1

如果您要做的只是提取“Javadoc”cmets，则不需要完整的解析器；毕竟，您只需要识别 cmets 和正则表达式就可以了。

如果您想从代码中提取信息并使用它来扩充 javadoc cmets，您不仅需要解析器，还需要名称和类型解析。

您可以在Java Source Code Browser 中看到结合解析、名称/类型解析和 Javadoc 注释提取的结果，它会生成 Javadoc 结果以及交叉引用到 Javadocs 中的完全超链接源代码。

产生这个的机器是 ANTLR 之类的泛化。但是几乎不需要使用代码模板来生成 HTML 本身；所有的辛苦工作都在于跨符号表进行解析和事实收集。