Extension:Wikibase EDTF

From mediawiki.org
Jump to navigation Jump to search
Other languages:
English • ‎日本語
MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Wikibase EDTF
Release status: stable
20210421 Srceenshot Wikibase-EDTF-extension example-statements.png
Description Adds support for the Extended Date/Time Format (EDTF) Specification via a new data type
Author(s) Jeroen De Dauwtalk
Maintainer(s) Professional.Wiki
Latest version 1.2.0 (2021-04-28)
MediaWiki 1.35.x
PHP 7.4+
Database changes No
Composer professional-wiki/wikibase-edtf
License GNU General Public License 2.0 or later
Download
README
CHANGELOG

Compatibility

  • Wikibase Repository: REL1_35 branch

Check usage and version matrix.

The Wikibase EDTF extension adds support for the Extended Date/Time Format (EDTF) Specification to Wikibase via a new data type.

See the documentation for detailed installation and usage instructions or the demo video for a short introduction.

Initial development[edit]

Initial development was funded by the Luxembourg Ministry of Culture.

Extended Date/Time Format (EDTF)[edit]

EDTF is part of ISO 8601-2:2019, which defines various extensions to ISO 8601 standard, such as uncertainties. For the implementation of the project the development team followed the publicly available concise description of the standard on the specification site of the U.S. Library of Congress.

The implementation supports:

  • Dates
  • Date and time
  • Time Intervals
  • Letter-prefixed calendar year
  • Seasons
  • Qualification of a date
  • Unspecified digit(s) from the right
  • Negative calendar years
  • Exponential years
  • Significant digits
  • Sub-year groupings
  • Set representations
  • Qualifications
  • Unspecified Digits
  • Intervals

Structure[edit]

The extension is divided into two libraries. One Library is a standalone PHP EDTF interpretation and humanisation library. It can be found at ProfessionalWiki/EDTF. Note that the library can be used independently from this extension.

This library is wrapped by this extension that interacts with the library and provides further functionality, e.g. GUI and export to RDF.

Functionality[edit]

The extension provides the user with an open text field where they can put in any text. Upon saving this text is validated against proper formatting of EDTF. If the string is not properly formatted the string is not saved. The users will be presented with an error message.

When the string is a valid EDTF-date it is saved. In the GUI a 'humanised' string is generated that transforms the string to a short sentences that is human readable.

Example humanisation
[2021-02-15, 2021-02-16, 2021-32, 2020-XX-11]

becomes

One of these:

  • February 15th, 2021
  • February 16th, 2021
  • Winter (Southern Hemisphere) 2021
  • 11th of unknown month, 2020

Interface translations[edit]

The extension is being translated via translatewiki.net. Its project can be found here.

See also[edit]