diff --git "a/include/class-mw\\CompleteTitle.php" "b/include/class-mw\\CompleteTitle.php" index 59d86fa..39ab558 100644 --- "a/include/class-mw\\CompleteTitle.php" +++ "b/include/class-mw\\CompleteTitle.php" @@ -1,164 +1,168 @@ . # MediaWiki namespace mw; /** * A MediaWiki complete title (with namespace) */ class CompleteTitle { /** * Which MediaWiki site * * @var object */ private $wiki; /** * @var object */ private $ns; /** * @var object */ private $title; /** * Constructor * * @param $wiki object * @param $ns object * @param $title object */ public function __construct( $wiki, Ns $ns, Title $title ) { $this->wiki = $wiki; $this->ns = $ns; $this->title = $title; } /** * Get the namespace object * * @return object */ public function getNs() { return $this->ns; } /** * Get the title object * * @return object */ public function getTitle() { return $this->title; } /** * Get the complete title, as displayed in a page * * @return string */ public function getCompleteTitle() { $title = $this->getTitle()->get(); $ns = $this->getNs()->getName(); if( $ns ) { $ns .= ":"; } return $ns . $title; } /** * Get the regex able to match this complete title * * @param $args array * ns-group-name: Name of the capturing group for the namespace * title-group-name: Name of the capturing group for the title * @return string */ public function getRegex( $args = [] ) { // default options $args = array_replace( [ 'wikilink' => true, 'ns-group-name' => null, 'title-group-name' => null, ], $args ); // namespace regex $ns = $this->getNs()->getRegex( [ 'wikilink' => $args[ 'wikilink' ], ] ); // title regex $title = $this->getTitle()->getRegex(); + // @TODO: handle anchor + // eventually group $ns = \regex\Generic::groupNamed( $ns, $args[ 'ns-group-name' ] ); $title = \regex\Generic::groupNamed( $title, $args[ 'title-group-name' ] ); return $ns . '[ _]*' . $title; } /** * Create a Wikilink to this title * * @param $alias string|false|null (NULL: whatever, false: no one) * @return object */ public function createWikilink( $alias = null ) { return new Wikilink( $this, $alias ); } /** * Static constructor parsing a string * * @param $wiki object * @param $s string e.g. ' Mediawiki: test ' * @return self */ public static function createParsingTitle( $wiki, $s ) { + // @TODO: parse also anchor + // split namespace and title $ns_raw = ''; $tokens = explode( ':', $s, 2 ); if( count( $tokens ) === 2 ) { $ns_raw = $tokens[ 0 ]; $title_raw = $tokens[ 1 ]; } else { // no namespace? that's the main namespace! $ns_raw = ''; $title_raw = $tokens[ 0 ]; } // validate namespace $ns = $wiki->findNamespace( $ns_raw ); if( ! $ns ) { // that was the main namespace with a ':' in the title $ns = $wiki->getNamespace( 0 ); $title_raw = "$ns_raw:$title_raw"; } $title = new Title( $title_raw, $wiki ); return new self( $wiki, $ns, $title ); } } diff --git "a/include/class-mw\\Wikilink.php" "b/include/class-mw\\Wikilink.php" index 244be26..b7bda61 100644 --- "a/include/class-mw\\Wikilink.php" +++ "b/include/class-mw\\Wikilink.php" @@ -1,222 +1,256 @@ . # MediaWiki namespace mw; /** * A MediaWiki wikilink * * Something like [[Wikipedia:Contatti|contatti]]. */ class Wikilink { /** * A valid alias value */ const WHATEVER_ALIAS = null; /** * A valid alias value */ const NO_ALIAS = false; /** * MediaWiki title * * When falsy, it means that can be whatever * * @var object|null */ private $title; /** * Displayed alias * * When NULL, it means that can be whatever, * When false, it means that there is no one. * * @var object */ private $alias; /** * Constructor * * @param $title object * @param $alias string|false|null (NULL: whatever, false: no one) */ public function __construct( CompleteTitle $title, $alias = null ) { $this->setTitle( $title ) ->setAlias( $alias ); } /** * Set the title (link) * * @param $title object * @return self */ public function setTitle( CompleteTitle $title ) { $this->title = $title; return $this; } /** * Set the alias * * @param $alias string|null|false (NULL: whatever, false: no one * @return self */ public function setAlias( $alias ) { $this->alias = $alias; return $this; } /** * Get a regex matching this wikilink's title * * If there is no title, match a generic one. * * @param $args array Arguments * 'wikilink' boolean If false, a category will categorize (default true) * @return string */ public function getRegexTitle( $args = [] ) { return $this->title ? $this->title->getRegex( $args ) : '[' . self::legalTitleCharset() . ']*'; } + /** + * Get a regex matching this wikilink's anchor + * + * @param $args array Arguments + * anchor-group-name (string) group name for the anchor + * @return string + */ + public function getRegexAnchor( $args = [] ) { + //if( $this->title ) { + // @TODO: allow CompleteTitle objects to have a specific anchor + // return $this->title->getRegexAnchor( $args ); + //} + + // allowed characters in the anchor + $regex = self::legalTitleCharset(); + + // may be empty + $regex = "[$regex]*"; + + // create a group for just the text after the '#' (that may be empty) + $regex = \regex\Generic::groupNamed( $regex, $args[ 'anchor-group-name' ] ); + + // the anchor may be not specified + return "( *#$regex)?"; + } + /** * Get a regex matching this wikilink's alias * * If there is no alias, match a generic one. * * @return string */ public function getRegexAlias() { // match the alias exactly if present if( $this->alias ) { return preg_quote( $this->alias ); } // match whatever alias otherwise (non-greedy) return '.*?'; } /** * Get the wikitext that will point to this wikilink * * @param $args array * @return string */ public function getWikitext( $args = [] ) { // default arguments $args = array_replace( [ 'wikilink' => true, ], $args ); $completetitle = $this->title; $ns = $completetitle->getNs(); $ns_name = $ns->getName(); $title = $completetitle->getTitle()->get(); // categories must me prefixed with ':' if you want a wikilink $prefix = ''; if( $ns->getID() === 14 && $args[ 'wikilink' ] ) { $prefix = ':'; } // the alias is the piped text $alias = ''; if( strlen( $this->alias ) > 1 ) { $alias = "|$this->alias"; } + // @TODO: get the anchor from CompleteTitle + return "[[$prefix$ns_name:$title$alias]]"; } /** * Get a regex matching this wikilink * * @param $args array Arguments to be specified - * 'title-group-name' string If specified, the title will be captured in a group with this name - * 'alias-group-name' string If specified, the alias will be captured in a group with this name + * 'title-group-name' string If specified, the title will be captured in a group with this name + * 'alias-group-name' string If specified, the alias will be captured in a group with this name + * 'anchor-group-name' string If specified, the anchor will be captured in a group with this name * 'wikilink': bool If false, a category will categorize (default true) */ public function getRegex( $args = [] ) { // default options $args = array_replace( [ - 'wikilink' => true, - 'title-group-name' => null, - 'alias-group-name' => null, + 'wikilink' => true, + 'title-group-name' => null, + 'alias-group-name' => null, + 'anchor-group-name' => null, ], $args ); // regex matching the title $title_regex = $this->getRegexTitle( [ 'wikilink' => $args[ 'wikilink' ], ] ); $title_regex = \regex\Generic::groupNamed( $title_regex, $args[ 'title-group-name' ] ); + // regex matching the anchor + $anchor_regex = $this->getRegexAnchor( $args ); + // regex matching the alias (if any) $alias_regex = false; if( $this->alias !== self::NO_ALIAS ) { $alias_regex = \regex\Generic::groupNamed( $this->getRegexAlias(), $args[ 'alias-group-name' ] ); // the alias part, when it's a captch-all, is optional if( $this->alias === self::WHATEVER_ALIAS ) { // note, do not try to create an atomic group, because atomic groups do not backreference past $alias_regex = "([ _]*\|$alias_regex)?"; } } // complete regex - $regex = $title_regex; + $regex = $title_regex; + $regex .= $anchor_regex; if( $alias_regex ) { $regex .= $alias_regex; } // surround with spaces $regex = \regex\Generic::spaceBurger( $regex ); // surround with brackets return "\[\[$regex\]\]"; } /** * Legal characters for a title * * @see https://www.mediawiki.org/wiki/Manual:$wgLegalTitleChars * '#' is added to allow section links. */ public static function legalTitleCharset() { return '# %!\"$&\'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+'; } /** * Legal characters for an alias * * @see https://www.mediawiki.org/wiki/Manual:$wgLegalTitleChars */ public static function legalAliasCharset() { return self::legalTitleCharset() . '#<>\[\]{}\n\t'; } }