Файловый менеджер - Редактировать - /var/www/html/mediawiki-1.43.1/extensions/Cite/src/ReferenceListFormatter.php
Ðазад
<?php namespace Cite; use MediaWiki\Html\Html; use MediaWiki\Parser\Parser; /** * Renderer for the actual list of references in place of the <references /> tag at the end of an * article. * * @license GPL-2.0-or-later */ class ReferenceListFormatter { /** * The backlinks, in order, to pass as $3 to * 'cite_references_link_many_format', defined in * 'cite_references_link_many_format_backlink_labels * * @var string[]|null */ private ?array $backlinkLabels = null; private ErrorReporter $errorReporter; private AnchorFormatter $anchorFormatter; private ReferenceMessageLocalizer $messageLocalizer; public function __construct( ErrorReporter $errorReporter, AnchorFormatter $anchorFormatter, ReferenceMessageLocalizer $messageLocalizer ) { $this->errorReporter = $errorReporter; $this->anchorFormatter = $anchorFormatter; $this->messageLocalizer = $messageLocalizer; } /** * @param Parser $parser * @param array<string|int,ReferenceStackItem> $groupRefs * @param bool $responsive * @param bool $isSectionPreview * * @return string HTML */ public function formatReferences( Parser $parser, array $groupRefs, bool $responsive, bool $isSectionPreview ): string { if ( !$groupRefs ) { return ''; } $wikitext = $this->formatRefsList( $parser, $groupRefs, $isSectionPreview ); $html = $parser->recursiveTagParse( $wikitext ); $html = Html::rawElement( 'ol', [ 'class' => 'references' ], $html ); if ( $responsive ) { $wrapClasses = [ 'mw-references-wrap' ]; if ( count( $groupRefs ) > 10 ) { $wrapClasses[] = 'mw-references-columns'; } // Use a DIV wrap because column-count on a list directly is broken in Chrome. // See https://bugs.chromium.org/p/chromium/issues/detail?id=498730. return Html::rawElement( 'div', [ 'class' => $wrapClasses ], $html ); } return $html; } /** * @param Parser $parser * @param array<string|int,ReferenceStackItem> $groupRefs * @param bool $isSectionPreview * * @return string Wikitext */ private function formatRefsList( Parser $parser, array $groupRefs, bool $isSectionPreview ): string { // After sorting the list, we can assume that references are in the same order as their // numbering. Subreferences will come immediately after their parent. uasort( $groupRefs, static function ( ReferenceStackItem $a, ReferenceStackItem $b ): int { $cmp = ( $a->number ?? 0 ) - ( $b->number ?? 0 ); return $cmp ?: ( $a->extendsIndex ?? 0 ) - ( $b->extendsIndex ?? 0 ); } ); // Add new lines between the list items (ref entries) to avoid confusing tidy (T15073). // Note: This builds a string of wikitext, not html. $parserInput = "\n"; /** @var string|bool $indented */ $indented = false; foreach ( $groupRefs as $key => &$ref ) { // Make sure the parent is not a subreference. // FIXME: Move to a validation function. $extends =& $ref->extends; if ( isset( $extends ) && isset( $groupRefs[$extends]->extends ) ) { $ref->warnings[] = [ 'cite_error_ref_nested_extends', $extends, $groupRefs[$extends]->extends ]; } if ( !$indented && isset( $extends ) ) { // The nested <ol> must be inside the parent's <li> if ( preg_match( '#</li>\s*$#D', $parserInput, $matches, PREG_OFFSET_CAPTURE ) ) { $parserInput = substr( $parserInput, 0, $matches[0][1] ); } $parserInput .= Html::openElement( 'ol', [ 'class' => 'mw-extended-references' ] ); $indented = $matches[0][0] ?? true; } elseif ( $indented && !isset( $extends ) ) { $parserInput .= $this->closeIndention( $indented ); $indented = false; } $parserInput .= $this->formatListItem( $parser, $key, $ref, $isSectionPreview ) . "\n"; } $parserInput .= $this->closeIndention( $indented ); return $parserInput; } /** * @param string|bool $closingLi * * @return string */ private function closeIndention( $closingLi ): string { if ( !$closingLi ) { return ''; } return Html::closeElement( 'ol' ) . ( is_string( $closingLi ) ? $closingLi : '' ); } /** * @param Parser $parser * @param string|int $key The key of the reference * @param ReferenceStackItem $ref * @param bool $isSectionPreview * * @return string Wikitext, wrapped in a single <li> element */ private function formatListItem( Parser $parser, $key, ReferenceStackItem $ref, bool $isSectionPreview ): string { $text = $this->renderTextAndWarnings( $parser, $key, $ref, $isSectionPreview ); // Special case for an incomplete follow="…". This is valid e.g. in the Page:… namespace on // Wikisource. Note this returns a <p>, not an <li> as expected! if ( isset( $ref->follow ) ) { return '<p id="' . $this->anchorFormatter->jumpLinkTarget( $ref->follow ) . '">' . $text . '</p>'; } // Parameter $4 in the cite_references_link_one and cite_references_link_many messages $extraAttributes = ''; if ( isset( $ref->dir ) ) { // The following classes are generated here: // * mw-cite-dir-ltr // * mw-cite-dir-rtl $extraAttributes = Html::expandAttributes( [ 'class' => 'mw-cite-dir-' . $ref->dir ] ); } if ( $ref->count === 1 ) { if ( !isset( $ref->name ) ) { $id = $ref->key; $backlinkId = $this->anchorFormatter->backLink( $ref->key ); } else { $id = $key . '-' . $ref->key; // TODO: Use count without decrementing. $backlinkId = $this->anchorFormatter->backLink( $key, $ref->key . '-' . ( $ref->count - 1 ) ); } return $this->messageLocalizer->msg( 'cite_references_link_one', $this->anchorFormatter->jumpLinkTarget( $id ), $backlinkId, $text, $extraAttributes )->plain(); } $backlinks = []; for ( $i = 0; $i < $ref->count; $i++ ) { $numericLabel = $this->referencesFormatEntryNumericBacklinkLabel( $ref->number . ( $ref->extendsIndex ? '.' . $ref->extendsIndex : '' ), $i, $ref->count ); $backlinks[] = $this->messageLocalizer->msg( 'cite_references_link_many_format', $this->anchorFormatter->backLink( $key, $ref->key . '-' . $i ), $numericLabel, $this->referencesFormatEntryAlternateBacklinkLabel( $parser, $i ) ?? $numericLabel )->plain(); } // The parent of a subref might actually be unused and therefor have zero backlinks $linkTargetId = $ref->count > 0 ? $this->anchorFormatter->jumpLinkTarget( $key . '-' . $ref->key ) : ''; return $this->messageLocalizer->msg( 'cite_references_link_many', $linkTargetId, $this->listToText( $backlinks ), $text, $extraAttributes )->plain(); } /** * @param Parser $parser * @param string|int $key * @param ReferenceStackItem $ref * @param bool $isSectionPreview * * @return string Wikitext */ private function renderTextAndWarnings( Parser $parser, $key, ReferenceStackItem $ref, bool $isSectionPreview ): string { if ( !isset( $ref->text ) ) { return $this->errorReporter->plain( $parser, $isSectionPreview ? 'cite_warning_sectionpreview_no_text' : 'cite_error_references_no_text', $key ); } $text = $ref->text ?? ''; foreach ( $ref->warnings as $warning ) { // @phan-suppress-next-line PhanParamTooFewUnpack $text .= ' ' . $this->errorReporter->plain( $parser, ...$warning ); // FIXME: We could use a StatusValue object to get rid of duplicates break; } return '<span class="reference-text">' . rtrim( $text, "\n" ) . "</span>\n"; } /** * Generate a numeric backlink given a base number and an * offset, e.g. $base = 1, $offset = 2; = 1.2 * Since bug #5525, it correctly does 1.9 -> 1.10 as well as 1.099 -> 1.100 * * @param string $base * @param int $offset * @param int $max Maximum value expected. * * @return string */ private function referencesFormatEntryNumericBacklinkLabel( string $base, int $offset, int $max ): string { return $this->messageLocalizer->localizeDigits( $base ) . $this->messageLocalizer->localizeSeparators( '.' ) . $this->messageLocalizer->localizeDigits( str_pad( (string)$offset, strlen( (string)$max ), '0', STR_PAD_LEFT ) ); } /** * Generate a custom format backlink given an offset, e.g. * $offset = 2; = c if $this->mBacklinkLabels = [ 'a', * 'b', 'c', ...]. Return an error if the offset > the # of * array items */ private function referencesFormatEntryAlternateBacklinkLabel( Parser $parser, int $offset ): ?string { if ( !isset( $this->backlinkLabels ) ) { $msg = $this->messageLocalizer->msg( 'cite_references_link_many_format_backlink_labels' ); $this->backlinkLabels = $msg->isDisabled() ? [] : preg_split( '/\s+/', $msg->plain() ); } // Disabling the message just disables the feature if ( !$this->backlinkLabels ) { return null; } return $this->backlinkLabels[$offset] ?? $this->errorReporter->plain( $parser, 'cite_error_references_no_backlink_label' ); } /** * This does approximately the same thing as * Language::listToText() but due to this being used for a * slightly different purpose (people might not want , as the * first separator and not 'and' as the second, and this has to * use messages from the content language) I'm rolling my own. * * @param string[] $arr The array to format * * @return string Wikitext */ private function listToText( array $arr ): string { $lastElement = array_pop( $arr ); if ( $arr === [] ) { return (string)$lastElement; } $sep = $this->messageLocalizer->msg( 'cite_references_link_many_sep' )->plain(); $and = $this->messageLocalizer->msg( 'cite_references_link_many_and' )->plain(); return implode( $sep, $arr ) . $and . $lastElement; } }
| ver. 1.1 | |
.
| PHP 8.4.18 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка