LanguageVariantConverter.php

Go to the documentation of this file.

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Parser\Parsoid;
 
use MediaWiki\Language\Language;
use MediaWiki\Language\LanguageFactory;
use MediaWiki\OutputTransform\OutputTransformPipeline;
use MediaWiki\Page\PageIdentity;
use MediaWiki\Parser\ParserOptions;
use MediaWiki\Parser\ParserOutput;
use MediaWiki\Rest\HttpException;
use MediaWiki\Title\Title;
use MediaWiki\Title\TitleFactory;
use Wikimedia\Bcp47Code\Bcp47Code;
use Wikimedia\Parsoid\Config\SiteConfig;
use Wikimedia\Parsoid\Core\HtmlPageBundle;
 
class LanguageVariantConverter {
    private readonly Title $pageTitle;
    private ?Language $pageLanguageOverride = null;
 
    private ?ParserOptions $parserOptionsForTest = null;
 
    public function __construct(
        private readonly OutputTransformPipeline $languageConverterPipeline,
        private readonly LanguageFactory $languageFactory,
        private readonly SiteConfig $siteConfig,
        TitleFactory $titleFactory,
        private readonly PageIdentity $pageIdentity,
    ) {
        $this->pageTitle = $titleFactory->newFromPageIdentity( $pageIdentity );
    }
 
    public function setPageLanguageOverride( Bcp47Code $language ) {
        $this->pageLanguageOverride = $this->languageFactory->getLanguage(
            $language
        );
    }
 
    public function convertPageBundleVariant(
        HtmlPageBundle $pageBundle,
        Bcp47Code $targetVariant,
        ?Bcp47Code $sourceVariant = null
    ): HtmlPageBundle {
        $parserOutput = PageBundleParserOutputConverter::parserOutputFromPageBundle(
            $pageBundle, title: $this->pageIdentity,
            siteConfig: $this->siteConfig
        );
        $modifiedParserOutput = $this->convertParserOutputVariant(
            $parserOutput, $targetVariant, $sourceVariant
        );
        return PageBundleParserOutputConverter::htmlPageBundleFromParserOutput(
            $modifiedParserOutput,
            siteConfig: $this->siteConfig,
            bodyOnly: false,
        );
    }
 
    public function convertParserOutputVariant(
        ParserOutput $parserOutput,
        Bcp47Code $targetVariant,
        ?Bcp47Code $sourceVariant = null
    ): ParserOutput {
        if ( !$parserOutput->getContentHolder()->isParsoidContent() ) {
            // Do not convert non-Parsoid HTML (it should be preconverted)
            return $parserOutput;
        }
        $targetVariant = $this->languageFactory->getLanguage( $targetVariant );
        $popts = $this->parserOptionsForTest ?? ParserOptions::newFromAnon();
        $popts->setVariant( $targetVariant );
        $popts->setUseParsoid( true );
        $parent = fn ( $l ) => $l === null ? null :
            $this->languageFactory->getParentLanguage( $l ) ??
            $this->languageFactory->getLanguage( $l );
        $popts->setTargetLanguage(
            $parent( $sourceVariant ) ??
            $parent( $this->pageLanguageOverride ) ??
            $parent( $parserOutput->getLanguage() ) ??
            $this->pageTitle->getPageLanguage()
        );
        // TEMPORARY during transition to new LanguageConverter
        // Ensure we can distinguish ParserOutputs created using the
        // older language converter implementation.
        $parserOutput->setExtensionData(
            'core:parsoid-languageconverter', 'postprocess'
        );
        return $this->languageConverterPipeline->run(
            $parserOutput, $popts, []
        );
    }
}