Template:Google Books URL/doc
This is a documentation subpage for Template:Google Books URL. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 5,100 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
[edit]{{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.
See also
[edit]- Google Books ID (P675) (see uses)
- {{Google books}}
- {{Cite book}}
- Google Books
- WP:GBOOKS