Manual:Creating pages with preloaded text/ja

From MediaWiki.org

Jump to: navigation, search

Please note: Some techniques recommended in this article require the use of extensions. Please use with care. The status assigned to each extension is self-assigned by the maintainer and does not represent the opinion of the MediaWiki development team.


wikitextのプリローディングはユーザーが素早く記事を作成してページの質を改善するための多くの技術の一つです。一から新しいページを作成する代わりに、ユーザーには部分的に作成されたページとお手本が表示されます。

このテクニックはとりわけ次のような時に便利です:

  • wikiユーザーはシンプルなwikitextには進んで読み書きします(時にイントラネットのMediaWikiインストレーション上の問題があります)
  • wikiはたくさんの形式上のテキストを伴う一つもしくは複数の記事のカテゴリを含みます
  • 記事のために集める必要のある情報は構造化されたデータとフリーフォームテキストのミックスです


Contents


プリロードされたテキストが付属するページの作成方法は次 の3つのステップの処理です:

  1. プリロードテキストファイルとそれのサポートテンプレートをデザインする
  2. プリロードファイルとテンプレートのサポートテンプレートのためのページを作成する
  3. プリロードファイルをロードするトリッガーをセットアップする

[edit] プリロードファイルを設計する

プリロードファイルは埋め込みテンプレートを含む記事になります。例えば、それぞれの顧客もしくはマーケティングコンタクトのために一つの記事が欲しい場合、プリロードテキストは次のようになります:

   <!-- 等号の後に顧客とのコンタクト情報の入力をお願いします。
        ビジネスカードの画像のアップロードに関するヘルプが必要な場合、
        [[Help:Uploading business card images]]をご覧頂くようお願いします
   -->
   {{CustomerContact
   |Number=
   |BizcardImage=
   |Primary phone number=
   |Address=
   }}

[edit] プリロードファイルを命名してドキュメントにする

拡張機能の中にはプリロードテキストが保存される場所をあらかじめ決めているものがあります。他のものはその場所の決定を完全にシステム管理者に任せています。

プリロードテキストの命名とドキュメントにすることはある程度の注意が必要です。 プリロードファイルは"What links here"上に表示され不注意で削除される危険性があります(インフォ/ノーリンクではありません - 作成され廃棄される記事から伝えることは難しいです)。 プリロードファイルに基づくテンプレートのために、次の命名規約は不慮の削除を回避するための手助けになることがあります:

  • Template:CategoryNameにテンプレートを設置します
  • Template:CategoryName/Preloadにプリロードファイルを設置します

通常のテンプレートのドキュメンテーションがテンプレートページ自身でよく表示される一方で(noincludeタグを使用)、これはプリロードされるページにたいしては出来ません。 またプリロードページ自身のカテゴリとインターランゲージリンクはプリロードされるwikitextへの影響なしでは出来ません。会話ページはこれらのすべてのために使用されなければなりません。

[edit] プリロードファイルをロードする

プリロードはhttp://meta.wikimedia.org/wiki/abc?action=edit&preload=Template:Preload_demo のようなURLでプリロードパラメータによって行うことが出来ます。http://meta.wikimedia.org/wiki/abc?action=edit&preload=Template:Preload_demoはm:Template:Preload demo (talk, backlinks, edit)でプリロードされた新しいページの編集ボックスにリンクをします。 プリロードファイルを呼び起こす拡張機能がたくさんあります。下記をご覧下さい。

ソースページのwikitext、 includeonlyタグではなく、noinclude部分とタグを含むは、ページもしくはセクションがまだ存在しない場合編集ボックスにプリロードされます。編集されるページもしくはセクションが既に存在する場合、wikitextはロードされるだけで、プリロードコマンドは無視されます。

注:

  • <noinclude>と</noinclude>タグの両方とそれらの内容はプリロードされることはソースページをカテゴリ化できないもしくはいくつかのセルフドキュメンテーションを含むことができないことを意味します: それはプリロードされたテキストにもダンプされません。
  • <includeonly>と</includeonly>タグはソースページからストリップされます。includeonlyタグを提供するプリロードされたテキストが必要な場合、
<include<includeonly></includeonly>only>を使うことが出来ます
ソースにおいて: 2つの真ん中のタグがストリップされるので、プリロードされたテキストは望み通り<includeonly>で終わります。

完全なインクルージョンでも通常のトランスクルージョンも存在しません。bug 5210 (2006-03-09以降)もご覧下さい。

[edit] 拡張機能

プリロードファイルを動かす拡張機能は次のようなものを含みます:

  • Extension:InputboxExtension:CreateBoxExtension:CreateArticleはロードプロセスに対する大抵の制御方法を提供します。それぞれの拡張機能によって記事のどこかにボタンを設置出来ます。よくあるのはユーザーのヘルプページもしくは記事に対応したカテゴリーページです。プリロードファイルの名前をボタン定義の一部として指定します。
  • Extension:BoilerplateSelection - 記事のタイトル上のパターンマッチによって選択されたプリロードされたテキスト。これをセットアップするためにLocalSettings.phpファイルで配列を作成します。この配列はプリロード記事名で正規表現と関連付けします。
  • Extension:Boilerplate - 名前もしくはカテゴリに関係なくすべての記事に対するプリロードされたテキスト。プリロードされたテキストはMediaWikiの記事の[[MediaWiki:Boilerplate]]に保存されなければなりません。記事が作成されたときにこれは自動的にロードされます。

いくつかの拡張機能も3つのステップをすべて取り扱います:

  • Extension:Add Article to Category - それぞれのカテゴリ上にアドオンの記事ボタンを設置します。この拡張機能を利用して記事が作成される時、自動的にその記事をカテゴリに含めるためにwikitext、すなわち[[Category:...]]が含まれます。