Help:CirrusSearch/ja

で情報を見つけるための最も速い方法は直接探すことです. ページにボックスがあります.

CirrusSearch（シーラスサーチ）は MediaWiki の拡張機能で、既定の MediaWiki 検索よりも強化された検索機能を提供するためにElasticsearchが使われています. ウィキメディア財団は、ウィキメディアプロジェクト群のすべてのサイトにシーラスサーチを使っています. このページではシーラスサーチの機能を説明します. 疑問がここで解消しない際には遠慮なくトークページでお尋ねください. 誰かがお答えします.

MediaWiki 拡張機能の情報は、 を参照してください.

ウィキデータで使い方法はをご参照ください.



使い方
単語や語句を入力し、Enter や Return キーを押します. あるいは、虫眼鏡アイコン、または「検索」ボタン、（設定により）「表示」ボタンをクリックしてください. 入力文字と同じ名前のページが存在すれば、直接そのページを表示します. 見つからない場合には、ウィキのすべてのページを検索し、検索語に合致する記事の一覧を表示するか、合致する記事が存在しないことを知らせます.

検索ボックスに入力せずに「」ボタンをクリックすると、追加の検索オプションがある「Special:Search」に移動します（この検索オプションは、検索結果の画面でも常に利用できます）

検索対象を特定の 名前空間、たとえば   ページのみから探すように指定すると役に立つことがあります. そうするには、その名前空間のチェックボックスをオンにします.



改良点
CirusSearch は、標準の MediaWiki 検索と比較して、主に以下の3つの改良点があります:


 * さまざま言語での検索への対応を改善
 * 検索インデックスの更新の高速化. これにより記事に加えられた変更が大幅に高速に検索結果に反映されるようになります.
 * テンプレートの展開. これにより、内容のうちテンプレートに入っている部分がすべて検索結果に反映されるようになります.



検索インデックスの更新頻度
検索インデックスへの更新はほぼリアルタイムで適用されます. ページを変更するとすぐに、それが検索結果に現れるはずです. テンプレートへの変更は、そのテンプレートを参照読み込みしている記事に反映されるまでに数分かかるはずです. テンプレートへの変更はジョブ・キューを使用するため、パフォーマンスは変化する場合があります. 即座に変更を反映させたい場合は空編集を行うことで、強制的に反映させることが可能です. しかし、これは検索が成功している場合には特に必要ではありません.



検索候補の表示
検索ボックスに入力するとドロップダウンで表示される候補のページは、記事の品質の大まかな評価順に並んでいます. その候補の選別には、内部リンクされている数、ページサイズ、外部リンクの数、見出しの数、リダイレクトの数が考慮されます. 検索候補はスキップでき、クエリは検索結果ページに直接移動します. クエリの前に、半角チルダ記号 を入力. サンプル "~Frida Kahlo". 検索サジェスチョンはその後も表示されますが、Enter キーを押すと検索結果ページへ飛びます.

言語によっては、アクサンやダイアクリティカルマーク（発音区別符号）がオンになります. 詳細は言語ごとに特定されます.



全文検索
「全文検索」は「インデックス検索」です. すべてのページはウィキ・データベースに格納されており、リダイレクトページではないページにある全ての単語は、実質、そのウィキの全文を索引にした検索データベースに格納されています. それぞれの知られた単語はそれが見つかったページの一覧として索引にされているので、ある単語の検索は、単一のデータを見つけるごとく早いです. さらにいかなる文言の変更も数秒以内に検索インデックスに反映されます.

ウィキの「全文検索」のインデックスは多数あり、必要な検索のさまざまなタイプに対応しています. ウィキテキスト全体に対して、インデックスを個別の目的ごとに付与し、それに基づいて解析するため、あらゆる方法で柔軟に利用できます. インデックスの例をあげます.


 * 「補助」テキスト ‐ HTML属性 class=searchaux で分類された、ハットノートやキャプション、目次および任意のウィキテキストが含まれます.
 * 「Lead-in」テキスト ‐ ページの上部と最初の見出しの間にあるウィキテキストです.
 * 「カテゴリ」テキスト ‐ ページ最下部の一覧を索引化します.
 * テンプレートのインデックスが作成されます. テンプレートに埋め込み参照された単語の変更により、それを継承するすべてのページが更新されます. （ジョブキューによっては時間がかかります. ）テンプレートが呼び出すサブテンプレートの変更によって、インデックスが更新されます.
 * FileやMediaの名前空間に格納されたドキュメントの内容も、索引化するようになりました. 数千のフォーマットが認識されます.

この機能は多言語で提供されていますが、すべての言語での対応が望まれています. 現在サポートしている言語の一覧は外部サイトelasticsearch.orgにあります. パッチや要望の連絡先は投稿の説明文書を参照してください. Elasticsearch が対象としない言語は、外部第三者のオープンソースなライブラリを使って対応します.

CirrusSearchはクエリを最適化して実行します. 検索結果は近似かどうかで並べ替え、20件ずつ検索結果ページに出力します. 記事から拾った断片を添付し、検索した文字列を太字で表示するなど、後処理を重ねてあります.

検索結果には、しばしばさまざまな予備的な報告が付いています. 「クエリの修正候補」（スペル修正）を示す場合や、どうしても結果が見つからなかった場合には「○○に対する検索結果」（クエリの修正）と（ユーザー指定のクエリの）「代わりに○○を検索」と表示します.

その他の検索機能の要素：


 * 検索結果をリンク元の数で並べ替え.
 * チルダ記号 を先頭に付けて、ページの順位を保存するようなナビゲーションやお奨めを無効化.
 * 文字のスマートマッチング ‐ 外字（キーボードにない文字）をキーボード文字に正規化（または「折りたたむ」）.
 * マッチする単語や句は検索結果のページにおいて強調されます. 強調表示機能が見た目を分析する一方で、検索インデックス分析機能が実際にページを検出するので、両者が100％同期しない可能性があります（特に正規表現の場合）. 強調表示機能がインデックス分析器能よりも正確に一致することも不正確なこともあります.



