mediawiki/semantic-breadcrumb-links

A Semantic MediaWiki extension to build breadcrumb links from an attributive property filter.

Semantic Breadcrumb Links

, _(*1)

Semantic Breadcrumb Links (a.k.a. SBL) is a Semantic Mediawiki extension to aid in-page navigation by building breadcrumb links from an attributive property filter., _(*2)

SBL uses a pattern match strategy to filter property usage (e.g. Has parent page) that ascribe the location of a page relative to its parent and provides navigational help by generating a breadcrumb trail., _(*3)

This video demonstrates the functionality of the Semantic Breadcrumb Links extension., _(*4)

Requirements

• PHP 5.6 or later
• MediaWiki 1.27 or later
• Semantic MediaWiki 2.5 or later

Installation

The recommended way to install Semantic Breadcrumb Links is using Composer with MediaWiki's built-in support for Composer., _(*5)

Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided., _(*6)

Step 1

Change to the base directory of your MediaWiki installation. If you do not have a "composer.local.json" file yet, create one and add the following content to it:, _(*7)

{
    "require": {
        "mediawiki/semantic-breadcrumb-links": "~2.0"
    }
}

If you already have a "composer.local.json" file add the following line to the end of the "require" section in your file:, _(*8)

"mediawiki/semantic-breadcrumb-links": "~2.0"

Remember to add a comma to the end of the preceding line in this section., _(*9)

Step 2

Run the following command in your shell:, _(*10)

php composer.phar update --no-dev

Note if you have Git installed on your system add the --prefer-source flag to the above command., _(*11)

Step 3

Add the following line to the end of your "LocalSettings.php" file:, _(*12)

wfLoadExtension( 'SemanticBreadcrumbLinks' );

Usage

, _(*13)

This document decribes available settings and features of this extension., _(*14)

Contribution and support

If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guideline., _(*15)

• File an issue
• Submit a pull request
• Ask a question on the mailing list

Tests

This extension provides unit and integration tests that are run by a continues integration platform but can also be executed using composer phpunit from the extension base directory., _(*16)

License

GNU General Public License, version 2 or later., _(*17)