config = $config; } /** * Enables the two and tags. */ public function register( Parser $parser ): void { $parser->setHook( 'ref', [ $this, 'ref' ] ); $parser->setHook( 'references', [ $this, 'references' ] ); } /** * Parser hook for the tag. * * @param ?string $text Raw, untrimmed wikitext content of the tag, if any * @param string[] $argv * @param Parser $parser * @param PPFrame $frame * * @return string HTML */ public function ref( ?string $text, array $argv, Parser $parser, PPFrame $frame ): string { $cite = $this->citeForParser( $parser ); $result = $cite->ref( $parser, $text, $argv ); if ( $result === null ) { return htmlspecialchars( "$text" ); } $parserOutput = $parser->getOutput(); $parserOutput->addModules( [ 'ext.cite.ux-enhancements' ] ); $parserOutput->addModuleStyles( [ 'ext.cite.styles' ] ); $frame->setVolatile(); return $result; } /** * Parser hook for the tag. * * @param ?string $text Raw, untrimmed wikitext content of the tag, if any * @param string[] $argv * @param Parser $parser * @param PPFrame $frame * * @return string HTML */ public function references( ?string $text, array $argv, Parser $parser, PPFrame $frame ): string { $cite = $this->citeForParser( $parser ); $result = $cite->references( $parser, $text, $argv ); if ( $result === null ) { return htmlspecialchars( $text === null ? "" : "$text" ); } $frame->setVolatile(); return $result; } /** * Get or create Cite state for this parser. */ private function citeForParser( Parser $parser ): Cite { $parser->extCite ??= new Cite( $parser, $this->config ); return $parser->extCite; } }