単語、句、および修飾子
基本的な検索語は、単語または「引用符〈"〉で囲んだ句」です. 詳細は言語ごとに規定され、特に語間に空白を置かない言語は特徴的ですが、検索は次の条件により「単語」を認識します:


 * 一連の半角数字
 * 一連の文字
 * 文字や数字の間に挟まる部分語. 例： txt2regex の「2」に当たるもの
 * compoundName（複合語）に含まれる部分語をキャメルケースで判定

「ストップワード」はあまりにも一般的などの理由で無視されます (英語の a、the 他). ストップワードの一覧は言語ごとに固有であり、またストップワードのない言語もあります. 指定した検索語はコンテンツと照合（ページ内でレンダリング処理）します. そうではなくMediaWikiマークアップを含めた「句」であるウィキテキストと照合するには、 insource 検索を使います（下記の節参照）. それぞれの検索パラメータは独自のインデックスを持ち、指定された語を独自の方法で解釈します.

単語、句、パラメータ、およびパラメータへの入力の間のスペーシングには、ホワイトスペース文字およびグレースペース文字をいくつでも含めることができます. 「グレースペース文字」とはアルファベットではないすべての文字 ~!@#$%^&_+-={}|[]\:";'<>?,./ のことです. グレースペース文字とホワイトスペース文字の混合文字列は、「グレースペース」であり、大きなひとつの単語境界として扱われます. グレースペースはインデックスを作成し、クエリを解釈する方法です.

例外は2件あります. 1)「 embedded:colon 」 は1単語（文字として扱われる). 2）「 1,2,3 」のように埋め込まれたカンマ「, 」は数字として扱われる. グレースペース文字は、クエリ構文により、修飾子の文字として解釈できる場合を除き無視されます.

修飾子とは「 ~ * \? - " ! 」のことです. 構文のどの位置にあるかにより、語、パラメータ、クエリ全体のいずれかを修飾します. 単語および句を修飾するものは、ワイルドカードと類似検索、あいまい検索です. パラメータごとに修飾子が異なる場合もあるものの、一般原則は次のとおりです：


 * fuzzy-word または fuzzy-phrase 検索によりチルダ記号  を接尾辞に使用します (検索の深さを数字で指定).
 * チルダ記号  をクエリ項目の最初の単語の接頭辞に使うと、ページ遷移を伴わずに検索結果のみ表示します.
 * 単語内のワイルドカード文字は、1文字に対しては (エスケープされた) 疑問符 \? を、ゼロ文字以上に対してはアスタリスク記号 * を使ってください.
 * 真理・論理は AND および OR を解釈できますが、 パラメータはできません. AND および OR 演算子は現在のところ、伝統的な真理・論理のやり方で機能しないことに注意してください！ 詳細は 論理演算子 を参照してください.
 * 真理・論理は接頭辞として単語に与えられた - や ! を理解し、単語の通常の意味を「一致する」match から「除外する」exclude に入れ替えます.


 * 単語を引用符で囲むと、「完全一致」検索になります. パラメータに対して、複数の単語の入力を区切るためにも必要とされます.
 * 語幹解釈 (stemming) は自動処理されますが、無効化するには「完全一致」検索を使います.

句検索は、検索エンジンにさまざまなヒントを与えて実行します. そのヒントの与え方にはそれぞれ副作用があり、単語の組み合わせに対する検索結果の許容範囲が異なります. greyspace、camelCase、あるいはtxt2numberに対するヒントは：


 * words-joined_by_greyspace(characters) または wordsJoinedByCamelCaseCharacters を入力すると出力は words joined by …… characters となり、原形またはグレースペース文字で示します.
 * txt2number は または にマッチします.
 * ストップワードはgrey_space またはcamelCase 句の境界文字（周辺）に対して有効化されます. 一例として、 文内で the 、 of 、 a を当てると、 the_invisible_hand_of_a が と一致します.

普遍的に知られていない単語が句で無視されると、「○○の代わりに検索」のレポートが発動します.

句に照合する以下のタイプはそれぞれ、直前のものの照合結果を内包し検出率を向上させます.


 * 「完全一致」「引用符で挟んだ」を選ぶとグレースペースを許容（照合）します. 「 "exact_phrase" 」「 "exact phrase" 」を選ぶと「 」を照合.
 * greyspace_phraseにより語幹解釈が始まり、ストップワードを照合.
 * 「 CamelCase 」を選ぶと追加条件として「 」をすべて小文字と認識して照合. 原因はCirrusSearchの照合は大文字小文字を認識しないため. 注意点は CamelCase 一致を使えない言語もあることです.

パラメータによってはグレースペース句を解釈するものの、「 」などのようなその他のパラメータは、通常の「引用符で挟んだ句」のみを解釈します.

語幹解釈では大文字小文字を区別しないことにご注意ください.

注意点は「完全一致」 検索が具体的に文字として解釈した embedded:colon 記号と、しなかった embedded_underscore 記号の差です. 数字の羅列内の半角カンマ記号, の場合も似たイベントが発生します.

CirrusSearchは「完全一致」の文脈で を指定した場合（insource パラメータの文脈も対象）は 、 、 は除外し、 のみに絞りこみます.

それ以外は CirrusSearch では単語は文字、数字、その組み合わせであり、大文字小文字は無関係です.

The common word search employs the space character and is aggressive with stemming, and when the same words are joined by greyspace characters or camelCase they are aggressive with phrases and subwords.

When common words like "of" or "the" are included in a greyspace-phrase, they are ignored, so as to match more aggressively.

