Extension:InputBox/ja
From MediaWiki.org
|
Inputbox Release status: stable |
|
|---|---|
| Implementation | Tag, Page action, Search |
| Description | この拡張機能はErik Möllerによって開発され予め定義されたHTMLフォームをwikiページに追加します。これはもともと記事作成ボックスをWikinewsに追加する目的で開発されました。MediaWikiのバージョン1.5以降と拡張機能のスクリプトが必要になります(下記の#インストレーションを参照)。 |
| Author(s) | Erik Möller |
| MediaWiki | 1.5+ |
| Download | SVN |
Contents |
[edit] インストレーション
- InputBox.php・ InputBox.i18n.php・ InputBox.classes.php・ InputBox.hooks.phpファイルをダウンロードしてextensions/InputBox/フォルダに保存します。
InputBox.phpの最新バージョンは古いMediaWikiのバージョンでは動作しないかもしれません。バージョン 1.17はMediaWiki 1.6.8に対して動作します。
望むのであれば、Subvresionのリポジトリから$IP/extensions/フォルダにチェックアウトできます:
svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/InputBox/
- LocalSettings.phpファイルを開いて一番の下の行付近に次のコードを追加して下さい:
require_once($IP.'/extensions/InputBox/InputBox.php');
[edit] 例
[edit] Wikiコード<inputbox> type=search width=42 buttonlabel=Go searchbuttonlabel=Search break=no </inputbox> |
[edit] 結果 |
この種のものはWikipediaのメインページで見つかりました。新しい記事を始めるために使うことができました。既に存在する記事の編集ボックスに移動しなかったからです。
Inputbox拡張機能はErik Möllerによって開発された予め定義されたHTMLフォームをwikiページに追加するMediaWikiの拡張機能です。元々はCreate an articleボックスを Wikinewsに追加するために作られました。少なくともMediaWiki 1.5と拡張機能のスクリプトが必要です(上記の#インストレーションを参照)。
[edit] 一般的な構文
入力ボックスは次のように作られます:
<inputbox> type=box type parameter1=value parameter2=value </inputbox> |
typeパラメータは強制です。その他のパラメータはオプションです。
[edit] ボックスのタイプ
| Type | Example |
|---|---|
| type=search |
|
| デフォルトの幅が50文字である検索ボックスを生成します。ボタンラベルは指定できます。下記を参照; デフォルトはMediaWiki:Tryexact とMediaWiki:Searchfulltextです。テキストフィールドは検索基準を指定します。 | |
| type=create |
|
| 新しいページを作れるようにします。ボタンラベルを指定できます。下記を参照; デフォルトはMediaWiki:Createarticleです。テキストフィールドはどのページが編集されるのかを指定します。 | |
| type=comment |
|
| (最初の)新しいセクションヘッダーと自動的に同じになる編集要約付きで、既存のページに1つもしくは複数のセクションを追加、もしくは新しいページを作ります。ボタンラベルを指定できます。下記を参照; デフォルトのMediaWiki:Postcommentは"標準の"スキンのサイドバーでも使われます。テキストフィールドはどのページが編集されるのかを指定します。 | |
[edit] パラメータ
| Parameter Scope |
Example |
|---|---|
| bgcolor= All types テーブルの背景色を設定する(HTMLの色の値)。クォートは使わないで下さい。 |
<inputbox> type=search bgcolor=#eeeeff </inputbox> |
| width= All types 文字の単位で入力ボックスの幅を設定する。 |
<inputbox> type=create width=24 </inputbox> |
| default= All types 入力ボックスに設置するデフォルトのテキスト。 |
<inputbox> type=comment default=User talk:Eloquence </inputbox> |
| preload= comment, create 新しいページが作られたとき、このタイトル化のページを(Manual:Creating pages with preloaded text/jaを参照) に空白の編集ボックスにプリロードします。 |
<inputbox> type=create preload=Log </inputbox> |
| 例の入力ボックスの上側もしくは下側に存在しないページのタイトルを入力し、この効果をテストするために"Create article"もしくは"Post a comment"をそれぞれクリックする。 | |
| editintro= comment, create このタイトルの下のページのテキストがウィンドウを編集する前に、手引きとして、追加されます。 |
<inputbox> type=comment editintro=MediaWiki:Missingcommenttext </inputbox> |
| buttonlabel= All types このラベルはフォームのメインボタンのために使われます。 |
<inputbox> type=comment buttonlabel=Add new rumor </inputbox> |
| hidden= create, comment これは入力ボックスが存在しないことを指定します。 "default"パラメータで使われますが、現在はデフォルトではなく、ページの名前の修正された値です。 |
<inputbox> type=comment editintro=Extension:Inputbox/editintro comment preload=Extension:Inputbox/preload hidden=yes default=Extension talk:Inputbox buttonlabel=Post a comment on the talk page </inputbox> |
| searchbuttonlabel= search このラベルは検索フォームの"Search full text"のために使われます。 |
<inputbox> type=search searchbuttonlabel=Dig deeper </inputbox> |
| break= All types 改行を入力ボックスとボタンの間に挿入するかどうか。noを設定しない限りデフォルトは改行を使います。 |
<inputbox> type=create width=24 break=no </inputbox> |
| namespaces= search 全文検索の名前空間のチェックボックスに対するサポートです。 "Namespace**"でデフォルトでチェックされます。 |
<inputbox> type=search namespaces=Main**,Help </inputbox> |
create を既存のページに適用することによって単に編集ページが渡されます。その場合preloadは無視されます。 新しいページに対するcomment を適用することは機能します。
MediaWiki:名前空間から取得されたテキストはもちろん例で、どの既存のページもeditintro もしくはpreloadに対して使うことができます。不幸にもpreloadはSpecial:Uploadの要約に対してまだ機能しません。
変数、テンプレート、パーサー関数とテンプレートパラメータは入力ボックスのパラメータでサポートされていません。
[edit] 配置の強化
入力ボックスを使うたびに配置を定義する必要がないことに気づきました。 入力ボックスを投稿するとき入力ボックスのHTMLからdivタグを削除しdivを指定できました。代わりにコードでalignを定義できるようにするパラメータを追加しました。
これを使うために、hereのコードの更新されたコピーを入手し、別のパラメータでalign=left、 align=center、もしくはalign=rightを指定できます。
あなたがこれが便利であることを見いだしてくれることを望んでおります。
[edit] 既知のバグ
原文を参照。
[edit] 関連項目
- Meta: Help talk:Inputbox (marked as moved to here)
- Extension:CreateArticle
- Extension:CreateBox
- Extension:Preloader
この拡張機能はWikimediaの一つもしくは複数のwikiで利用されています。このことは拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。MediaWiki.orgにインストールされている拡張機能の全リストはバージョン情報ページで見ることができます。