Extension:TemplateSandbox

これは、拡張機能の技術的な文書です。 利用者向け説明文書もあります。

MediaWiki 拡張機能マニュアル

TemplateSandbox リリースの状態: 安定
実装	特別ページ , ページの操作
説明	サンドボックス化されたTemplateを使ってページをプレビューする
作者	Brad Jorsch (Anomieトーク)
最新バージョン	1.1.0 (continuous updates)
互換性の方針	MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
MediaWiki	>= 1.43
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (Phabricator · GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
ヘルプ	Help:Extension:TemplateSandbox/ja
パラメーター $wgTemplateSandboxEditNamespaces
使用するフック APIGetAllowedParams AlternateEditPreview ApiMakeParserOptions EditPage::importFormData EditPage::showStandardInputs:options
四半期ごとのダウンロード数	43 (Ranked 94th)
使用中の公開ウィキ	1,040 (Ranked 233rd)
translatewiki.net で翻訳を利用できる場合は、TemplateSandbox 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

The TemplateSandbox extension adds the ability to preview a page using sandboxed versions of templates, allowing for easy testing before making the sandbox code live. It also works with Scribunto modules.

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のTemplateSandboxという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TemplateSandbox
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'TemplateSandbox' );
  

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

設定

パラメーター

• $wgTemplateSandboxEditNamespaces - Namespaces in which to show the "Preview page with this template" box below the edit form. NS_TEMPLATE by default. Can be expanded to all namespaces by individual users using advancedtemplatesandbox.js.

使用法

The extension adds a new special page, Special:TemplateSandbox. To preview a page using sandboxed templates, do the following:

1. Copy the templates to be tested under a common prefix. For example, you might copy Template:Foo to User:Example/sandbox/Template:Foo. Alternatively, you might create User:Example/sandbox/Template:Foo as a redirect to Template:Foo/sandbox.
2. Go to Special:TemplateSandbox. Fill in the page or revision to be rendered, and the prefix you chose in step 1. It is possible to specify multiple prefixes (a prefix search path) by separating them using vertical bars, e.g., User:Example/sandbox1|User:Example/sandbox2.
3. Click View.

The extension also adds a box at the bottom of the edit form for pages in the namespaces configured in $wgTemplateSandboxEditNamespaces. This allows for previewing some other page as it would appear were the template being edited saved with the current contents of the edit form. The box can be forced to appear in the edit form for any page by adding the query parameter wpTemplateSandboxShow to the URL.

関連項目

• User:Jackmcbarn/advancedtemplatesandbox.js — A user script that enables use of TemplateSandbox for all pages.
• Help:テンプレート展開
• Extension:SandboxLink
• Extension:Scribunto − This extension also allows for sandboxing Scribunto modules.