| commit | ece969995a939e5c09ea95e412e11682f7fba99a | [log] [tgz] |
|---|---|---|
| author | jenkins-bot <jenkins-bot@gerrit.wikimedia.org> | Fri Dec 13 17:06:55 2024 +0000 |
| committer | Gerrit Code Review <gerrit@wikimedia.org> | Fri Dec 13 17:06:55 2024 +0000 |
| tree | c0b8d450082c62047bee4e9bda7dc11fc40cff3c | |
| parent | 4b9c9fe021120a561471050c0a29ecf004232dc0 [diff] | |
| parent | afb61b199011c85a5782cc77fd9133040bc00de4 [diff] |
Merge "Fix missing Rdbms namespace suffix"
- .github/
- .phan/
- build/
- client/
- data-access/
- docs/
- jmeter/
- lib/
- repo/
- tests/
- view/
- .editorconfig
- .eslintignore
- .eslintrc.js
- .gitignore
- .gitmodules
- .gitreview
- .luacheckrc
- .mailmap
- .phpcs.xml
- .scrutinizer.yml
- .stylelintrc.json
- CODE_OF_CONDUCT.md
- composer.json
- COPYING
- CREDITS
- Doxyfile
- extension-client.json
- extension-repo.json
- Gruntfile.js
- HISTORY
- jsduck.json
- package-lock.json
- package.json
- phpstan.neon
- README.md
- RELEASE-NOTES-1.43
- RELEASE-NOTES-1.44
- sonar-project.properties
- Wikibase.php
Introduction to Wikibase
The Wikibase.git package is part of the Wikibase software and consists of multiple MediaWiki extensions and other components.
The package allows for the creation, maintenance, dissemination, and usage of structured data in MediaWiki.
High level documentation can be found on wikiba.se and mediawiki.org. Lower level documentation can be found on doc.wikimedia.org here.
Install
Wikibase depends on various composer libraries.
Once you have Wikibase in your MediaWiki extensions directory, go to the root of your MediaWiki folder, and if composer.local.json does not yet exist there, copy composer.local.json-sample to composer.local.json (see MediaWiki's Composer documentation).
Then run:
composer install
If you already ran composer install during the installation of MediaWiki, run instead:
composer update
When using ways to combine MediaWiki with the extension folders (e.g. symlinks or docker volumes) please make sure that the folders are available to composer in the same structure they are available to the webserver, too.
This will install both Wikibase Client and Repo together on the same wiki.
If you want to only have one or the other, then set $wgEnableWikibaseRepo = false or $wgEnableWikibaseClient to false for the one you don't want to enable.
Wikibase also depends on several JavaScript libraries. They are included in this repository as submodules. To fetch files of these libraries, you might need to run, in the Wikibase extension folder, the following command:
git submodule update --init
Development
Wikibase uses tools to ensure the quality of software developed. To invoke these tools, inside the Wikibase folder, run:
composer install composer run-script test
As this uses development dependencies and custom configuration, executing it from the MediaWiki root folder (via
composer run-script test extensions/Wikibase) will not work satisfactorily
JavaScript
Wikibase makes use of frontend software from various eras - resulting in a heterogenous technological landscape.
Some notable (not a comprehensive list) mentions are
- the use of ResourceLoader to
- allow for concatenation and minification of code neatly organized in separate files
- translate less to CSS
- model module inter-dependencies
- handle delivery to the client through MediaWiki
- use of the Javascript interfaces exposed by MediaWiki; e.g.
mw.hookin EntityInitializer - frontend components making heavy use of jQuery; e.g. for so called experts
- the use of qunit to test this code; e.g. in
repo/tests/qunit, available via a special page - vue.js as a frontend framework; e.g. in data-bridge, the Lexeme extension, and termbox
Adding language code support in Wikibase
To add support for a new language code (for labels or monolingual text) please refer to the detailed documentation.