��ѧۧݧ�ӧ�� ާ֧ߧ֧էا֧�

��ѧۧݧ�ӧ�� ާ֧ߧ֧էا֧� - ��֧էѧܧ�ڧ��ӧѧ�� - /home/rickpfrv/wiki.craftaro.com/vendor/wikimedia/parsoid/src/Wt2Html/TT/WikiLinkHandler.php

��ѧ٧ѧ�
<?php declare( strict_types = 1 ); /** * Simple link handler. * * TODO: keep round-trip information in meta tag or the like / namespace Wikimedia\Parsoid\Wt2Html\TT; use stdClass; use Wikimedia\Assert\Assert; use Wikimedia\Parsoid\Config\Env; use Wikimedia\Parsoid\Core\DomSourceRange; use Wikimedia\Parsoid\Core\InternalException; use Wikimedia\Parsoid\Core\Sanitizer; use Wikimedia\Parsoid\Language\Language; use Wikimedia\Parsoid\NodeData\DataParsoid; use Wikimedia\Parsoid\Tokens\EndTagTk; use Wikimedia\Parsoid\Tokens\EOFTk; use Wikimedia\Parsoid\Tokens\KV; use Wikimedia\Parsoid\Tokens\SelfclosingTagTk; use Wikimedia\Parsoid\Tokens\SourceRange; use Wikimedia\Parsoid\Tokens\TagTk; use Wikimedia\Parsoid\Tokens\Token; use Wikimedia\Parsoid\Utils\ContentUtils; use Wikimedia\Parsoid\Utils\PHPUtils; use Wikimedia\Parsoid\Utils\PipelineUtils; use Wikimedia\Parsoid\Utils\Title; use Wikimedia\Parsoid\Utils\TitleException; use Wikimedia\Parsoid\Utils\TokenUtils; use Wikimedia\Parsoid\Utils\Utils; use Wikimedia\Parsoid\Wikitext\Consts; use Wikimedia\Parsoid\Wt2Html\PegTokenizer; use Wikimedia\Parsoid\Wt2Html\TokenTransformManager; class WikiLinkHandler extends TokenHandler { /* * @var PegTokenizer / private $urlParser; /* @inheritDoc / public function __construct( TokenTransformManager $manager, array $options ) { parent::__construct( $manager, $options ); // Create a new peg parser for image options. if ( !$this->urlParser ) { // Actually the regular tokenizer, but we'll call it with the // url rule only. $this->urlParser = new PegTokenizer( $this->env ); } } /* * @param string $str * @return array\|null / private static function hrefParts( string $str ): ?array { if ( preg_match( '/^([^:]+):(.)$/D', $str, $matches ) ) { return [ 'prefix' => $matches[1], 'title' => $matches[2] ]; } else { return null; } } /** * Normalize and analyze a wikilink target. * * Returns an object containing * - href: The expanded target string * - hrefSrc: The original target wikitext * - title: A title object or * - language: An interwikiInfo object or * - interwiki: An interwikiInfo object. * - localprefix: Set if the link had a localinterwiki prefix (or prefixes) * - fromColonEscapedText: Target was colon-escaped ([[:en:foo]]) * - prefix: The original namespace or language/interwiki prefix without a * colon escape. * * @param Token $token * @param string $href * @param string $hrefSrc * @return stdClass The target info. * @throws InternalException / private function getWikiLinkTargetInfo( Token $token, string $href, string $hrefSrc ): stdClass { $env = $this->env; $siteConfig = $env->getSiteConfig(); $info = (object)[ 'href' => $href, 'hrefSrc' => $hrefSrc, // Initialize these properties to avoid isset checks 'interwiki' => null, 'language' => null, 'localprefix' => null, 'fromColonEscapedText' => null ]; if ( ( ltrim( $info->href )[0] ?? '' ) === ':' ) { $info->fromColonEscapedText = true; // Remove the colon escape $info->href = substr( ltrim( $info->href ), 1 ); } if ( ( $info->href[0] ?? '' ) === ':' ) { if ( $siteConfig->linting() ) { $lint = [ 'dsr' => DomSourceRange::fromTsr( $token->dataAttribs->tsr ), 'params' => [ 'href' => ':' . $info->href ], 'templateInfo' => null ]; if ( $this->options['inTemplate'] ) { // Match Linter.findEnclosingTemplateName(), by first // converting the title to an href using env.makeLink $name = PHPUtils::stripPrefix( $env->makeLink( $this->manager->getFrame()->getTitle() ), './' ); $lint['templateInfo'] = [ 'name' => $name ]; // TODO(arlolra): Pass tsr info to the frame $lint['dsr'] = new DomSourceRange( 0, 0, null, null ); } $env->recordLint( 'lint/multi-colon-escape', $lint ); } // This will get caught by the caller, and mark the target as invalid throw new InternalException( 'Multiple colons prefixing href.' ); } $title = $env->resolveTitle( Utils::decodeURIComponent( $info->href ) ); $hrefBits = self::hrefParts( $info->href ); if ( $hrefBits ) { $nsPrefix = $hrefBits['prefix']; $info->prefix = $nsPrefix; $nnn = Utils::normalizeNamespaceName( trim( $nsPrefix ) ); $interwikiInfo = $siteConfig->interwikiMapNoNamespaces()[$nnn] ?? null; // check for interwiki / language links $ns = $siteConfig->namespaceId( $nnn ); // also check for url to protect against [[constructor:foo]] if ( $ns !== null ) { $info->title = $env->makeTitleFromURLDecodedStr( $title ); } elseif ( isset( $interwikiInfo['localinterwiki'] ) ) { if ( $hrefBits['title'] === '' ) { // Empty title => main page (T66167) $info->title = $env->makeTitleFromURLDecodedStr( $siteConfig->mainpage() ); } else { $info->href = str_contains( $hrefBits['title'], ':' ) ? ':' . $hrefBits['title'] : $hrefBits['title']; // Recurse! $info = $this->getWikiLinkTargetInfo( $token, $info->href, $info->hrefSrc ); $info->localprefix = $nsPrefix . ( $info->localprefix ? ( ':' . $info->localprefix ) : '' ); } } elseif ( !empty( $interwikiInfo['url'] ) ) { $info->href = $hrefBits['title']; // Ensure a valid title, even though we're discarding the result $env->makeTitleFromURLDecodedStr( $title ); // Interwiki or language link? If no language info, or if it starts // with an explicit ':' (like [[:en:Foo]]), it's not a language link. if ( $info->fromColonEscapedText \|\| ( !isset( $interwikiInfo['language'] ) && !isset( $interwikiInfo['extralanglink'] ) ) ) { // An interwiki link. $info->interwiki = $interwikiInfo; // Remove the colon escape after an interwiki prefix if ( ( ltrim( $info->href )[0] ?? '' ) === ':' ) { $info->href = substr( ltrim( $info->href ), 1 ); } } else { // A language link. $info->language = $interwikiInfo; } } else { $info->title = $env->makeTitleFromURLDecodedStr( $title ); } } else { $info->title = $env->makeTitleFromURLDecodedStr( $title ); } return $info; } /* * Handle mw:redirect tokens * * @param Token $token * @return TokenHandlerResult * @throws InternalException / private function onRedirect( Token $token ): TokenHandlerResult { // Avoid duplicating the link-processing code by invoking the // standard onWikiLink handler on the embedded link, intercepting // the generated tokens using the callback mechanism, reading // the href from the result, and then creating a // <link rel="mw:PageProp/redirect"> token from it. $rlink = new SelfclosingTagTk( 'link', Utils::clone( $token->attribs ), $token->dataAttribs->clone() ); $wikiLinkTk = $rlink->dataAttribs->linkTk; $rlink->setAttribute( 'rel', 'mw:PageProp/redirect' ); // Remove the nested wikiLinkTk token and the cloned href attribute unset( $rlink->dataAttribs->linkTk ); $rlink->removeAttribute( 'href' ); // Transfer href attribute back to wikiLinkTk, since it may have been // template-expanded in the pipeline prior to this point. $wikiLinkTk->attribs = Utils::clone( $token->attribs ); // Set "redirect" attribute on the wikilink token to indicate that // image and category links should be handled as plain links. $wikiLinkTk->setAttribute( 'redirect', 'true' ); // Render the wikilink (including interwiki links, etc) then collect // the resulting href and transfer it to rlink. $r = $this->onWikiLink( $wikiLinkTk ); $firstToken = ( $r->tokens[0] ?? null ); $isValid = $firstToken instanceof Token && in_array( $firstToken->getName(), [ 'a', 'link' ], true ); if ( $isValid ) { $da = $r->tokens[0]->dataAttribs; $rlink->addNormalizedAttribute( 'href', $da->a['href'], $da->sa['href'] ); return new TokenHandlerResult( [ $rlink ] ); } else { // Bail! Emit tokens as if they were parsed as a list item: // #REDIRECT.... $src = $rlink->dataAttribs->src; $tsr = $rlink->dataAttribs->tsr; preg_match( '/^([^#])(#)/', $src, $srcMatch ); $ntokens = strlen( $srcMatch[1] ) ? [ $srcMatch[1] ] : []; $hashPos = $tsr->start + strlen( $srcMatch[1] ); $tsr0 = new SourceRange( $hashPos, $hashPos + 1 ); $dp = new DataParsoid; $dp->tsr = $tsr0; $li = new TagTk( 'listItem', [ new KV( 'bullets', [ '#' ], $tsr0->expandTsrV() ) ], $dp ); $ntokens[] = $li; $ntokens[] = substr( $src, strlen( $srcMatch[0] ) ); PHPUtils::pushArray( $ntokens, $r->tokens ); return new TokenHandlerResult( $ntokens ); } } /** * @param TokenTransformManager $manager * @param Token $token * @return array / public static function bailTokens( TokenTransformManager $manager, Token $token ): array { $frame = $manager->getFrame(); $tsr = $token->dataAttribs->tsr; $frameSrc = $frame->getSrcText(); $linkSrc = $tsr->substr( $frameSrc ); $src = substr( $linkSrc, 1, -1 ); if ( $src === false ) { $manager->getEnv()->log( 'error', 'Unable to determine link source.', "frame: $frameSrc", 'tsr: ', $tsr, "link: $linkSrc" ); return [ $linkSrc ]; // Forget about trying to tokenize this } $startOffset = $tsr->start + 1; $toks = PipeLineUtils::processContentInPipeline( $manager->getEnv(), $frame, $src, [ 'sol' => false, 'pipelineType' => 'text/x-mediawiki', 'srcOffsets' => new SourceRange( $startOffset, $startOffset + strlen( $src ) ), 'pipelineOpts' => [ 'expandTemplates' => $manager->getOptions()['expandTemplates'], 'inTemplate' => $manager->getOptions()['inTemplate'], ], ] ); TokenUtils::stripEOFTkfromTokens( $toks ); return array_merge( [ '[' ], $toks, [ ']' ] ); } /* * Handle a mw:WikiLink token. * * @param Token $token * @return TokenHandlerResult * @throws InternalException / private function onWikiLink( Token $token ): TokenHandlerResult { $env = $this->env; $hrefKV = $token->getAttributeKV( 'href' ); $hrefTokenStr = TokenUtils::tokensToString( $hrefKV->v ); // Don't allow internal links to pages containing PROTO: // See Parser::handleInternalLinks2() if ( $env->getSiteConfig()->hasValidProtocol( $hrefTokenStr ) ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } // Xmlish tags in title position are invalid. Not according to the // preprocessor ABNF but at later stages in the legacy parser, // namely handleInternalLinks. if ( is_array( $hrefKV->v ) ) { // Use the expanded attr instead of trying to unpackDOMFragments // since the fragment will have been released when expanding to DOM $expandedVal = $token->fetchExpandedAttrValue( 'href' ); if ( preg_match( '#mw:(Nowiki\|Extension\|DOMFragment/sealed)#', $expandedVal ?? '' ) ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } } // First check if the expanded href contains a pipe. if ( str_contains( $hrefTokenStr, '\|' ) ) { // It does. This 'href' was templated and also returned other // parameters separated by a pipe. We don't have any sensible way to // handle such a construct currently, so prevent people from editing // it. See T226523 // TODO: add useful debugging info for editors ('if you would like to // make this content editable, then fix template X..') // TODO: also check other parameters for pipes! return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } $target = null; try { $target = $this->getWikiLinkTargetInfo( $token, $hrefTokenStr, $hrefKV->vsrc ); } catch ( TitleException \| InternalException $e ) { // Invalid title return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } // Ok, it looks like we have a sensible href. Figure out which handler to use. $isRedirect = (bool)$token->getAttribute( 'redirect' ); return $this->wikiLinkHandler( $token, $target, $isRedirect ); } /* * Figure out which handler to use to render a given WikiLink token. Override * this method to add new handlers or swap out existing handlers based on the * target structure. * * @param Token $token * @param stdClass $target * @param bool $isRedirect * @return TokenHandlerResult * @throws InternalException / private function wikiLinkHandler( Token $token, stdClass $target, bool $isRedirect ): TokenHandlerResult { $title = $target->title ?? null; if ( $title ) { if ( $isRedirect ) { return $this->renderWikiLink( $token, $target ); } $ns = $title->getNamespace(); if ( $ns->isMedia() ) { // Render as a media link. return $this->renderMedia( $token, $target ); } if ( !$target->fromColonEscapedText ) { if ( $ns->isFile() ) { // Render as a file. return $this->renderFile( $token, $target ); } if ( $ns->isCategory() ) { // Render as a category membership. return $this->renderCategory( $token, $target ); } } // Render as plain wiki links. return $this->renderWikiLink( $token, $target ); } // language and interwiki links if ( $target->interwiki ) { return $this->renderInterwikiLink( $token, $target ); } if ( $target->language ) { $ns = $this->env->getPageConfig()->getNs(); $noLanguageLinks = $this->env->getSiteConfig()->namespaceIsTalk( $ns ) \|\| !$this->env->getSiteConfig()->interwikiMagic(); if ( $noLanguageLinks ) { $target->interwiki = $target->language; return $this->renderInterwikiLink( $token, $target ); } return $this->renderLanguageLink( $token, $target ); } // Neither a title, nor a language or interwiki. Should not happen. throw new InternalException( 'Unknown link type' ); } /* ------------------------------------------------------------ * This (overloaded) function does three different things: * - Extracts link text from attrs (when k === "mw:maybeContent"). * As a performance micro-opt, only does if asked to (getLinkText) * - Updates existing rdfa type with an additional rdf-type, * if one is provided (rdfaType) * - Collates about, typeof, and linkAttrs into a new attr. array * * @param array $attrs * @param bool $getLinkText * @param ?string $rdfaType * @param ?array $linkAttrs * @return array / public static function buildLinkAttrs( array $attrs, bool $getLinkText, ?string $rdfaType, ?array $linkAttrs ): array { $newAttrs = []; $linkTextKVs = []; $about = null; // In one pass through the attribute array, fetch about, typeof, and linkText // // about && typeof are usually at the end of the array if at all present foreach ( $attrs as $kv ) { $k = $kv->k; $v = $kv->v; // link-text attrs have the key "maybeContent" if ( $getLinkText && $k === 'mw:maybeContent' ) { $linkTextKVs[] = $kv; } elseif ( is_string( $k ) && $k ) { if ( trim( $k ) === 'typeof' ) { $rdfaType = $rdfaType ? $rdfaType . ' ' . $v : $v; } elseif ( trim( $k ) === 'about' ) { $about = $v; } elseif ( trim( $k ) === 'data-mw' ) { $newAttrs[] = $kv; } } } if ( $rdfaType ) { $newAttrs[] = new KV( 'typeof', $rdfaType ); } if ( $about ) { $newAttrs[] = new KV( 'about', $about ); } if ( $linkAttrs ) { PHPUtils::pushArray( $newAttrs, $linkAttrs ); } return [ 'attribs' => $newAttrs, 'contentKVs' => $linkTextKVs, 'hasRdfaType' => $rdfaType !== null ]; } /* * Generic wiki link attribute setup on a passed-in new token based on the * wikilink token and target. As a side effect, this method also extracts the * link content tokens and returns them. * * @param Token $newTk * @param Token $token * @param stdClass $target * @param bool $buildDOMFragment * @return array * @throws InternalException / private function addLinkAttributesAndGetContent( Token $newTk, Token $token, stdClass $target, bool $buildDOMFragment = false ): array { $attribs = $token->attribs; $dataAttribs = $token->dataAttribs; $newAttrData = self::buildLinkAttrs( $attribs, true, null, [ new KV( 'rel', 'mw:WikiLink' ) ] ); $content = $newAttrData['contentKVs']; $env = $this->env; // Set attribs and dataAttribs $newTk->attribs = $newAttrData['attribs']; $newTk->dataAttribs = $dataAttribs->clone(); unset( $newTk->dataAttribs->src ); // clear src string since we can serialize this // Note: Link tails are handled on the DOM in handleLinkNeighbours, so no // need to handle them here. $l = count( $content ); if ( $l > 0 ) { $newTk->dataAttribs->stx = 'piped'; $out = []; // re-join content bits foreach ( $content as $i => $kv ) { $toks = $kv->v; // since this is already a link, strip autolinks from content // FIXME: Maybe add a stop in the grammar so that autolinks // aren't tokenized in link content to begin with? if ( !is_array( $toks ) ) { $toks = [ $toks ]; } $toks = array_values( array_filter( $toks, static function ( $t ) { return $t !== ''; } ) ); $n = count( $toks ); foreach ( $toks as $j => $t ) { // Bail on media-syntax in wikilink-syntax scenarios, // since the legacy parser explodes on [[, last one wins. // Note that without this, anchors tags in media output // will be stripped and we won't have the right structure // when we get to the dom pass to add media info. if ( $t instanceof TagTk && ( $t->getName() === 'figure' \|\| $t->getName() === 'span' ) && TokenUtils::matchTypeOf( $t, '#^mw:File($\|/)#D' ) !== null ) { throw new InternalException( 'Media-in-link' ); } if ( $t instanceof TagTk && $t->getName() === 'a' ) { // Bail on wikilink-syntax in wiklink-syntax scenarios, // since the legacy parser explodes on [[, last one wins if ( preg_match( '#^mw:WikiLink(/Interwiki)?$#D', $t->getAttribute( 'rel' ) ?? '' ) && // ISBN links don't use wikilink-syntax but still // get the same "rel", so should be ignored ( $t->dataAttribs->stx ?? '' ) !== 'magiclink' ) { throw new InternalException( 'Link-in-link' ); } if ( $j + 1 < $n && $toks[$j + 1] instanceof EndTagTk && $toks[$j + 1]->getName() === 'a' ) { // autonumbered links in the stream get rendered // as an <a> tag with no content -- but these ought // to be treated as plaintext since we don't allow // nested links. $out[] = '[' . $t->getAttribute( 'href' ) . ']'; } // suppress <a> continue; } if ( $t instanceof EndTagTk && $t->getName() === 'a' ) { continue; // suppress </a> } $out[] = $t; } if ( $i < $l - 1 ) { $out[] = '\|'; } } if ( $buildDOMFragment ) { // content = [part 0, .. part l-1] // offsets = [start(part-0), end(part l-1)] $offsets = isset( $dataAttribs->tsr ) ? new SourceRange( $content[0]->srcOffsets->value->start, $content[$l - 1]->srcOffsets->value->end ) : null; $content = [ PipelineUtils::getDOMFragmentToken( $out, $offsets, [ 'inlineContext' => true, 'token' => $token ] ) ]; } else { $content = $out; } } else { $newTk->dataAttribs->stx = 'simple'; $morecontent = Utils::decodeURIComponent( $target->href ); // Try to match labeling in core if ( $env->getSiteConfig()->namespaceHasSubpages( $env->getPageConfig()->getNs() ) ) { // subpage links with a trailing slash get the trailing slashes stripped. // See https://gerrit.wikimedia.org/r/173431 if ( preg_match( '#^((\.\./)+\|/)(?!\.\./)(.?[^/])/+$#D', $morecontent, $match ) ) { $morecontent = $match[3]; } elseif ( str_starts_with( $morecontent, '../' ) ) { // Subpages on interwiki / language links aren't valid, // so $target->title should always be present here $morecontent = $target->title->getPrefixedText(); } } // for interwiki links, include the interwiki prefix in the link text if ( $target->interwiki ) { $morecontent = $target->prefix . ':' . $morecontent; } // for local links, include the local prefix in the link text if ( $target->localprefix ) { $morecontent = $target->localprefix . ':' . $morecontent; } $content = [ $morecontent ]; } return $content; } /** * Render a plain wiki link. * * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderWikiLink( Token $token, stdClass $target ): TokenHandlerResult { $newTk = new TagTk( 'a' ); try { $content = $this->addLinkAttributesAndGetContent( $newTk, $token, $target, true ); } catch ( InternalException $e ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } $newTk->addNormalizedAttribute( 'href', $this->env->makeLink( $target->title ), $target->hrefSrc ); // Add title unless it's just a fragment if ( $target->href[0] !== '#' ) { $newTk->setAttribute( 'title', $target->title->getPrefixedText() ); } return new TokenHandlerResult( array_merge( [ $newTk ], $content, [ new EndTagTk( 'a' ) ] ) ); } /* * Render a category 'link'. Categories are really page properties, and are * normally rendered in a box at the bottom of an article. * * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderCategory( Token $token, stdClass $target ): TokenHandlerResult { $newTk = new SelfclosingTagTk( 'link' ); try { $content = $this->addLinkAttributesAndGetContent( $newTk, $token, $target ); } catch ( InternalException $e ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } $env = $this->env; // Change the rel to be mw:PageProp/Category $newTk->getAttributeKV( 'rel' )->v = 'mw:PageProp/Category'; $newTk->addNormalizedAttribute( 'href', $env->makeLink( $target->title ), $target->hrefSrc ); // Change the href to include the sort key, if any (but don't update the rt info) $strContent = str_replace( "\n", '', TokenUtils::tokensToString( $content ) ); if ( $strContent !== '' && $strContent !== $target->href ) { $hrefkv = $newTk->getAttributeKV( 'href' ); $hrefkv->v .= '#'; $hrefkv->v .= str_replace( '#', '%23', Sanitizer::sanitizeTitleURI( $strContent, false ) ); } if ( count( $content ) !== 1 ) { // Deal with sort keys that come from generated content (transclusions, etc.) $key = [ 'txt' => 'mw:sortKey' ]; $contentKV = $token->getAttributeKV( 'mw:maybeContent' ); $so = $contentKV->valueOffset(); $val = PipelineUtils::expandValueToDOM( $this->env, $this->manager->getFrame(), [ 'html' => $content, 'srcOffsets' => $so ], $this->options['expandTemplates'], $this->options['inTemplate'] ); $attr = [ $key, $val ]; $dataMW = $newTk->getAttribute( 'data-mw' ); if ( $dataMW ) { $dataMW = PHPUtils::jsonDecode( $dataMW, false ); $dataMW->attribs[] = $attr; } else { $dataMW = (object)[ 'attribs' => [ $attr ] ]; } // Mark token as having expanded attrs $newTk->addAttribute( 'about', $env->newAboutId() ); $newTk->addSpaceSeparatedAttribute( 'typeof', 'mw:ExpandedAttrs' ); $newTk->addAttribute( 'data-mw', PHPUtils::jsonEncode( $dataMW ) ); } // @todo Record this category in the metadata // $this->env->getMetadata()->addCategory('title', 'sort'); return new TokenHandlerResult( [ $newTk ] ); } /* * Render a language link. Those normally appear in the list of alternate * languages for an article in the sidebar, so are really a page property. * * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderLanguageLink( Token $token, stdClass $target ): TokenHandlerResult { // The prefix is listed in the interwiki map $newTk = new SelfclosingTagTk( 'link', [], $token->dataAttribs ); try { $this->addLinkAttributesAndGetContent( $newTk, $token, $target ); } catch ( InternalException $e ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } // add title attribute giving the presentation name of the // "extra language link" if ( isset( $target->language['extralanglink'] ) && !empty( $target->language['linktext'] ) ) { $newTk->addNormalizedAttribute( 'title', $target->language['linktext'], null ); } // We set an absolute link to the article in the other wiki/language $title = Sanitizer::sanitizeTitleURI( Utils::decodeURIComponent( $target->href ), false ); $absHref = str_replace( '$1', $title, $target->language['url'] ); if ( isset( $target->language['protorel'] ) ) { $absHref = preg_replace( '/^https?:/', '', $absHref, 1 ); } $newTk->addNormalizedAttribute( 'href', $absHref, $target->hrefSrc ); // Change the rel to be mw:PageProp/Language $newTk->getAttributeKV( 'rel' )->v = 'mw:PageProp/Language'; return new TokenHandlerResult( [ $newTk ] ); } /* * Render an interwiki link. * * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderInterwikiLink( Token $token, stdClass $target ): TokenHandlerResult { // The prefix is listed in the interwiki map $tokens = []; $newTk = new TagTk( 'a', [], $token->dataAttribs ); try { $content = $this->addLinkAttributesAndGetContent( $newTk, $token, $target, true ); } catch ( InternalException $e ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } // We set an absolute link to the article in the other wiki/language $isLocal = !empty( $target->interwiki['local'] ); $trimmedHref = trim( $target->href ); $title = Sanitizer::sanitizeTitleURI( Utils::decodeURIComponent( $trimmedHref ), !$isLocal ); $absHref = str_replace( '$1', $title, $target->interwiki['url'] ); if ( isset( $target->interwiki['protorel'] ) ) { $absHref = preg_replace( '/^https?:/', '', $absHref, 1 ); } $newTk->addNormalizedAttribute( 'href', $absHref, $target->hrefSrc ); // Change the rel to be mw:ExtLink $newTk->getAttributeKV( 'rel' )->v = 'mw:WikiLink/Interwiki'; // Remember that this was using wikitext syntax though $newTk->dataAttribs->isIW = true; // Add title unless it's just a fragment (and trim off fragment) // (The normalization here is similar to what Title#getPrefixedDBKey() does.) if ( $target->href === '' \|\| $target->href[0] !== '#' ) { $titleAttr = $target->interwiki['prefix'] . ':' . Utils::decodeURIComponent( str_replace( '_', ' ', preg_replace( '/#./s', '', $trimmedHref, 1 ) ) ); $newTk->setAttribute( 'title', $titleAttr ); } $tokens[] = $newTk; PHPUtils::pushArray( $tokens, $content ); $tokens[] = new EndTagTk( 'a' ); return new TokenHandlerResult( $tokens ); } /** * Get the style and class lists for an image's wrapper element. * * @param array $opts The option hash from renderFile. * @return array with boolean isInline Whether the image is inline after handling options. * or classes The list of classes for the wrapper. / private static function getWrapperInfo( array $opts ) { $format = self::getFormat( $opts ); $isInline = !in_array( $format, [ 'thumbnail', 'manualthumb', 'framed' ], true ); $classes = []; if ( !isset( $opts['size']['src'] ) && // Framed and manualthumb images aren't scaled !in_array( $format, [ 'manualthumb', 'framed' ], true ) ) { $classes[] = 'mw-default-size'; } // Border isn't applicable to 'thumbnail', 'manualthumb', or 'framed' formats // Using $isInline as a shorthand for that here (see above), // but this isn't about being inline* per se if ( $isInline && isset( $opts['border'] ) ) { $classes[] = 'mw-image-border'; } $halign = $opts['halign']['v'] ?? null; switch ( $halign ) { case 'none': // PHP parser wraps in <div class="floatnone"> $isInline = false; if ( $halign === 'none' ) { $classes[] = 'mw-halign-none'; } break; case 'center': // PHP parser wraps in <div class="center"><div class="floatnone"> $isInline = false; if ( $halign === 'center' ) { $classes[] = 'mw-halign-center'; } break; case 'left': // PHP parser wraps in <div class="floatleft"> $isInline = false; if ( $halign === 'left' ) { $classes[] = 'mw-halign-left'; } break; case 'right': // PHP parser wraps in <div class="floatright"> $isInline = false; if ( $halign === 'right' ) { $classes[] = 'mw-halign-right'; } break; } if ( $isInline ) { $valignOpt = $opts['valign']['v'] ?? null; switch ( $valignOpt ) { case 'middle': $classes[] = 'mw-valign-middle'; break; case 'baseline': $classes[] = 'mw-valign-baseline'; break; case 'sub': $classes[] = 'mw-valign-sub'; break; case 'super': $classes[] = 'mw-valign-super'; break; case 'top': $classes[] = 'mw-valign-top'; break; case 'text_top': $classes[] = 'mw-valign-text-top'; break; case 'bottom': $classes[] = 'mw-valign-bottom'; break; case 'text_bottom': $classes[] = 'mw-valign-text-bottom'; break; default: break; } } return [ 'classes' => $classes, 'isInline' => $isInline ]; } /** * Determine the name of an option. * * @param string $optStr * @param Env $env * @return array\|null * ck Canonical key for the image option. * v Value of the option. * ak Aliased key for the image option - includes `"$1"` for placeholder. * s Whether it's a simple option or one with a value. / private static function getOptionInfo( string $optStr, Env $env ): ?array { $oText = trim( $optStr ); $siteConfig = $env->getSiteConfig(); $getOption = $siteConfig->getMediaPrefixParameterizedAliasMatcher(); // oText contains the localized name of this option. the // canonical option names (from mediawiki upstream) are in // English and contain an '(img\|timedmedia)_' prefix. We drop the // prefix before stuffing them in data-parsoid in order to // save space (that's shortCanonicalOption) $canonicalOption = $siteConfig->magicWordCanonicalName( $oText ) ?? ''; $shortCanonicalOption = preg_replace( '/^(img\|timedmedia)_/', '', $canonicalOption, 1 ); // 'imgOption' is the key we'd put in opts; it names the 'group' // for the option, and doesn't have an img_ prefix. $imgOption = Consts::$Media['SimpleOptions'][$canonicalOption] ?? null; $bits = $getOption( $oText ); $normalizedBit0 = $bits ? mb_strtolower( trim( $bits['k'] ) ) : null; $key = $bits ? ( Consts::$Media['PrefixOptions'][$normalizedBit0] ?? null ) : null; if ( !empty( $imgOption ) && $key === null ) { return [ 'ck' => $imgOption, 'v' => $shortCanonicalOption, 'ak' => $optStr, 's' => true ]; } // bits.a has the localized name for the prefix option // (with $1 as a placeholder for the value, which is in bits.v) // 'normalizedBit0' is the canonical English option name // (from mediawiki upstream) with a prefix. // 'key' is the parsoid 'group' for the option; it doesn't // have a prefix (it's the key we'd put in opts) if ( $bits && $key ) { $shortCanonicalOption = preg_replace( '/^(img\|timedmedia)_/', '', $normalizedBit0, 1 ); // map short canonical name to the localized version used // Note that we deliberately do entity decoding // after* splitting so that HTML-encoded pipes don't // separate options. This matches PHP, whether or // not it's a good idea. return [ 'ck' => $shortCanonicalOption, 'v' => Utils::decodeWtEntities( $bits['v'] ), 'ak' => $optStr, 's' => false ]; } return null; } /** * @param Env $env * @param ?array &$optInfo * @param string $prefix * @param string $resultStr * @return bool / private static function isWikitextOpt( Env $env, ?array &$optInfo, string $prefix, string $resultStr ): bool { // link and alt options are allowed to contain arbitrary // wikitext (even though only strings are supported in reality) // SSS FIXME: Is this actually true of all options rather than // just link and alt? if ( $optInfo === null ) { $optInfo = self::getOptionInfo( $prefix . $resultStr, $env ); } return $optInfo !== null && in_array( $optInfo['ck'], [ 'link', 'alt' ], true ); } /* * Make option token streams into a stringy thing that we can recognize. * * @param array $tstream * @param string $prefix Anything that came before this part of the recursive call stack. * @param Env $env * @return string\|string[]\|null / private static function stringifyOptionTokens( array $tstream, string $prefix, Env $env ) { // Seems like this should be a more general "stripTags"-like function? $tokenType = null; $tkHref = null; $nextResult = null; $skipToEndOf = null; $optInfo = null; $resultStr = ''; for ( $i = 0; $i < count( $tstream ); $i++ ) { $currentToken = $tstream[$i]; if ( $skipToEndOf ) { if ( $currentToken instanceof EndTagTk && $currentToken->getName() === $skipToEndOf ) { $skipToEndOf = null; } continue; } if ( is_string( $currentToken ) ) { $resultStr .= $currentToken; } elseif ( is_array( $currentToken ) ) { $nextResult = self::stringifyOptionTokens( $currentToken, $prefix . $resultStr, $env ); if ( $nextResult === null ) { return null; } $resultStr .= $nextResult; } elseif ( !( $currentToken instanceof EndTagTk ) ) { // This is actually a token if ( TokenUtils::hasDOMFragmentType( $currentToken ) ) { if ( self::isWikitextOpt( $env, $optInfo, $prefix, $resultStr ) ) { $str = TokenUtils::tokensToString( [ $currentToken ], false, [ // These tokens haven't been expanded to DOM yet // so unpacking them here is justifiable // FIXME: It's a little convoluted to figure out // that this is actually the case in the // AttributeExpander, but it seems like only // target/href ever gets expanded to DOM and // the rest of the wikilink_content/options // become mw:maybeContent that gets expanded // below where $hasExpandableOpt is set. 'unpackDOMFragments' => true, // FIXME: Sneaking in `env` to avoid changing the signature 'env' => $env ] ); // Entity encode pipes since we wouldn't have split on // them from fragments and we're about to attempt to // when this function returns. // This is similar to getting the shadow "href" below. $resultStr .= preg_replace( '/\\|/', '\|', $str, 1 ); $optInfo = null; // might change the nature of opt continue; } else { // if this is a nowiki, we must be in a caption return null; } } if ( $currentToken->getName() === 'mw-quote' ) { if ( self::isWikitextOpt( $env, $optInfo, $prefix, $resultStr ) ) { // just recurse inside $optInfo = null; // might change the nature of opt continue; } } // Similar to TokenUtils.tokensToString()'s includeEntities if ( TokenUtils::isEntitySpanToken( $currentToken ) ) { $resultStr .= $currentToken->dataAttribs->src; $skipToEndOf = 'span'; continue; } if ( $currentToken->getName() === 'a' ) { if ( $optInfo === null ) { $optInfo = self::getOptionInfo( $prefix . $resultStr, $env ); if ( $optInfo === null ) { // An <a> tag before a valid option? // This is most likely a caption. $optInfo = null; return null; } } if ( self::isWikitextOpt( $env, $optInfo, $prefix, $resultStr ) ) { $tokenType = $currentToken->getAttribute( 'rel' ); // Using the shadow since entities (think pipes) would // have already been decoded. $tkHref = $currentToken->getAttributeShadowInfo( 'href' )['value']; $isLink = $optInfo && $optInfo['ck'] === 'link'; // Reset the optInfo since we're changing the nature of it $optInfo = null; // Figure out the proper string to put here and break. if ( $tokenType === 'mw:ExtLink' && ( $currentToken->dataAttribs->stx ?? '' ) === 'url' ) { // Add the URL $resultStr .= $tkHref; // Tell our loop to skip to the end of this tag $skipToEndOf = 'a'; } elseif ( $tokenType === 'mw:WikiLink/Interwiki' ) { if ( $isLink ) { $resultStr .= $currentToken->getAttribute( 'href' ); $i += 2; continue; } // Nothing to do -- the link content will be // captured by walking the rest of the tokens. } elseif ( $tokenType === 'mw:WikiLink' \|\| $tokenType === 'mw:MediaLink' ) { // Nothing to do -- the link content will be // captured by walking the rest of the tokens. } else { // There shouldn't be any other kind of link... // This is likely a caption. return null; } } else { // Why would there be an a tag without a link? return null; } } } } return $resultStr; } /* * Get the format for media. * * @param array $opts * @return string\|null / private static function getFormat( array $opts ): ?string { if ( $opts['manualthumb'] ) { return 'manualthumb'; } return $opts['format']['v'] ?? null; } private $used; /* * This is the set of file options that apply to the container, rather * than the media element itself (or, apply generically to a span). * Other options depend on the fetched media type and won't necessary be * applied. * * @return array / private function getUsed(): array { if ( $this->used ) { return $this->used; } $this->used = PHPUtils::makeSet( [ 'lang', 'width', 'class', 'upright', 'border', 'frameless', 'framed', 'thumbnail', 'left', 'right', 'center', 'none', 'baseline', 'sub', 'super', 'top', 'text_top', 'middle', 'bottom', 'text_bottom' ] ); return $this->used; } /* * @param array $toks * @return bool / private function hasTransclusion( array $toks ): bool { foreach ( $toks as $t ) { if ( $t instanceof SelfclosingTagTk && TokenUtils::hasTypeOf( $t, 'mw:Transclusion' ) ) { return true; } } return false; } /* * Render a file. This can be an image, a sound, a PDF etc. * * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderFile( Token $token, stdClass $target ): TokenHandlerResult { $manager = $this->manager; $env = $this->env; // FIXME: Re-enable use of media cache and figure out how that fits // into this new processing model. See T98995 // const cachedMedia = env.mediaCache[token.dataAttribs.src]; $dataAttribs = $token->dataAttribs->clone(); $dataAttribs->optList = []; // Account for the possibility of an expanded target $dataMwAttr = $token->getAttribute( 'data-mw' ); $dataMw = $dataMwAttr ? PHPUtils::jsonDecode( $dataMwAttr, false ) : new stdClass; $opts = [ 'title' => [ 'v' => $env->makeLink( $target->title ), 'src' => $token->getAttributeKV( 'href' )->vsrc ], 'size' => [ 'v' => [ 'height' => null, 'width' => null ] ], // Initialize these properties to avoid isset checks 'caption' => null, 'format' => null, 'manualthumb' => null, 'class' => null ]; $hasExpandableOpt = false; $optKVs = self::buildLinkAttrs( $token->attribs, true, null, null )['contentKVs']; while ( count( $optKVs ) > 0 ) { $oContent = array_shift( $optKVs ); Assert::invariant( $oContent instanceof KV, 'bad type' ); $origOptSrc = $oContent->v; if ( is_array( $origOptSrc ) && count( $origOptSrc ) === 1 ) { $origOptSrc = $origOptSrc[0]; } $oText = TokenUtils::tokensToString( $origOptSrc, true, [ 'includeEntities' => true ] ); if ( !is_string( $oText ) ) { // Might be that this is a valid option whose value is just // complicated. Try to figure it out, step through all tokens. $maybeOText = self::stringifyOptionTokens( $oText, '', $env ); if ( $maybeOText !== null ) { $oText = $maybeOText; } } $optInfo = null; if ( is_string( $oText ) ) { if ( str_contains( $oText, '\|' ) ) { // Split the pipe-separated string into pieces // and convert each one into a KV obj and add them // to the beginning of the array. Note that this is // a hack to support templates that provide multiple // image options as a pipe-separated string. We aren't // really providing editing support for this yet, or // ever, maybe. // // TODO(arlolra): Tables in captions suppress breaking on // "linkdesc" pipes so `stringifyOptionTokens` should account // for pipes in table cell content. For the moment, breaking // here is acceptable since it matches the php implementation // bug for bug. $pieces = array_map( static function ( $s ) { return new KV( 'mw:maybeContent', $s ); }, explode( '\|', $oText ) ); $optKVs = array_merge( $pieces, $optKVs ); // Record the fact that we won't provide editing support for this. $dataAttribs->uneditable = true; continue; } else { // We're being overly accepting of media options at this point, // since we don't know the type yet. After the info request, // we'll filter out those that aren't appropriate. $optInfo = self::getOptionInfo( $oText, $env ); } } // For the values of the caption and options, see // getOptionInfo's documentation above. // // If there are multiple captions, this code always // picks the last entry. This is the spec; see // "Image with multiple captions" parserTest. if ( !is_string( $oText ) \|\| $optInfo === null \|\| // Deprecated options in_array( $optInfo['ck'], [ 'disablecontrols' ], true ) ) { // No valid option found!? // Record for RT-ing $optsCaption = [ 'v' => $oContent->v, 'src' => $oContent->vsrc ?? $oText, 'srcOffsets' => $oContent->valueOffset(), // remember the position 'pos' => count( $dataAttribs->optList ) ]; // if there was a 'caption' previously, round-trip it as a // "bogus option". if ( !empty( $opts['caption'] ) ) { // Wrap the caption opt in an array since the option itself is an array! // Without the wrapping, the splicing will flatten the value. array_splice( $dataAttribs->optList, $opts['caption']['pos'], 0, [ [ 'ck' => 'bogus', 'ak' => $opts['caption']['src'] ] ] ); $optsCaption['pos']++; } $opts['caption'] = $optsCaption; continue; } // First option wins, the rest are 'bogus' // FIXME: For now, see T305628 if ( isset( $opts[$optInfo['ck']] ) \|\| // All the formats are simple options with the key "format" // except for "manualthumb", so check if the format has been set ( in_array( $optInfo['ck'], [ 'format', 'manualthumb' ], true ) && self::getFormat( $opts ) ) ) { $dataAttribs->optList[] = [ 'ck' => 'bogus', 'ak' => $optInfo['ak'] ]; continue; } $opt = [ 'ck' => $optInfo['v'], 'ak' => $oContent->vsrc ?? $optInfo['ak'] ]; if ( $optInfo['s'] === true ) { // Default: Simple image option $opts[$optInfo['ck']] = [ 'v' => $optInfo['v'] ]; } else { // Map short canonical name to the localized version used. $opt['ck'] = $optInfo['ck']; // The MediaWiki magic word for image dimensions is called 'width' // for historical reasons // Unlike other options, use last-specified width. if ( $optInfo['ck'] === 'width' ) { // We support a trailing 'px' here for historical reasons // (T15500, T53628) $maybeDim = Utils::parseMediaDimensions( $optInfo['v'] ); if ( $maybeDim !== null ) { $opts['size']['v'] = [ 'width' => Utils::validateMediaParam( $maybeDim['x'] ) ? $maybeDim['x'] : null, 'height' => array_key_exists( 'y', $maybeDim ) && Utils::validateMediaParam( $maybeDim['y'] ) ? $maybeDim['y'] : null ]; // Only round-trip a valid size $opts['size']['src'] = $oContent->vsrc ?? $optInfo['ak']; // check for duplicated options foreach ( $dataAttribs->optList as &$value ) { if ( $value['ck'] === 'width' ) { $value['ck'] = 'bogus'; // mark the previous definition as bogus, last one wins break; } } } else { $opt['ck'] = 'bogus'; } // Lang is a global attribute and can be applied to all media elements // for editing and roundtripping. However, not all file handlers will // make use of it. This param validation is from the SVG handler but // seems generally applicable. } elseif ( $optInfo['ck'] === 'lang' && !Language::isValidCode( $optInfo['v'] ) ) { $opt['ck'] = 'bogus'; } elseif ( $optInfo['ck'] === 'upright' && ( !is_numeric( $optInfo['v'] ) \|\| $optInfo['v'] <= 0 ) ) { $opt['ck'] = 'bogus'; } else { $opts[$optInfo['ck']] = [ 'v' => $optInfo['v'], 'src' => $oContent->vsrc ?? $optInfo['ak'], 'srcOffsets' => $oContent->valueOffset(), ]; } } // Collect option in dataAttribs (becomes data-parsoid later on) // for faithful serialization. $dataAttribs->optList[] = $opt; // Collect source wikitext for image options for possible template expansion. $maybeOpt = !isset( self::getUsed()[$opt['ck']] ); $expOpt = null; // Links more often than not show up as arrays here because they're // tokenized as `autourl`. To avoid unnecessarily considering them // expanded, we'll use a more restrictive test, at the cost of // perhaps missing some edgy behaviour. if ( $opt['ck'] === 'link' ) { $expOpt = is_array( $origOptSrc ) && $this->hasTransclusion( $origOptSrc ); } else { $expOpt = is_array( $origOptSrc ); } if ( $maybeOpt \|\| $expOpt ) { $val = []; if ( $expOpt ) { $hasExpandableOpt = true; $val['html'] = $origOptSrc; $val['srcOffsets'] = $oContent->valueOffset(); $val = PipelineUtils::expandValueToDOM( $env, $manager->getFrame(), $val, $this->options['expandTemplates'], $this->options['inTemplate'] ); } // This is a bit of an abuse of the "txt" property since // `optInfo.v` isn't necessarily wikitext from source. // It's a result of the specialized stringifying above, which // if interpreted as wikitext upon serialization will result // in some (acceptable) normalization. // // We're storing these options in data-mw because they aren't // guaranteed to apply to all media types and we'd like to // avoid the need to back them out later. // // Note that the caption in the legacy parser depends on the // exact set of options parsed, which we aren't attempting to // try and replicate after fetching the media info, since we // consider that more of bug than a feature. It prevent anyone // from ever safely adding media options in the future. // // See T163582 if ( $maybeOpt ) { $val['txt'] = $optInfo['v']; } if ( !isset( $dataMw->attribs ) ) { $dataMw->attribs = []; } $dataMw->attribs[] = [ $opt['ck'], $val ]; } } // Add the last caption in the right position if there is one if ( $opts['caption'] ) { // Wrap the caption opt in an array since the option itself is an array! // Without the wrapping, the splicing will flatten the value. array_splice( $dataAttribs->optList, $opts['caption']['pos'], 0, [ [ 'ck' => 'caption', 'ak' => $opts['caption']['src'] ] ] ); } $format = self::getFormat( $opts ); // Handle image default sizes and upright option after extracting all // options if ( $format === 'framed' \|\| $format === 'manualthumb' ) { // width and height is ignored for framed and manualthumb images // https://phabricator.wikimedia.org/T64258 $opts['size']['v'] = [ 'width' => null, 'height' => null ]; // Mark any definitions as bogus foreach ( $dataAttribs->optList as &$value ) { if ( $value['ck'] === 'width' ) { $value['ck'] = 'bogus'; } } } elseif ( $format ) { if ( !$opts['size']['v']['height'] && !$opts['size']['v']['width'] ) { $defaultWidth = $env->getSiteConfig()->widthOption(); if ( isset( $opts['upright'] ) ) { if ( $opts['upright']['v'] === 'upright' ) { // Simple option $defaultWidth = 0.75; } else { $defaultWidth = $opts['upright']['v']; } // round to nearest 10 pixels $defaultWidth = 10 round( $defaultWidth / 10 ); } $opts['size']['v']['width'] = $defaultWidth; } } $rdfaType = 'mw:File'; // If the format is something we recognize, add the subtype switch ( $format ) { case 'manualthumb': // FIXME(T305759): Does it deserve its own type? case 'thumbnail': $rdfaType .= '/Thumb'; break; case 'framed': $rdfaType .= '/Frame'; break; case 'frameless': $rdfaType .= '/Frameless'; break; } // Tell VE that it shouldn't try to edit this if ( !empty( $dataAttribs->uneditable ) ) { $rdfaType .= ' mw:Placeholder'; } else { unset( $dataAttribs->src ); } $wrapperInfo = self::getWrapperInfo( $opts ); $isInline = $wrapperInfo['isInline']; $containerName = $isInline ? 'span' : 'figure'; $classes = $wrapperInfo['classes']; if ( !empty( $opts['class'] ) ) { PHPUtils::pushArray( $classes, explode( ' ', $opts['class']['v'] ) ); } $attribs = [ new KV( 'typeof', $rdfaType ) ]; if ( count( $classes ) > 0 ) { array_unshift( $attribs, new KV( 'class', implode( ' ', $classes ) ) ); } $container = new TagTk( $containerName, $attribs, $dataAttribs ); $containerClose = new EndTagTk( $containerName ); if ( $hasExpandableOpt ) { $container->addAttribute( 'about', $env->newAboutId() ); $container->addSpaceSeparatedAttribute( 'typeof', 'mw:ExpandedAttrs' ); } elseif ( preg_match( '/\bmw:ExpandedAttrs\b/', $token->getAttribute( 'typeof' ) ?? '' ) ) { $container->addSpaceSeparatedAttribute( 'typeof', 'mw:ExpandedAttrs' ); } $span = new TagTk( 'span', [ new KV( 'class', 'mw-broken-media' ) ] ); // "resource" and "lang" are allowed attributes on spans $span->addNormalizedAttribute( 'resource', $opts['title']['v'], $opts['title']['src'] ); if ( isset( $opts['lang'] ) ) { $span->addNormalizedAttribute( 'lang', $opts['lang']['v'], $opts['lang']['src'] ); } // Token's KV attributes only accept strings, Tokens or arrays of those. $size = $opts['size']['v']; if ( !empty( $size['width'] ) ) { $span->addAttribute( 'data-width', (string)$size['width'] ); } if ( !empty( $size['height'] ) ) { $span->addAttribute( 'data-height', (string)$size['height'] ); } $anchor = new TagTk( 'a' ); $anchor->setAttribute( 'href', $this->specialFilePath( $target->title ) ); $tokens = [ $container, $anchor, $span, // FIXME: The php parser seems to put the link text here instead. // The title can go on the `anchor` as the "title" attribute. $target->title->getPrefixedText(), new EndTagTk( 'span' ), new EndTagTk( 'a' ) ]; $optsCaption = $opts['caption'] ?? null; if ( $isInline ) { if ( $optsCaption ) { if ( !is_array( $optsCaption['v'] ) ) { $opts['caption']['v'] = $optsCaption['v'] = [ $optsCaption['v'] ]; } // Parse the caption $captionDOM = PipelineUtils::processContentInPipeline( $this->env, $this->manager->getFrame(), array_merge( $optsCaption['v'], [ new EOFTk() ] ), [ 'pipelineType' => 'tokens/x-mediawiki/expanded', 'pipelineOpts' => [ 'inlineContext' => true, 'expandTemplates' => $this->options['expandTemplates'], 'inTemplate' => $this->options['inTemplate'] ], 'srcOffsets' => $optsCaption['srcOffsets'] ?? null, 'sol' => true ] ); // Use parsed DOM given in `captionDOM` // FIXME: Does this belong in `dataMw.attribs`? $dataMw->caption = ContentUtils::ppToXML( $captionDOM, [ 'innerXML' => true ] ); } } else { // We always add a figcaption for blocks $tsr = $optsCaption['srcOffsets'] ?? null; $dp = new DataParsoid; $dp->tsr = $tsr; $tokens[] = new TagTk( 'figcaption', [], $dp ); if ( $optsCaption ) { if ( is_string( $optsCaption['v'] ) ) { $tokens[] = $optsCaption['v']; } else { $tokens[] = PipelineUtils::getDOMFragmentToken( $optsCaption['v'], $tsr, [ 'inlineContext' => true, 'token' => $token ] ); } } $tokens[] = new EndTagTk( 'figcaption' ); } if ( (array)$dataMw !== [] ) { $container->addAttribute( 'data-mw', PHPUtils::jsonEncode( $dataMw ) ); } $tokens[] = $containerClose; return new TokenHandlerResult( $tokens ); } /** * @param Title $title * @return string / private function specialFilePath( Title $title ): string { $filePath = Sanitizer::sanitizeTitleURI( $title->getKey(), false ); return "./Special:FilePath/{$filePath}"; } /* * @param Token $token * @param stdClass $target * @param array $errs * @param ?array $info * @return TokenHandlerResult / private function linkToMedia( Token $token, stdClass $target, array $errs, ?array $info ): TokenHandlerResult { // Only pass in the url, since media links should not link to the thumburl $imgHref = $info['url'] ?? $this->specialFilePath( $target->title ); // Copied from getPath $imgHrefFileName = preg_replace( '#./#', '', $imgHref, 1 ); $link = new TagTk( 'a' ); try { $content = $this->addLinkAttributesAndGetContent( $link, $token, $target ); } catch ( InternalException $e ) { return new TokenHandlerResult( self::bailTokens( $this->manager, $token ) ); } // Change the rel to be mw:MediaLink $link->getAttributeKV( 'rel' )->v = 'mw:MediaLink'; $link->setAttribute( 'href', $imgHref ); // html2wt will use the resource rather than try to parse the href. $link->addNormalizedAttribute( 'resource', $this->env->makeLink( $target->title ), $target->hrefSrc ); // Normalize title according to how PHP parser does it currently $link->setAttribute( 'title', str_replace( '_', ' ', $imgHrefFileName ) ); if ( count( $errs ) > 0 ) { // Set RDFa type to mw:Error so VE and other clients // can use this to do client-specific action on these. if ( !TokenUtils::hasTypeOf( $link, 'mw:Error' ) ) { $link->addSpaceSeparatedAttribute( 'typeof', 'mw:Error' ); } // Update data-mw $dataMwAttr = $token->getAttribute( 'data-mw' ); $dataMw = $dataMwAttr ? PHPUtils::jsonDecode( $dataMwAttr, false ) : new stdClass; if ( is_array( $dataMw->errors ?? null ) ) { PHPUtils::pushArray( $dataMw->errors, $errs ); } else { $dataMw->errors = $errs; } $link->setAttribute( 'data-mw', PHPUtils::jsonEncode( $dataMw ) ); } $tokens = array_merge( [ $link ], $content, [ new EndTagTk( 'a' ) ] ); return new TokenHandlerResult( $tokens ); } // FIXME: The media request here is only used to determine if this is a // redlink and deserves to be handling in the redlink post-processing pass. /** * @param Token $token * @param stdClass $target * @return TokenHandlerResult / private function renderMedia( Token $token, stdClass $target ): TokenHandlerResult { $env = $this->env; $title = $target->title; $errs = []; $info = $env->getDataAccess()->getFileInfo( $env->getPageConfig(), [ [ $title->getKey(), [ 'height' => null, 'width' => null ] ] ] )[0]; if ( !$info ) { $errs[] = [ 'key' => 'apierror-filedoesnotexist', 'message' => 'This image does not exist.' ]; } elseif ( isset( $info['thumberror'] ) ) { $errs[] = [ 'key' => 'apierror-unknownerror', 'message' => $info['thumberror'] ]; } return $this->linkToMedia( $token, $target, $errs, $info ); } /* @inheritDoc */ public function onTag( Token $token ): ?TokenHandlerResult { switch ( $token->getName() ) { case 'wikilink': return $this->onWikiLink( $token ); case 'mw:redirect': return $this->onRedirect( $token ); default: return null; } } }

| ver. 1.4 | Github | . | PHP 7.4.33 | ��֧ߧ֧�ѧ�ڧ� ��ѧߧڧ��: 0.3 | proxy | phpinfo | ��ѧ��ۧܧ