Proper encoding support for POD files

[fgabolde]

The indexer generates warnings when rendering POD that contains wide characters, such as Moose.pm (author names). When browsing to the Moose POD page, mojibake can be seen.

[fgabolde]

Encoding issues are still a problem.

For example, the RewriteRule/Set/Singleton POD contains

(∩(A)) = A or Sum(|A|)=|A|

which should be rendered as HTML entities in the html file

(∩(A)) = A or Sum(|A|)=|A|

but instead is

(∩(A)) = A or Sum(|A|)=|A|

which renders in the browser as

(∩(A)) = A or Sum(|A|)=|A|

and generates a warning: "A numeric character reference expanded to the C1 controls range".