README

Semantic Interlanguage Links (a.k.a. SIL) is a Semantic Mediawiki extension to create and manage interlanguage links.

This extension helps to create interlanguage links and provides queryable annotations that:

Can connect pages with similar content for different languages to be accessible via the sitelink navigation
Provides a interlanguagelink parser function to create cachable assignments
Provides a interlanguagelist parser function to format a list of available language links
Provides a annotatedlanguage parser function to return the language code of the current page
To set the page content language of an article
Integration with Special:Search to search By Language

This video demonstrates the functionality of the Semantic Interlanguage Links extension.

Requirements

PHP 7.1 or later
MediaWiki 1.35 or later
Semantic MediaWiki 3.0 or later

Installation

The recommended way to install Semantic Interlanguage Links is using Composer with MediaWiki's built-in support for Composer.

Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided.

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:

{
	"require": {
		"mediawiki/semantic-interlanguage-links": "~2.1"
	}
}

If you already have a "composer.local.json" file add the following line to the end of the "require" section in your file:

"mediawiki/semantic-interlanguage-links": "~2.1"

Remember to add a comma to the end of the preceding line in this section.

Step 2

Run the following command in your shell:

php composer.phar update --no-dev

Note if you have Git installed on your system add the --prefer-source flag to the above command.

Step 3

Add the following line to the end of your "LocalSettings.php" file:

wfLoadExtension( 'SemanticInterlanguageLinks' );

Usage

The parser function {{interlanguagelink: ... }} provides an interface to declare multilingual content using semantic annotations.

{{interlanguagelink: language code | interlanguage reference }}, the first argument specifies the language code (e.g es, ja) of the content while the second argument contains an arbitrary reference (interlanguage reference) that describes content of similar nature (content that should be connected to each other) for different languages.

Further details and usage examples can be found here.

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.

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.

License

GNU General Public License, version 2 or later.

mediawiki / semantic-interlanguage-links

Maintainers

Details