A greyspace_phrase search term, or a camelCase, or a txt2number term, match the signified words interchangeably. You can use any of those three forms. Now camelcase matches camelCase because Search is not case sensitive, but camelCase matches camelcase because camelCase is more aggressive. Like the rest of Search, subword "words" are not case-sensitive. By comparison the "exact phrase" is greyspace oriented and ignores numeric or letter-case transitions, and stemming. "Quoted phrases" are not case sensitive.

From the table we can surmise that the basic search parser_function -"parser function" is the sum of the basic searches  and.

Making inquiries with numbers, we would find that:


 * Plan9 or Plan_9 matches any of:,  ,  ,  ,
 * "plan9" only matches  (case insensitive)
 * Plan*9 matches  or.

The star * wildcard matches a string of letters and digits within a rendered word, but never the beginning character. One or more characters must precede the * character.


 * When * matches numbers, a comma is considered part of one number, but the decimal point is considered a greyspace character, and will delimit two numbers.
 * Inside an "exact phrase" * is treated as a greyspace character and not a wild card character, so it delimits words.

The \? wildcard represents one letter or number; *\? is also accepted, but \?* is not recognized.

The wildcards are for basic word, phrase, and insource searches, and may also be an alternative to (some) advanced regex searches (covered later).

単語または句のあとにチルダ ~ を書くとあいまい検索を実行します.


 * 句(phrase)に対しては、完全一致(exact phrase)よりも、近似な(proximal) 単語群が許容されるので近似proximity検索と呼ばれます.
 * 例えば、 "exact one two phrase"~2 は にマッチします.
 * 単語に対しては、余分な文字または変更された文字を意味します.
 * 句に対しては、あいまい検索は余分な単語をいくつ含めて良いか示す数が必須ですが、単語に対しては、あいまい検索は小数を持つことができ、 word~0.5 （ word~.5 ）を既定とし、この場合には最大で2文字を入れ替え、変更、または追加できるものの、先頭の2文字は常に除外します.
 * 近似的な句に対しては、大きな数字を適用できますが、「費用のかかる」（遅い）検索になります.
 * 単語に対しては、 word~2 が編集距離 2 で最もあいまい（既定）、 word~1 のときに最もあいまいさが小さく、そして word~0 はまったくあいまいでなくなります.

For the closeness value necessary to match in reverse (right to left) order, count and discard all the extra words, then add twice the total count of remaining words minus one. (In other words, add twice the number of segments). For the full proximity algorithm, see Elasticsearch slop.

Quotes turn off stemming, "but appending"~ the tilde reactivates the stemming.

insource検索
Insource検索は、あるページでレンダリングされたひとつの「単語」を見つけるために使用することもできますが、あらゆる句を見つけるのに役立ちます - MediaWikiマークアップ（別名ウィキコード）を含め、リダイレクトを除くあらゆるページを検索することができます. ここでいう「句」は、グレースペースを完全に無視します. 例えば、 insource: "state state autocollapse" は にマッチします.

Insource complements itself. On the one hand it has full text search for any word in the wikitext, instantly. On the other hand it can process a regexp search for any string of characters. Regexes scan all the textual characters in a given list of pages; they don't have a word index to speed things up, and the process is interrupted if it runs for more than twenty seconds. Regexes run last in a query, so to limit needless character-level scanning, every regex query should include other search terms to limit the number of documents that need to be scanned. Often the best candidate to add to the regex query insource:/arg/ is insource:arg, where arg is the same (and uses no wildcards).

正規表現の構文は insource: スペースなし、それから /regexp/ です（他にスペースを禁じるパラメータはありません. insource:/regexp/ 以外のパラメータはコロンのあとにスペースを許容します. ）

Insource indexed-search and regexp-search roles are similar in many respects:


 * Both search wikitext only.
 * Neither finds things "sourced" by a transclusion.
 * Neither does stemmed, fuzzy, or proximity searches.
 * Both want the fewest results, and both work faster when accompanied by another clause.

But indexed searches all ignore greyspace; wildcards searches do not match greyspace, so regexes are the only way to find an exact string of any and all characters, for example a sequence of two spaces. Regexes are an entirely different class of search tool that make matching a literal string easy (basic, beginner use), and make matching by metacharacter expressions possible (advanced use) on the wiki. See #Regular expression searches below.



接頭辞と名前空間
検索では、名前空間タームは初期の検索ドメインを指定するために機能します. ウィキ全体を検索する代わりに、既定では標準名前空間 (main namespace, mainspace) を検索対象とします.

検索ボックスのクエリからは単一の名前空間のみ設定できます. 接頭辞パラメータの、最初もしくは最後のタームです.

検索結果を表示するたび、Special:Searchページの上部に現われる検索バーにあるAdvanced枠には2個以上の名前空間を入力して検索できます. ここで検索対象のドメインは名前空間のプロフィールとして設定します (利用者の個人設定ページを開く必要はありません). このときの名前空間の一覧は、将来の検索時に1ページ目に表示され、検索結果の検索対象ドメインがわかります. この設定を解除するには、既定の名前空間 (丸カッコ内に表示) を選択、「記憶」を選んで「検索」ボタンを押します.

The search bar graphically sets and indicates a search domain. "Content pages" (mainspace), "Multimedia" (File), "Everything" (all plus File), "Translations", etc., are hyperlinks that can activate the query in that domain, and then indicate this by going inactive (dark). But the query will override the search bar. When a namespace or prefix is used in the query the search bar activations and indications may be misleading, so the search bar and the search box are mutually exclusive (not complementary) ways to set the search domain.

A namespace term overrides the search bar, and a prefix term overrides a namespace.

Enter a namespace name, or enter, or enter a     colon for mainspace. All does not include the File namespace. File includes media content held at Commons such as PDF, which are all indexed and searchable.

When File is involved, a namespace modifier  has an effect, otherwise it is ignored.

