` * with appropriate language and directionality set * @param array $messages Translations by translation unit; * empty when rendering the translatable page * @param Parser|null $parser Wikitext parser to use when generating anchors for translated * headings; if `null`, no anchors will be generated */ public function getPageTextForRendering( Language $sourceLanguage, Language $targetLanguage, bool $wrapUntranslated, array $messages = [], ?Parser $parser = null ): string { $text = $this->translationPageTemplate(); foreach ( $this->unitMap as $ph => $s ) { $t = $s->getTextForRendering( $messages[$s->id] ?? null, $sourceLanguage, $targetLanguage, $wrapUntranslated, $parser ); $text = str_replace( $ph, $t, $text ); } // Replace {{TRANSLATIONLANGUAGE}} usage outside of translation units (T224810) $text = preg_replace( TranslationUnit::TRANSLATIONLANGUAGE_REGEX, $targetLanguage->getCode(), $text ); return $text; } /** Returns the source page with translation unit markers. */ public function sourcePageTextForSaving(): string { $text = $this->sourcePageTemplate(); foreach ( $this->unitMap as $ph => $s ) { $text = str_replace( $ph, $s->getMarkedText(), $text ); } return $text; } /** Returns the page text with translation tags and unit placeholders for easy diffs */ public function sourcePageTemplateForDiffs(): string { $text = $this->sourcePageTemplate(); foreach ( $this->unitMap as $ph => $s ) { $text = str_replace( $ph, "", $text ); } return $text; } private function assertContainsOnlyInstancesOf( string $expected, string $name, array $x ): void { foreach ( $x as $item ) { if ( !$item instanceof $expected ) { $actual = get_debug_type( $item ); throw new InvalidArgumentException( "Parameter $name must only contain instances of class $expected. Got $actual." ); } } } }