មើលកូដរបស់ ទំព័រគំរូ:Google custom/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
==Usage==

Creates a Google custom search link, which searches one site (and, optionally, pages with URLs containing one directory path in the site). (If you want to search on the entire Web, use {{Tl|Google}} instead.) This template takes three unnamed input parameters; you must supply the first one, and the last two are optional.

# A domain name, and optionally the first part of directory path (to specify one part of the site to search). (Required.) This parameter becomes the values of the <code>sitesearch=</code> and <code>domains=</code> parameters in the resulting search URL. If the value ends in a directory path component, it evidently must end with a complete path component. For Wikipedia URLs, this would be everything up to a slash, a colon (including or not including the slash or colon has no effect on the resulting search). Delimiting a search with other punctuation characters can sometimes work, such as a trailing opening parenthesis character. Examples:
#* <code>en.wikipedia.org</code> &mdash; (search all of the English Wikipedia)
#* <code>en.wikipedia.org/wiki/Wikipedia:Help_desk</code> &mdash; (search the English Wikipedia Help desk)
#* <code>en.wikipedia.org/wiki/Help:</code> &mdash; (search the English Wikipedia's Help: [[w:Help:Namespace|namespace]])
#* <code>en.wikipedia.org/wiki/Help_</code> &mdash; (generates a search link that does not work: {{Google custom|en.wikipedia.org/wiki/Help_||try it}}, evidently because no Wikipedia page URLs contain the string with a colon or a slash immediately after it)
#* <code>en.wikipedia.org/wiki/Wikipedia:Village_pump_(</code> &mdash; (search the English Wikipedia's Village pump section-specific pages and their archive pages; evidently the trailing open parenthesis character is necessary to make this work)
# Your search term(s). (Optional.) If this parameter is empty, clicking on the resulting link generates a Google search form with an initially blank input field, ready to search on the site the first parameter specifies.
# Link text to display on your wiki page. (Optional.)

=== Do not use in articles ===
{{Warning|Do not use this template in [[WP:WIAA|articles]] (as Google search links [[WP:EL#Links normally to be avoided|are not appropriate in articles]]). The template is only for [[Help:Talk page|talk pages]] and other process pages ([[WP:HD|Help desk]], [[WP:PROJ|WikiProjects]], [[Help:User page|user pages]], etc.). The template will produce an ugly messagebox warning if you attempt to use it in an article.}}

==Examples==

The template allows for some very flexible searching on entire [[Web site]]s, Wikipedia [[Help:Namespace|namespaces]], and [[Help:Subpage|subpage trees]] within Wikipedia.

=== How to search entire sites ===

{| class="wikitable"
<!-- ! width=280px | Type this !! width=130px | To get this !! What it produces, or searches for -->
! Type this !! To get this !! What it produces, or searches for
|-
| <tt><nowiki>{{google custom|en.wikipedia.org||Search Wikipedia}}</nowiki></tt> || {{google custom|en.wikipedia.org||Search Wikipedia}} || Blank form to search Wikipedia (also see: {{Tl|Google wikipedia}})
|-
| <tt><nowiki>{{google custom|en.wikipedia.org|google|Search Wikipedia for "google"}}</nowiki></tt> || {{google custom|en.wikipedia.org|google|Search Wikipedia for "google"}} || Search Wikipedia for "google"
|-
| <tt><nowiki>{{google custom|meta.wikimedia.org||Search Meta-Wiki with Google}}</nowiki></tt> || {{google custom|meta.wikimedia.org||Search Meta-Wiki with Google}} || Blank form to search Meta-Wiki
|-
| <tt><nowiki>{{google custom|www.mediawiki.org||Search MediaWiki.org with Google}}</nowiki></tt> || {{google custom|www.mediawiki.org||Search MediaWiki.org with Google}} || Blank form to search MediaWiki.org
|-
| <tt><nowiki>{{google custom|deletionpedia.dbatley.com||Search Deletionpedia with Google}}</nowiki></tt> || {{google custom|deletionpedia.dbatley.com||Search Deletionpedia with Google}} || Blank form to search Deletionpedia (articles [[WP:AFD|deleted]] from Wikipedia)
|}

=== How to search Wikipedia namespaces ===

{| class="wikitable"
<!-- ! width=280px | Type this !! width=130px | To get this !! What it produces, or searches for -->
! Type this !! To get this !! What it produces, or searches for
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:||Search Wikipedia's Wikipedia: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:||Search Wikipedia's Wikipedia: namespace}} || Blank form to search the Wikipedia: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/MediaWiki:||Search Wikipedia's MediaWiki: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/MediaWiki:||Search Wikipedia's MediaWiki: namespace}} || Blank form to search the MediaWiki: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Category:||Search Wikipedia's Category namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Category:||Search Wikipedia's Category namespace}} || Blank form to search Wikipedia's Category: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Help:||Search Wikipedia's Help: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Help:||Search Wikipedia's Help namespace}} || Blank form to search Wikipedia's Help: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/File:||Search Wikipedia's File: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/File:||Search Wikipedia's File namespace}} || Blank form to search Wikipedia's File: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/User:||Search Wikipedia's User: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/User:||Search Wikipedia's User namespace}} || Blank form to search Wikipedia's User: namespace
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Template:|google|Search Wikipedia's Template: namespace for "google"}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Template:|google|Search Wikipedia's Template: namespace for "google"}} || Search Wikipedia's Template: namespace for "google"
|}

