Преобразовывать содержимое HTML в mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объект, содержимое HTML должно быть XML parsable. Содержимое HTML XML parsable, когда оно выполняет правила для правильно сформированного XML, такие как:
Включайте закрывающий тэг для всех элементов.
Используйте нижний регистр для открытия и заключительный (начало и конец) теги элемента. Например, используйте <p> и </p> для элемента абзаца, не <P> и </P>.
Элементы вложенного множества правильно. Если вы открываете элемент в другом элементе, закрываете первый элемент, прежде чем вы закроете содержание элемента.
Заключите значения атрибута с кавычками. Например, используйте <p align="center"></p>.
Для получения дополнительной информации см. сводные данные W3Schools правил XML в www.w3schools.com/xml/xml_syntax.asp.
Совет
Чтобы сделать содержимое HTML XML parsable, можно использовать mlreportgen.utils.html2dom.prepHTMLString, mlreportgen.utils.html2dom.prepHTMLFile, и mlreportgen.utils.tidy. Смотрите готовят HTML перед преобразованием.
Эта таблица показывает элементы HTML и атрибуты, которые поддерживаются, когда вы преобразуете HTML в Объект DOM. Неподдерживаемые элементы и атрибуты проигнорированы.
| Элемент HTML | Атрибуты |
|---|---|
a | class, style, hrefИмя |
b | class, style |
body | class, style |
br | нет данных |
code | class, style |
del | class, style |
div | class, style |
font | class, style, color, faceразмер |
h1, h2, h3, h4, h5, h6 | class, styleвыравнивание |
hr | class, styleвыравнивание |
i | class, style |
ins | class, style |
img | class, stylesrc высотаwidth |
li | class, style |
ol | class, style |
p | class, styleвыравнивание |
pre | class, style |
s | class, style |
span | class, style |
strike | class, style |
sub | class, style |
sup | class, style |
table | class, styleвыравнивание, bgcolor'Граница' , cellspacing, cellpaddingСистема координат, ruleswidth |
tbody | class, styleвыравнивание, valign |
tfoot | class, styleвыравнивание, valign |
thead | class, styleвыравнивание, valign |
td | class, style, bgcolorвысотаwidth, colspan, rowspan, valign, nowrap |
tr | class, style, bgcolor, valign |
tt | class, style |
u | class, style |
ul | class, style |
Для получения информации об этих элементах см. https://developer.mozilla.org/en-US/docs/Web/HTML/Element.
Можно использовать атрибуты стиля HTML, чтобы отформатировать содержимое HTML, которое вы добавляете к отчету DOM. Атрибут стиля является строкой форматов каскадных таблиц стилей (CSS).
Эти форматы CSS поддерживаются:
background-color
border
border-bottom
border-bottom-color
border-bottom-style
boder-bottom-width
border-color
border-left
border-left-color
border-left-style
boder-left-width
border-right
border-right-color
border-rigtht-style
border-right-width
border-style
border-top
border-top-color
border-top-style
border-top-width
border-width
color
counter-increment
counter-reset
display
font-family
font-size
font-style
font-weight
height
line-height
list-style-type
margin
margin-bottom
margin-left
margin-right
margin-top
padding
padding-bottom
padding-left
padding-right
padding-top
text-align
text-decoration
text-indent
vertical-align
white-space
width
Для получения информации об этих форматах, https://developer.mozilla.org/en-US/docs/Web/CSS/Reference.
Можно добавить содержимое HTML, которое включает специальные символы, такие как знак британского фунта, знак доллара США или зарезервированные символы разметки XML. Специальными символами разметки XML является >, <, &, ", и '. Чтобы включать специальные символы, используйте названный HTML или ссылки цифрового символа. Например, чтобы включать открывающую угловую скобку (<) в содержимом HTML, которое вы хотите добавить, используйте одну из этих ссылок символьной сущности:
Именованная ссылка символьной сущности <
Ссылка на сущность цифрового символа &003c;
Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references.
Содержимое HTML, которое вы добавляете к отчету DOM, не должно включать объявление типа документа (см. https://en.wikipedia.org/wiki/Document_type_declaration). Если содержимое включает объявление типа документа, оно должно ответить следующим условиям:
Если содержимое включает ссылки символьной сущности (специальные символы), объявление типа документа должно сослаться на определение типа документа (DTD), которое задает сущности, на которые ссылаются. Например, следующее объявление задает файл DTD, который задает всю символьную сущность HTML:
<!DOCTYPE html SYSTEM "html.dtd">
html.dtd включен в программное обеспечение MATLAB® Report Generator™.
Если объявление типа документа ссылается на файл DTD, допустимый файл DTD должен существовать в пути, заданном объявлением. В противном случае добавление содержимого вызывает ошибку анализа DTD. Например, следующее объявление вызывает ошибку анализа:
<!DOCTYPE html SYSTEM "foo.dtd">
Если содержимое, которое будет добавлено, не включает ссылки символьной сущности, объявление типа документа не должно ссылаться на файл DTD. Например, следующее объявление работает на содержимое, которое не использует специальные символы:
<!DOCTYPE html>
Совет
Чтобы избежать проблем объявления типа документа, удалите объявления из существующего содержимого HTML, что вы намереваетесь добавить к отчетам DOM. Если содержимое не включает объявление, DOM предварительно ожидает допустимое объявление, которое задает целый набор символьной сущности HTML.
