-
-
21 Aug 2018 04:24:16 UTC
- Distribution: Text-WordDiff
- Module version: 0.09
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues (5)
- Testers (741 / 0 / 0)
- Kwalitee
Bus factor: 1- 87.76% Coverage
- License: perl_5
- Activity
24 month- Tools
- Download (25.41KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Algorithm::Diff
- HTML::Entities
- Term::ANSIColor
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
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
Support
This module is stored in an open repository at the following address:
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>
Currently maintained by the developers of The Perl Shop <tps@cpan.org>.
Copyright and License
Copyright (c) 2005-2011 David E. Wheeler. Some Rights Reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Module Install Instructions
To install Text::WordDiff, copy and paste the appropriate command in to your terminal.
cpanm Text::WordDiff
perl -MCPAN -e shell install Text::WordDiff
For more information on module installation, please visit the detailed CPAN module installation guide.