Jacques Distler > MathML-Entities > MathML::Entities

Download:
MathML-Entities-0.17.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.17   Source  

NAME ^

MathML::Entities - Convert XHTML+MathML Named Entities to Numeric Character References

SYNOPSIS ^

 use MathML::Entities;
 
 $html    = '<b>&copy;</b> by me';
 
 # convert named HTML entities to character references:
 $numeric = name2numbered($html);    # <b>&#x000A9;</b> by me

 # convert named HTML entities to character references:
 $utf8 = name2utf8($html);    # utf8 

DESCRIPTION ^

MathML::Entities a content conversion filter for named XHTML+MathML entities. There are over two thousand named entities in the XHTML+MathML DTD. All the Entities defined in the XHTML+MathML DTD except the five "safe" ones (&lt;, &gt;, &amp;, &quot;, &apos;), will be converted to the equivalent numeric character references or to utf-8 characters. Named entities which are not in the XHTML+MathML DTD are escaped. This makes the resulting XHTML (or XHTML+MathML) safe for consumption by non-validating XML parsers.

Unlike, HTML::Entities, the mapping between MathML named entities and codepoints is many-to-one. Therefore, there's no particular sense in having an inverse function, which takes codepoints to named entities.

Based on: HTML::Entities by Koichi Taniguchi <taniguchi@livedoor.jp>

FUNCTIONS ^

The following functions are exported by default.

AUTHOR ^

Jacques Distler <distler@golem.ph.utexas.edu>

COPYRIGHT ^

Copyright (c) 2005 Jacques Distler. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO ^

HTML::Entities, HTML::Entities::Numbered, http://www.w3.org/TR/REC-html40/sgml/entities.html, http://www.w3.org/Math/characters/

syntax highlighting: