Fix bug 2642 : watchdetails message using HTML instead of wiki syntax. Patch by zigge...
[lhc/web/wiklou.git] / includes / Linker.php
1 <?php
2 /**
3 * Split off some of the internal bits from Skin.php.
4 * These functions are used for primarily page content:
5 * links, embedded images, table of contents. Links are
6 * also used in the skin.
7 * @package MediaWiki
8 */
9
10 /**
11 * For the moment, Skin is a descendent class of Linker.
12 * In the future, it should probably be further split
13 * so that ever other bit of the wiki doesn't have to
14 * go loading up Skin to get at it.
15 *
16 * @package MediaWiki
17 */
18 class Linker {
19
20 function Linker() {}
21
22 /**
23 * OBSOLETE
24 */
25 function postParseLinkColour( $s = NULL ) {
26 return NULL;
27 }
28
29 /** @todo document */
30 function getExternalLinkAttributes( $link, $text, $class='' ) {
31 global $wgContLang;
32
33 $same = ($link == $text);
34 $link = urldecode( $link );
35 $link = $wgContLang->checkTitleEncoding( $link );
36 $link = preg_replace( '/[\\x00-\\x1f_]/', ' ', $link );
37 $link = htmlspecialchars( $link );
38
39 $r = ($class != '') ? " class='$class'" : " class='external'";
40
41 $r .= " title=\"{$link}\"";
42 return $r;
43 }
44
45 /** @todo document */
46 function getInternalLinkAttributes( $link, $text, $broken = false ) {
47 $link = urldecode( $link );
48 $link = str_replace( '_', ' ', $link );
49 $link = htmlspecialchars( $link );
50
51 if( $broken == 'stub' ) {
52 $r = ' class="stub"';
53 } else if ( $broken == 'yes' ) {
54 $r = ' class="new"';
55 } else {
56 $r = '';
57 }
58
59 $r .= " title=\"{$link}\"";
60 return $r;
61 }
62
63 /**
64 * @param bool $broken
65 */
66 function getInternalLinkAttributesObj( &$nt, $text, $broken = false ) {
67 if( $broken == 'stub' ) {
68 $r = ' class="stub"';
69 } else if ( $broken == 'yes' ) {
70 $r = ' class="new"';
71 } else {
72 $r = '';
73 }
74
75 $r .= ' title="' . $nt->getEscapedText() . '"';
76 return $r;
77 }
78
79 /**
80 * Note: This function MUST call getArticleID() on the link,
81 * otherwise the cache won't get updated properly. See LINKCACHE.DOC.
82 */
83 function makeLink( $title, $text = '', $query = '', $trail = '' ) {
84 wfProfileIn( 'Linker::makeLink' );
85 $nt = Title::newFromText( $title );
86 if ($nt) {
87 $result = $this->makeLinkObj( Title::newFromText( $title ), $text, $query, $trail );
88 } else {
89 wfDebug( 'Invalid title passed to Linker::makeLink(): "'.$title."\"\n" );
90 $result = $text == "" ? $title : $text;
91 }
92
93 wfProfileOut( 'Linker::makeLink' );
94 return $result;
95 }
96
97 /** @todo document */
98 function makeKnownLink( $title, $text = '', $query = '', $trail = '', $prefix = '',$aprops = '') {
99 $nt = Title::newFromText( $title );
100 if ($nt) {
101 return $this->makeKnownLinkObj( Title::newFromText( $title ), $text, $query, $trail, $prefix , $aprops );
102 } else {
103 wfDebug( 'Invalid title passed to Linker::makeKnownLink(): "'.$title."\"\n" );
104 return $text == '' ? $title : $text;
105 }
106 }
107
108 /** @todo document */
109 function makeBrokenLink( $title, $text = '', $query = '', $trail = '' ) {
110 $nt = Title::newFromText( $title );
111 if ($nt) {
112 return $this->makeBrokenLinkObj( Title::newFromText( $title ), $text, $query, $trail );
113 } else {
114 wfDebug( 'Invalid title passed to Linker::makeBrokenLink(): "'.$title."\"\n" );
115 return $text == '' ? $title : $text;
116 }
117 }
118
119 /** @todo document */
120 function makeStubLink( $title, $text = '', $query = '', $trail = '' ) {
121 $nt = Title::newFromText( $title );
122 if ($nt) {
123 return $this->makeStubLinkObj( Title::newFromText( $title ), $text, $query, $trail );
124 } else {
125 wfDebug( 'Invalid title passed to Linker::makeStubLink(): "'.$title."\"\n" );
126 return $text == '' ? $title : $text;
127 }
128 }
129
130 /**
131 * Pass a title object, not a title string
132 */
133 function makeLinkObj( &$nt, $text= '', $query = '', $trail = '', $prefix = '' ) {
134 global $wgOut, $wgUser;
135 $fname = 'Linker::makeLinkObj';
136 wfProfileIn( $fname );
137
138 # Fail gracefully
139 if ( ! is_object($nt) ) {
140 # wfDebugDieBacktrace();
141 wfProfileOut( $fname );
142 return "<!-- ERROR -->{$prefix}{$text}{$trail}";
143 }
144
145 $ns = $nt->getNamespace();
146 $dbkey = $nt->getDBkey();
147 if ( $nt->isExternal() ) {
148 $u = $nt->getFullURL();
149 $link = $nt->getPrefixedURL();
150 if ( '' == $text ) { $text = $nt->getPrefixedText(); }
151 $style = $this->getExternalLinkAttributes( $link, $text, 'extiw' );
152
153 $inside = '';
154 if ( '' != $trail ) {
155 if ( preg_match( '/^([a-z]+)(.*)$$/sD', $trail, $m ) ) {
156 $inside = $m[1];
157 $trail = $m[2];
158 }
159 }
160
161 # Check for anchors, normalize the anchor
162
163 $parts = explode( '#', $u, 2 );
164 if ( count( $parts ) == 2 ) {
165 $anchor = urlencode( Sanitizer::decodeCharReferences( str_replace(' ', '_', $parts[1] ) ) );
166 $replacearray = array(
167 '%3A' => ':',
168 '%' => '.'
169 );
170 $u = $parts[0] . '#' .
171 str_replace( array_keys( $replacearray ),
172 array_values( $replacearray ),
173 $anchor );
174 }
175
176 $t = "<a href=\"{$u}\"{$style}>{$text}{$inside}</a>";
177
178 wfProfileOut( $fname );
179 return $t;
180 } elseif ( $nt->isAlwaysKnown() ) {
181 # Image links, special page links and self-links with fragements are always known.
182 $retVal = $this->makeKnownLinkObj( $nt, $text, $query, $trail, $prefix );
183 } else {
184 wfProfileIn( $fname.'-immediate' );
185 # Work out link colour immediately
186 $aid = $nt->getArticleID() ;
187 if ( 0 == $aid ) {
188 $retVal = $this->makeBrokenLinkObj( $nt, $text, $query, $trail, $prefix );
189 } else {
190 $threshold = $wgUser->getOption('stubthreshold') ;
191 if ( $threshold > 0 ) {
192 $dbr =& wfGetDB( DB_SLAVE );
193 $s = $dbr->selectRow(
194 array( 'page' ),
195 array( 'page_len',
196 'page_namespace',
197 'page_is_redirect' ),
198 array( 'page_id' => $aid ), $fname ) ;
199 if ( $s !== false ) {
200 $size = $s->page_len;
201 if ( $s->page_is_redirect OR $s->page_namespace != NS_MAIN ) {
202 $size = $threshold*2 ; # Really big
203 }
204 } else {
205 $size = $threshold*2 ; # Really big
206 }
207 } else {
208 $size = 1 ;
209 }
210 if ( $size < $threshold ) {
211 $retVal = $this->makeStubLinkObj( $nt, $text, $query, $trail, $prefix );
212 } else {
213 $retVal = $this->makeKnownLinkObj( $nt, $text, $query, $trail, $prefix );
214 }
215 }
216 wfProfileOut( $fname.'-immediate' );
217 }
218 wfProfileOut( $fname );
219 return $retVal;
220 }
221
222 /**
223 * Pass a title object, not a title string
224 */
225 function makeKnownLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' , $aprops = '' ) {
226 global $wgOut, $wgTitle;
227
228 $fname = 'Linker::makeKnownLinkObj';
229 wfProfileIn( $fname );
230
231 if ( !is_object( $nt ) ) {
232 wfProfileOut( $fname );
233 return $text;
234 }
235
236 $u = $nt->escapeLocalURL( $query );
237 if ( '' != $nt->getFragment() ) {
238 if( $nt->getPrefixedDbkey() == '' ) {
239 $u = '';
240 if ( '' == $text ) {
241 $text = htmlspecialchars( $nt->getFragment() );
242 }
243 }
244 $anchor = urlencode( Sanitizer::decodeCharReferences( str_replace( ' ', '_', $nt->getFragment() ) ) );
245 $replacearray = array(
246 '%3A' => ':',
247 '%' => '.'
248 );
249 $u .= '#' . str_replace(array_keys($replacearray),array_values($replacearray),$anchor);
250 }
251 if ( '' == $text ) {
252 $text = htmlspecialchars( $nt->getPrefixedText() );
253 }
254 $style = $this->getInternalLinkAttributesObj( $nt, $text );
255
256 list( $inside, $trail ) = Linker::splitTrail( $trail );
257 $r = "<a href=\"{$u}\"{$style}{$aprops}>{$prefix}{$text}{$inside}</a>{$trail}";
258 wfProfileOut( $fname );
259 return $r;
260 }
261
262 /**
263 * Pass a title object, not a title string
264 */
265 function makeBrokenLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
266 # Fail gracefully
267 if ( ! isset($nt) ) {
268 # wfDebugDieBacktrace();
269 return "<!-- ERROR -->{$prefix}{$text}{$trail}";
270 }
271
272 $fname = 'Linker::makeBrokenLinkObj';
273 wfProfileIn( $fname );
274
275 if ( '' == $query ) {
276 $q = 'action=edit';
277 } else {
278 $q = 'action=edit&'.$query;
279 }
280 $u = $nt->escapeLocalURL( $q );
281
282 if ( '' == $text ) {
283 $text = htmlspecialchars( $nt->getPrefixedText() );
284 }
285 $style = $this->getInternalLinkAttributesObj( $nt, $text, "yes" );
286
287 list( $inside, $trail ) = Linker::splitTrail( $trail );
288 $s = "<a href=\"{$u}\"{$style}>{$prefix}{$text}{$inside}</a>{$trail}";
289
290 wfProfileOut( $fname );
291 return $s;
292 }
293
294 /**
295 * Pass a title object, not a title string
296 */
297 function makeStubLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
298 $link = $nt->getPrefixedURL();
299
300 $u = $nt->escapeLocalURL( $query );
301
302 if ( '' == $text ) {
303 $text = htmlspecialchars( $nt->getPrefixedText() );
304 }
305 $style = $this->getInternalLinkAttributesObj( $nt, $text, 'stub' );
306
307 list( $inside, $trail ) = Linker::splitTrail( $trail );
308 $s = "<a href=\"{$u}\"{$style}>{$prefix}{$text}{$inside}</a>{$trail}";
309 return $s;
310 }
311
312 /**
313 * Generate either a normal exists-style link or a stub link, depending
314 * on the given page size.
315 *
316 * @param int $size
317 * @param Title $nt
318 * @param string $text
319 * @param string $query
320 * @param string $trail
321 * @param string $prefix
322 * @return string HTML of link
323 */
324 function makeSizeLinkObj( $size, $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
325 global $wgUser;
326 $threshold = IntVal( $wgUser->getOption( 'stubthreshold' ) );
327 if( $size < $threshold ) {
328 return $this->makeStubLinkObj( $nt, $text, $query, $trail, $prefix );
329 } else {
330 return $this->makeKnownLinkObj( $nt, $text, $query, $trail, $prefix );
331 }
332 }
333
334 /** @todo document */
335 function makeSelfLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
336 $u = $nt->escapeLocalURL( $query );
337 if ( '' == $text ) {
338 $text = htmlspecialchars( $nt->getPrefixedText() );
339 }
340 list( $inside, $trail ) = Linker::splitTrail( $trail );
341 return "<strong>{$prefix}{$text}{$inside}</strong>{$trail}";
342 }
343
344 /** @todo document */
345 function fnamePart( $url ) {
346 $basename = strrchr( $url, '/' );
347 if ( false === $basename ) {
348 $basename = $url;
349 } else {
350 $basename = substr( $basename, 1 );
351 }
352 return htmlspecialchars( $basename );
353 }
354
355 /** Obsolete alias */
356 function makeImage( $url, $alt = '' ) {
357 return $this->makeExternalImage( $url, $alt );
358 }
359
360 /** @todo document */
361 function makeExternalImage( $url, $alt = '' ) {
362 global $wgOut;
363 if ( '' == $alt ) {
364 $alt = $this->fnamePart( $url );
365 }
366 $s = '<img src="'.$url.'" alt="'.$alt.'" />';
367 return $s;
368 }
369
370 /** @todo document */
371 function makeImageLinkObj( &$nt, $label, $alt, $align = '', $width = false, $height = false, $framed = false,
372 $thumb = false, $manual_thumb = '' )
373 {
374 global $wgContLang, $wgUser, $wgThumbLimits;
375
376 $img = new Image( $nt );
377 $url = $img->getViewURL();
378 $prefix = $postfix = '';
379
380 if ( 'center' == $align )
381 {
382 $prefix = '<div class="center">';
383 $postfix = '</div>';
384 $align = 'none';
385 }
386
387 if ( $thumb || $framed ) {
388
389 # Create a thumbnail. Alignment depends on language
390 # writing direction, # right aligned for left-to-right-
391 # languages ("Western languages"), left-aligned
392 # for right-to-left-languages ("Semitic languages")
393 #
394 # If thumbnail width has not been provided, it is set
395 # to the default user option as specified in Language*.php
396 if ( $align == '' ) {
397 $align = $wgContLang->isRTL() ? 'left' : 'right';
398 }
399
400
401 if ( $width === false ) {
402 $wopt = $wgUser->getOption( 'thumbsize' );
403
404 if( !isset( $wgThumbLimits[$wopt] ) ) {
405 $wopt = User::getDefaultOption( 'thumbsize' );
406 }
407
408 $width = $wgThumbLimits[$wopt];
409 }
410
411 return $prefix.$this->makeThumbLinkObj( $img, $label, $alt, $align, $width, $height, $framed, $manual_thumb ).$postfix;
412
413 } elseif ( $width ) {
414
415 # Create a resized image, without the additional thumbnail
416 # features
417
418 if ( $height !== false && ( $img->getHeight() * $width / $img->getWidth() > $height ) ) {
419 $width = $img->getWidth() * $height / $img->getHeight();
420 }
421 if ( '' == $manual_thumb ) {
422 $thumb = $img->getThumbnail( $width );
423 if ( $thumb ) {
424 $height = $thumb->height;
425 $url = $thumb->getUrl( );
426 }
427 }
428 }
429
430 $u = $nt->escapeLocalURL();
431 if ( $url == '' ) {
432 $s = $this->makeBrokenImageLinkObj( $img->getTitle() );
433 //$s .= "<br />{$alt}<br />{$url}<br />\n";
434 } else {
435 $s = '<a href="'.$u.'" class="image" title="'.$alt.'">' .
436 '<img src="'.$url.'" alt="'.$alt.'" ' .
437 ( $width
438 ? ( 'width="'.$width.'" height="'.$height.'" ' )
439 : '' ) .
440 'longdesc="'.$u.'" /></a>';
441 }
442 if ( '' != $align ) {
443 $s = "<div class=\"float{$align}\"><span>{$s}</span></div>";
444 }
445 return str_replace("\n", ' ',$prefix.$s.$postfix);
446 }
447
448 /**
449 * Make HTML for a thumbnail including image, border and caption
450 * $img is an Image object
451 */
452 function makeThumbLinkObj( $img, $label = '', $alt, $align = 'right', $boxwidth = 180, $boxheight=false, $framed=false , $manual_thumb = "" ) {
453 global $wgStylePath, $wgContLang;
454 $url = $img->getViewURL();
455
456 $width = $height = 0;
457 if ( $img->exists() )
458 {
459 $width = $img->getWidth();
460 $height = $img->getHeight();
461 }
462 if ( 0 == $width || 0 == $height )
463 {
464 $width = $height = 200;
465 }
466 if ( $boxwidth == 0 )
467 {
468 $boxwidth = 200;
469 }
470 if ( $framed )
471 {
472 // Use image dimensions, don't scale
473 $boxwidth = $width;
474 $oboxwidth = $boxwidth + 2;
475 $boxheight = $height;
476 $thumbUrl = $url;
477 } else {
478 $h = intval( $height/($width/$boxwidth) );
479 $oboxwidth = $boxwidth + 2;
480 if ( ( ! $boxheight === false ) && ( $h > $boxheight ) )
481 {
482 $boxwidth *= $boxheight/$h;
483 } else {
484 $boxheight = $h;
485 }
486 if ( '' == $manual_thumb ) $thumbUrl = $img->createThumb( $boxwidth );
487 }
488
489 if ( $manual_thumb != '' ) # Use manually specified thumbnail
490 {
491 $manual_title = Title::makeTitleSafe( NS_IMAGE, $manual_thumb ); #new Title ( $manual_thumb ) ;
492 $manual_img = new Image( $manual_title );
493 $thumbUrl = $manual_img->getViewURL();
494 if ( $manual_img->exists() )
495 {
496 $width = $manual_img->getWidth();
497 $height = $manual_img->getHeight();
498 $boxwidth = $width ;
499 $boxheight = $height ;
500 $oboxwidth = $boxwidth + 2 ;
501 }
502 }
503
504 $u = $img->getEscapeLocalURL();
505
506 $more = htmlspecialchars( wfMsg( 'thumbnail-more' ) );
507 $magnifyalign = $wgContLang->isRTL() ? 'left' : 'right';
508 $textalign = $wgContLang->isRTL() ? ' style="text-align:right"' : '';
509
510 $s = "<div class=\"thumb t{$align}\"><div style=\"width:{$oboxwidth}px;\">";
511 if ( $thumbUrl == '' ) {
512 $s .= $this->makeBrokenImageLinkObj( $img->getTitle );
513 $zoomicon = '';
514 } else {
515 $s .= '<a href="'.$u.'" class="internal" title="'.$alt.'">'.
516 '<img src="'.$thumbUrl.'" alt="'.$alt.'" ' .
517 'width="'.$boxwidth.'" height="'.$boxheight.'" ' .
518 'longdesc="'.$u.'" /></a>';
519 if ( $framed ) {
520 $zoomicon="";
521 } else {
522 $zoomicon = '<div class="magnify" style="float:'.$magnifyalign.'">'.
523 '<a href="'.$u.'" class="internal" title="'.$more.'">'.
524 '<img src="'.$wgStylePath.'/common/images/magnify-clip.png" ' .
525 'width="15" height="11" alt="'.$more.'" /></a></div>';
526 }
527 }
528 $s .= ' <div class="thumbcaption" '.$textalign.'>'.$zoomicon.$label."</div></div></div>";
529 return str_replace("\n", ' ', $s);
530 }
531
532 /**
533 * Pass a title object, not a title string
534 */
535 function makeBrokenImageLinkObj( &$nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
536 # Fail gracefully
537 if ( ! isset($nt) ) {
538 # wfDebugDieBacktrace();
539 return "<!-- ERROR -->{$prefix}{$text}{$trail}";
540 }
541
542 $fname = 'Linker::makeBrokenImageLinkObj';
543 wfProfileIn( $fname );
544
545 $q = 'wpDestFile=' . urlencode( $nt->getDBkey() );
546 if ( '' != $query ) {
547 $q .= "&$query";
548 }
549 $uploadTitle = Title::makeTitle( NS_SPECIAL, 'Upload' );
550 $url = $uploadTitle->escapeLocalURL( $q );
551
552 if ( '' == $text ) {
553 $text = htmlspecialchars( $nt->getPrefixedText() );
554 }
555 $style = $this->getInternalLinkAttributesObj( $nt, $text, "yes" );
556 list( $inside, $trail ) = Linker::splitTrail( $trail );
557 $s = "<a href=\"{$url}\"{$style}>{$prefix}{$text}{$inside}</a>{$trail}";
558
559 wfProfileOut( $fname );
560 return $s;
561 }
562
563 /** @todo document */
564 function makeMediaLink( $name, $url, $alt = '' ) {
565 $nt = Title::makeTitleSafe( NS_IMAGE, $name );
566 return $this->makeMediaLinkObj( $nt, $alt );
567 }
568
569 /**
570 * Create a direct link to a given uploaded file.
571 *
572 * @param Title $title
573 * @param string $text pre-sanitized HTML
574 * @param bool $nourl Mask absolute URLs, so the parser doesn't
575 * linkify them (it is currently not context-aware)
576 * @return string HTML
577 *
578 * @access public
579 * @todo Handle invalid or missing images better.
580 */
581 function makeMediaLinkObj( $title, $text = '', $nourl=false ) {
582 if( is_null( $title ) ) {
583 ### HOTFIX. Instead of breaking, return empty string.
584 return $text;
585 } else {
586 $name = $title->getDBKey();
587 $img = new Image( $title );
588 if( $img->exists() ) {
589 $url = $img->getURL();
590 if( $nourl ) {
591 $url = str_replace( "http://", "http-noparse://", $url );
592 }
593 $class = 'internal';
594 } else {
595 $upload = Title::makeTitle( NS_SPECIAL, 'Upload' );
596 $url = $upload->getLocalUrl( 'wpDestFile=' . urlencode( $img->getName() ) );
597 $class = 'new';
598 }
599 $alt = htmlspecialchars( $title->getText() );
600 if( $text == '' ) {
601 $text = $alt;
602 }
603 $u = htmlspecialchars( $url );
604 return "<a href=\"{$u}\" class='$class' title=\"{$alt}\">{$text}</a>";
605 }
606 }
607
608 /** @todo document */
609 function specialLink( $name, $key = '' ) {
610 global $wgContLang;
611
612 if ( '' == $key ) { $key = strtolower( $name ); }
613 $pn = $wgContLang->ucfirst( $name );
614 return $this->makeKnownLink( $wgContLang->specialPage( $pn ),
615 wfMsg( $key ) );
616 }
617
618 /** @todo document */
619 function makeExternalLink( $url, $text, $escape = true, $linktype = '' ) {
620 $style = $this->getExternalLinkAttributes( $url, $text, 'external ' . $linktype );
621 global $wgNoFollowLinks;
622 if( $wgNoFollowLinks ) {
623 $style .= ' rel="nofollow"';
624 }
625 $url = htmlspecialchars( $url );
626 if( $escape ) {
627 $text = htmlspecialchars( $text );
628 }
629 return '<a href="'.$url.'"'.$style.'>'.$text.'</a>';
630 }
631
632 /**
633 * This function is called by all recent changes variants, by the page history,
634 * and by the user contributions list. It is responsible for formatting edit
635 * comments. It escapes any HTML in the comment, but adds some CSS to format
636 * auto-generated comments (from section editing) and formats [[wikilinks]].
637 *
638 * The &$title parameter must be a title OBJECT. It is used to generate a
639 * direct link to the section in the autocomment.
640 * @author Erik Moeller <moeller@scireview.de>
641 *
642 * Note: there's not always a title to pass to this function.
643 * Since you can't set a default parameter for a reference, I've turned it
644 * temporarily to a value pass. Should be adjusted further. --brion
645 */
646 function formatComment($comment, $title = NULL) {
647 $fname = 'Linker::formatComment';
648 wfProfileIn( $fname );
649
650 global $wgContLang;
651 $comment = str_replace( "\n", " ", $comment );
652 $comment = htmlspecialchars( $comment );
653
654 # The pattern for autogen comments is / * foo * /, which makes for
655 # some nasty regex.
656 # We look for all comments, match any text before and after the comment,
657 # add a separator where needed and format the comment itself with CSS
658 while (preg_match('/(.*)\/\*\s*(.*?)\s*\*\/(.*)/', $comment,$match)) {
659 $pre=$match[1];
660 $auto=$match[2];
661 $post=$match[3];
662 $link='';
663 if($title) {
664 $section=$auto;
665
666 # This is hackish but should work in most cases.
667 $section=str_replace('[[','',$section);
668 $section=str_replace(']]','',$section);
669 $title->mFragment=$section;
670 $link=$this->makeKnownLinkObj($title,wfMsg('sectionlink'));
671 }
672 $sep='-';
673 $auto=$link.$auto;
674 if($pre) { $auto = $sep.' '.$auto; }
675 if($post) { $auto .= ' '.$sep; }
676 $auto='<span class="autocomment">'.$auto.'</span>';
677 $comment=$pre.$auto.$post;
678 }
679
680 # format regular and media links - all other wiki formatting
681 # is ignored
682 $medians = $wgContLang->getNsText( NS_MEDIA ) . ':';
683 while(preg_match('/\[\[(.*?)(\|(.*?))*\]\](.*)$/',$comment,$match)) {
684 # Handle link renaming [[foo|text]] will show link as "text"
685 if( "" != $match[3] ) {
686 $text = $match[3];
687 } else {
688 $text = $match[1];
689 }
690 if( preg_match( '/^' . $medians . '(.*)$/i', $match[1], $submatch ) ) {
691 # Media link; trail not supported.
692 $linkRegexp = '/\[\[(.*?)\]\]/';
693 $thelink = $this->makeMediaLink( $submatch[1], "", $text );
694 } else {
695 # Other kind of link
696 if( preg_match( wfMsgForContent( "linktrail" ), $match[4], $submatch ) ) {
697 $trail = $submatch[1];
698 } else {
699 $trail = "";
700 }
701 $linkRegexp = '/\[\[(.*?)\]\]' . preg_quote( $trail, '/' ) . '/';
702 if ($match[1][0] == ':')
703 $match[1] = substr($match[1], 1);
704 $thelink = $this->makeLink( $match[1], $text, "", $trail );
705 }
706 $comment = preg_replace( $linkRegexp, $thelink, $comment, 1 );
707 }
708 wfProfileOut( $fname );
709 return $comment;
710 }
711
712 /**
713 * Wrap a comment in standard punctuation and formatting if
714 * it's non-empty, otherwise return empty string.
715 *
716 * @param string $comment
717 * @param Title $title
718 * @return string
719 * @access public
720 */
721 function commentBlock( $comment, $title = NULL ) {
722 if( $comment == '' || $comment == '*' ) {
723 return '';
724 } else {
725 $formatted = $this->formatComment( $comment, $title );
726 return " <span class='comment'>($formatted)</span>";
727 }
728 }
729
730 /** @todo document */
731 function tocIndent() {
732 return "\n<ul>";
733 }
734
735 /** @todo document */
736 function tocUnindent($level) {
737 return "</li>\n" . str_repeat( "</ul>\n</li>\n", $level>0 ? $level : 0 );
738 }
739
740 /**
741 * parameter level defines if we are on an indentation level
742 */
743 function tocLine( $anchor, $tocline, $tocnumber, $level ) {
744 return "\n<li class='toclevel-$level'><a href=\"#" .
745 $anchor . '"><span class="tocnumber">' .
746 $tocnumber . '</span> <span class="toctext">' .
747 $tocline . '</span></a>';
748 }
749
750 /** @todo document */
751 function tocLineEnd() {
752 return "</li>\n";
753 }
754
755 /** @todo document */
756 function tocList($toc) {
757 global $wgJsMimeType;
758 return "<table id='toc' class='toc'><tr><td>"
759 . "<div id='toctitle'><h2>" . wfMsgForContent('toc') . "</h2></div>\n"
760 . $toc
761 . "</ul>\n</td></tr></table>\n"
762 . '<script type="'.$wgJsMimeType.'">'
763 . ' if (window.showTocToggle) {'
764 . ' var tocShowText = "' . wfEscapeJsString( wfMsgForContent('showtoc') ) . '";'
765 . ' var tocHideText = "' . wfEscapeJsString( wfMsgForContent('hidetoc') ) . '";'
766 . ' showTocToggle();'
767 . ' } '
768 . "</script>\n";
769 }
770
771 /** @todo document */
772 function editSectionLinkForOther( $title, $section ) {
773 global $wgRequest;
774 global $wgContLang;
775
776 $title = Title::newFromText($title);
777 $editurl = '&section='.$section;
778 $url = $this->makeKnownLink($title->getPrefixedText(),wfMsg('editsection'),'action=edit'.$editurl);
779
780 if( $wgContLang->isRTL() ) {
781 $farside = 'left';
782 $nearside = 'right';
783 } else {
784 $farside = 'right';
785 $nearside = 'left';
786 }
787 return "<div class=\"editsection\" style=\"float:$farside;margin-$nearside:5px;\">[".$url."]</div>";
788
789 }
790
791 /** @todo document */
792 function editSectionLink( $nt, $section ) {
793 global $wgContLang;
794
795 $editurl = '&section='.$section;
796 $url = $this->makeKnownLink($nt->getPrefixedText(),wfMsg('editsection'),'action=edit'.$editurl);
797
798 if( $wgContLang->isRTL() ) {
799 $farside = 'left';
800 $nearside = 'right';
801 } else {
802 $farside = 'right';
803 $nearside = 'left';
804 }
805 return "<div class=\"editsection\" style=\"float:$farside;margin-$nearside:5px;\">[".$url."]</div>";
806 }
807
808 /**
809 * Split a link trail, return the "inside" portion and the remainder of the trail
810 * as a two-element array
811 *
812 * @static
813 */
814 function splitTrail( $trail ) {
815 static $regex = false;
816 if ( $regex === false ) {
817 global $wgContLang;
818 $regex = $wgContLang->linkTrail();
819 }
820 $inside = '';
821 if ( '' != $trail ) {
822 if ( preg_match( $regex, $trail, $m ) ) {
823 $inside = $m[1];
824 $trail = $m[2];
825 }
826 }
827 return array( $inside, $trail );
828 }
829
830 }
831 ?>