Tabela HTML para "texto gráfico" para comentários de código
Existe uma ferramenta (idealmente baseada em linha de comando) que pode ajudar a converter a fonte em tabelas HTML em "texto gráfico" (pense talvezArte ASCII para tabelas HTML) para uso em comentários de código, como mostrado abaixo?
Por exemplo, dada a seguinte fonte de tabela 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 ferramenta produziria algo como o seguinte para ser incorporado nos comentários do código (como/*…*/
):
/*
A test table with merged cells
+----------+-------------------+----------+--------+
| | Average | other | Misc |
| +---------+---------+ category +--------|
| | height | weight | | |
|----------+---------+---------+----------+--------|
| males | 1.9 | 0.003 | | |
|----------+---------+---------+----------+--------|
| females | 1.7 | 0.002 | | |
+----------+---------+---------+----------+--------+
*/
Antecedentes: um pedaço de código que lê valores das tabelas HTML pode ser anotado com comentários que representam representações gráficas baseadas em texto de layouts complexos de tabelas HTML. Alguém que mantém o código posteriormente pode achar mais fácil entender, por exemplo, como um pedaço de código está fatiando e picando uma tabela HTML ou obtendo valores em determinadas posições da célula.