mediawiki/semantic-interlanguage-links

A Semantic Mediawiki extension to create and manage interlanguage links.

1.4.0 2017-07-30 01:12 UTC

README

Build Status Code Coverage Scrutinizer Code Quality Latest Stable Version Packagist download count Dependency Status

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

Installation

The recommended way to install Semantic Interlanguage Links is by using Composer with an entry in MediaWiki's composer.json or alternatively composer.local.json.

{
	"require": {
		"mediawiki/semantic-interlanguage-links": "~1.4"
	}
}
  1. From your MediaWiki installation directory, execute composer require mediawiki/semantic-interlanguage-links:~1.4
  2. Navigate to Special:Version on your wiki and verify that the package have been successfully installed.

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.

sil

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.