Namespace aliases are accepted.

As with search parameters, local and all must be lowercase. Namespaces names are case insensitive.

The prefix: parameter matches any number of first-characters of all pagenames in one namespace. When the first letters match a namespace name and colon, the search domain changes.

Given a namespace only, prefix will match all its pagenames. Given one character only, it cannot be - dash or ' quote or " double quote. The last character cannot be a colon.

For pagenames that match, their subpage titles match by definition.

The prefix parameter does not allow a space before a namespace, but allows whitespace before a pagename.

The prefix parameter goes at the end so that pagename characters may contain " quotation marks.

The Translate extension creates a sort of "language namespace", of translated versions of a page. But unlike namespace or prefix, which create the initial search domain, the inlanguage parameter is a filter of it. (See the next section.)



検索索引からコンテンツを除外する
コンテンツを検索の索引から除外するには を加えます. すると CirrusSearch は検索索引で当該のコンテンツを無視する指示を受けます（文脈の例はを参照したください. ）

Additionally content can be marked as auxiliary information by adding. すると CirrusSearch は当該のコンテンツをメインの文から除去して、検索とスニペットの照合における優先度の低い任意の欄へ移動させます. This distinction is used for items such as image thumbnail descriptions, 'see also' sections, etc.

フィルター
A filter will have multiple instances, or negated instances, or it can run as a standalone filtering a search domain. A query is formed as terms that filter a search domain.

Adding another word, phrase, or parameter filters more. A highly refined search result may have very many Y/N filters when every page in the results will be addressed. (In this case ranking is largely irrelevant.) Filtering applies critically to adding a regex term; you want as few pages as possible before adding a regex (because it can never have a prepared index for its search).

A namespace is a specified search domain but not a filter because a namespace will not run standalone. A prefix will negate so it is a filter. The search parameters below are filters for which there may be multiple instances.

Insource (covered above) is also a filter, but insource:/regexp/ is not a filter. Filters and all other search parameters are lowercase. (Namespaces are an exception, being case insensitive.)



タイトル内、カテゴリ内
語句の検索はページの題名やページ下部のカテゴリ欄とも照合します. ただしそれらのパラメータのうち、ページ題名限定 またはカテゴリのみ 指定できます.
 * cow*
 * Find articles whose title or text contains words that start with cow
 * intitle:foo
 * Find articles whose title contains foo. Stemming is enabled for foo.
 * intitle:"fine line"
 * Find articles whose title contains fine line. Stemming is disabled.
 * intitle:foo bar
 * Find articles whose title contains foo and whose title or text contains bar.
 * -intitle:foo bar
 * foo がタイトルに含まれず、かつ、bar がタイトルまたは本文に含まない記事を検索します.
 * incategory:Music
 * Category:Music に属する記事を検索します.
 * incategory:"music history"
 * Category:Music_history に属する記事を検索します.
 * incategory:"musicals" incategory:"1920"
 * Find articles that are in both Category:Musicals and Category:1920
 * -incategory:"musicals" incategory:"1920"
 * Find articles that are not in Category:Musicals but are in Category:1920

Intitle and incategory are old search parameters. Incategory no longer searches any subcategory automatically, but you can now add multiple category pagenames manually.

Since Regular expression searches are supported for intitle:
 * intitle:/regex/, intitle:/regex/i

Everything written in the #Regular expression searches is also valid for these searches, including warnings.

Deepcategory
詳細カテゴリ検索ではカテゴリおよびすべての下位カテゴリが検索対象です. ツリーの深さは現在5段階（設定可能）、カテゴリ数は256段階（設定可能）でそれぞれ制限されています. ディープサーチはWDQSのSPARQLカテゴリサービスを使用します. キーワードはdeepcategory またはdeepcat です. 例:


 * deepcat:"musicals"
 * Category:Musicalsまたはいずれかの下位カテゴリにある記事を探す

The DeepCat gadget that previously implemented the parameter was sunsetted in January 2020.

Note that some deepcat searches return incomplete results. See bug for more details.

Linksto
Linksto はコンテンツ ではなく指定したname の内部リンクを探します. ページ名 の入力は正規表現で大文字小文字を識別します. コンテンツページの題名とは、文字種ケースにいかなる改変も加えない状態で正しく合致する必要があります (たとえばのように{ {FULLPAGENAME}}と合致. )

Linksto はリダイレクトを対象にしません. テンプレートで出力されても、[ [wikilinks]]を検索します. URL がたとえウィキの内部リンクであっても、それにより生成されたリンクは検索しません.

"Help:Cirrus Search"に対する"Help:Searching"や"H:S"のリダイレクト先である内部リンクすべてを検索する方法は以下のとおりです.
 * 1) linksto: "Help:Cirrus Search"
 * 2) linksto: Help:Searching
 * 3) linksto: H:S

は"CirrusSearch"に言及しても内部リンクされていない記事を検出します.

Hastemplate
はテンプレートの使用を指定できます. 正規表現でページ名を入力すると特定のテンプレートを使うすべての例 を検出、リダイレクトのページ名のうちどれかを入力するとその名のみ 検出します. 名前検索1回で名前空間の別名も受け付け、大文字はまったく考慮せずリダイレクトは検出します. (既定の名前空間を指定しないboost-template で比較した場合. linksto は名前空間名の別名を除外、大文字小文字を識別、リダイレクトは除外. intitle はリダイレクトを除外. )

Hastemplate finds secondary (or meta-template) usage on a page: it searches the post-expansion inclusion. This is the same philosophy as for words and phrases from a template, but here it's for templates from a template. The page will be listed as having that content even though that content is not seen in the wikitext.


 * hastemplate: "quality image", finds "Template:Quality image" usage in your default search domain (namespaces).
 * hastemplate: portal:contents/tocnavbar, finds mainspace usage of a "Contents/TOCnavbar" template in the Portal namespace.

For installations with the Translate extension, hastemplate searches get interference wherever Template:Translatable template name wraps the template name of a translatable template. Use insource instead.

Inlanguage
inlanguage は翻訳拡張機能のインストールとの併用では、高度な検索やページカウントにとって重要です.


 * inlanguage: 言語コード

の指定により、検索結果をその言語に限定します.

例えば


 * そのウィキにある日本語ページをすべて数える
 * all: inlanguage: ja


 * ヘルプ名前空間からドイツ語とスペイン語のページを抽出
 * help: -inlanguage: de -inlanguage: es


 * Translate を無視し英語を基本言語に指定して、次を追加.
 * inlanguage:en

Contentmodel
contentmodel: キーワードにより、検索範囲を特定のコンテンツ型に制限します. Content handlersの使える型を示します. 例：


 * JSON ページのみ表示：
 * contentmodel:json

subpageof
下位ページを検出.
 * subpageof: 親ページ

例


 * CirrusSearch の下位ページをすべて検出.
 * subpageof:CirrusSearch


 * 親ページのページ名に空白スペースが含まれる場合は、「"」で挟む.


 * subpageof:"Requests for comment"

Articletopic
The articletopic: keyword allows filtering search results by topic. For possible topics see. E.g. articletopic:books will filter the search results to articles about books. articletopic:books|films will filter to articles about books or films. articletopic:books articletopic:films will filter to articles which are about both books and films.

