HTML-таблица с «графическим текстом» для комментариев кода
Существует ли инструмент (в идеале на основе командной строки), который может помочь в преобразовании исходного кода в таблицы HTML в «графический текст» (подумайте, возможно,ASCII искусство для таблиц HTML) для использования в комментариях к коду, как показано ниже?
Например, учитывая следующий источник 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 или собирает значения в определенных позициях ячейки.