Jump to content

Extension:HTML Tags

From mediawiki.org
This page is a translated version of the page Extension:HTML Tags and the translation is 48% complete.
MediaWiki 拡張機能マニュアル
HTML Tags
リリースの状態: 安定
実装 タグ
説明 Defines a tag, ‎<htmltag>, that allows for placing HTML tags on the page out of a set of allowed tags and attributes pre-specified by the administrator.
作者 Yaron Koren <yaron57@gmail.com>
最新バージョン 0.3 (2020-01-22)
MediaWiki 1.29+
データベースの変更 いいえ
ライセンス GNU 一般公衆利用許諾書 2.0 以降
ダウンロード
HTMLタグ拡張機能の例
  • $wgHTMLTagsAttributes

  • ‎<htmltag>
translatewiki.net で翻訳を利用できる場合は、HTML Tags 拡張機能の翻訳にご協力ください

拡張機能HTMLタグは、‎<htmltag>を定義し、MediaWikiによって許可されないHTMLタグをwikiページ内に表示するために使用できます。

HTML Tags was initially developed in order to allow support the use of LRMI (Learning Resource Metadata Initiative) tags within MediaWiki pages. See Implementing LRMI for how to implement such a thing using HTML Tags.

HTMLタグのもう1つの可能性のある使い方は、マイクロデータ(特にすでに埋め込むことができない種類)を埋め込むことです。

この拡張機能の基本的な例はこちらでご覧いただけます。

コードとダウンロード

HTMLタグは .zip形式で、ここからダウンロードできます。

また、MediaWiki のソース コード リポジトリから Git 経由で直接ダウンロードすることもできます。 From a command line, you can call the following:

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

To view the code online, including version history for each file, go here.

インストール

警告 警告: 安全でないタグを許可するとXSS脆弱性につながるので、この拡張機能の設定方法には十分注意してください。 たとえば、以下のように<a>を許可すると、次のようなコードでXSSを引き起こす可能性があります。 <htmltag tagname="a" href="javascript:alert('XSS');">ここをクリック</htmltag>

After you've obtained an 'HTMLTags' directory (either by extracting a compressed file or downloading via Git), place this directory within the main MediaWiki 'extensions' directory. Then, in the file 'LocalSettings.php' in the main MediaWiki directory, add the following line:

wfLoadExtension( 'HTMLTags' );

You then need to specify the allowed set of HTML tags, and the allowed set of attributes for each one, using the global variable $wgHTMLTagsAttributes. For instance, to allow the ‎<a> tag, and to allow only the attributes "href" and "class" for it, you would add the following to LocalSettings.php, after the inclusion of LocalSettings.php:

$wgHTMLTagsAttributes['a'] = [ 'href', 'class' ];

If you wanted to allow the tag ‎<fieldset>, but without any allowed attributes, you would add the following:

$wgHTMLTagsAttributes['fieldset'] = [];

使用法

Once a set of allowed tags and attributes are specified, you can use ‎<htmltag> to place those tags on the page. You use the attribute "tagname" to specify the actual tag, and then add the other attributes exactly as you want them to appear. The "contents" of the tag become the contents of ‎<htmltag>.

For instance, if the above lines are added, and you want to add a link on some page using the ‎<a> tag, you could add something to the page like:

<htmltag tagname="a" href="http://en.wikipedia.org/wiki/Antarctica" class="my-links">Read about Antarctica</htmltag>

This will add the following to the page's HTML source:

<a href="http://en.wikipedia.org/wiki/Antarctica" class="my-links">Read about Antarctica</a>

Calling ‎<htmltag> with a tag name that is not allowed will result in an error message; calling it with an attribute that is not allowed will simply lead to the attribute being ignored.

See Implementing LRMI for a full description of how this extension, along with some templates, can be used to allow for easy adding of LRMI metadata to pages.

作者

HTML Tags was written by Yaron Koren, reachable at yaron57 -at- gmail.com.

This extension was funded by Creative Commons as part of the LRMI project.

バージョン履歴

HTMLタグは現在バージョン0.3です。

バージョン履歴:

  • 0.1 - 2012年11月1日 - 初期バージョン
  • 0.2 - 2014年5月27日 - i18nメッセージをJSONファイルに移動。様々な修正
  • 0.3 - January 22, 2020 - converted to extension registration

関連項目