Only mainspace articles belong into topics, and topics are only available on Wikipedias. Unlike other filters, articletopic also does page weighting: articles which are a stronger match for a topic will be higher in the search results (while articles which aren't about that subject at all will be removed from the result set completely).

Topic models are derived via machine learning from ORES. Any given article receives a score on dozens of different topics, and therefore may appear under different keywords. For instance, the article on Albert Einstein may appear as a "physics" article and a "biography" article. All Wikipedias have scores available -- some have local-language topic models that have coverage on all articles. Other languages do not have local ORES models, and are using English-language scores assigned to articles in the local language that also exist in English Wikipedia. The languages with such "cross-wiki" scores do not have 100% coverage -- depending on the language, it may only be something like 60% of articles that have topics available.

Topic-related search data is updated weekly, so recently created articles might not show up in topic-based search queries.

Pageid
The pageid: keyword restricts search results to the given set of page IDs. This is not really useful for manual searching; it can be used by software tools for checking whether a set of pages match the given set of search conditions (e.g. for re-validating cached search results).



ページの重み付け
Weighting determines snippet, suggestions, and page relevance. The normal weight is one. Additional weighting is given through multipliers.

クエリが文字列のみを対象とする場合、順序にそれを含むページに重みが付きます. 直観的な 語句を検索に記入する、または特定の他の追加を記述する場合、この「prefer phrase」機能は適用されません.

Morelike

 * morelike:page name 1|page name 2|...|page name n
 * 指定した記事と文章がもっとも似たものを探す.
 * morelike:wasp|bee|ant
 * Find articles about stinging insects.
 * morelike:template:search|template:regex|template:usage
 * Find templates about regex searching for template usage on the wiki.

morelike is a "greedy" keyword, meaning that it cannot be combined with other search queries. If you want to use other search queries, use morelikethis in your search:


 * morelikethis:bee hastemplate:"featured article"
 * Find articles about bees that also have the "featured article" template.

morelike: クエリは入力記事で複数の単語を選ぶことによって機能し、選択された単語でクエリを実行します. 動作方法を調整するには、検索結果の URL に以下のパラメータを追加します:

これらの設定を永続化するには システム メッセージ の   を無効にする.
 * cirrusMltMinDocFreq : 文書 (分割データベースごと) で、判断に必要な用語を 1 つ要求するときの最小値.
 * cirrusMltMaxDocFreq : 文書 (分割データベースごと) で、判断に必要な用語を 1 つ要求するときの最大値.
 * cirrusMltMaxQueryTerms : 判断する用語の最大値.
 * cirrusMltMinTermFreq : 判断すべき docの入力について用語が出現する最小値. フィールドが小さい場合は . 既定値は必ず 1.
 * cirrusMltMinWordLength : 判断すべき用語の長さの最小値. 既定値は 0.
 * cirrusMltMaxWordLength : 単語を無視する場合の上限値. 既定値は無限 (0).
 * cirrusMltFields (コンマで区切った値のリスト): これらをフィールドとして使用. 許容フィールドは title 、 text 、 auxiliary_text 、 opening_text 、 headings 、 all.
 * cirrusMltUseFields ( | ): 使用はフィールドデータに限定.  既定値: システムは   の内容からフィールドを抽出、照会を作成.
 * cirrusMltPercentTermsToMatch : 一致する用語のパーセント. 既定値は 0.3 (30 %)
 * 例:

Prefer-recent
クエリの任意の位置に prefer-recent: を記入するとページ順位付けの規則において、最近編集された記事に正常時よりもやや重みを付けます. Prefer-recent is only applied when using the default  sort order.

既定では、スコアの 60% のみを160日という広い期間でブーストするようになっており、クエリの記述は prefer-recent:0.6,160. とします. これは他のページの順位づけ規則との共用がうまく働き、ほとんどの検索に使用可能です.

規則を操作するには: prefer-recent:boost,recent Technically, "boost" is the proportion of score to scale, and "recent" is the half life in days. 増幅とは通常の 乗数 ではなく、むしろ 指数関数的 な増幅を指します. The factor used in the exponent is the time since the last edit.

例えば


 * prefer-recent:,7

ページの重みづけは作成後7日以上経過すると半減し、 14日以上経過するとさらに半減し、時間の経過に合わせてこれに正比例します. 特に条件をしぼった検索結果に単純な「日付順並べ替え」を適用した場合、ページのランキングと増幅がほぼ無意味なときら単にスコア全体を増幅します.
 * prefer-recent:1,7 (weeks)
 * prefer-recent:1,1 (days)
 * prefer-recent:1,0.0007 (minutes)
 * prefer-recent:1,0.0001 (8.64 seconds)
 * prefer-recent:1,0.00001 (seconds)

増幅-テンプレート
ページに含まれるテンプレートに基づき、スコアを増幅することができます. 操作は直接、検索で を使うか メッセージを介してすべての検索に既定で適用します. 前者を指定すると は のコンテンツを置換します. 構文はやや変動的ですが、簡略性を重んじて選ばれました. 同類のprefer-recentに似て、boost-templatesは既定の 並べ替え順を適用した場合に限定して適用されます. 例:


 * File:boost-templates:"Template:Quality Image|200%" incategory:china
 * Find files in the China category, sorting quality images first.


 * File:boost-templates:"Template:Quality Image|200% Template:Low Quality|50%" incategory:china
 * Find files in the China category, sorting quality images first and low-quality images last.


 * File:boost-templates:"Template:Quality Image|200% Template:Low Quality|50%" popcorn
 * Find files about popcorn, sorting quality images first and low-quality images last. Remember that through the use of the  message this can be reduced to just.

Don't try to add decimal points to the percentages. They don't work, and search scoring is such that they are unlikely to matter much.

に関する警告：非常に巨大または小さなパーセンテージを追加した場合、全文のスコアリングに悪影響を及ぼす可能性があります. 例えば、英語版ウィキペディアで秀逸な記事を100万%に増幅したと考えてみてください. すると秀逸な記事で言及されている語の検索で、その語に正確にマッチするタイトルよりも前に秀逸な記事が見つかるようになってしまいます. 句のマッチも同様に異常になり、 で検索してもBrave New Worldについての記事の代わりに、それらの単語が散在している秀逸な記事が見つかるようになってしまいます.



正規表現の検索
A basic indexed search finds words rendered visible on a page. Hyphenation and punctuation marks and bracketing, slash and other math and computing symbols, are merely boundaries for the words. It is not possible to include them in an indexed search. Mostly that search behavior is wanted by the user. However, sometimes one wants to have the ability for a more precise search.

To get around the syntactic deficiency of index-based searches regexp searches can be used. ただし、正規表現のみを使用するクエリは非常に遅く、リソースを消費するため、正規表現の検索ドメインが1つ以上のインデックスベースの検索の結果に制限されるように、常にインデックスベースの検索と組み合わせる必要があります.

An "exact string" regexp search is a basic search; it will simply "quote" the entire regexp, or "backslash-escape" all non-alphanumeric characters in the string. All regexp searches also require that the user develops a simple filter to generate the search domain for the regex engine to search (index based search domain marked bold, regexp part marked in italics):


 * insource:"debian.reproducible.net" insource:/debian\.reproducible\.net/
 * insource:"c:\program files (x86)" insource:/C\:\\Program Files \(x86\)/i
 * insource:"&lt;tag>{ {template}}&lt;/tag>" insource:/"&lt;tag>{ {template}}&lt;"\/"tag>"/
 * insource:"[ [title|link label]]'s" insource:/"[ [title|link label]]'s"/
 * insource:/regexp/ prefix:{ {FULLPAGENAME}}

The last example works from a link on a page, but { {FULLPAGENAME}} doesn't function in the search box.

For example: Special:Search/insource:/regex/ prefix: finds the term regex on this page.

名前空間と接頭辞を特定しないクエリは、利用者の既定の検索ドメイン (設定は Special:Search などどの検索結果ページでも可能) を対象にします. 利用者の中には既定の検索ドメインを「すべての名前空間」つまりウィキ全体に指定しています. 大規模なウィキでこのような利用者が無条件の正規表現検索を実行すると、おそらく検索を完了する前にタイムアウトが発生して処理に失敗します.

正規表現検索は実際には検索ドメイン内の各ページを1文字ずつ精査します. インデックス検索はそれとは対照的に、実際はウィキデータベースとは別に維持されるデータベースにいくつかのレコードを問い合わせることで、ほぼ即座に結果を提供します. そのため、insource://（あらゆる種類の正規表現）を使用する場合、他の検索用語を1つ作成して、正規表現検索ドメインをできるだけ制限することを検討します. 多くの検索用語がインデックスを使用しており、/regexp/に対して、即座により検索ドメインを絞り込んで提供します. 一般的な効果の順に紹介します:


 * insource:"" with quotation marks, duplicating the regexp except without the slashes or escape characters, is ideal.
 * intitle (without regex search), incategory, and linksto are excellent filters.
 * hastemplate: is a very good filter.
 * "word1 word2 word3", with or without the quotation marks, are good.
 * namespace: is practically useless, but may enable a slow regexp search to complete.

無条件の正規表現検索を使用するには、テストパターンを記入したページを作成して保存、その完全なページ名に接頭辞パラメタprefix を使います. The match will be highlighted. It searches that page (in the database) and its subpages.

正規表現検索の効率性向上に役立たないのは、morelike、 boost-template、prefer-recentなどのページスコア演算子です.

メタ文字
この節では正規表現検索でメタ文字をエスケープする方法を取上げます. メタ文字の実際の意味は構文の解説をご参照ください.

例:


 * to search a namespace, gauge the number of pages with a single term that is a namespace. This will list the number of pages in that namespace.
 * starting out to find again what you may have seen, like "wiki-link" or "(trans[in]clusion)" start with namespace and insource filters.



文字列を限定して絞込み

 * 実行中の検索プロセスは、たとえば「2 + 2 = 4」や「site」など期待する値で絞り込みができます. これはregexの最良の使用法で、唯一の正規表現の単語として検索の絞り込みに用いると、正規表現がクロールするページ数を制限することから理想的です.

You can start out intending an exact string search, but keep in mind:


 * regex only search the wikitext not the rendered text, so there are some differences around the markup, and even the number of space characters must match precisely.
 * You are obligated to supply an accompanying filter.
 * You must learn how to escape regex metacharacters.

There are two ways to escape metacharacters. They are both useful at times, and sometimes concatenated side-by-side in the escaping of a string.


 * \charでその1つをバックスラッシュエスケープ（訳注：日本語環境ではバックスラッシュではなく円マークで表示されることが多い）します. insource:/regexp/ は正規表現を区切るためにスラッシュ「/」を使います. /reg/exp/の入力はあいまいなので、/reg\/exp/と入力してください.
 * それらの文字列を"文字列"のように二重引用符で囲んでください. 文字をエスケープすることによって問題が発生する可能性がなく、その中に含まれている可能性のあるあらゆるメタ文字について、あらゆる文字をエスケープすることができるからです. 引用符でエスケープする方がきれいです.
 * 検索方法の混在はできませんが、連続処理はできます.

Double-quotes escaping using insource:/"regexp"/ is an easy way to search for many kinds of strings, but you can't backslash-escape anything inside a double-quoted escape.


 * instead of
 * is as good as
 * But  always.
 * And .  It finds the   literally, which is not the   you probably wanted.

insource:/regexp/ にバックスラッシュ・エスケープ（訳注：日本語環境ではバックスラッシュではなく円マークで表示されることが多い）を使用すると区切り文字「"」と「/」をエスケープできるものの、メタ文字を考慮する必要があり、以下のいずれかによってエスケープします：


 * To match a  delimiter character use.
 * To match a  delimiter character use.
 * The escaped metacharacters would be.
 * The equivalent expression escaped with double-quotes is.

「"」と「/」を除きメタ文字を考慮に入れる必要なく、insource:/"regexp"/を使って基本的な文字列を見つける表現を作成する最も単純なアルゴリズムは：
 * 1) Write   out. (The /" delimiters "/ are not shown.)
 * 1) Replace   with   (previous double-quote: stop, concatenate, quote restart).
 * 1) Replace   with   (stop, concatenate, start).
 * 1) You get , showing concatenation of the two methods.