=== How to search subpage trees within Wikipedia ===

Wikipedia has many [[Help:Talk page|talk pages]] (a.k.a. discussion pages) and other project pages that behave similarly (such as the [[WP:HD|Help desk]], the [[WP:VPT|Village pump]], the [[WP:RD|Reference desk]], as well as announcement pages such as the [[WP:SIGNPOST|Signpost]]). High-volume talk pages typically have [[WP:EIW#Archive|archives]] consisting of subpages. The template can search on any set of archive pages that follows the right naming structure (many if not most archives on Wikipedia do).

{| class="wikitable"
<!-- ! width=280px | Type this !! width=130px | To get this !! What it produces, or searches for -->
! Type this !! To get this !! What it produces, or searches for
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Help_desk||Search Wikipedia Help desk}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Help_desk||Search Wikipedia Help desk}} || Blank form to search the Wikipedia Help desk (also see: {{Tl|Google help desk}})
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:New_contributors%27_help_page/Archive||Search Wikipedia New Contributors' help page archive}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:New_contributors%27_help_page/Archive||Search Wikipedia New Contributors' help page archive}} || Blank form to search the Wikipedia New Contributors' help page archive
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Clueless_newbies||Search Wikipedia Clueless newbies archive}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Clueless_newbies||Search Wikipedia Clueless newbies archive}} || Blank form to search the Wikipedia Clueless newbies archive (2005-2006)
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost||Search Wikipedia Signpost}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost||Search Wikipedia Signpost}} || Blank form to search the [[WP:SIGNPOST|Wikipedia Signpost]]
|-
| <tt><nowiki>{{Google custom|en.wikipedia.org/wiki/Wikipedia:FAQ||Search all FAQs}}</nowiki></tt> || {{Google custom|en.wikipedia.org/wiki/Wikipedia:FAQ||Search all FAQs}} || Blank form to search [[WP:FAQ]] and [[Special:PrefixIndex/Wikipedia:FAQ|subpages]]<ref name="FAQ_bug">{{As of|2008|09|26}}, Google custom search on several [[Special:PrefixIndex/Wikipedia:FAQ|FAQ subpages]] does not work, because Google treats them as duplicates of older pages outside the [[WP:FAQ]] tree which are now [[Help:Redirect|redirects]]. See the discussion in [[Wikipedia:Village pump (technical)/Archive 48#How Google handles page moves on Wikipedia]].</ref>
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump||Search Wikipedia:Village pump}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump||Search Wikipedia:Village pump}} || Blank form to search only the "main" [[WP:PUMP|Village pump]] (does not find the parenthesized sections; [[Template talk:Villagepump#Village pump section search links|does find archives]] from [[Wikipedia:Village pump archive#July 2002 - July 2004|July 2002 - July 2004]])
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(policy)||Search Wikipedia:Village pump (policy)}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(policy)||Search Wikipedia:Village pump (policy)}} || Blank form to search the [[WP:VPP|Village pump (policy)]] section and its archive pages
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(technical)||Search Wikipedia:Village pump (technical)}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(technical)||Search Wikipedia:Village pump (technical)}} || Blank form to search the [[WP:VPT|Village pump (technical)]] section and its archive pages
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(||Search Wikipedia:Village pump (}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Village_pump_(||Search Wikipedia:Village pump (}} || Use the ( character as a search delimiter to trick Google into searching all Village pump sections
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia_talk:AutoWikiBrowser||search the AutoWikiBrowser discussion archive}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia_talk:AutoWikiBrowser||search the AutoWikiBrowser discussion archive}} || Blank form to search the [[Wikipedia talk:AutoWikiBrowser|AutoWikiBrowser discussion archive]]
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Reliable_sources/Noticeboard||search the Reliable sources noticeboard archive}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Reliable_sources/Noticeboard||Reliable sources noticeboard archive}} || Blank form to search the [[Wikipedia:Reliable sources/Noticeboard|Reliable sources noticeboard archive]]
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Wikipedia:Template_messages||search Wikipedia's template messages}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Wikipedia:Template_messages||search Wikipedia's template messages}} || Blank form to search the  [[Wikipedia:Template messages]] subtree
|-
|}

[[Wikipedia:Wikipedia Signpost/2008-11-10/Search engine|As of October, 2008]], Wikipedia's internal search became able to search on subpage trees. {{Tl|Search subpages link}} uses this new Wikipedia search feature, and works in some cases where Google search does not.

=== Problem with the Talk: namespace ===

