Extension:Attachments

MediaWiki 拡張機能マニュアル

Attachments リリースの状態: 安定
実装	パーサー関数 , 変数 , ページの操作 , フック
説明	下位ページ、ファイル、外部リンクをページに添付できるようにする。
作者	(Gittenburgトーク)
最新バージョン	0.1.0 (2019-06-11)
互換性ポリシー	master は後方互換性を維持しています。
MediaWiki	1.32+
ライセンス	MIT ライセンス
ダウンロード	GitHub: プロジェクトのページ git リポジトリの URL [ヘルプ ] コミット履歴 注: 地域化の更新は translatewiki.net からは提供されません。
例	https://vowi.fsinf.at/
パラメーター $wgAttachmentsNamespaces $wgAttachmentsChunkListByLetter $wgAttachmentsShowSubpageForm $wgAttachmentsShowLinkForm
使用するフック ParserFirstCallInit BeforePageDisplay MagicWordwgVariableIDs ParserGetVariableValueSwitch SkinTemplateNavigation MinervaPreRender ListDefinedTags ChangeTagsListActive
提供するフック BeforeSortAttachments ShowEmptyAttachmentsSection
使用状況とバージョン マトリクスを確認してください。

Attachments 拡張機能は、利用者が有効な名前空間内のページに下位ページ、ファイル、外部リンクを添付できるようにします。

• Attachments can easily be added through the user interface.
• Attachments of an article are displayed in an automatically generated list at its end.
• This extension integrates with the Vector and Minerva skins.

So how does it work?

• subpages automatically count as attached to their parent page
• When you upload a file through the Attach page action, a parser function {{#attach: Title}} is added to the descripiton.
• When you add a link, the extension creates a subpage containing the {{#exturl: URL}} parser function.
• Both parser functions set page properties, which are queried for the autogenerated sections.

高度な機能

• #attach can also be used to attach a regular page to another regular page.
• You can exclude subpages starting with a specific prefix from the autoindex with {{#attachments ignore subpages: prefix}} on the parent page.
• You can access attachments before they are sorted with the BeforeSortAttachments(&$links) hook, where links is an associative array mapping string keys to HTML links. Return false to take over the sorting.

Relatively linking an attached file

The Attachments extension provides the {{FILEPREFIX}} parser function to faciliate linking/embedding attached files.

If you attach an image Example.jpg to Somepage then you can embed the image:

• from Somepage with [[File:{{FILEPREFIX}}Example.jpg]]
• from Somepage/Subpage with [[File:{{FILEPREFIX:..}}Example.jpg]]
• from Somepage/Subpage/Subsubpage with [[File:{{FILEPREFIX:../..}}Example.jpg]]

Note that the same also works with [[Media:...]] links.

インストール

• Enable Uploads .

• ダウンロードして、ファイルをextensions/フォルダー内のAttachmentsという名前のディレクトリ内に配置します。
• 以下のコードを LocalSettings.php の末尾に追加します:

  wfLoadExtension( 'Attachments' );
  

•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

You will need to enable the extension for the namespaces where you want to use it, e.g:

$wgAttachmentsNamespaces[NS_MAIN] = true;

Note that you should also enable subpages for these namespaces.

省略可能な構成パラメーター

$wgAttachmentsChunkListByLetter

Boolean, whether or not the attachment list should be chunked by the first letter of list items. Defaults to true.

$wgAttachmentsShowSubpageForm

Boolean, whether or not the subpage form should be shown. Defaults to true.

$wgAttachmentsShowLinkForm

Boolean, whether or not the external link form should be shown. Defaults to true.

ヒント

• Enable $wgCountCategorizedImagesAsUsed to exclude attached files from Special:UnusedImages.
• Attachments and external URLs are both stored as page props, meaning they can be queried with API:Pageprops and API:Pageswithprop.
• Set $wgForeignUploadTargets to [], if you want to prevent users from circumventing this extension through the upload dialog.
• If new attachments do not show up, it might be because you have many jobs in your job queue.

クレジット

This extension is essentially a complete rewrite of PerPageResources by Mathias Ertl, which consists of Extension:Resources, Extension:AddResource and Extension:ExternalRedirects. This extension replaces all three, notable differences are:

• attachments are stored in page_props instead of pagelinks
• no open redirects, just links
• attachments are shown at the end of pages, as opposed to on a special page

関連項目

• MoinMoinWiki - supports attachments out of the box.
• Extension:PageAttachment - unmaintained, has 7k lines of PHP – this extension has about 400
• Extension:FileAttach - unmaintained, saves attachments in wikitext