The square-bracket notation for creating your own character-class also escapes its metacharacters. To target a literal right square bracket in your character-class pattern, it must be backslash escaped, otherwise it can be interpreted as the closing delimiter of the character-class pattern definition. The first position of a character class will also escape the right square bracket. Inside the delimiting square brackets of a character class, the dash character also has special meaning (range) but it too can be included literally in the class the same way as the right square bracket can. For example both of these patterns target a character that is either a dash or a right square bracket or a dot:  or.

For general examples using metacharacters:


 * insource:"2+2=4" insource:/"2+2=4"/ matches "2 + 2 = 4", with zero spaces between the characters.
 * insource:"2 + 2 = 4" insource:/2 ?\+ ?2 ?= ?4\./ match with zero or one space in between. The equals = sign is not a metacharacter, but the plus + sign is.
 * insource:"[ [link|2\3?]]\" insource:/"[ [link|2\3?]]< "\/" tag>"/

There are some notable differences from standard regex metacharacters:


 * あるいは  は改行にマッチするために予約されていません.  To search for a string that contains a newline, you can do a search like   which means not a curly brace, then two curly braces, then any two characters except a curly brace, space, or pipe, then a  tag. The "any character except" will include a newline in the search. Note thas this search was designed only to match to the following string:


 * The dot . metacharacter stands for any character including a newline, so .* matches across lines.
 * The range  will roughly match 3 or more newline characters in sequence. Note that it will be a rather slow search and could in theory match other characters (e.g. tabs and other control code characters 0x00-0x1F). But in practice those other characters would not be added to a typical article text.
 * The number # sign means something, and must be escaped.
 * The ^ and $ are not implemented. Like "grep" (global per line, regular expression, print each line), each insource:// is a "global per document, regular expression, search-results-list each document" per document.
 * and  support a multi-digit numeric range like   does, but without regard to the number of character positions, or the range in each position, so   works, and even   works.

Regex on titles
The insource keyword does only search the page source content. To run regex searches on the title strings intitle:/regex/ can be used.



高度な例
For example, using metacharacters to find the usage of a template called Val having, inside the template call, an unnamed parameter containing a possibly signed, three to four digit number, possibly surrounded by space characters, and on the same page, inside a template Val call, a named argument  having any allowable spaces around it, (it could be the same template call, or a separate one):



Note that the = sign in "fmt commas" is not needed but that adding it would not change the search results. フィルタを2件使用しregexpがクロールするどのページでも最高の可能性が出るため検索が速いのです.

<span id="Geo_Search">

地理検索
Searching based on the (primary) coordinates associated with pages. と  に依存

制限値
特定の地理座標の近くにあるとわかっている事物のページに検索対象を限定することができます. 座標は、緯度と経度の組を直接指定することも、座標の元となるページ名を入力することもできます. 検索する範囲を限定したい場合は、最初にその範囲を入力します. 例:


 * neartitle:"San Francisco"
 * neartitle:"100km,San Francisco"
 * nearcoord:37.77666667,-122.39
 * nearcoord:42km,37.77666667,-122.39

増幅
あるいは特定の地理的地域を決めて、その関連ののページは得点を増やすという方法があります. 構文は 制限値検索と同じですが、キーワードに重みづけをしてあります. これにより検索範囲のページのスコアを効率的に倍増し、近似の検索結果を上位近くに配置する確率が高くなります.


 * boost-neartitle:"San Francisco"
 * boost-neartitle:"100km,San Francisco"
 * boost-nearcoord:37.77666667,-122.39
 * boost-nearcoord:42km,37.77666667,-122.39

