XMLPRETTY(1) | User Contributed Perl Documentation | XMLPRETTY(1) |
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
2000-06-19 | perl v5.16.3 |