Template:Documentation
- Аԥсшәа
- Acèh
- Адыгабзэ
- Afrikaans
- ak:Nhwɛsode:Documentation
- Alemannisch
- Алтай тил
- አማርኛ
- Pangcah
- Aragonés
- Ænglisc
- अंगिका
- العربية
- ܐܪܡܝܐ
- الدارجة
- مصرى
- অসমীয়া
- Asturianu
- Atikamekw
- Авар
- Aymar aru
- Azərbaycanca
- تۆرکجه
- Башҡортса
- Basa Bali
- Boarisch
- Žemaitėška
- Batak Toba
- Bikol Central
- Bajau Sama
- Беларуская
- Беларуская (тарашкевіца)
- Betawi
- Български
- भोजपुरी
- Bislama
- Banjar
- ပအိုဝ်ႏဘာႏသာႏ
- Bamanankan
- বাংলা
- བོད་ཡིག
- বিষ্ণুপ্রিয়া মণিপুরী
- Brezhoneg
- Bosanski
- Basa Ugi
- Буряад
- Català
- Chavacano de Zamboanga
- 閩東語 / Mìng-dĕ̤ng-ngṳ̄
- Нохчийн
- Cebuano
- Chamoru
- ᏣᎳᎩ
- Tsetsêhestâhese
- کوردی
- Corsu
- Nēhiyawēwin / ᓀᐦᐃᔭᐍᐏᐣ
- Qırımtatarca
- Čeština
- Kaszëbsczi
- Словѣньскъ / ⰔⰎⰑⰂⰡⰐⰠⰔⰍⰟ
- Чӑвашла
- Cymraeg
- Dansk
- Deutsch
- Thuɔŋjäŋ
- Zazaki
- Dolnoserbski
- डोटेली
- ދިވެހިބަސް
- ཇོང་ཁ
- Eʋegbe
- Ελληνικά
- Emiliàn e rumagnòl
- English
- Esperanto
- Español
- Eesti
- Euskara
- Estremeñu
- فارسی
- Mfantse
- Fulfulde
- Suomi
- Na Vosa Vakaviti
- Français
- Arpetan
- Furlan
- Frysk
- Gaeilge
- Gagauz
- 贛語
- Kriyòl gwiyannen
- Gàidhlig
- Galego
- گیلکی
- गोंयची कोंकणी / Gõychi Konknni
- Bahasa Hulontalo
- 𐌲𐌿𐍄𐌹𐍃𐌺
- ગુજરાતી
- Wayuunaiki
- Farefare
- Gungbe
- Gaelg
- Hausa
- 客家語 / Hak-kâ-ngî
- Hawaiʻi
- עברית
- हिन्दी
- Fiji Hindi
- Hrvatski
- Hornjoserbsce
- Kreyòl ayisyen
- Magyar
- Հայերեն
- Արեւմտահայերէն
- Interlingua
- Bahasa Indonesia
- Interlingue
- Igbo
- Ilokano
- ГӀалгӀай
- Ido
- Íslenska
- Italiano
- ᐃᓄᒃᑎᑐᑦ / inuktitut
- Patois
- La .lojban.
- Jawa
- ქართული
- Qaraqalpaqsha
- Taqbaylit
- Адыгэбзэ
- Kabɩyɛ
- Tyap
- Kongo
- Gĩkũyũ
- Қазақша
- Kalaallisut
- ភាសាខ្មែរ
- ಕನ್ನಡ
- 한국어
- Перем коми
- Къарачай-малкъар
- कॉशुर / کٲشُر
- Kurdî
- Kʋsaal
- Kernowek
- Кыргызча
- Latina
- Ladino
- Lëtzebuergesch
- Лезги
- Luganda
- Limburgs
- Ligure
- Lombard
- Lingála
- ລາວ
- Lietuvių
- Latgaļu
- Latviešu
- Madhurâ
- मैथिली
- Basa Banyumasan
- Мокшень
- Malagasy
- Олык марий
- Māori
- Minangkabau
- Македонски
- മലയാളം
- Монгол
- ဘာသာမန်
- मराठी
- Кырык мары
- Bahasa Melayu
- Malti
- Mirandés
- မြန်မာဘာသာ
- Эрзянь
- مازِرونی
- Nāhuatl
- Napulitano
- Plattdüütsch
- Nedersaksies
- नेपाली
- नेपाल भाषा
- Nederlands
- Norsk nynorsk
- Norsk bokmål
- Novial
- ߒߞߏ
- Nouormand
- Sesotho sa Leboa
- Chi-Chewa
- Occitan
- Livvinkarjala
- Oromoo
- ଓଡ଼ିଆ
- Ирон
- ਪੰਜਾਬੀ
- Pangasinan
- Kapampangan
- Papiamentu
- Picard
- Pälzisch
- पालि
- Norfuk / Pitkern
- Polski
- Piemontèis
- پنجابی
- پښتو
- Português
- Pinayuanan
- Runa Simi
- Rumantsch
- Ikirundi
- Română
- Armãneashti
- Tarandíne
- Русский
- Русиньскый
- Ikinyarwanda
- संस्कृतम्
- Саха тыла
- ᱥᱟᱱᱛᱟᱲᱤ
- Sardu
- Sicilianu
- Scots
- سنڌي
- Davvisámegiella
- Sängö
- Srpskohrvatski / српскохрватски
- ၽႃႇသႃႇတႆး
- සිංහල
- Simple English
- Slovenčina
- سرائیکی
- Slovenščina
- Gagana Samoa
- Anarâškielâ
- ChiShona
- Soomaaliga
- Shqip
- Српски / srpski
- Sranantongo
- Seeltersk
- Sunda
- Svenska
- Kiswahili
- Ślůnski
- Sakizaya
- தமிழ்
- Tayal
- ತುಳು
- తెలుగు
- Tetun
- Тоҷикӣ
- ไทย
- ትግርኛ
- Türkmençe
- Tagalog
- Tolışi
- Setswana
- Tok Pisin
- Türkçe
- Seediq
- Xitsonga
- Татарча / tatarça
- ChiTumbuka
- Twi
- Reo tahiti
- Тыва дыл
- Удмурт
- ئۇيغۇرچە / Uyghurche
- Українська
- اردو
- Oʻzbekcha / ўзбекча
- Tshivenda
- Vèneto
- Vepsän kel’
- Tiếng Việt
- Volapük
- Walon
- Winaray
- Wolof
- 吴语
- Хальмг
- IsiXhosa
- მარგალური
- ייִדיש
- Yorùbá
- Vahcuengh
- ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ
- 中文
- 文言
- 閩南語 / Bân-lâm-gú
- 粵語
- IsiZulu
余計な混乱やサーバーへの負荷を避けるために、どんな変更でも最初はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページで試すべきです。そうすれば、試した変更を1度の編集でこのテンプレートに加えることができます。しかし、最初にあなたの提案した変更を、この項目のノートで議論するようにお願いします。
このテンプレートは今ここに表示されているような解説を、他のページから自動的に呼び出して表示します。このテンプレートは他のページに呼び出されるようなページに解説を加えることに使われ、おもにテンプレートでの使用を想定していますが名前空間によって制限されているわけではありません。
使い方
基本
あなたがこのテンプレートを使用しようとしているページが「Template:テンプレート名例示用」だとすると「Template:テンプレート名例示用/doc」に解説を書いて保存し、「Template:テンプレート名例示用」に次のコードを付け足してください。
<noinclude>{{Documentation}}</noinclude>
ページ指定
解説が保存されているページが「Template:any page/doc」である場合、次のコードを「Template:テンプレート名例示用」に付け足してください。
<noinclude>{{Documentation|Template:any page/doc}}</noinclude>
インライン・コンテンツ
解説を別のページに保存せず、次のように「Template:テンプレート名例示用」に直接書き込むこともできます。
<noinclude>{{Documentation|content=This is documentation.}}</noinclude>
「Template:テンプレート名例示用/doc」が存在する場合は、そちらも同時に表示されます。
- 注意:「|content=」で指定した部分に含まれているパイプ構文の表は正しく表示されません。「|content=」で指定する部分に表を作成する場合はパイプ構文ではなくHTMLタグを使用するようにしてください(「/doc」等のこのテンプレートによって呼び出されたページにパイプ構文の表が含まれる場合は、正しく表示されます)。
ヘッドラインを変更する
次のように書き込めば、ヘッドライン(冒頭表示)を変更できます。
<noinclude>{{Documentation|heading=変更したヘッドライン}}</noinclude>
もし次のように heading 引数を空にすれば、ヘッドラインは表示されません。
<noinclude>{{Documentation|heading=}}</noinclude>
注意
これらのコードは<noinclude>の前に余分な空白をつけずに、テンプレートやその他の解説を呼び出したいページに付け加えてください。もし、解説・説明文書のページが<includeonly>や<noinclude>といったタグを解説の一部として含むならば「<」を「<」で置き換えてください。
特別な機能
プリロード
もし解説のページが存在しなければ、[編集]リンクはTemplate:Documentation/preloadから解説の雛形ファイルをプリロードします。
プリロードするファイルは、preload 引数で変更できます。
サンドボックスとテストケースとの連携
このテンプレートはサンドボックスとテストケースの存在を確認し、存在していればそのことを存在していなくてもそのことを通知しサンドボックスとテストケースの使用に誘導します。
この機能は、sandbox-testcases引数に「show」以外を指定することによってキャンセルできます。
保護アイコンの表示
このテンプレートを使用しているテンプレートが保護されていれば、そのテンプレートのページに{{pp-template}}に相当するインジケーターアイコンを表示し、さらにCategory:編集保護中のテンプレートやCategory:編集半保護中のテンプレートなどのカテゴリを付与します。
したがって本テンプレートを使用しているのであれば、テンプレートを保護しても手動で{{pp-template}}を追加する必要はありません。荒らし行為や編集合戦などを理由に一時的に保護する場合、テンプレートのページにおいて{{Documentation}}
より後ろに{{pp-vandalism|small=yes}}
のようなテンプレート呼び出しを挿入することで、インジケーターアイコンを上書きすることができます。
引数
引数 | 指定内容 | 既定値 | 説明 |
---|---|---|---|
1 | ページ名 | {{Documentation/docname}} | 解説として読み込むページ名。 |
content | 任意の文章 | {{{{{1}}}}} | 解説として表示する文章。 |
heading | 任意の文字列 | 解説 | ヘッドラインとして表示する文字列。 |
heading-style | CSS書式 | font-size:150% | ヘッドラインのスタイル。 |
heading-padding | 単位つき数値(CSS書式) | 3px | ヘッドラインのパディング。 |
heading-margin | 単位つき数値(CSS書式) | 1ex | ヘッドラインのマージン。 |
transcluded | 任意の文字列 | show | 「show」以外を指定すると、読込先を表示しない。 |
sandbox-testcases | 任意の文字列 | show | 「show」以外を指定すると、サンドボックスとテストケースの存否を表示しない。 |
preload | ページ名 | Template:Documentation/preload | 解説のページが存在しない場合にプレロードする雛形ファイル。 |
カテゴリ
このテンプレートが使用されているページが保護されている場合はCategory:編集保護中のテンプレートやCategory:編集半保護中のテンプレートなどのカテゴリを付与します。
このテンプレートを使う理由
- このテンプレートを使うことによってテンプレートやその他のページが保護されていても、そのページのための解説、言語間リンク、カテゴリなどを変更することができます。
- テンプレートのページはテンプレートを表示するための空間に読み込まれますが、その空間の大きさはパフォーマンス上の理由により制限されています。解説をサブページにおけば、テンプレートのページ自体に書かれるコードを減らすことができます。
関連項目
- Help:テンプレートの説明文
- Wikipedia:テンプレートのサンドボックスとテストケース
- {{Documentation subpage}}
- {{Template sandbox notice}}
- {{Template test cases notice}}