<span id="File_properties_search">

ファイルの属性を検索
MediaWiki 1.28 以降、CirrusSearch は 名前空間でファイルの属性を索引化した検索をサポートしています. 次の操作ができます.
 * ファイルのメディアの種類
 * MIME タイプ
 * データサイズ
 * 幅と高さの数値
 * 解像度
 * 該当する場合はビットの深さ

ファイルの種別
ファイルの種類に基づく検索は分類を指定でき、事務文書や動画、画像がラスタかベクターかなどが使えます. 現在、次の分類が利用できます.



この一覧は将来的に拡張されるかもしれません. 関連情報は の を参照してください.

検索の構文例は、 filetype:{type}. 例:

filetype:video - 検索対象は動画

ファイルタイプ検索は大文字小文字を区別しません.

filemime
MIME 形式のファイル. 構文の記述：

filemime:{MIMEtype} - この MIME 形式のファイルを検索

引数を引用符ではさむと、完全一致検索を指定できます. 引用符がない場合、MIME タイプの要素の部分一致も適用されます.

例:


 * filemime:"image/png" - MIME 形式で  と完全一致するファイルを検索
 * filemime:pdf - PDF 文書をすべて検索
 * -filemime:pdf - PDF 形式の文書はすべて除外（Commonsに特異的）

The MIME 形式の検索では大文字と小文字は識別しません.

ファイルサイズ
指定のサイズをKB換算して照合し、ファイルを検索 （KBとは 1024 バイト相当）. 文の例は次のとおり.


 * filesize:{number} または filesize:>{number} - サイズが指定の数値以上のファイル
 * filesize:<{number} - file with size no more than given number
 * filesize:{number},{number} - サイズが指定の数値の範囲内のファイル

例:


 * filesize:>20 または filesize:20 - 20KB 以上のファイル
 * filesize:<1024 - 1MB 以下のファイル
 * filesize:100,500 - サイズが100KB から 500KB のファイル

<span id="File_measures">

ファイルの大きさ
大きさを指定した検索が可能です. 幅、高さ、解像度 (w高さと幅の乗数のルート)、ビット深度です. これらの属性を与えられていないファイルもあります. 次の構文を使います.


 * {measure}:{number} - サイズが指定の数値と一致するファイル
 * {measure}:>{number} - サイズが指定の数値以上のファイル
 * {measure}:<{number} - サイズが指定の数値以下のファイル
 * {measure}:{number},{number} - サイズが指定の数値の範囲内のファイル

の値は次のいずれかに当たります.

$fileh1または$fileh2 - 画像ファイルの幅

fileh または fileheight - 画像ファイルの高さ

fileres - 画像解像度（前述参照）

filebits - ファイルの bit 深度

例:

filew:>800 fileh:>600 - 画像サイズが 800x600 px 以上のファイル

filebits:16 - 色深度が 16-bit の画像ファイル

fileheight:100,500 - 画像の高さが100 - 500 px のファイル

<span id="Wikibase_search">

Wikibase 検索
拡張機能は 複数の検索キーワードを指定し、特定の Wikibase 項目を検索しやすくします. その他の Wikibase サイト群で利用でき、たとえばから画像に構造化データのあるものを検索する場合を含みます. 詳細は を参照してください.

<span id="Cross-wiki_search_results">

ウィキ間検索の結果
ウィキ間検索の結果はウィキペディアで検索している時に表示され、2タイプあります.

プロジェクト間検索（別称はウィキ間検索あるいは対象が姉妹プロジェクトだったら姉妹検索）は他のプロジェクト※の検索結果を、ウィキペディアのそれと対照するように、検索結果を画面の余白に表示します（※＝ウィクショナリー、ウィキソース、ウィキクオートほか. ） プロジェクト間検索はウィキペディアのほとんどの言語版ならびにしまいプロジェクトで有効です.

言語間検索（ブログ投稿ご参照）とは、主な検索結果の下部に他の結果も示してあり、出所は他言語版のウィキペディアです. 言語間検索には という、本来は軽量の言語検出機能に幾重にも改良を加えて特化して応用しています. 言語間検索は現状、ウィキペディアの特定の言語版のみ有効です（詳細は TextCat へのリンクをご参照. ）

<span id="Explicit_sort_orders">

正確な並び順
既定では関連度順の並び順に加え、CirrusSearchではその他の直観的な並び順の指定が可能です. 並べ替え順に 以外を指定すると、スコアを左右する検索キーワードをすべて無効にし、たとえば や の場合です. キーワードも処理されますが、効果はありません.

並べ替えの選択肢は MediaWiki API から利用でき、  パラメータを指定します.

指針:

検索URLに を追加することによって、並べ替えのオプションを手動で設定することができます. 例えば、



'''有効な並べ替え順には以下を含みます. '''

<span id="Interface_for_advanced_options">

高度なオプション用インターフェース


AdvancedSearch拡張機能は検索ページに改良型のインターフェースを補い、前述のオプションを利用者にわかりやすく使えるようにします. 詳細はこちらのユーザーマニュアルを参照してください.

<span id="See_also">

関連項目

 * Completion Suggester - CirrusSearchの増分的な検索機能
 * — 定義、文脈、検索関連の語句のリンク.
 * MWSearch の詳細はをご参照ください. 独自に検索拡張機能を備えていない多くのウィキで使われています.
 * MWSearch の詳細はをご参照ください. 独自に検索拡張機能を備えていない多くのウィキで使われています.

<span id="External_links">

外部リンク

 * From Lucene - クエリの概念を的確に解説
 * (as of 2017-12-06)
 * Extension:CirrusSearch/Profiles – 索引作りにさまざまな影響を与える調整可能なパラメータのセット
 * Wikimedia blog articles related to search
 * WMF Global Search

<span id="Notes_and_references">