класс mlreportgen.utils.tidy

Пакет: mlreportgen.utils
Суперклассы:

Правильный и чистый XML и содержимое HTML

Конструкция

outString = mlreportgen.utils.tidy(inString) исправляет и чистит строку XHTML. Исправление добавляет недостающие конечные тэги. Очистка удаляет ненужные теги.

outFile = mlreportgen.utils.tidy(inFile) исправляет и чистит файл XHTML.

Входные параметры

развернуть все

Текст HTML, чтобы исправить и убрать, заданный как строка или вектор символов.

Файл HTML, чтобы исправить и убрать, заданный как строка или вектор символов.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: tidy("myFile.html","OutputType","html")

Можно также использовать строки, чтобы задать аргументы пары "имя-значение".

Тип выходного файла, заданного как строка или вектор символов. Допустимыми значениями является 'xml', 'html' и 'xhtml'. Чтобы гарантировать, что приведенный в порядок файл XML совместимый, используйте 'xhtml' в качестве выходного типа.

Путь выходного файла, заданного как строка или вектор символов. Если файл находится в текущей рабочей папке, можно задать только имя файла, в противном случае задать полный путь. Приведенный в порядок выходной файл может перезаписать исходный файл HTML или быть сохранен в новый файл.

Конфигурационный файл, заданный как строка или вектор символов. Конфигурационный файл содержит опции для того, чтобы очистить и исправить входные строки и файлы. (Для получения дополнительной информации смотрите Внешние ссылки.) Конфигурационные файлы по умолчанию для каждого выходного типа расположены в папке <matlabroot>/toolbox/shared/mlreportgen/utils/resources. Файлами является tidy-html.cfg, tidy-xml.cfg и tidy-xhtml.cfg. Можно создать собственный конфигурационный файл и задать его с помощью этого параметра. Самый легкий способ создать ваш собственный конфигурационный файл состоит в том, чтобы скопировать файл по умолчанию, внести ваши изменения и сохранить его с помощью нового имени файла. Если вы задаете свой собственный ConfigFile, он заменяет параметр OutputType.

Примечание

Добавление отступа приведенного в порядок файла установлено в false в конфигурационном файле по умолчанию. Чтобы включить добавление отступа, создайте свой собственный конфигурационный файл и установите отступ на true.

Выходные аргументы

развернуть все

Приведенный в порядок XHTML, возвращенный как строка, которая содержит базовые элементы файла HTML.

Приведенный в порядок файл XHTML, возвращенный как строка, которая указывает на расположение файла и имя.

Примеры

свернуть все

outString = mlreportgen.utils.tidy...
   ("<p>sample input string with missing end tag")
outString = 

    "<html xmlns="http://www.w3.org/1999/xhtml">
     <head>
     <title></title>
     </head>
     <body>
     <p>sample input string with missing end tag</p>
     </body>
     </html>
     "

В данном примере замените своим username в строке "c:\Users\username\Documents\myHTMLFile.html".

outFile = mlreportgen.utils.tidy("myHTMLFile.html",...
   "OutputFile","C:\Users\username\Documents\myHTMLFile.html")
outFile = 

      "C:\Users\username\Documents\myHTMLFile.html"
     

Примите, что вы создали свой собственный конфигурационный файл, названный myConfig.cfg, и сохранили его в вашей папке Documents, в то время как вы тестируете его. Для простоты нахождения файла позже, сохраните его в том же месте как конфигурационные файлы по умолчанию или сохраните его вашим выходным файлом.

В данном примере замените своим username в строке "c:\Users\username\Documents\myNewHTMLFile.html".

outFile = mlreportgen.utils.tidy("myHTMLFile.html","OutputFile",...
   "c:\Users\username\Documents\myNewHTMLFile.html",...
   "ConfigFile","myConfig.cfg")
outFile = 

      "C:\Users\username\Documents\myHTMLFile.html"
     

Введенный в R2018b