Skip to content

Commit 5c1452d

Browse files
authored
Merge pull request #109 from ProfessionalWiki/rel100
Bump to 1.0 and add usage docs
2 parents 61d72db + dfaeb4c commit 5c1452d

File tree

4 files changed

+22
-5
lines changed

4 files changed

+22
-5
lines changed

README.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,23 @@ It was conceived and funded by the [Wikibase Stakeholder Group].
2323

2424
## Usage
2525

26-
TODO
26+
When the extension is enabled, Item and Property pages show a "Mapping to other ontologies" section.
27+
This section is located in between the "In more languages" and "Statements" sections.
2728

29+
<img src="https://user-images.githubusercontent.com/146040/193851219-dc30080a-7cbb-4c1a-9800-e7c7d98ef644.png" style="border: 1px solid black" alt="Property page with a mapping">
30+
31+
Users with editing permissions can add, edit or remove mappings.
32+
33+
A mapping consists of a predicate and a URL. The predicate can only be one out of a preconfigured set of values. The URL has to be a valid URL.
34+
35+
<img src="https://user-images.githubusercontent.com/146040/193851211-b4031ca1-4cc9-47ab-9160-658f4a38d979.png" style="border: 1px solid black" alt="Mapping editing UI">
36+
37+
Mapping predicates can be configured via the `MediaWiki:MappingPredicates` page by anyone with interface-admin permissions.
38+
You can also configure mapping predicates via [PHP Configuration](#php-configuration).
39+
40+
<img src="https://user-images.githubusercontent.com/146040/193851215-86b8ad05-0c1a-431c-ad4b-5750997fd642.png" style="border: 1px solid black" alt="Mapping predicates configuration page">
41+
42+
<img src="https://user-images.githubusercontent.com/146040/193854181-af8b85f2-1444-4882-a0af-d8123331f30c.png" style="border: 1px solid black" alt="Editing mapping predicates via the configuration page">
2843

2944
### REST API
3045

@@ -83,6 +98,8 @@ $wgWikibaseRdfPredicates = [
8398
];
8499
```
85100

101+
You can also configure what predicates are allowed via the `MediaWiki:MappingPredicates` page.
102+
86103
## Development
87104

88105
To ensure the dev dependencies get installed, have this in your `composer.local.json`:
@@ -120,7 +137,7 @@ Alternatively, you can execute commands from the MediaWiki root directory:
120137

121138
## Release notes
122139

123-
### Version 1.0.0 - TBD
140+
### Version 1.0.0 - 2022-10-04
124141

125142
Initial release for Wikibase 1.37 with these features:
126143

extension.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "Wikibase RDF",
33
"type": "wikibase",
44

5-
"version": "1.0.0-alpha",
5+
"version": "1.0.0",
66

77
"author": [
88
"[https://Professional.Wiki/ Professional.Wiki]",

i18n/de.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
"wikibase-rdf-save-mappings-save-failed": "Speichern fehlgeschlagen",
1818
"wikibase-rdf-entity-id-invalid": "Die von Dir angegebene Entitätskennung ist ungültig.",
1919
"wikibase-rdf-permission-denied": "Du bist nicht berechtigt, die RDF-Zuordnungen zu dieser Entität zu bearbeiten.",
20-
"wikibase-rdf-config-intro": "Das Entfernen von RDF-Prädikaten, die im Wiki genutzt werden, verursacht Probleme mit der Eingabemaske. Davon wird daher abgeraten.",
20+
"wikibase-rdf-config-intro": "",
2121
"wikibase-rdf-config-invalid": "{{PLURAL:$1|Ungültiges RDF-Prädikat|Ungültige RDF-Prädikate}}:\n$2. Die Änderungen wurden nicht gespeichert.",
2222
"wikibase-rdf-config-list-intro": "Diese Seite gibt an, welche Prädikate für die Zuordnungen zu anderen Ontologien verwendet werden können. Diese Funktionalität ist Teil der <a href=\"https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:WikibaseRDF\">„Erweiterung Wikibase RDF“</a>.",
2323
"wikibase-rdf-config-list-heading": "{{PLURAL:$1|Zulässiges RDF-Prädikat|Zulässige RDF-Prädikate}}:",

i18n/en.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
"wikibase-rdf-entity-id-invalid": "The entity ID you specified is invalid",
2222
"wikibase-rdf-permission-denied": "You do not have permission to edit this entity's mappings",
2323

24-
"wikibase-rdf-config-intro": "Removing predicates that are in use on your wiki breaks the editing UI and is not recommended.",
24+
"wikibase-rdf-config-intro": "",
2525
"wikibase-rdf-config-invalid": "Invalid {{PLURAL:$1|predicate|predicates}}:\n$2. Your changes were not saved.",
2626

2727
"wikibase-rdf-config-list-intro": "This page defines which predicates can be used in mappings to other ontologies. This functionality is part of the <a href=\"https://www.mediawiki.org/wiki/Extension:WikibaseRDF\">Wikibase RDF extension</a>.",

0 commit comments

Comments
 (0)