Extension:BibManager
Soliciting Project Owners Looking for additional project owners. In addition to actively soliciting your suggestions for improvements and fixes, we'd like to have a more robust set of code reviewers and testers. You'll be in on plans and updates. All you have to do is request ownership here. |
BibManager Release status: stable |
|
---|---|
Implementation | Tag , Special page , Database |
Description | Enables MediaWiki to store and manage bibliographic data and to use it within an article. |
Author(s) | Robert Vogel (Talk),Tobias Weichart (Talk), Daniel Riedmüller (Talk), |
Latest version | 1.23 |
MediaWiki | >= 1.39 |
Database changes | Yes |
Tables | bibmanager bibmanager_page_citation_rel |
License | GNU General Public License 2.0 or later |
Download | |
|
|
|
|
|
|
Quarterly downloads | 3 (Ranked 123rd) |
Translate the BibManager extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The BibManager extension enables MediaWiki to store BibTeX data and to use these entries within an article. It offers forms to create edit and otherwise manage bibliograpic data and allows import and export of BibTeX format. It has been developed in 2011 for the SaltWiki-Project of the HAWK Hochschule Hildesheim/Holzminden/Göttingen, Hornemann Institut by Hallo Welt! Medienwerkstatt GmbH and can be helpful for universities and scientific work.
Download
editThe extension can be retrieved directly from Git [?]:
- Browse code
- Some extensions have tags for stable releases.
- Browse tags
- Select the tag
- Click "snapshot"
- Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
- Browse branches
- Select a branch name
- Click "Continue"
Extract the snapshot and place it in the extensions/BibManager/ directory of your MediaWiki installation.
If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BibManager.git
Installation
edit- Download and move the extracted
BibManager
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BibManager - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'BibManager' );
- Run the update script which will automatically create the necessary database tables that this extension needs.
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration parameters
edit$wgBibManagerUseJS
- Whether or not to use JS for better user experience. Default is
true
. $wgBibManagerRepoClass
- This is for future development. Default is
'BibManagerLocalMWDatabaseRepo'
. You may implement your own repo by extending the abstractBibManagerRepository
class inincludes/BibManagerRepository.php
. $wgBibManagerCitationFormats
- An associative array that defines the output format of the various entry types. Please take a look ah the
BibManager.php
for an example. $wgBibManagerCitationArticleNamespace
- The namespace citation links point to. Default is
NS_MAIN
. $wgBibManagerScholarLink
- The link to which the 'Google Scholar' link points. Default is
'http://scholar.google.com/scholar?q=%title%'
.
User rights
editbibmanageredit
- User can access the edit special page. Edit links are shown.
bibmanagerdelete
- User can delete entries. Delete links are shown.
bibmanagercreate
- User can add or import entries. Creation and import SpecialPages can be accessed.
Tags
editTo use one of the three BibManager-Tags proceed as follows:
<bib id="citation" />
- Get a link to the citation you have set up before (e.g.
<bib id='testing:2010' />
points to the articleTesting:2010
) <biblist />
- List all the
<bib />
tags embedded in the articles text (list in alphabetical order) <bibprint />
- Render list of citations. You can use the
filter
attribute to influence the result. I.e.<bibprint filter="year:2011|2010, author:hawkins" />
will show all entries from the repository that are from the year 2011 OR 2010 AND have hawkins as author.
Further documentation
editIdeas for futher development / TODOs
edit- Add additional fields like on uni-bremen.de on section Other fields.
- Implement API for remote access and shared repos
- Add a article <-> entry relationship table for automatic purging at entry change and sophisticated querys like Other pages using this entry
Licensing
edit© GPL, see subfolder "docs/"
Icons from famfamfam are used within this extension.