Google searches (both {{Tl|Google}} and {{Tl|Google custom}}) appear to work on the "talk" [[Help:Namespace|namespaces]] associated with some non-[[WP:WIAA|article]] namespaces (such as Wikipedia talk:), but they do not work on the Talk: namespace associated with [[WP:WIAA|article]]s, nor on the User talk: namespace. For example, even a simple Google search for the [[Talk:Psychokinesis]] page: {{Google|Talk:Psychokinesis}} does not return the [[Talk:Psychokinesis]] page on Wikipedia as one of its results. Google does appear to find a copy of that page on somebody's [[WP:MIRROR|mirror wiki]], but not Wikipedia's talk page. The following Google custom searches do not work, either:

{| class="wikitable"
<!-- ! width=280px | Type this !! width=130px | To get this !! What it produces, or searches for -->
! Type this !! To get this !! What it produces, or searches for
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Talk:Psychokinesis||Search Talk:Psychokinesis}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Talk:Psychokinesis||Search Talk:Psychokinesis}} || Blank form to search Talk:Psychokinesis and its subpages - does not work
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Talk:Psychokinesis/||Search Talk:Psychokinesis}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Talk:Psychokinesis/||Search Talk:Psychokinesis}} || Blank form to search Talk:Psychokinesis and its subpages - does not work, with or without the trailing slash
|-
| <tt><nowiki>{{google custom|en.wikipedia.org/wiki/Talk:||Search the Talk: namespace}}</nowiki></tt> || {{google custom|en.wikipedia.org/wiki/Talk:||Search the Talk: namespace}} || Blank form to search Talk: namespace - does not work
|-
|}

Googling for clues: {{Google|google does not index wikipedia talk pages}} found this blog post by [[User:Cumbrowski]]:
* [http://www.searchenginejournal.com/all-wikipedia-links-are-now-nofollow/4288/ All Wikipedia Links Are Now NOFOLLOW], January 21st, 2007 by CarstenCumbrowski 
which includes a comment posting that says "Google excluded the talk pages from the index". This probably means article talk pages, since Google is still indexing talk pages for non-article pages. {{Tl|Google custom}} therefore will not work on the Talk: namespace.

Wikipedia's internal search can search all of Wikipedia's talk pages. Use {{Tl|Search link}} to generate a link to search an entire talk namespace, and {{Tl|Search subpages link}} to search a subpage tree within a talk namespace on Wikipedia.

=== Other Wikipedia exclusions ===

See Wikipedia's [[robots.txt]] file at http://en.wikipedia.org/robots.txt for a list of content that Wikipedia tells [[search engines]] such as [[Google]] not to index. {{Tl|Google custom}} therefore will not find any content that robots.txt excludes.

=== Problem with moved pages ===

If a page was originally at a name that is now a [[Help:Redirect|redirect]] as a result of a [[Help:Moving a page|move]], evidently Google continues to index the content at the original page name. For example, the page which is now [[Wikipedia:FAQ/Business]] began as [[Wikipedia:Business' FAQ]] (which is now a redirect to the new page). However, Google continues to index the new page content under the old page name, apparently regarding the new page as a more-recent duplicate.

This is not a problem when you search on all of the English Wikipedia, or on the entire Wikipedia: [[Help:Namespace|namespace]], but if you try to search on the [[Wikipedia:FAQ]] subpage tree, Google does not find content on subpages that it indexes through redirects that are outside of the tree.

It may be possible to fix this problem by changing redirects such as [[Wikipedia:Business' FAQ]] to [[Wikipedia:Soft redirect|soft redirects]]. Then the redirect page should not appear to Google to be a duplicate of the content page, at the next time when Google re-indexes Wikipedia. This would slightly inconvenience users who are following links to the redirects, but they would only have to click once more. (As of September 25, 2008 we have not tested this. For research notes, see [[User:Teratornis/Notes#Wikipedia:FAQ search broke]].)

=== Repetitive searches ===

If you need to create a large number of search links on a particular subset of Wikipedia pages, you can save much typing by making a new template. See {{Tl|Google help desk}} and {{Tl|Google wikipedia}} for examples showing how to cut down {{Tl|Google custom}} to make it do one specific kind of custom search. This has been useful for answering questions on the [[WP:HD|Help desk]]. It may be useful on other high-volume [[Help:Talk page|talk pages]], or on process pages that work like talk pages, where users new to a discussion ask the same questions repeatedly.

==See also==
{{Google templates}}
*[[Google Co-op]] - information about the Google custom search engine
*[[Wikipedia:Wikipedia Signpost/2008-11-10/Search engine]] - improvements to Wikipedia's built-in [[Help:Search|search]] which are similar to some Google search features
*{{Tl|Search subpages link}} - searches subpage trees on Wikipedia using the internal search feature

==Notes==
{{reflist}}

==External links==
*[http://www.google.com/coop/cse/ Google custom search engine] - official site with documentation 

<includeonly><!--
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANK YOU. -->
[[Category:Google search templates|{{PAGENAME}}]]
</includeonly>