Text::WordDiff::HTML.3pm

Langue: en

Autres versions - même langue

Version: 2010-05-07 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

Name

Text::WordDiff::HTML - XHTML formatting for Text::WordDiff

Synopsis

     use Text::WordDiff;
 
     my $diff = word_diff 'file1.txt', 'file2.txt'; { STYLE => 'HTML' };
     my $diff = word_diff \$string1,   \$string2,    { STYLE => 'HTML' };
     my $diff = word_diff \*FH1,       \*FH2,        { STYLE => 'HTML' };
     my $diff = word_diff \&reader1,   \&reader2,    { STYLE => 'HTML' };
     my $diff = word_diff \@records1,  \@records2,   { STYLE => 'HTML' };
 
     # May also mix input types:
     my $diff = word_diff \@records1,  'file_B.txt', { STYLE => 'HTML' };

Description

This class subclasses Text::WordDiff::Base to provide a XHTML formatting for Text::WordDiff. See Term::WordDiff for usage details. This class should never be used directly.

Text::WordDiff::HTML formats word diffs for viewing in a Web browser. The diff content is highlighted as follows:

*
"<div class="file">"

This element contains the entire contents of the diff ``file'' returned by "word_diff()". All of the following elements are subsumed by this one.

*
"<span class="fileheader">"

The header section for the files being "diff"ed, usually something like:

   --- in.txt    Thu Sep  1 12:51:03 2005
   +++ out.txt   Thu Sep  1 12:52:12 2005

This element immediately follows the opening ``file'' "<div>" element, but will not be present if Text::WordDif cannot deterimine the file names for both files being compared.

*
"<span class="hunk">"

This element contains a single diff ``hunk''. Each hunk may contain the following elements:

*
"<ins>"

Inserted content.

*
"<del>"

Deleted content.

You may do whatever you like with these elements and classes; I highly recommend that you style them using CSS. You'll find an example CSS file in the eg directory in the Text-WordDiff distribution.

See Also

Text::WordDiff
Text::WordDiff::ANSIColor

Support

This module is stored in an open repository at the following address:

https://svn.kineticode.com/Text-WordDiff/trunk/ <https://svn.kineticode.com/Text-WordDiff/trunk/>

Patches against Text::WordDiff are welcome. Please send bug reports to <bug-text-worddiff@rt.cpan.org>.

Author

David Wheeler <david@kineticode.com> Copyright (c) 2005-2008 David Wheeler. Some Rights Reserved.

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