有没有一种工具(最好是基于命令行的)可以帮助将源代码转换为 HTML 表格为“图形文本”(可能是 HTML 表格的ASCII 艺术)以用于代码注释,如下所示?
例如,给定以下 HTML 表格源
<TABLE BORDER=1>
<CAPTION>A test table with merged cells</CAPTION>
<TR><TH ROWSPAN=2><TH COLSPAN=2>Average
<TH ROWSPAN=2>other<BR>category<TH>Misc
<TR><TH>height<TH>weight
<TR><TH ALIGN=LEFT>males<TD>1.9<TD>0.003
<TR><TH ALIGN=LEFT ROWSPAN=2>females<TD>1.7<TD>0.002
</TABLE>
该工具将输出如下内容以嵌入到代码注释中(如/*…*/
):
/*
A test table with merged cells
+----------+-------------------+----------+--------+
| | Average | other | Misc |
| +---------+---------+ category +--------|
| | height | weight | | |
|----------+---------+---------+----------+--------|
| males | 1.9 | 0.003 | | |
|----------+---------+---------+----------+--------|
| females | 1.7 | 0.002 | | |
+----------+---------+---------+----------+--------+
*/
背景:一段从 HTML 表格中读取值的代码可以用注释来注释,这些注释描述了复杂 HTML 表格布局的基于文本的图形表示。稍后维护代码的人会发现它更容易理解,例如,一段代码如何对 HTML 表进行切片和切块或在某些单元格位置提取值。