Extension:BibManager

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:BibManager and the translation is 43% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎فارسی • ‎日本語
MediaWiki 拡張機能マニュアル
OOjs UI icon advanced.svg
BibManager
リリースの状態: 保守されていない
Extension BibManager Logo.svg
実装 Tag, Special page, Database
説明 Enables MediaWiki to store and manage bibliographic data and to use it within an article.
作者 Robert Vogel (Talk),Tobias Weichart (Talk)
最新バージョン 1.22
MediaWiki 1.22+
データベースの変更 はい
ライセンス GNU General Public License 2.0 or later
ダウンロード
タグ
<bib />, <biblist />, <bibprint />
追加する権限
bibmanageredit, bibmanagerdelete, bibmanagercreate
使用するフック
ParserFirstCallInit
BeforePageDisplay
LoadExtensionSchemaUpdates
translatewiki.net で翻訳を利用できる場合は、BibManager 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。

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

拡張機能は、Git から直接取得できる場合があります [?]:

  • コードを参照
  • 一部の拡張機能には安定版リリースのタグがあります。
    • タグを参照
    • タグを選択します
    • 「スナップショット」をクリックします
  • 各ブランチは過去の MediaWiki リリースと関連付けられています。 最新のアルファ バージョンを含む「master」ブランチもあります (MediaWiki のアルファ バージョンが必要な場合用)。

スナップショットを展開して、MediaWiki インストレーション内の extensions/BibManager/ ディレクトリに配置します。

git に馴染みがあり、かつサーバーにシェルでアクセスできる場合は、拡張機能を以下のようにして取得することもできます:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/BibManager.git

Installation

  • ダウンロードして、ファイルを extensions/ フォルダー内の BibManager という名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    wfLoadExtension( 'BibManager' );
    
  • 更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベース テーブルを自動的に作成します。
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

MediaWiki 1.24 以前を稼働させている利用者へ:

上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.24 以前) にインストールする必要がある場合は、wfLoadExtension( 'BibManager' ); の代わりに以下を使用する必要があります:

require_once "$IP/extensions/BibManager/BibManager.php";

Configuration parameters

$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 abstract BibManagerRepository class in includes/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

bibmanageredit
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

To 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 article Testing: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

Ideas for futher development / TODOs

  • 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

© GPL, see subfolder "docs/"

Icons from famfamfam are used within this extension.