The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

xmlpretty - XML pretty printer

SYNOPSIS

xmlpretty [--options] [filename]

DESCRIPTION

xmlpretty is the commandline interface to XML::Handler::YAWriter, acting as a tool to add and remove pretty printing to XML files.

xmlpretty has several methods to add human readablitiy.

If you want to add readablity without adding so-called ignorable whitespace, use it in the following way :

$ xmlpretty --AddHiddenNewline \
            --AddHiddenAttrTab \
        --CatchEmptyElement \
        uglyfile.xml > prettyfile.xml

If you do not want to process the file further, but only want it human readable, add visible whitespace to the file as follows :

$ xmlpretty --PrettyWhiteNewline \
            --PrettyWhiteIndent \
        --CatchEmptyElement \
        uglyfile.xml > prettyfile.xml

You may use YAWriter to clean whitespace from XML documents. This may work in 99% of the cases where you want to get rid of ignorable whitespace caused by the various forms of pretty printing.

$ xmlpretty --NoWhiteSpace \
            --NoComments \
            --AddHiddenNewline \
        --AddHiddenAttrTab \
        --CatchEmptyElement \
        prettyfile.xml > cleanfile.xml

Options

Options are given in a gnu like --option idiom.

AddHiddenNewline boolean

Add hidden newline before ">"

AddHiddenAttrTab boolean

Add hidden tabulation for attributes

CatchEmptyElement boolean

Catch empty Elements, apply "/>" compression

CatchWhiteSpace boolean

Catch whitespace with comments

IsSGML boolean

This option will cause start_document, processing_instruction and doctype_decl to appear as SGML. The SGML is still well-formed of course, if your SAX events are well-formed.

NoComments boolean

Supress Comments

NoDTD boolean

Supress DTD

NoPI boolean

Supress Processing Instructions

NoProlog boolean

Supress <?xml ... ?> Prolog

NoWhiteSpace boolean

Supress WhiteSpace to clean documents from prior pretty printing.

PrettyWhiteIndent boolean

Add visible indent before any eventstring

PrettyWhiteNewline boolean

Add visible newlines before any eventstring

SAX1 boolean (not yet implemented)

Output only SAX1 compilant eventstrings

Bugs:

Automatic recoding between 8bit and 16bit does not yet work correctly !

I have Perl-5.6 at home and here I can specify "use utf8;" in the right places to make recoding work. But I dislike saying "use 5.00555;" because many systems run 5.00503.

AUTHOR

Michael Koehne, Kraehe@Copyleft.De

Thanks

"Derksen, Eduard (Enno), CSCIO" <enno@att.com> helped me with the Escape hash and gave quite a lot of usefull comments.

SEE ALSO

perl and XML::Parser::PerlSAX