Difference between revisions of "Template:Google books/doc"
imported>User-duck m (Remove errant output from Example 1) |
(→Usage: title parameter) |
||
| Line 10: | Line 10: | ||
The {{para|id}} parameter is the string of twelve characters found in the specific Google Books URL after "id=" but before "&". | The {{para|id}} parameter is the string of twelve characters found in the specific Google Books URL after "id=" but before "&". | ||
| + | |||
| + | The {{para|title}} parameter is used to specify the publication title when used as a link (and not as a bare URL; {{para|title}} is not useful when {{para|plainurl}} is used). | ||
The {{para|page}} parameter may be used to link to a particular page number. {{para|pg}} can be used for "special" pages, e.g. {{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). | The {{para|page}} parameter may be used to link to a particular page number. {{para|pg}} can be used for "special" pages, e.g. {{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). | ||
| Line 16: | Line 18: | ||
The {{para|plainurl}} parameter tells the template to output a URL (web address) only, rather than a linked book title and page number. Use {{para|plainurl|yes}} when using this template in a {{para|url}} parameter of a citation template. {{para|plain-url}} works as an alias. | The {{para|plainurl}} parameter tells the template to output a URL (web address) only, rather than a linked book title and page number. Use {{para|plainurl|yes}} when using this template in a {{para|url}} parameter of a citation template. {{para|plain-url}} works as an alias. | ||
| + | |||
| + | For external links, the following all do the same thing: | ||
| + | *{{tnull|{{BASEPAGENAME}}|id{{=}}{{var|id}}|title{{=}}{{var|title}}}} | ||
| + | *{{tnull|{{BASEPAGENAME}}|1{{=}}{{var|id}}|2{{=}}{{var|title}}}} | ||
| + | *{{tnull|{{BASEPAGENAME}}|{{var|id}}|{{var|title}}}} | ||
| + | |||
| + | For URLs, the following all do the same thing: | ||
| + | *{{tnull|{{BASEPAGENAME}}|id{{=}}{{var|id}}|plainurl{{=}}yes}} | ||
| + | *{{tnull|{{BASEPAGENAME}}|1{{=}}{{var|id}}|plainurl{{=}}yes}} | ||
| + | *{{tnull|{{BASEPAGENAME}}|{{var|id}}|plainurl{{=}}yes}} | ||
'''Example 1:''' | '''Example 1:''' | ||
Revision as of 19:50, 23 July 2019
| This is a documentation subpage for Template:Google books. It contains usage information, categories and other content that is not part of the original template page. |
| This template is used on approximately 9,900 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.
Transclusion count updated automatically (see documentation). |
Usage
{{Google books|id|title|page=|keywords=|text=|plainurl=}}
The page, keywords, text, and plainurl 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 |title= parameter is used to specify the publication title when used as a link (and not as a bare URL; |title= is not useful when |plainurl= is used).
The |page= parameter may be used to link to a particular page number. |pg= can be used for "special" pages, e.g. |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).
The |keywords= parameter may be used to search for particular keywords within the text (corresponding to the q parameter in the Google URL); |text= searches for a quoted phrase (corresponding to the dq parameter in the Google URL).
The |plainurl= parameter tells the template to output a URL (web address) only, rather than a linked book title and page number. Use |plainurl=yes when using this template in a |url= parameter of a citation template. |plain-url= works as an alias.
For external links, the following all do the same thing:
{{Google books|id=id|title=title}}{{Google books|1=id|2=title}}{{Google books|id|title}}
For URLs, the following all do the same thing:
{{Google books|id=id|plainurl=yes}}{{Google books|1=id|plainurl=yes}}{{Google books|id|plainurl=yes}}
Example 1:
Doe, John. {{Google books|7ydCAAAAIAAJ|History of the Western Insurrection|page=42}}
creates
- Doe, John. History of the Western Insurrection, p. 42, at Google Books.
Example 2:
{{cite book|last=Doe|first=John|title=History of the Western Insurrection|url={{Google books|7ydCAAAAIAAJ|page=42|plainurl=yes}}|page=42}}
creates
- Doe, John. History of the Western Insurrection. p. 42.
Example 3:
Doe, John. {{Google books|7ydCAAAAIAAJ|History of the Western Insurrection|pg=PP2}}
creates this which links to the bookplate on the inside cover
- Doe, John. History of the Western Insurrection at Google Books.
Example 4:
Doe, John. {{Google books|7ydCAAAAIAAJ|History of the Western Insurrection|pg=PR1}}
creates this which links to the title page complete with inscriptions
- Doe, John. History of the Western Insurrection at Google Books.