Extension:Lingo
Lingo リリースの状態: 安定 |
|
---|---|
実装 | 拡張構文 , 外装 |
説明 | ウィキページで言葉にカーソルを当てると、登録された定義をツールチップに表示する機能です。 |
作者 | |
メンテナー | WikiTeq team |
最新バージョン | 3.2.4 (2024-12-12) |
互換性の方針 | 長期間サポート リリースであるすべての MediaWiki リリースについて、拡張機能に対応するブランチが存在します。 |
MediaWiki | 1.39 |
PHP | 7.4+ |
データベースの変更 | いいえ |
Composer | mediawiki/lingo |
ライセンス | GNU 一般公衆利用許諾書 2.0 以降 |
ダウンロード | README Release notes |
|
|
四半期ごとのダウンロード数 | 25 (Ranked 105th) |
translatewiki.net で翻訳を利用できる場合は、Lingo 拡張機能の翻訳にご協力ください | |
問題点 | 未解決のタスク · バグを報告 |
Lingo is a glossary extension. It lets you define a list of abbreviations and their definitions on a page and then displays them whenever an abbreviation is hovered over in an article.
The encoding of definitions is WCAG compliant, and should be available in screen readers as well.
使用法
術語のページ
既定では Lingo はウィキの Terminology ページ (またはウィキの言語におけるそれぞれのページ) で定義された用語と定義ですべてのページをマークアップすることになっています。 そのページを作成し、次の構文でいくつかのエントリーを挿入するだけです。
;FTP:File Transfer Protocol ;AAAAA:American Association Against Acronym Abuse ;ACK:Acknowledge ;AFAIK:As Far As I Know ;AWGTHTGTATA:Are We Going To Have To Go Through All This Again ;HTTP:HyperText Transfer Protocol
用語にはどんな文字でも使用でき(句読点、スペース、すべてのUTF-8文字を含むが、もちろんコロン(:)は除く)、文字だけに限定されることはない。
用語集のページを構成するために、用語と定義を別々の行にすることもできます。 セミコロン(;)またはコロン(:)で始まらない行は無視されますので、空行、見出し、説明文などをどんどん入れてください。
Using this format, you may assign one definition to multiple terms, e.g., to cover grammatical variants (see the U.S.A. example below), and multiple definitions to one term, e.g., to cover different meanings (see the ACK example). You may even combine this, i.e., have multiple definitions for a set of multiple terms. Finally, you may also use transclusion, e.g., to have different glossaries for different topics and pull them all together on the Terminology page.
;FTP :File Transfer Protocol ;AAAAA :American Association Against Acronym Abuse ;ACK :Acknowledge :Acklington railway station ;U.S.A. ;USA :United States of America Pull in more terminology from elsewhere: {{:MoreTerminology}}
語彙をマークアップから除外する
You can exclude an article from markup by including the magic word __NOGLOSSARY__
anywhere in that article's text.
In some cases, it may be necessary to exclude only portions of a page, e.g., because Lingo interferes with some JavaScript. This can be achieved by wrapping that part in an HTML element (e.g., a span or a div) and specifying class="noglossary"
. As a shorthand for <span class="noglossary">
you can just use the <noglossary>
tag.
ApprovedRevs
Lingo supports the Approved Revs extension for the Terminology page. See Customization below.
国際化
The extension is pretty well internationalized by now, thanks to the efforts of the volunteers on https://translatewiki.net. (If your language is not supported yet, get an account there and help yourself. It's easy!) To find out the name of the Terminology page and of the __NOGLOSSARY__
magic word in your wiki's language, have a look at the files in the i18n
folder and the Lingo.i18n.magic.php
file. If you want to change the name of the Terminology page, you can do so by editing the page on your wiki named MediaWiki:lingo-terminologypagename.
インストール
Composer
Lingo should be installed using Composer. The package name is mediawiki/lingo
. For instructions on how to install Composer, see MediaWiki's Composer User manual .
- Run
COMPOSER=composer.local.json php composer.phar require --no-update mediawiki/lingo ^3.0
from the MediaWiki installation directory. - Run
php composer.phar update --no-dev mediawiki/lingo
from the MediaWiki installation directory.- Any future update is then just a call to
php composer.phar update --no-dev mediawiki/lingo
.
- Any future update is then just a call to
- Add to the end of LocalSettings.php :
wfLoadExtension('Lingo');
- Do some customization if necessary (see below)
- Go to the Special:Version page of your wiki and verify that an entry for Lingo exists
- From Lingo's entry on the Special:Version page follow the link to the Terminology page of your wiki and insert some entries OR (if this page exists already) edit and re-save it to trigger the recreation of the glossary
パッケージ版をダウンロード
If Composer is not an option, you may also install it like this:
- Download Lingo 3.2.0 or the current development version (Alternatively you can clone Lingo using git.)
- Extract the files to the
$IP/extensions
directory - If necessary rename the newly created directory to Lingo
- Add to the end of LocalSettings.php :
wfLoadExtension('Lingo');
- Do some customization if necessary (see below)
- Go to the Special:Version page of your wiki and verify that an entry for Lingo exists
- From Lingo's entry on the Special:Version page follow the link to the Terminology page of your wiki and insert some entries OR (if this page exists already) edit and re-save it to trigger the recreation of the glossary
カスタマイズ
Add the following to LocalSettings.php
and uncomment/modify as needed:
// specify a different name for the terminology page (Default: 'Terminology' (or localised version). See MediaWiki:Lingo-terminologypagename.)
//$wgexLingoPage = 'Terminology';
// specify that each term should be annotated only once per page (Default: false)
//$wgexLingoDisplayOnce = false;
// specify what namespaces should or should not be used (Default: Empty, i.e. use all namespaces)
//$wgexLingoUseNamespaces[NS_SPECIAL] = false;
// set default cache type (Default: null, i.e. use main cache)
//$wgexLingoCacheType = CACHE_NONE;
// use ApprovedRevs extension on the Terminology page (Default: false)
//$wgexLingoEnableApprovedRevs = true;
MobileFrontend suppresses Lingo's styling, which makes all Definitions used on the article appear at the end of the page. To avoid this add the following to your LocalSettings.php when using MobileFrontend:
$wgMFRemovableClasses = [ 'base' => [ '.mw-lingo-tooltip' ] ];
Lingo also provides an interface to plug in alternative dictionaries (backends). If you are interested in that, see Semantic Glossary for an example. You can also drop me a mail.
Finally you can provide your own styling. For the classes used by Lingo for the various HTML elements, please have a look at the style file.
事例集
- NORA online - Dutch Government Reference Architecture website
- Helminthic Therapy Wiki - Information database about helminth replacement therapy - see notes here)
- https://www.wissensmanagement.gv.at - Website for Knowledge Management in Austrian Government
Add your wiki here!
You can find other examples on the usage and version matrix
バージョン履歴
クレジット
Lingo is a rewrite of extension Terminology, written by BarkerJr with modifications by Benjamin Kahn. Lingo was originally written by Barry Coughlan and is currently maintained by WikiTeq.
Lingo makes use of the jQuery qTip2 library.
バグ報告
Bugs and feature requests should preferably be reported on the Wikimedia bug tracker.
Comments, questions and suggestions should be sent or posted to:
- the Lingo discussion page
- the maintainer
関連項目
この拡張機能は以下のウィキ ファーム/ウィキ ホスト/パッケージに含まれています: これは正式な一覧ではありません。 一部のウィキ ファーム/ウィキ ホスト/パッケージは、ここに記載されていなくてもこの拡張機能を含んでいる場合があります。 必ずご利用のウィキ ファーム、ウィキ ホスト、バンドルで確認してください。 |