Преобразовывать содержимое 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 , style src высота 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 Система координат , rules width |
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.