Skip to content

Commit

Permalink
Release version 1.5.0 (#64)
Browse files Browse the repository at this point in the history
* Update RELEASE-NOTES.md
* Update README.md
* Update 02-ask-queries.md
* Update composer.json
* Update SemanticInterlanguageLinks.php
  • Loading branch information
kghbln authored Oct 8, 2018
1 parent ccc5d74 commit 4f1d018
Show file tree
Hide file tree
Showing 5 changed files with 72 additions and 29 deletions.
67 changes: 48 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,46 +22,75 @@ This [video](https://vimeo.com/115871518) demonstrates the functionality of the

## Requirements

- PHP 5.5 or later
- PHP 5.6 or later
- MediaWiki 1.27 or later
- [Semantic MediaWiki][smw] 2.4 or later
- [Semantic MediaWiki][smw] 2.5 or later

## Installation

The recommended way to install Semantic Interlanguage Links is by using [Composer][composer]
with an entry in MediaWiki's `composer.json` or alternatively [`composer.local.json`][composer-local].
The recommended way to install Semantic Interlanguage Links is using [Composer](http://getcomposer.org) with
[MediaWiki's built-in support for Composer](https://www.mediawiki.org/wiki/Composer).

```json
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. This is where the "LocalSettings.php"
file is located. If you have not yet installed Composer do it now by running the following command
in your shell:

wget https://getcomposer.org/composer.phar

### Step 2

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": "~1.4"
"mediawiki/semantic-interlanguage-links": "~1.5"
}
}
```
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.

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": "~1.5"

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

### Step 3

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. Also
note that it may be necessary to run this command twice. If unsure do it twice right away.

### Verify installation success

As final step, you can verify SCI got installed by looking at the "Special:Version" page on your wiki and
check that it is listed in the semantic extensions section.

## Usage

The parser function `{{interlanguagelink: ... }}` provides an interface
to declare multilingual content using semantic annotations.
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.
`{{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](https://cloud.githubusercontent.com/assets/1245473/9477943/450195e0-4b75-11e5-9cd4-61e2672eb8fa.png)

Further details and usage examples can be found [here](docs/README.md).

## 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.
If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guideline.

* [File an issue](https://github.com/SemanticMediaWiki/SemanticLanguageLinks/issues)
* [Submit a pull request](https://github.com/SemanticMediaWiki/SemanticLanguageLinks/pulls)
Expand Down
11 changes: 11 additions & 0 deletions RELEASE-NOTES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
This file contains the RELEASE-NOTES of the Semantic Interlanguage Links (a.k.a. SIL) extension.

### 1.5.0

Released on October 8, 2018.

* Minimum requirement for
* PHP changed to version 5.6 and later
* Semantic MediaWiki changed to version 2.5 and later
* Fixed issue with `DIProperty::findPropertyLabel`
* #59 Removed the useage of deprecated `wfBCP47()` global function
* Localization updates from https://translatewiki.net

### 1.4.0

Released on July 29, 2017.
Expand Down
2 changes: 1 addition & 1 deletion SemanticInterlanguageLinks.php
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ public static function load() {
*/
public static function initExtension() {

define( 'SIL_VERSION', '1.5.0-alpha' );
define( 'SIL_VERSION', '1.5.0' );

// Register extension info
$GLOBALS[ 'wgExtensionCredits' ][ 'semantic' ][ ] = [
Expand Down
4 changes: 2 additions & 2 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
"mediawiki",
"localization"
],
"homepage": "https://semantic-mediawiki.org/wiki/Extension:SemanticInterlanguageLinks",
"homepage": "https://semantic-mediawiki.org/wiki/Extension:Semantic_Interlanguage_Links",
"license": "GPL-2.0-or-later",
"authors": [
{
"name": "mwjames",
"name": "James Hong Kong",
"role": "Developer"
}
],
Expand Down
17 changes: 10 additions & 7 deletions docs/02-ask-queries.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,22 +3,25 @@
List all subjects (articles) that have a reference to the `Shogi` topic.

```
{{#ask: [[Has interlanguage link.Interlanguage reference::Shogi]]
|?Some property
{{#ask:
[[Has interlanguage link.Interlanguage reference::Shogi]]
|?Some property
}}
```
List all available languages that are connected to the `Shogi` topic.

```
{{#ask: [[Interlanguage reference::Shogi]]
|?Page content language
{{#ask:
[[Interlanguage reference::Shogi]]
|?Page content language
}}
```

The subject `将棋` is assigned to which language?

```
{{#ask: [[-Has interlanguage link::将棋]]
|?Page content language
{{#ask:
[[-Has interlanguage link::将棋]]
|?Page content language
}}
```
```

0 comments on commit 4f1d018

Please sign in to comment.