View source for Template:Google Books URL/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{template shortcut|GBurl}}
This template, based on {{tl|Google books}}, outputs a Google Books URL (web address) only, rather than a linked book title and page number. It is suitable for use in the {{para|url}} parameter of a citation template.

== Usage ==

<pre><nowiki>{{GBurl|id|p=|pg=|dq=|q=}}</nowiki></pre>

The <code>p</code>, <code>dq</code>, and <code>q</code> parameters are all optional.

The {{para|id}} parameter is the string of twelve characters found in the specific Google Books URL after "id=" but before "&".

The {{para|p}} parameter may be used to link to a particular page number. {{para|page}} works as an alias. 

An alternative parameter {{para|pg}} can be used for "special" pages as well as ordinary pages. For example, {{para|pg|PR1}} for the page numbered "i", or {{para|pg|PP2}} for an inside cover (check the specific circumstances as appropriate for the latter as they vary from book to book). Because the {{para|pg}} parameter corresponds directly to the ''pg'' parameter in the Google URL, it can also be used for ordinary pages numbered with Arabic numerals; ''e.g.'', {{para|pg|PA10}} yields the same result as {{para|p|10}}.

As of 2022 the {{para|p}} and {{para|pg}} parameters do not seem to work if a preview is unavailable; Google Books may not support going to a page specified by number. <code>q</code> and <code>dq</code> do work; <code>dq</code> to a phrase that only appears on one page will find a specific page.

The {{para|q}} (alias {{para|keywords}}) parameter may be used to search for particular keywords within the text (corresponding to the ''q'' parameter in the Google URL). Enclose phrases in quotation marks (").

The {{para|dq}} (alias {{para|text}}) parameter searches for a quoted phrase (corresponding to the ''dq'' parameter in the Google URL).  Enclose phrases in quotation marks (").

In many cases when converting an existing Google Books URL, only one of the above should be used.  When multiple parameters are present, the final target page is much more likely to vary over time.  If linking to a specific page, only use the page parameter, and if doing a text search then do not include the page parameter.

'''Example 1:'''
:<pre><nowiki>* {{cite book |last=Brackenridge |first=H.M. |title=History of the Western Insurrection |url={{GBurl|7ydCAAAAIAAJ|p=42}} |page=42 }}</nowiki></pre>
creates:
:* {{cite book |last=Brackenridge |first=H.M. |title=History of the Western Insurrection |url={{ {{BASEPAGENAME}}|7ydCAAAAIAAJ|p=42}} |page=42 }}

'''Example 2:'''
:<pre><nowiki>{{cite book|last=Brackenridge|first=H.M.|title=History of the Western Insurrection|url={{GBurl|id=7ydCAAAAIAAJ|page=42}}|page=42}}</nowiki></pre>
creates:
:{{cite book|last=Brackenridge|first=H.M.|title=History of the Western Insurrection|url={{ {{BASEPAGENAME}} |id=7ydCAAAAIAAJ|page=42}}|page=42}}

'''Example 3:'''
:<pre><nowiki>Brackenridge, H.M.. [{{GBurl|7ydCAAAAIAAJ|pg=PP2}} ''History of the Western Insurrection''].</nowiki></pre>
creates this, which links to the bookplate on the inside cover:
:Brackenridge, H.M.. [{{ {{BASEPAGENAME}} |7ydCAAAAIAAJ|pg=PP2}} ''History of the Western Insurrection''].

'''Example 4:'''
:<pre><nowiki>Brackenridge, H.M.. [{{GBurl|7ydCAAAAIAAJ|pg=PR1}} ''History of the Western Insurrection''].</nowiki></pre>
creates this, which links to the title page complete with inscriptions:
:Brackenridge, H.M.. [{{ {{BASEPAGENAME}} |7ydCAAAAIAAJ|pg=PR1}} ''History of the Western Insurrection''].

== See also ==
* {{tl|Google books}}
* {{tl|Cite book}}
* [[Google Books]]
* [[WP:GBOOKS]]

<includeonly>{{Sandbox other||
[[Category:Google search templates]]
[[Category:Catalog lookup templates]]
[[Category:Free content external link templates]]
}}</includeonly>