Semantic Cite

, _(*1)

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., _(*2)

It can be used to centralize the management of citation resources and foster the reuse of references stored within a wiki. Supported features include:, _(*3)

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"., _(*4)

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., _(*5)

Installation

The recommended way to install Semantic Cite is using Composer with MediaWiki's built-in support for Composer., _(*6)

Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided., _(*7)

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:, _(*8)

{
    "require": {
        "mediawiki/semantic-cite": "~3.0"
    }
}

If you already have a "composer.local.json" file add the following line to the end of the "require" section in your file:, _(*9)

"mediawiki/semantic-cite": "~3.0"

Remember to add a comma to the end of the preceding line in this section., _(*10)

Step 2

Run the following command in your shell:, _(*11)

php composer.phar update --no-dev

Note if you have Git installed on your system add the --prefer-source flag to the above command., _(*12)

Step 3

Add the following line to the end of your "LocalSettings.php" file:, _(*13)

wfLoadExtension( 'SemanticCite' );

Step 4

Run the maintenance script "update.php" to ensure that property tables are properly initialized., _(*14)

Usage

scite-sneak , _(*15)

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., _(*16)

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., _(*17)

{{#scite:Byrne 2008
 |type=journal
 |author=Byrne, A
 |year=2008
 |title=Web 2.0 strategies in libraries and information services
 |journal=The Australian Library Journal
 |volume=57
 |number=4
 |pages=365-376
}}

Above shows an example for a citation resource to be created by the #scite parser. More information about #scite can be found here., _(*18)

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]...., _(*19)

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., _(*20)

More information about in-text citations and references can be found here together with a description about the usage of the #referencelist parser function., _(*21)

For questions about Semantic Cite and Cite, see the comments section., _(*22)

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., _(*23)

For more information, please read the search section., _(*24)

Configuration

To change default settings, or add property mapping add text formatting rules, please read the configuration document., _(*25)

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., _(*26)

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., _(*27)