wiki.techinc.nl/includes/diff/TableDiffFormatter.php
Thiemo Mättig 6806400129 Added and updated Doxygen comments in content handler and diff namespaces
Reasons for touching this are:
* "@param type $var" were mixed in a lot of places. Both works but the
  MediaWiki coding conventions suggest that specific order.
* Things like String and Bool aren't objects and shouldn't be uppercase.
* Tried to fill missing types in "@param $var".
* Tried to fill missing descriptions in "@return type" when I could.
* Removed duplicate descriptions if a @see is sufficend.
* Removed useless descriptions ("isUsefull returns true if usefull").
* Removed useless @return void.
* Replaces mixed[] with array (does have the exact same meaning).
* Tried to find better replacements for "varargs", phpDocumentor
  suggest $var,...
* Order should be @since, @param, @throws, @return, @see. This is the
  order Doxygen renders this.

There is always more to do but I think this is already much better
than before. Please feel free to put more change sets on top of mine
or request more changes by adding comments.

Change-Id: I05262ce06caabf79f68772302524ac91bbead1c6
2014-03-06 11:17:41 +01:00

212 lines
5.1 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
/**
* Portions taken from phpwiki-1.3.3.
*
* Copyright © 2000, 2001 Geoffrey T. Dairiki <dairiki@dairiki.org>
* You may copy this code freely under the conditions of the GPL.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
* @ingroup DifferenceEngine
*/
/**
* MediaWiki default table style diff formatter
* @todo document
* @private
* @ingroup DifferenceEngine
*/
class TableDiffFormatter extends DiffFormatter {
function __construct() {
$this->leadingContextLines = 2;
$this->trailingContextLines = 2;
}
/**
* @static
* @param string $msg
*
* @return mixed
*/
public static function escapeWhiteSpace( $msg ) {
$msg = preg_replace( '/^ /m', '&#160; ', $msg );
$msg = preg_replace( '/ $/m', ' &#160;', $msg );
$msg = preg_replace( '/ /', '&#160; ', $msg );
return $msg;
}
/**
* @param int $xbeg
* @param int $xlen
* @param int $ybeg
* @param int $ylen
*
* @return string
*/
protected function blockHeader( $xbeg, $xlen, $ybeg, $ylen ) {
$r = '<tr><td colspan="2" class="diff-lineno"><!--LINE ' . $xbeg . "--></td>\n" .
'<td colspan="2" class="diff-lineno"><!--LINE ' . $ybeg . "--></td></tr>\n";
return $r;
}
/**
* Writes the header to the output buffer.
*
* @param string $header
*/
protected function startBlock( $header ) {
echo $header;
}
protected function endBlock() {
}
/**
* @param string[] $lines
* @param string $prefix
* @param string $color
*/
protected function lines( $lines, $prefix = ' ', $color = 'white' ) {
}
/**
* HTML-escape parameter before calling this
*
* @param string $line
*
* @return string
*/
protected function addedLine( $line ) {
return $this->wrapLine( '+', 'diff-addedline', $line );
}
/**
* HTML-escape parameter before calling this
*
* @param string $line
*
* @return string
*/
protected function deletedLine( $line ) {
return $this->wrapLine( '', 'diff-deletedline', $line );
}
/**
* HTML-escape parameter before calling this
*
* @param string $line
*
* @return string
*/
protected function contextLine( $line ) {
return $this->wrapLine( '&#160;', 'diff-context', $line );
}
/**
* @param string $marker
* @param string $class Unused
* @param string $line
*
* @return string
*/
protected function wrapLine( $marker, $class, $line ) {
if ( $line !== '' ) {
// The <div> wrapper is needed for 'overflow: auto' style to scroll properly
$line = Xml::tags( 'div', null, $this->escapeWhiteSpace( $line ) );
}
return "<td class='diff-marker'>$marker</td><td class='$class'>$line</td>";
}
/**
* @return string
*/
protected function emptyLine() {
return '<td colspan="2">&#160;</td>';
}
/**
* Writes all lines to the output buffer, each enclosed in <tr>.
*
* @param string[] $lines
*/
protected function added( $lines ) {
foreach ( $lines as $line ) {
echo '<tr>' . $this->emptyLine() .
$this->addedLine( '<ins class="diffchange">' .
htmlspecialchars( $line ) . '</ins>' ) . "</tr>\n";
}
}
/**
* Writes all lines to the output buffer, each enclosed in <tr>.
*
* @param string[] $lines
*/
protected function deleted( $lines ) {
foreach ( $lines as $line ) {
echo '<tr>' . $this->deletedLine( '<del class="diffchange">' .
htmlspecialchars( $line ) . '</del>' ) .
$this->emptyLine() . "</tr>\n";
}
}
/**
* Writes all lines to the output buffer, each enclosed in <tr>.
*
* @param string[] $lines
*/
protected function context( $lines ) {
foreach ( $lines as $line ) {
echo '<tr>' .
$this->contextLine( htmlspecialchars( $line ) ) .
$this->contextLine( htmlspecialchars( $line ) ) . "</tr>\n";
}
}
/**
* Writes the two sets of lines to the output buffer, each enclosed in <tr>.
*
* @param string[] $orig
* @param string[] $closing
*/
protected function changed( $orig, $closing ) {
wfProfileIn( __METHOD__ );
$diff = new WordLevelDiff( $orig, $closing );
$del = $diff->orig();
$add = $diff->closing();
# Notice that WordLevelDiff returns HTML-escaped output.
# Hence, we will be calling addedLine/deletedLine without HTML-escaping.
while ( $line = array_shift( $del ) ) {
$aline = array_shift( $add );
echo '<tr>' . $this->deletedLine( $line ) .
$this->addedLine( $aline ) . "</tr>\n";
}
foreach ( $add as $line ) { # If any leftovers
echo '<tr>' . $this->emptyLine() .
$this->addedLine( $line ) . "</tr>\n";
}
wfProfileOut( __METHOD__ );
}
}