Skip to content

Commit

Permalink
Release version 1.2.0 (#36)
Browse files Browse the repository at this point in the history
* Update RELEASE-NOTES.md
* Update README.md
* Update SemanticCompoundQueries.php
  • Loading branch information
kghbln authored Oct 8, 2018
1 parent e612d92 commit 1502bd4
Show file tree
Hide file tree
Showing 3 changed files with 61 additions and 28 deletions.
61 changes: 45 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,35 +10,64 @@ Semantic Compound Queries (a.k.a. SCQ) is a [Semantic Mediawiki][smw] extension

## Requirements

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

## Installation

The recommended way to install Semantic Compound Queries is by using [Composer][composer] with an entry in MediaWiki's `composer.json` or alternatively `composer.local.json`.
The recommended way to install Semantic Compound Queries 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-compound-queries": "~1.1"
"mediawiki/semantic-compound-queries": "~1.2"
}
}
```
1. From your MediaWiki installation directory, execute
`composer require mediawiki/semantic-compound-queries:~1.1`
2. Navigate to _Special:Version_ on your wiki and verify that the extension
has been successfully installed.

Note that the required extension Semantic MediaWiki must be installed first according to the installation
instructions provided with it.
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-compound-queries": "~1.2"

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 syntax of `#compound_query` resembles that of `#ask`, but with more than
one query, and with the elements of each sub-query delimited by semicolons
instead of pipes. Elements that are common across all sub-queries, like
`format=` and `width=` (for maps) should be placed after all sub-queries.
The syntax of `#compound_query` resembles that of `#ask`, but with more than one query, and with the elements
of each sub-query delimited by semicolons instead of pipes. Elements that are common across all sub-queries,
like `format=` and `width=` (for maps) should be placed after all sub-queries.

### Example

Expand Down
26 changes: 15 additions & 11 deletions RELEASE-NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,23 @@ These are the release notes for the Semantic Compound Queries extension.

## Semantic Compound Queries 1.2.0

This is not a release yet.
Released on Oktober 8, 2018

* Minimum requirement for
* PHP changed to version 5.6 and later
* MediaWiki changed to version 1.27 and later
* Semantic MediaWiki changed to version 2.5 and later
* Localization updates from https://translatewiki.net

## Semantic Compound Queries 1.1.0

Released on June 24, 2017.

* Bumped Requirements to:
* PHP 5.5 or later
* Semantic MediaWiki 2.4 or later

* Minimum requirement for
* PHP changed to version 5.5 and later
* Semantic MediaWiki changed to version 2.4 and later
* Made general repository cleanup ... continued
* Provided translation updates (by translatewiki.net community)
* Localization updates from https://translatewiki.net

## Semantic Compound Queries 1.0.1

Expand All @@ -25,11 +30,10 @@ Released on December 21, 2016

Released on September 21, 2016.

* Bumped Requirements to:
* PHP 5.3.2 or later
* MediaWiki 1.23 or later
* Semantic MediaWiki 2.1 or later

* Minimum requirement for
* PHP changed to version 5.3 and later
* MediaWiki changed to version 1.23 and later
* Semantic MediaWiki changed to version 2.1 and later
* Added `compoundquery` API endpoint
* Added `unsorted` parameter
* Added composer support
Expand Down
2 changes: 1 addition & 1 deletion SemanticCompoundQueries.php
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ public static function load() {
*/
public static function initExtension() {

define( 'SCQ_VERSION', '1.2.0-alpha' );
define( 'SCQ_VERSION', '1.2.0' );

// Register the extension
$GLOBALS['wgExtensionCredits']['semantic'][] = [
Expand Down

0 comments on commit 1502bd4

Please sign in to comment.