Download the PHP package mediawiki/semantic-cite without Composer
On this page you can find all versions of the php package mediawiki/semantic-cite. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mediawiki/semantic-cite
More information about mediawiki/semantic-cite
Files in mediawiki/semantic-cite
Package semantic-cite
Short Description A Semantic MediaWiki extension to manage citation resources.
License GPL-2.0-or-later
Homepage https://semantic-mediawiki.org/wiki/Extension:Semantic_Cite
Informations about the package semantic-cite
Semantic Cite
Semantic Cite (a.k.a. SCI) is a Semantic Mediawiki extension that provides a simple way of organizing citation resources with the help of semantic annotations.
It can be used to centralize the management of citation resources and foster the reuse of references stored within a wiki. Supported features include:
- Self-added and customizable reference list
- Individual property annotation and text formatting rules
- In-text reference tooltip
- Bibtex record import support
- Metadata retrieval from selected providers (PubMed, CrossRef etc.)
Several short videos demonstrate "How Semantic Cite can be used or is expected to work".
Requirements
- PHP 7.4 or later
- MediaWiki 1.35 or later
- Semantic MediaWiki 3.0 or later
Semantic Cite does not require nor uses any part of extension Cite (or <ref>
tags) as a means to declare
a citation resource.
Installation
The recommended way to install Semantic Cite is using Composer with MediaWiki's built-in support for Composer.
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. If you do not have a "composer.local.json" file yet, create one and add the following content to 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-cite": "~3.0"
Remember to add a comma to the end of the preceding line in this section.
Step 2
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.
Step 3
Add the following line to the end of your "LocalSettings.php" file:
wfLoadExtension( 'SemanticCite' );
Step 4
Run the maintenance script "update.php" to ensure that property tables are properly initialized.
Usage
A citation resource collects all structured data of a citation under one unique key that can be accessed
through out the wiki and is created and managed by the #scite
parser function.
Citation resources (those created by #scite
) can be added to a source page or any other wiki page each
being identifiable by a citation key.
Above shows an example for a citation resource to be created by the #scite
parser. More information about
#scite
can be found here.
In-text citation
A resource can be cited using the Citation reference
(or its alias CiteRef
) property for an in-text
annotation in form of Lorem ipsum [[CiteRef::Byrne 2008]] ...
to appear as Lorem ipsum
[1]
...
.
A reference list is automatically added to the content as soon as a Citation reference
annotation is added
to a page. The magic word __NOREFERENCELIST__
can be used to suppress a reference list from showing on an
individual page while #referencelist
can be used to position the list differently.
More information about in-text citations and references can be found here together with a
description about the usage of the #referencelist
parser function.
For questions about Semantic Cite and Cite
, see the comments section.
Metadata search
Special:FindCitableMetadata
is provided as user interface to search, find, and map metadata with the
#scite
parser to conveniently integrate authority data from sources like PubMed or CrossRef.
For more information, please read the search section.
Configuration
To change default settings, or add property mapping add text formatting rules, please read the configuration document.
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.
- File an issue
- Submit a pull request
- Ask a question on the mailing list
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
All versions of semantic-cite with dependencies
composer/installers Version ^1.0.12
mediawiki/semantic-media-wiki Version ~3.0|~4.0
onoi/cache Version ~1.2
mediawiki/http-request Version ~2.0|~1.1
onoi/remi Version ~0.2