Help:External searches

From FamilySearch Wiki

(Difference between revisions)
(cat)
m
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{move|(new name to be decided)}}
+
{{Help article}}
{{PD Help Page}}
+
 
 
It is possible to create an external searches of a topic using key words using a template.
 
It is possible to create an external searches of a topic using key words using a template.
  
 
For example, this is something that would work for Google:
 
For example, this is something that would work for Google:
<pre><nowiki>
+
 
<span style="border: 1px solid #CCD5DB;">[[Image:GoogleIcon.PNG]] [http://www.google.com/search?hl=en&safe=off&q={{{1|Wiki}}}&btnG=Search&meta= {{{1|Google}}}]</span>
+
<pre style="overflow: auto"><nowiki>
 +
<span style="border: 1px solid #CCD5DB;">[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{{1|Wiki}}} {{{1|Google}}}]</span>
 
<noinclude>
 
<noinclude>
 
==Usage==
 
==Usage==
Line 13: Line 14:
 
&lt;/pre></div>
 
&lt;/pre></div>
 
[[Category:Template|Google]]
 
[[Category:Template|Google]]
</noinclude></nowiki></pre>
+
</noinclude></nowiki></pre><br />
  
 
The usage is very simple and easy to use. <nowiki>{{Google|firstTerm+Second+etc}}</nowiki>  
 
The usage is very simple and easy to use. <nowiki>{{Google|firstTerm+Second+etc}}</nowiki>  
Line 26: Line 27:
 
Note: Wikipedia has an [[Help:Links#Interwiki_links|interwiki prefix]] with a similar effect, so you can link to google results with <nowiki>[[Google:firstTerm+Second+etc]]</nowiki>, although templates are still useful for linking other search engines.
 
Note: Wikipedia has an [[Help:Links#Interwiki_links|interwiki prefix]] with a similar effect, so you can link to google results with <nowiki>[[Google:firstTerm+Second+etc]]</nowiki>, although templates are still useful for linking other search engines.
  
{{languages}}
+
For a clear advantage of implementing a template over the default Google interwiki prefix, consider the following, modified example:
 +
 
 +
<pre style="overflow: auto"><nowiki>
 +
<span style="border: 1px solid #CCD5DB;">[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{urlencode:{{{1|Wiki}}}}} {{{1|Google}}}]</span>
 +
<noinclude>
 +
==Usage==
 +
Allows to establish a link to a search query at the Google search engine:
 +
* <code>{{Google|Term1 Term2 Term3}}</code>
 +
* <code>{{Google|"a phrase"}}</code>
 +
[[Category:Template|Google]]
 +
</noinclude></nowiki></pre><br />
 +
 
 +
{{Contributor Help badge}}
 +
'''Note''' the application of MediaWiki [[Help:Magic words|magic word]] <code>urlencode</code>. This grants us the convenience and elegance of entering the query string in a FamilySearch Wiki article in the same literal form we would enter it in Google search box, including spaces and quotation marks instead of representing them indirectly with <code>+</code> and <code>%20</code>.
 +
 
 +
{{Translation needed|es|Ayuda:Búsquedas externas}}
 +
 
 +
{{Contributor help-navbox}} {{Editing help}}
  
[[Category:Help]]
+
[[Category:Help|External searches]]

Revision as of 07:31, 19 November 2012

Help-content.png This help article will guide you as you edit in the Wiki. See Contributor Help for more help articles.


It is possible to create an external searches of a topic using key words using a template.

For example, this is something that would work for Google:

<span style="border: 1px solid #CCD5DB;">[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{{1|Wiki}}} {{{1|Google}}}]</span>
<noinclude>
==Usage==
Allows to establish a link to a search query at the Google search engine:
<div style="display:table; width:auto;"><pre>
{{Google|Term1+Term2+Term3}}
</pre></div>
[[Category:Template|Google]]
</noinclude>

The usage is very simple and easy to use. {{Google|firstTerm+Second+etc}}

It is also possible to do phrases by using %22Term1+Term2+etc%22

  • External searches are useful where an article requires certain keywords to make an effective search.
  • For the editor it allows making searches of web more quickly and painlessly.

Other applications of the template include searching Forums, for bug reports of the same type for software development wikis where the wiki and forum work together.

Note: Wikipedia has an interwiki prefix with a similar effect, so you can link to google results with [[Google:firstTerm+Second+etc]], although templates are still useful for linking other search engines.

For a clear advantage of implementing a template over the default Google interwiki prefix, consider the following, modified example:

<span style="border: 1px solid #CCD5DB;">[[Image:GoogleIcon.PNG]] [http://www.google.com/search?safe=off&q={{urlencode:{{{1|Wiki}}}}} {{{1|Google}}}]</span>
<noinclude>
==Usage==
Allows to establish a link to a search query at the Google search engine:
* <code>{{Google|Term1 Term2 Term3}}</code>
* <code>{{Google|"a phrase"}}</code>
[[Category:Template|Google]]
</noinclude>

Help-content.png Questions?
Visit the Wiki Contributor Help Forum to receive help with contributing to the Wiki.

Note the application of MediaWiki magic word urlencode. This grants us the convenience and elegance of entering the query string in a FamilySearch Wiki article in the same literal form we would enter it in Google search box, including spaces and quotation marks instead of representing them indirectly with + and %20.