Fix extra space from r64084
[lhc/web/wiklou.git] / includes / Linker.php
index 29ef95d..c049f47 100644 (file)
@@ -21,13 +21,11 @@ class Linker {
         * Get the appropriate HTML attributes to add to the "a" element of an ex-
         * ternal link, as created by [wikisyntax].
         *
-        * @param string $title  The (unescaped) title text for the link
-        * @param string $unused Unused
         * @param string $class  The contents of the class attribute; if an empty
         *   string is passed, which is the default value, defaults to 'external'.
         */
-       function getExternalLinkAttributes( $title, $unused = null, $class='' ) {
-               return $this->getLinkAttributesInternal( $title, $class, 'external' );
+       function getExternalLinkAttributes( $class = 'external' ) {
+               return $this->getLinkAttributesInternal( '', $class );
        }
 
        /**
@@ -40,7 +38,7 @@ class Linker {
         * @param string $class  The contents of the class attribute; if an empty
         *   string is passed, which is the default value, defaults to 'external'.
         */
-       function getInterwikiLinkAttributes( $title, $unused = null, $class='' ) {
+       function getInterwikiLinkAttributes( $title, $unused = null, $class = 'external' ) {
                global $wgContLang;
 
                # FIXME: We have a whole bunch of handling here that doesn't happen in
@@ -49,7 +47,7 @@ class Linker {
                $title = $wgContLang->checkTitleEncoding( $title );
                $title = preg_replace( '/[\\x00-\\x1f]/', ' ', $title );
 
-               return $this->getLinkAttributesInternal( $title, $class, 'external' );
+               return $this->getLinkAttributesInternal( $title, $class );
        }
 
        /**
@@ -87,20 +85,16 @@ class Linker {
        /**
         * Common code for getLinkAttributesX functions
         */
-       private function getLinkAttributesInternal( $title, $class, $classDefault = false ) {
+       private function getLinkAttributesInternal( $title, $class ) {
                $title = htmlspecialchars( $title );
-               if( $class === '' and $classDefault !== false ) {
-                       # FIXME: Parameter defaults the hard way!  We should just have
-                       # $class = 'external' or whatever as the default in the externally-
-                       # exposed functions, not $class = ''.
-                       $class = $classDefault;
-               }
                $class = htmlspecialchars( $class );
                $r = '';
-               if( $class !== '' ) {
+               if ( $class != '' ) {
                        $r .= " class=\"$class\"";
                }
-               $r .= " title=\"$title\"";
+               if ( $title != '') {
+                       $r .= " title=\"$title\"";
+               }
                return $r;
        }
 
@@ -116,7 +110,7 @@ class Linker {
                if ( $t->isRedirect() ) {
                        # Page is a redirect
                        $colour = 'mw-redirect';
-               } elseif ( $threshold > 0 && 
+               } elseif ( $threshold > 0 &&
                           $t->exists() && $t->getLength() < $threshold &&
                           MWNamespace::isContent( $t->getNamespace() ) ) {
                        # Page is a stub
@@ -212,7 +206,7 @@ class Linker {
 
                $ret = null;
                if( wfRunHooks( 'LinkEnd', array( $this, $target, $options, &$text, &$attribs, &$ret ) ) ) {
-                       $ret = Xml::openElement( 'a', $attribs ) . $text . Xml::closeElement( 'a' );
+                       $ret = Html::rawElement( 'a', $attribs, $text );
                }
 
                wfProfileOut( __METHOD__ );
@@ -222,10 +216,13 @@ class Linker {
        /**
         * Identical to link(), except $options defaults to 'known'.
         */
-       public function linkKnown( $target, $text = null, $customAttribs = array(), $query = array(), $options = 'known' ) {
+       public function linkKnown( $target, $text = null, $customAttribs = array(), $query = array(), $options = array('known','noclasses') ) {
                return $this->link( $target, $text, $customAttribs, $query, $options );
        }
 
+       /**
+        * Returns the Url used to link to a Title
+        */
        private function linkUrl( $target, $query, $options ) {
                wfProfileIn( __METHOD__ );
                # We don't want to include fragments for broken links, because they
@@ -248,6 +245,9 @@ class Linker {
                return $ret;
        }
 
+       /**
+        * Returns the array of attributes used when linking to the Title $target
+        */
        private function linkAttribs( $target, $attribs, $options ) {
                wfProfileIn( __METHOD__ );
                global $wgUser;
@@ -307,6 +307,9 @@ class Linker {
                return $ret;
        }
 
+       /**
+        * Default text of the links to the Title $target
+        */
        private function linkText( $target ) {
                # We might be passed a non-Title by make*LinkObj().  Fail gracefully.
                if( !$target instanceof Title ) {
@@ -347,7 +350,7 @@ class Linker {
         * despite $query not being used.
         */
        function makeSelfLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
-               if ( '' == $text ) {
+               if ( $text == '' ) {
                        $text = htmlspecialchars( $nt->getPrefixedText() );
                }
                list( $inside, $trail ) = Linker::splitTrail( $trail );
@@ -366,7 +369,10 @@ class Linker {
                }
        }
 
-       /** @todo document */
+       /**
+        * Returns the filename part of an url.
+        * Used as alternative text for external images.
+        */
        function fnamePart( $url ) {
                $basename = strrchr( $url, '/' );
                if ( false === $basename ) {
@@ -377,9 +383,12 @@ class Linker {
                return $basename;
        }
 
-       /** @todo document */
+       /**
+        * Return the code for images which were added via external links,
+        * via Parser::maybeMakeExternalImage().
+        */
        function makeExternalImage( $url, $alt = '' ) {
-               if ( '' == $alt ) {
+               if ( $alt == '' ) {
                        $alt = $this->fnamePart( $url );
                }
                $img = '';
@@ -388,7 +397,7 @@ class Linker {
                        wfDebug("Hook LinkerMakeExternalImage changed the output of external image with url {$url} and alt text {$alt} to {$img}\n", true);
                        return $img;
                }
-               return Xml::element( 'img',
+               return Html::element( 'img',
                        array(
                                'src' => $url,
                                'alt' => $alt ) );
@@ -447,8 +456,7 @@ class Linker {
                $page = isset( $hp['page'] ) ? $hp['page'] : false;
                if ( !isset( $fp['align'] ) ) $fp['align'] = '';
                if ( !isset( $fp['alt'] ) ) $fp['alt'] = '';
-               # Backward compatibility, title used to always be equal to alt text
-               if ( !isset( $fp['title'] ) ) $fp['title'] = $fp['alt'];
+               if ( !isset( $fp['title'] ) ) $fp['title'] = '';
 
                $prefix = $postfix = '';
 
@@ -460,7 +468,7 @@ class Linker {
                if ( $file && !isset( $hp['width'] ) ) {
                        $hp['width'] = $file->getWidth( $page );
 
-                       if( isset( $fp['thumbnail'] ) || isset( $fp['framed'] ) || isset( $fp['frameless'] ) || !$hp['width'] ) {
+                       if( isset( $fp['thumbnail'] ) || isset( $fp['framed'] ) || isset( $fp['frameless'] ) ) {
                                $wopt = $wgUser->getOption( 'thumbsize' );
 
                                if( !isset( $wgThumbLimits[$wopt] ) ) {
@@ -477,7 +485,9 @@ class Linker {
                                        round( $wgThumbLimits[$wopt] * $fp['upright'], -1 ) :
                                        $wgThumbLimits[$wopt];
                                if ( $hp['width'] <= 0 || $prefWidth < $hp['width'] ) {
-                                       $hp['width'] = $prefWidth;
+                                       if( !isset( $hp['height'] ) ) {
+                                               $hp['width'] = $prefWidth;
+                                       }
                                }
                        }
                }
@@ -491,7 +501,7 @@ class Linker {
                        # If  thumbnail width has not been provided, it is set
                        # to the default user option as specified in Language*.php
                        if ( $fp['align'] == '' ) {
-                               $fp['align'] = $wgContLang->isRTL() ? 'left' : 'right';
+                               $fp['align'] = $wgContLang->alignEnd();
                        }
                        return $prefix.$this->makeThumbLink2( $title, $file, $fp, $hp, $time, $query ).$postfix;
                }
@@ -513,7 +523,7 @@ class Linker {
                }
 
                if ( !$thumb ) {
-                       $s = $this->makeBrokenImageLinkObj( $title, '', '', '', '', $time==true );
+                       $s = $this->makeBrokenImageLinkObj( $title, $fp['title'], '', '', '', $time==true );
                } else {
                        $params = array(
                                'alt' => $fp['alt'],
@@ -533,7 +543,7 @@ class Linker {
 
                        $s = $thumb->toHtml( $params );
                }
-               if ( '' != $fp['align'] ) {
+               if ( $fp['align'] != '' ) {
                        $s = "<div class=\"float{$fp['align']}\">{$s}</div>";
                }
                return str_replace("\n", ' ',$prefix.$s.$postfix);
@@ -566,8 +576,7 @@ class Linker {
                $page = isset( $hp['page'] ) ? $hp['page'] : false;
                if ( !isset( $fp['align'] ) ) $fp['align'] = 'right';
                if ( !isset( $fp['alt'] ) ) $fp['alt'] = '';
-               # Backward compatibility, title used to always be equal to alt text
-               if ( !isset( $fp['title'] ) ) $fp['title'] = $fp['alt'];
+               if ( !isset( $fp['title'] ) ) $fp['title'] = '';
                if ( !isset( $fp['caption'] ) ) $fp['caption'] = '';
 
                if ( empty( $hp['width'] ) ) {
@@ -614,7 +623,7 @@ class Linker {
                # So we don't need to pass it here in $query. However, the URL for the
                # zoom icon still needs it, so we make a unique query for it. See bug 14771
                $url = $title->getLocalURL( $query );
-               if( $page ) { 
+               if( $page ) {
                        $url = wfAppendQuery( $url, 'page=' . urlencode( $page ) );
                }
 
@@ -622,7 +631,7 @@ class Linker {
 
                $s = "<div class=\"thumb t{$fp['align']}\"><div class=\"thumbinner\" style=\"width:{$outerWidth}px;\">";
                if( !$exists ) {
-                       $s .= $this->makeBrokenImageLinkObj( $title, '', '', '', '', $time==true );
+                       $s .= $this->makeBrokenImageLinkObj( $title, $fp['title'], '', '', '', $time==true );
                        $zoomicon = '';
                } elseif ( !$thumb ) {
                        $s .= htmlspecialchars( wfMsg( 'thumbnail_error', '' ) );
@@ -659,26 +668,31 @@ class Linker {
         * @return string
         */
        public function makeBrokenImageLinkObj( $title, $text = '', $query = '', $trail = '', $prefix = '', $time = false ) {
-               global $wgEnableUploads;
+               global $wgEnableUploads, $wgUploadNavigationUrl;
                if( $title instanceof Title ) {
                        wfProfileIn( __METHOD__ );
                        $currentExists = $time ? ( wfFindFile( $title ) != false ) : false;
-                       if( $wgEnableUploads && !$currentExists ) {
-                               $upload = SpecialPage::getTitleFor( 'Upload' );
+                       if( ( $wgUploadNavigationUrl || $wgEnableUploads ) && !$currentExists ) {
                                if( $text == '' )
                                        $text = htmlspecialchars( $title->getPrefixedText() );
+
                                $redir = RepoGroup::singleton()->getLocalRepo()->checkRedirect( $title );
                                if( $redir ) {
+                                       wfProfileOut( __METHOD__ );
                                        return $this->makeKnownLinkObj( $title, $text, $query, $trail, $prefix );
                                }
-                               $q = 'wpDestFile=' . $title->getPartialUrl();
-                               if( $query != '' )
-                                       $q .= '&' . $query;
+                               
+                               $href = $this->getUploadUrl( $title, $query );
+
+
                                list( $inside, $trail ) = self::splitTrail( $trail );
-                               $style = $this->getInternalLinkAttributesObj( $title, $text, 'new' );
+
                                wfProfileOut( __METHOD__ );
-                               return '<a href="' . $upload->escapeLocalUrl( $q ) . '"'
-                                       . $style . '>' . $prefix . $text . $inside . '</a>' . $trail;
+                               return Html::element( 'a', array(
+                                       'href' => $href,
+                                       'class' => 'new',
+                                       'title' => $title->getPrefixedText()
+                               ), $prefix . $text . $inside ) . $trail;
                        } else {
                                wfProfileOut( __METHOD__ );
                                return $this->makeKnownLinkObj( $title, $text, $query, $trail, $prefix );
@@ -687,6 +701,27 @@ class Linker {
                        return "<!-- ERROR -->{$prefix}{$text}{$trail}";
                }
        }
+       
+       /**
+        * Get the URL to upload a certain file
+        * 
+        * @param $destFile Title Title of the file to upload
+        * @param $query string Urlencoded query string to prepend
+        * @return string Urlencoded URL
+        */
+       protected function getUploadUrl( $destFile, $query = '' ) {
+               global $wgUploadNavigationUrl;
+               $q = 'wpDestFile=' . $destFile->getPartialUrl();
+               if( $query != '' )
+                       $q .= '&' . $query;
+
+               if( $wgUploadNavigationUrl ) {
+                       return wfAppendQuery( $wgUploadNavigationUrl, $q );
+               } else {
+                       $upload = SpecialPage::getTitleFor( 'Upload' );
+                       return $upload->getLocalUrl( $q );
+               }       
+       }
 
        /**
         * Create a direct link to a given uploaded file.
@@ -704,13 +739,12 @@ class Linker {
                        ### HOTFIX. Instead of breaking, return empty string.
                        return $text;
                } else {
-                       $img  = wfFindFile( $title, $time );
+                       $img  = wfFindFile( $title, array( 'time' => $time ) );
                        if( $img ) {
                                $url  = $img->getURL();
                                $class = 'internal';
                        } else {
-                               $upload = SpecialPage::getTitleFor( 'Upload' );
-                               $url = $upload->getLocalUrl( 'wpDestFile=' . urlencode( $title->getDBkey() ) );
+                               $url = $this->getUploadUrl( $title );
                                $class = 'new';
                        }
                        $alt = htmlspecialchars( $title->getText() );
@@ -722,11 +756,15 @@ class Linker {
                }
        }
 
-       /** @todo document */
+       /**
+        *  Make a link to a special page given its name and, optionally,
+        * a message key from the link text.
+        * Usage example: $skin->specialLink( 'recentchanges' )
+        */
        function specialLink( $name, $key = '' ) {
                global $wgContLang;
 
-               if ( '' == $key ) { $key = strtolower( $name ); }
+               if ( $key == '' ) { $key = strtolower( $name ); }
                $pn = $wgContLang->ucfirst( $name );
                return $this->makeKnownLink( $wgContLang->specialPage( $pn ),
                  wfMsg( $key ) );
@@ -739,17 +777,20 @@ class Linker {
         * @param boolean $escape Do we escape the link text?
         * @param String $linktype Type of external link. Gets added to the classes
         * @param array $attribs Array of extra attributes to <a>
-        * 
-        * @TODO! @FIXME! This is a really crappy implementation. $linktype and 
+        *
+        * @todo FIXME: This is a really crappy implementation. $linktype and
         * 'external' are mashed into the class attrib for the link (which is made
-        * into a string). Then, if we've got additional params in $attribs, we 
+        * into a string). Then, if we've got additional params in $attribs, we
         * add to it. People using this might want to change the classes (or other
-        * default link attributes), but passing $attribsText is just messy. Would 
-        * make a lot more sense to make put the classes into $attribs, let the 
-        * hook play with them, *then* expand it all at once. 
+        * default link attributes), but passing $attribsText is just messy. Would
+        * make a lot more sense to make put the classes into $attribs, let the
+        * hook play with them, *then* expand it all at once.
         */
        function makeExternalLink( $url, $text, $escape = true, $linktype = '', $attribs = array() ) {
-               $attribsText = $this->getExternalLinkAttributes( $url, $text, 'external ' . $linktype );
+               if ( isset( $attribs[ 'class' ] ) ) $class = $attribs[ 'class' ]; # yet another hack :(
+               else $class =  'external ' . $linktype;
+
+               $attribsText = $this->getExternalLinkAttributes( $class );
                $url = htmlspecialchars( $url );
                if( $escape ) {
                        $text = htmlspecialchars( $text );
@@ -761,7 +802,7 @@ class Linker {
                        return $link;
                }
                if ( $attribs ) {
-                       $attribsText .= Xml::expandAttributes( $attribs );
+                       $attribsText .= Html::expandAttributes( $attribs );
                }
                return '<a href="'.$url.'"'.$attribsText.'>'.$text.'</a>';
        }
@@ -870,7 +911,7 @@ class Linker {
                if( $rev->isDeleted( Revision::DELETED_USER ) && $isPublic ) {
                        $link = wfMsgHtml( 'rev-deleted-user' );
                } else if( $rev->userCan( Revision::DELETED_USER ) ) {
-                       $link = $this->userLink( $rev->getUser( Revision::FOR_THIS_USER ), 
+                       $link = $this->userLink( $rev->getUser( Revision::FOR_THIS_USER ),
                                $rev->getUserText( Revision::FOR_THIS_USER ) );
                } else {
                        $link = wfMsgHtml( 'rev-deleted-user' );
@@ -892,7 +933,7 @@ class Linker {
                        $link = wfMsgHtml( 'rev-deleted-user' );
                } else if( $rev->userCan( Revision::DELETED_USER ) ) {
                        $userId = $rev->getUser( Revision::FOR_THIS_USER );
-                       $userText = $rev->getUserText( Revision::FOR_THIS_USER ); 
+                       $userText = $rev->getUserText( Revision::FOR_THIS_USER );
                        $link = $this->userLink( $userId, $userText ) .
                                ' ' . $this->userToolLinks( $userId, $userText );
                } else {
@@ -920,7 +961,7 @@ class Linker {
         * @param mixed $title Title object (to generate link to the section in autocomment) or null
         * @param bool $local Whether section links should refer to local page
         */
-       function formatComment($comment, $title = NULL, $local = false) {
+       function formatComment($comment, $title = null, $local = false) {
                wfProfileIn( __METHOD__ );
 
                # Sanitize text a bit:
@@ -929,8 +970,8 @@ class Linker {
                $comment = Sanitizer::escapeHtmlAllowEntities( $comment );
 
                # Render autocomments and make links:
-               $comment = $this->formatAutoComments( $comment, $title, $local );
-               $comment = $this->formatLinksInComment( $comment );
+               $comment = $this->formatAutocomments( $comment, $title, $local );
+               $comment = $this->formatLinksInComment( $comment, $title, $local );
 
                wfProfileOut( __METHOD__ );
                return $comment;
@@ -961,16 +1002,16 @@ class Linker {
                unset( $this->autocommentLocal );
                return $comment;
        }
-       
+
        private function formatAutocommentsCallback( $match ) {
                $title = $this->autocommentTitle;
                $local = $this->autocommentLocal;
-               
-               $pre=$match[1];
-               $auto=$match[2];
-               $post=$match[3];
-               $link='';
-               if( $title ) {
+
+               $pre = $match[1];
+               $auto = $match[2];
+               $post = $match[3];
+               $link = '';
+               if ( $title ) {
                        $section = $auto;
 
                        # Generate a valid anchor name from the section title.
@@ -984,7 +1025,7 @@ class Linker {
                        if ( $local ) {
                                $sectionTitle = Title::newFromText( '#' . $section );
                        } else {
-                               $sectionTitle = Title::makeTitleSafe( $title->getNamespace(), 
+                               $sectionTitle = Title::makeTitleSafe( $title->getNamespace(),
                                        $title->getDBkey(), $section );
                        }
                        if ( $sectionTitle ) {
@@ -1013,15 +1054,20 @@ class Linker {
         * Formats wiki links and media links in text; all other wiki formatting
         * is ignored
         *
-        * @fixme doesn't handle sub-links as in image thumb texts like the main parser
+        * @todo Fixme: doesn't handle sub-links as in image thumb texts like the main parser
         * @param string $comment Text to format links in
         * @return string
         */
-       public function formatLinksInComment( $comment ) {
-               return preg_replace_callback(
+       public function formatLinksInComment( $comment, $title = null, $local = false ) {
+               $this->commentContextTitle = $title;
+               $this->commentLocal = $local;
+               $html = preg_replace_callback(
                        '/\[\[:?(.*?)(\|(.*?))*\]\]([^[]*)/',
                        array( $this, 'formatLinksInCommentCallback' ),
                        $comment );
+               unset( $this->commentContextTitle );
+               unset( $this->commentLocal );
+               return $html;
        }
 
        protected function formatLinksInCommentCallback( $match ) {
@@ -1038,12 +1084,13 @@ class Linker {
                }
 
                # Handle link renaming [[foo|text]] will show link as "text"
-               if( "" != $match[3] ) {
+               if( $match[3] != "" ) {
                        $text = $match[3];
                } else {
                        $text = $match[1];
                }
                $submatch = array();
+               $thelink = null;
                if( preg_match( '/^' . $medians . '(.*)$/i', $match[1], $submatch ) ) {
                        # Media link; trail not supported.
                        $linkRegexp = '/\[\[(.*?)\]\]/';
@@ -1060,16 +1107,104 @@ class Linker {
                        if (isset($match[1][0]) && $match[1][0] == ':')
                                $match[1] = substr($match[1], 1);
                        list( $inside, $trail ) = Linker::splitTrail( $trail );
-                       $thelink = $this->link(
-                               Title::newFromText( $match[1] ),
-                               $text . $inside
-                       ) . $trail;
+
+                       $linkText = $text;
+                       $linkTarget = Linker::normalizeSubpageLink( $this->commentContextTitle,
+                               $match[1], $linkText );
+
+                       $target = Title::newFromText( $linkTarget );
+                       if( $target ) {
+                               if( $target->getText() == '' && !$this->commentLocal && $this->commentContextTitle ) {
+                                       $newTarget = clone( $this->commentContextTitle );
+                                       $newTarget->setFragment( '#' . $target->getFragment() );
+                                       $target = $newTarget;
+                               }
+                               $thelink = $this->link(
+                                       $target,
+                                       $linkText . $inside
+                               ) . $trail;
+                       }
+               }
+               if( $thelink ) {
+                       // If the link is still valid, go ahead and replace it in!
+                       $comment = preg_replace( $linkRegexp, StringUtils::escapeRegexReplacement( $thelink ), $comment, 1 );
                }
-               $comment = preg_replace( $linkRegexp, StringUtils::escapeRegexReplacement( $thelink ), $comment, 1 );
 
                return $comment;
        }
 
+       static function normalizeSubpageLink( $contextTitle, $target, &$text ) {
+               # Valid link forms:
+               # Foobar -- normal
+               # :Foobar -- override special treatment of prefix (images, language links)
+               # /Foobar -- convert to CurrentPage/Foobar
+               # /Foobar/ -- convert to CurrentPage/Foobar, strip the initial / from text
+               # ../ -- convert to CurrentPage, from CurrentPage/CurrentSubPage
+               # ../Foobar -- convert to CurrentPage/Foobar, from CurrentPage/CurrentSubPage
+
+               wfProfileIn( __METHOD__ );
+               $ret = $target; # default return value is no change
+
+               # Some namespaces don't allow subpages,
+               # so only perform processing if subpages are allowed
+               if( $contextTitle && MWNamespace::hasSubpages( $contextTitle->getNamespace() ) ) {
+                       $hash = strpos( $target, '#' );
+                       if( $hash !== false ) {
+                               $suffix = substr( $target, $hash );
+                               $target = substr( $target, 0, $hash );
+                       } else {
+                               $suffix = '';
+                       }
+                       # bug 7425
+                       $target = trim( $target );
+                       # Look at the first character
+                       if( $target != '' && $target{0} === '/' ) {
+                               # / at end means we don't want the slash to be shown
+                               $m = array();
+                               $trailingSlashes = preg_match_all( '%(/+)$%', $target, $m );
+                               if( $trailingSlashes ) {
+                                       $noslash = $target = substr( $target, 1, -strlen($m[0][0]) );
+                               } else {
+                                       $noslash = substr( $target, 1 );
+                               }
+
+                               $ret = $contextTitle->getPrefixedText(). '/' . trim($noslash) . $suffix;
+                               if( $text === '' ) {
+                                       $text = $target . $suffix;
+                               } # this might be changed for ugliness reasons
+                       } else {
+                               # check for .. subpage backlinks
+                               $dotdotcount = 0;
+                               $nodotdot = $target;
+                               while( strncmp( $nodotdot, "../", 3 ) == 0 ) {
+                                       ++$dotdotcount;
+                                       $nodotdot = substr( $nodotdot, 3 );
+                               }
+                               if($dotdotcount > 0) {
+                                       $exploded = explode( '/', $contextTitle->GetPrefixedText() );
+                                       if( count( $exploded ) > $dotdotcount ) { # not allowed to go below top level page
+                                               $ret = implode( '/', array_slice( $exploded, 0, -$dotdotcount ) );
+                                               # / at the end means don't show full path
+                                               if( substr( $nodotdot, -1, 1 ) === '/' ) {
+                                                       $nodotdot = substr( $nodotdot, 0, -1 );
+                                                       if( $text === '' ) {
+                                                               $text = $nodotdot . $suffix;
+                                                       }
+                                               }
+                                               $nodotdot = trim( $nodotdot );
+                                               if( $nodotdot != '' ) {
+                                                       $ret .= '/' . $nodotdot;
+                                               }
+                                               $ret .= $suffix;
+                                       }
+                               }
+                       }
+               }
+
+               wfProfileOut( __METHOD__ );
+               return $ret;
+       }
+
        /**
         * Wrap a comment in standard punctuation and formatting if
         * it's non-empty, otherwise return empty string.
@@ -1080,7 +1215,7 @@ class Linker {
         *
         * @return string
         */
-       function commentBlock( $comment, $title = NULL, $local = false ) {
+       function commentBlock( $comment, $title = null, $local = false ) {
                // '*' used to be the comment inserted by the software way back
                // in antiquity in case none was provided, here for backwards
                // compatability, acc. to brion -ævar
@@ -1129,12 +1264,16 @@ class Linker {
                return "<span class=\"history-size\">$stxt</span>";
        }
 
-       /** @todo document */
+       /**
+        * Add another level to the Table of Contents
+        */
        function tocIndent() {
                return "\n<ul>";
        }
 
-       /** @todo document */
+       /**
+        * Finish one or more sublevels on the Table of Contents
+        */
        function tocUnindent($level) {
                return "</li>\n" . str_repeat( "</ul>\n</li>\n", $level>0 ? $level : 0 );
        }
@@ -1152,33 +1291,41 @@ class Linker {
                        $tocline . '</span></a>';
        }
 
-       /** @todo document */
+       /**
+        * End a Table Of Contents line.
+        * tocUnindent() will be used instead if we're ending a line below
+        * the new level.
+        */
        function tocLineEnd() {
                return "</li>\n";
        }
 
-       /** @todo document */
+       /**
+        * Wraps the TOC in a table and provides the hide/collapse javascript.
+        * @param string $toc html of the Table Of Contents
+        * @return string Full html of the TOC
+        */
        function tocList($toc) {
-               global $wgJsMimeType;
                $title = wfMsgHtml('toc') ;
                return
-                  '<table id="toc" class="toc" summary="' . $title .'"><tr><td>'
+                  '<table id="toc" class="toc"><tr><td>'
                 . '<div id="toctitle"><h2>' . $title . "</h2></div>\n"
                 . $toc
                 # no trailing newline, script should not be wrapped in a
                 # paragraph
                 . "</ul>\n</td></tr></table>"
-                . '<script type="' . $wgJsMimeType . '">'
-                . ' if (window.showTocToggle) {'
-                . ' var tocShowText = "' . Xml::escapeJsString( wfMsg('showtoc') ) . '";'
-                . ' var tocHideText = "' . Xml::escapeJsString( wfMsg('hidetoc') ) . '";'
-                . ' showTocToggle();'
-                . ' } '
-                . "</script>\n";
+                . Html::inlineScript(
+                       'if (window.showTocToggle) {'
+                       . ' var tocShowText = "' . Xml::escapeJsString( wfMsg('showtoc') ) . '";'
+                       . ' var tocHideText = "' . Xml::escapeJsString( wfMsg('hidetoc') ) . '";'
+                       . ' showTocToggle();'
+                       . ' } ' )
+               . "\n";
        }
-       
+
        /**
         * Generate a table of contents from a section tree
+        * Currently unused.
         * @param $tree Return value of ParserOutput::getSections()
         * @return string HTML
         */
@@ -1188,12 +1335,12 @@ class Linker {
                foreach ( $tree as $section ) {
                        if ( $section['toclevel'] > $lastLevel )
                                $toc .= $this->tocIndent();
-                       else if ( $secton['toclevel'] < $lastLevel )
+                       else if ( $section['toclevel'] < $lastLevel )
                                $toc .= $this->tocUnindent(
                                        $lastLevel - $section['toclevel'] );
                        else
                                $toc .= $this->tocLineEnd();
-                       
+
                        $toc .= $this->tocLine( $section['anchor'],
                                $section['line'], $section['number'],
                                $section['toclevel'], $section['index'] );
@@ -1216,6 +1363,8 @@ class Linker {
         * @return         string HTML to use for edit link
         */
        public function doEditSectionLink( Title $nt, $section, $tooltip = null ) {
+               // HTML generated here should probably have userlangattributes
+               // added to it for LTR text on RTL pages
                $attribs = array();
                if( !is_null( $tooltip ) ) {
                        $attribs['title'] = wfMsg( 'editsectionhint', $tooltip );
@@ -1268,12 +1417,12 @@ class Linker {
         * @return string HTML headline
         */
        public function makeHeadline( $level, $attribs, $anchor, $text, $link, $legacyAnchor = false ) {
-               $ret = "<div class=\"mw-h$level\">"
-                       . "<a name=\"$anchor\" id=\"$anchor\"></a>"
-                       . "<h$level$attribs$text</h$level>"
-                       . "$link </div>";
+               $ret = "<h$level$attribs"
+                       . $link
+                       . " <span class=\"mw-headline\" id=\"$anchor\">$text</span>"
+                       . "</h$level>";
                if ( $legacyAnchor !== false ) {
-                       $ret = "<a name=\"$legacyAnchor\" id=\"$legacyAnchor\"></a>$ret";
+                       $ret = "<a id=\"$legacyAnchor\"></a>$ret";
                }
                return $ret;
        }
@@ -1291,7 +1440,7 @@ class Linker {
                        $regex = $wgContLang->linkTrail();
                }
                $inside = '';
-               if ( '' != $trail ) {
+               if ( $trail != '' ) {
                        $m = array();
                        if ( preg_match( $regex, $trail, $m ) ) {
                                $inside = $m[1];
@@ -1368,11 +1517,11 @@ class Linker {
                        # Construct the HTML
                        $outText = '<div class="mw-templatesUsedExplanation">';
                        if ( $preview ) {
-                               $outText .= wfMsgExt( 'templatesusedpreview', array( 'parse' ) );
+                               $outText .= wfMsgExt( 'templatesusedpreview', array( 'parse' ), count( $templates ) );
                        } elseif ( $section ) {
-                               $outText .= wfMsgExt( 'templatesusedsection', array( 'parse' ) );
+                               $outText .= wfMsgExt( 'templatesusedsection', array( 'parse' ), count( $templates ) );
                        } else {
-                               $outText .= wfMsgExt( 'templatesused', array( 'parse' ) );
+                               $outText .= wfMsgExt( 'templatesused', array( 'parse' ), count( $templates ) );
                        }
                        $outText .= "</div><ul>\n";
 
@@ -1513,24 +1662,38 @@ class Linker {
                wfProfileOut( __METHOD__ );
                return false;
        }
-       
+
        /**
         * Creates a (show/hide) link for deleting revisions/log entries
         *
         * @param array $query  Query parameters to be passed to link()
         * @param bool $restricted  Set to true to use a <strong> instead of a <span>
+        * @param bool $delete Set to true to use (show/hide) rather than (show)
         *
         * @return string HTML <a> link to Special:Revisiondelete, wrapped in a
         * span to allow for customization of appearance with CSS
         */
-       public function revDeleteLink( $query = array(), $restricted = false ) {
+       public function revDeleteLink( $query = array(), $restricted = false, $delete = true ) {
                $sp = SpecialPage::getTitleFor( 'Revisiondelete' );
-               $text = wfMsgHtml( 'rev-delundel' );
+               $text = $delete ? wfMsgHtml( 'rev-delundel' ) : wfMsgHtml( 'rev-showdeleted' );
                $tag = $restricted ? 'strong' : 'span';
                $link = $this->link( $sp, $text, array(), $query, array( 'known', 'noclasses' ) );
                return Xml::tags( $tag, array( 'class' => 'mw-revdelundel-link' ), "($link)" );
        }
 
+       /**
+        * Creates a dead (show/hide) link for deleting revisions/log entries
+        *
+        * @param bool $delete Set to true to use (show/hide) rather than (show)
+        *
+        * @return string HTML text wrapped in a span to allow for customization
+        * of appearance with CSS
+        */
+       public function revDeleteLinkDisabled( $delete = true ) {
+               $text = $delete ? wfMsgHtml( 'rev-delundel' ) : wfMsgHtml( 'rev-showdeleted' );
+               return Xml::tags( 'span', array( 'class' => 'mw-revdelundel-link' ), "($text)" );
+       }
+
        /* Deprecated methods */
 
        /**
@@ -1812,7 +1975,7 @@ class Linker {
                if ( $valign ) {
                        $frameParams['valign'] = $valign;
                }
-               $file = wfFindFile( $title, $time );
+               $file = wfFindFile( $title, array( 'time' => $time ) );
                return $this->makeImageLink2( $title, $file, $frameParams, $handlerParams, $time );
        }
 
@@ -1853,9 +2016,12 @@ class Linker {
        }
 
        /**
-        * @deprecated Returns raw bits of HTML, use titleAttrib() and accesskey()
+        * Returns the attributes for the tooltip and access key
         */
-       public function tooltipAndAccesskey( $name ) {
+       public function tooltipAndAccesskeyAttribs( $name ) {
+               global $wgEnableTooltipsAndAccesskeys;
+               if ( !$wgEnableTooltipsAndAccesskeys )
+                       return array();
                # FIXME: If Sanitizer::expandAttributes() treated "false" as "output
                # no attribute" instead of "output '' as value for attribute", this
                # would be three lines.
@@ -1869,11 +2035,21 @@ class Linker {
                if ( $attribs['accesskey'] === false ) {
                        unset( $attribs['accesskey'] );
                }
-               return Xml::expandAttributes( $attribs );
+               return $attribs;
+       }
+       /**
+        * @deprecated Returns raw bits of HTML, use titleAttrib() and accesskey()
+        */
+       public function tooltipAndAccesskey( $name ) {
+               return Xml::expandAttributes( $this->tooltipAndAccesskeyAttribs( $name ) );
        }
 
+
        /** @deprecated Returns raw bits of HTML, use titleAttrib() */
        public function tooltip( $name, $options = null ) {
+               global $wgEnableTooltipsAndAccesskeys;
+               if ( !$wgEnableTooltipsAndAccesskeys )
+                       return '';
                # FIXME: If Sanitizer::expandAttributes() treated "false" as "output
                # no attribute" instead of "output '' as value for attribute", this
                # would be two lines.