Extension:TemplateStyles/ja

TemplateStyles拡張機能は、Wikiマークアップ記法のページからCSSを読み込むことを可能にするためのタグを導入します. これをテンプレートに書くことで、に配置しなくてもテンプレートにカスタムCSSを影響させることができます.

拡張機能をWiki上でエディタとして使用する方法は、を参照してください.

使用法
まず、CSSページを作ってください. 既定では、「.css」で終わるテンプレート名前空間の下位ページは、すべて、文法エラーがなければ「サニタイズ済みCSS」で作成されます.

名前空間の集合が で修正されるか、あるいはが任意のページで使用される場合があります. そして、テンプレートのwikitextに、スタイルを読み込むための タグを追加します.

「サニタイズ済みCSS」コンテンツモデルを使用して保存されたCSSは厳密な妥当性要件を満たさなければなりません. 無効なCSS、認識されない@-規則、認識されない、あるいはサポートされないプロパティーまたはプロパティーの値は保存できません. 無効なCSSがなぜが保存されてしまった場合、そのCSSがブラウザに出力された際に問題のある内容は取り除かれます.

タグの要素  の値はページタイトルであり、既定はテンプレート名前空間となります. (この既定値は  で変更できます. ) 例えば、 は "Template:Example/styles.css"をロードします. そのページが存在しないか、"サニタイズ済みCSS"以外のコンテンツモデルを持つ場合は失敗します.

スタイルはタグの省略可能な  パラメーターを使用してページ内でスコープさせることができます. 例えば  はロードしたスタイルをパース済みコンテンツ内のすべての   にスコープします. パラメーターには、すべてのCSSシンプルセレクター構文が利用できます. これは、テンプレートのライブ版とサンドボックス版を並べて比較できるようにするためのものです.

サニタイズ済みCSSはテンプレートのトランスクルージョンと同様にトラッキングされ、上にトランスクルージョンとして表示されます.

注意
This should largely prevent redefining fonts used elsewhere in the document. Other classes on the  or   elements may be targeted in the same manner.
 * TemplateStylesによって追加されるスタイルは、パース済みメインコンテンツ以外に影響を与えないように  でスコープされます.
 * TemplateStylesを使用してw:MediaWiki:Protectedpagetextのようなスタイルにしたい場合、メッセージ内容を で囲む必要があります.
 * スタイルは特定のCSSクラスに絞って記述すべきであり、それらのクラスを持つエレメントを生成するものは自身でスタイルを含めるようにすべきで、他のテンプレートに依存すべきではありません.
 * 現在はテンプレートに含まれたスタイルはそのコンテンツ以外のページ中のコンテンツにも影響を与えることができますが、この機能は将来的に削除される可能性があるため信頼してはなりません.
 * テンプレートのコンテンツ外に影響するスタイルが含まれている場合、そのテンプレートを含まないセクションの編集中のプレビューにスタイルが適用されなくなります. 例：インフォボックスにページ内のすべてのテーブルに影響するスタイルを含めた場合、インフォボックスを含まないセクションを編集しプレビュー表示したとき、それらのテーブルにはスタイルは適用されません.
 * TemplateStylesはいくつかの非スタンダードなCSSプロパティを許可します. Requests to support additional properties should be filed in Phabricator in the css-sanitizer and TemplateStyles projects.
 * Requests should include links to standards-track documents (e.g. on w3.org) describing the syntax of the properties being requested, and an analysis of current browser support for the properties (e.g. a link to a caniuse.com page about the properties).
 * Vendor-prefixed properties (e.g. anything starting with,  , or  ) are likely to be declined if they're not needed for modern browsers.
 * rules must use a  prefixed with "TemplateStyles".
 * To target styles based on skins, use a selector such as ; specification of the   element is required and must be followed by a descendant combinator (i.e. the space).

その他の依存関係
should be configured to use no tidying or RemexHtml. If used with any of the Raggett drivers, a tag in the middle of a paragraph (including in an inline template) will cause tidy to break the paragraph at that point. The other drivers have not been tested for this issue.

潜在的なエラー
It may help to enable in your   to determine if you are experiencing any of the errors below.


 * This means a required library has not been installed. The error may come up when attempting to import a wiki CSS page or when changing the content model of a page to "santized-css". This was common in the past due to a bug in the extension distributor; shouldn't happen anymore.
 * Happens when you try to import a wiki page created via TemplateStyles, but TemplateStyles is not installed on your wiki.
 * Happens when you try to import a wiki page created via TemplateStyles, but TemplateStyles is not installed on your wiki.
 * Happens when you try to import a wiki page created via TemplateStyles, but TemplateStyles is not installed on your wiki.

関連項目

 * - used for the sanitization of the CSS.
 * T483 "RfC: Allow styling in templates" (about possibly deploying this extension on Wikimedia wikis)
 * Requests for comment/Allow styling in templates
 * T56864 "ResourceLoader: Implement support for LESS in wiki modules (user and site), supporting e.g. MediaWiki:Common.less"
 * T155813 "Decide on storage and delivery method for TemplateStyles CSS"
 * It’s now easier to craft content for mobile devices: Responsive web design at the Wikipedia scale on the Wikimedia Blog.
 * It’s now easier to craft content for mobile devices: Responsive web design at the Wikipedia scale on the Wikimedia Blog.