.\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "XMLLINT" 1 "" "" "" .SH NAME xmllint \- консольная утилита для работы с XML .SH "Обзор" .nf \fBxmllint\fR [--version] [--debug] [--shell] [--debugent] [--copy] [--recover] [--noent] [--noout] [--htmlout] [--nowrap] [--valid] [--postvalid] [--dtdvalid \fIURL\fR] [--timing] [--repeat] [--insert] [--compress] [--sgml] [--html] [--push] [--memory] [--nowarning] [--noblanks] [--format] [--testIO] [--encode \fIencoding\fR] [--catalogs] [--nocatalogs] [--auto] [--xinclude] [--loaddtd] [--dtdattr] [--dropdtd] [\fIXML-файл\fR...] .fi .SH "Описание" .PP Программа xmllint обрабатывает один или несколько XML файлов, указанных в строке запуска как \fBXML-файл\fR\&. xmllint создаёт разные варианты вывода в зависимости от выбранных опций\&. Программа полезна для выявления ошибок в коде XML файла или в самом парсере\&. .PP xmllint является частью библиотеки libxml2: \fIhttp://xmlsoft.org\fR\&. .RS .Sh "Note" .PP Для перевода некоторых терминов XML используются русские переводы: \fIhttp://croll.hotbox.ru/W3C/Consortium/Translation/russian-ru.html\fR документов World Wide Web Consortium: \fIhttp://www.w3.org\fR (W3C)\&. .RE .SH "Опции" .TP \fB--version\fR Показать версию используемой библиотеки libxml2\&. .TP \fB--debug\fR Обработать файл и вывести с комментариями структуру представления документа в памяти\&. .TP \fB--shell\fR Запустить командную среду\&. Подробности о доступных командах среды описаны дальше\&. .TP \fB--debugent\fR Включить отладку сущностей (entities), указанных в документе\&. .TP \fB--copy\fR Тестировать реализацию внутреннего копирования\&. Как правило, просто копирует документ на стандартный вывод\&. .TP \fB--recover\fR Игнорировать мелкие ошибки в исходном документе\&. .TP \fB--noent\fR Заменять ссылки на сущности их значениями\&. По умолчанию xmllint оставляет в документе ссылки на сущности\&. Эта опция полезна вместе с \fB--postvalid\fR для проверки документов, или при использовании сущностей в значениях атрибутов\&. .TP \fB--noout\fR Отключает вывод\&. По умолчанию xmllint выводит результирующую структуру документа\&. .TP \fB--htmlout\fR Вывести результат в формате HTML\&. Добавляет в вывод необходимые HTML-теги, позволяющие просмотреть результирующий вывод в браузере\&. .TP \fB--nowrap\fR Не выводить начальное объявление HTML и завершающие теги\&. .TP \fB--valid\fR Проверить соответствие документа (validating) объявленному типу документа (например, DTD)\&. Можно явно указать тип документа для проверки с помощью опции \fB--dtdvalid\fR\&. По умолчанию xmllint также проверяет, что документ правильно сформирован (well-formed), то есть соответствует правилам разметки XML\&. .RS .Sh "Tip" .PP Полезно использовать эту опцию вместе с \fB--noout\fR, тогда проверочные сообщения не будут путаться с выводом самого документа\&. .RE Документы, объединённые с помощью опции \fB--xinclude\fR, нужно проверять опцией \fB--postvalid\fR\&. .TP \fB--postvalid\fR Проверить соответствие документа типу документа после его разбора и обработки\&. .TP \fB--dtdvalid \fIURL\fR\fR Проверять соответствие типу документа, указанному в \fIURL\fR\&. .TP \fB--timing\fR Выводить информацию о времени, затраченном на выполнение различных действий\&. .TP \fB--repeat\fR Повторить операцию 100 раз, используется для определения производительности\&. .TP \fB--insert\fR Тестировать вставку элементов (внутренний тест)\&. .TP \fB--compress\fR Включить gzip-сжатие вывода\&. .TP \fB--sgml\fR Использовать DocBook SGML парсер\&. Позволяет создавать в памяти представление документа, созданного в формате DocBook SGML, и обрабатывать его как созданный в XML\&. .TP \fB--html\fR Использовать HTML парсер\&. .TP \fB--push\fR Использовать ``push'' режим парсера\&. .TP \fB--memory\fR Обрабатывать в памяти\&. .TP \fB--nowarning\fR Не выводить предупреждающие сообщения (warnings)\&. .TP \fB--noblanks\fR Выбрасывать игнорируемые пробельные символы\&. .TP \fB--format\fR Форматировать результирующий вывод\&. .TP \fB--testIO\fR Тестировать возможности ввода/вывода\&. .TP \fB--encode \fIencoding\fR\fR Кодировать вывод в указанной кодировке\&. Кодировка в объявлении XML устанавливается автоматически\&. .TP \fB--catalogs\fR Использовать файлы каталогов (catalogs) из переменной \fISGML_CATALOG_FILES\fR\&. Иначе используется каталог по умолчанию -- \fI/etc/xml/catalog\fR\&. .TP \fB--nocatalogs\fR Не использовать любые каталоги\&. .TP \fB--auto\fR Вывести небольшой документ для тестирования\&. .TP \fB--xinclude\fR Обрабатывать включения документов по стандарту XML Inclusions (XInclude): \fIhttp://www.w3.org/TR/xinclude/\fR\&. По умолчанию xmllint не выполняет такие включения\&. .RS .Sh "Note" .PP В libxml2 до версии2\&.4\&.25 объединение большого количества документов требовало очень много ресурсов и времени\&. С версии 2\&.4\&.25 код включений серьёзно переписан и надобности в больших ресурсах нет\&. .RE .RS .Sh "Tip" .PP Для проверки документов, использующих включения, нужно пользоваться опцией \fB--postvalid\fR\&. .RE .TP \fB--loaddtd\fR Загрузить внешний тип документа\&. Эта опция полезна для разрешения сущностей, объявленных во внешнем типе документа, при объединении нескольких включаемых документов в один\&. .TP \fB--dtdattr\fR Загрузить внешний тип документа и построить дерево с унаследованными атрибутами\&. .TP \fB--dropdtd\fR Удалить объявление типа документа из вывода\&. .SH "Командная среда" .PP xmllint позволяет использовать интерактивный режим команд (опция \fB--shell\fR)\&. Команды интерактивного режима: .TP \fBbase\fR Показать XML базу узла\&. .TP \fBbye\fR Выйти из режима команд\&. .TP \fBcat node\fR Показать текущий узел, или указанный [node]\&. .TP \fBcd path\fR Перейти к указанному узлу, или к корневому, если узел [path] не указан\&. .TP \fBdir path\fR Сохранить информацию узла (пространство имён, атрибуты, содержимое)\&. .TP \fBdu path\fR Показать структуру поддерева от указанного [path] узла, или от текущего, если не указан\&. .TP \fBexit\fR Выйти из режима команд\&. .TP \fBhelp\fR Показать справку\&. .TP \fBfree\fR Показать информацию об использовании памяти\&. .TP \fBload name\fR Загрузить документ, указанный \fIname\fR\&. .TP \fBls path\fR Показать содержимое [path] или текущего каталога\&. .TP \fBpwd\fR Показать путь к текущему узлу\&. .TP \fBquit\fR Выйти из режима команд\&. .TP \fBsave name\fR Сохранить текущий документ с указанным [name] или с оригинальным именем\&. .TP \fBvalidate\fR Проверить документ на ошибки (соответствие объявленному типу, правильность XML)\&. .TP \fBwrite name\fR Записать текущий узел в файл с указанным \fIname\fR именем\&. .SH "Ссылки" .TP 3 \(bu Русские переводы: \fIhttp://croll.hotbox.ru/W3C/Consortium/Translation/russian-ru.html\fR документов World Wide Web Consortium: \fIhttp://www.w3.org\fR (W3C); .TP \(bu Сайт библиотеки libxml2: \fIhttp://xmlsoft.org\fR; .LP .SH AUTHORS John Fleck , Ziying Sherwin , Heiko Rupp .