 | This template is used on approximately 5,500 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template, a wrapper for {{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 |url= parameter of a citation template.[dubious – discuss]
Usage
{{GBurl|id|p=|pg=|dq=|q=}}
The p, pg, dq, and q parameters are all optional.
The |id= parameter is the string of twelve characters found in the specific Google Books URL after "id=" but before "&".
The |p= parameter may be used to link to a particular page number. |page= works as an alias.
An alternative parameter |pg= can be used for "special" pages as well as ordinary pages. For example, |pg=PR1 for the page numbered "i", or |pg=PP2 for an inside cover (check the specific circumstances as appropriate for the latter as they vary from book to book). Because the |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., |pg=PA10 yields the same result as |p=10.
As of 2022 the |p= and |pg= parameters do not seem to work if a preview is unavailable; Google Books may not support going to a page specified by number. q and dq do work; dq to a phrase that only appears on one page will find a specific page.
The |q= (alias |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 |dq= (alias |text=) parameter searches for a quoted phrase (corresponding to the dq parameter in the Google URL).
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:
* {{cite book |last=Brackenridge |first=H.M. |title=History of the Western Insurrection |url={{GBurl|7ydCAAAAIAAJ|p=42}} |page=42 }}
creates:
- Brackenridge, H.M. History of the Western Insurrection. p. 42.
Example 2:
{{cite book|last=Brackenridge|first=H.M.|title=History of the Western Insurrection|url={{GBurl|id=7ydCAAAAIAAJ|page=42}}|page=42}}
creates:
- Brackenridge, H.M. History of the Western Insurrection. p. 42.
Example 3:
Brackenridge, H.M.. [{{GBurl|7ydCAAAAIAAJ|pg=PP2}} ''History of the Western Insurrection''].
creates this, which links to the bookplate on the inside cover:
- Brackenridge, H.M.. History of the Western Insurrection.
Example 4:
Brackenridge, H.M.. [{{GBurl|7ydCAAAAIAAJ|pg=PR1}} ''History of the Western Insurrection''].
creates this, which links to the title page complete with inscriptions:
- Brackenridge, H.M.. History of the Western Insurrection.
TemplateData
TemplateData for Google Books URL
Generates a link to a specific Google Books page with optional parameters for customization.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Book ID | id | Twelve characters found in the specific Google Books URL after 'id=' but before '&'. | String | required |
| Page Anchor | p | This may be used to link to a particular page number. (works as an alias). | String | optional |
| Page Type | pg | Defines the type of page to link to (e.g., PR for preview, PA for specific pages). | String | optional |
| Search Query | dq | A search term to highlight or focus on within the book. | String | optional |
| Query | q | A general query string to refine the search results in Google Books. | String | optional |
| Display Text | text | Custom text to display for the hyperlink. If not specified, the link defaults to the book title or ID. | String | optional |
See also
Google Books ID (P675) (see uses)
- {{Google books}}
- {{Cite book}}
- Google Books
- WP:GBOOKS