Template:Barrett: Illustrated Buyer's Guide Mercedes-Benz/doc
| This is a documentation subpage for Template:Barrett: Illustrated Buyer's Guide Mercedes-Benz. It may contain usage information, categories and other content that is not part of the original template page. |
| This template uses Lua: |
- This template uses WP:SSTS; see that page for complete system documentation.
This template generates citations to the book Illustrated Buyer's Guide Mercedes-Benz by Frank Barrett.
The key=value parameters such as |author=, |title=, etc., are defined in Module:SST/shards/sets/BARRETT_ILLUSTRATED_BUYERS_GUIDE_MERCEDES_BENZ.
Editions
[edit]To cite a specific edition, use |edition= with the following identifiers:
| Edition | Title | Year |
|---|---|---|
|edition=First |
Illustrated Buyer's Guide Mercedes-Benz | 1994 |
|edition=Second |
Illustrated Buyer's Guide Mercedes-Benz | 1998 |
- Default:
|edition=Second - Valid inputs: The system recognizes many formats including numeric (
|edition=1), ordinal (|edition=1st), written (|edition=First), and Roman numeral (|edition=I) formats.
Usage
[edit]- Default
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz}}
- Barrett, Frank (1998). Illustrated Buyer's Guide Mercedes-Benz. Motorbooks International Illustrated Buyer's Guide series (2nd ed.). Osceola, WI, USA: MBI Publishing. ISBN 978-0-7603-0451-8.
- Specific Edition
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz |edition=First}}
- Barrett, Frank (1994). Illustrated Mercedes-Benz Buyer's Guide. Motorbooks International Illustrated Buyer's Guide series (1st ed.). Osceola, WI, USA: Motorbooks International. ISBN 978-0-87938-902-4.
- Single Page
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz |edition=First |page=42}}
- Barrett, Frank (1994). Illustrated Mercedes-Benz Buyer's Guide. Motorbooks International Illustrated Buyer's Guide series (1st ed.). Osceola, WI, USA: Motorbooks International. p. 42. ISBN 978-0-87938-902-4.
- Multiple Pages
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz |edition=First |pages=42-43, 44-45, 250}}
- Barrett, Frank (1994). Illustrated Mercedes-Benz Buyer's Guide. Motorbooks International Illustrated Buyer's Guide series (1st ed.). Osceola, WI, USA: Motorbooks International. pp. 42–43, 44–45, 250. ISBN 978-0-87938-902-4.
- Chapter
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz |edition=First |chapter=Chapter Title |pages=198–250 |chapter-page=198}}
- Barrett, Frank (1994). "Chapter Title". Illustrated Mercedes-Benz Buyer's Guide. Motorbooks International Illustrated Buyer's Guide series (1st ed.). Osceola, WI, USA: Motorbooks International. pp. 198–250. ISBN 978-0-87938-902-4.
Short citations
[edit]To create a short inline citation that links to this template, use:
{{sfn|Barrett|YEAR}}
- Note: For multi-volume/edition sets, replace YEAR with the specific publication year of the volume or edition you are citing.
- Note: This assumes
{{Barrett: Illustrated Buyer's Guide Mercedes-Benz}}exists elsewhere in the article.
Options
[edit]Supplement and Override
[edit]You have the option to supplement or override parameters.
- Supplement: You can add additional parameters supported by standard citation templates (like
{{cite book}}or{{cite encyclopedia}}) such as|quote=,|ref=, etc. - Override: You can override parameters already defined by the template (for example, providing a custom
|url=if you are citing a specific digital scan not mapped by the system).
Digital availability
[edit]Because texts have complex publication histories, digital availability may vary by volume. Some volumes may be physical-only, while others may be hosted digitally (e.g., on the Internet Archive, Google Books, or Wikisource). If a specific volume is hosted digitally, the underlying SST Module will automatically generate the correct links and activate the relevant digital features below.
Volumes and editions
[edit]Many historical works span multiple volumes or have been printed in various editions. SSTS templates are built to handle these variations natively. You can pass the |volume= or |edition= parameters exactly as you would in standard wikitext.
- Edition:
{{The Ottoman Empire |edition=Second |page=112}}
- Volume:
{{The Ottoman Empire |volume=2 |page=112}}
SSTS uses a normalization module that understands that "Second", "2nd", and "2" all mean the same thing, or "Vol. 1", "Volume 1", and "1".
Chapters
[edit]To link to a specific chapter, use |chapter= and |chapter-page=.
{{The Cambridge History of Iran |volume=1 |chapter=Introduction |chapter-page=12}}
Page numbers
[edit]The system supports page number formatting of various types:
|page=42- single page|pages=42-50- page ranges|pages=42, 50, 60- multiple pages|pages=42-49, 50-59, 60-69- multiple page range groups
All of these will get automatically linked to the specific page numbers.
Page number options
[edit]Leaf numbers
[edit]Because the page number printed on the physical page (e.g., Roman numeral "xii") might not match the digital file's "leaf" or "sequence" number (e.g., scan #7), SSTS uses a special display@machine syntax within the |page= or |pages= parameters to bridge this gap.
- Left of the @: The page number as it is printed in the physical book. This is what readers will see in the citation text.
- Right of the @: The machine code instructing the URL how to find that exact page in the digital archive.
Different digital libraries require slightly different machine codes.
Use the format display@<host code><leaf #>.
- Example Internet Archive:
xiii@n7means printed page "xiii" is located at Internet Archive leaf number 7 (e.g. the URL../page/n7). Thus,|page=xiii@n7 - Example Google Books:
xiii@gPR13means printed page "xiii" is located at Google Books leaf number 13 (e.g. the URL...&pg=PR13).
| Host Service | Host Code | Format | Resulting Link | Citation and Destination Printed Page |
|---|---|---|---|---|
| Internet Archive | n | 42 | .../page/42 |
42 |
| Internet Archive | n | xii@n7 | .../page/n7 |
xii |
| HathiTrust | s | 42 | Not Available | Does not support printed-page-number linking |
| HathiTrust | s | 42@s54 | ...&seq=54 |
42 |
| Project Gutenberg | u | 42 | .../pg78102-images.html#page-42 |
42 |
| Project Gutenberg | u | 42@u42 | .../pg78102-images.html#page-42 |
42 |
| Wikisource | w | 42 | Not Available | Does not support printed-page-number linking |
| Wikisource | w | 42@w54 | [[s:Page:FileName.pdf/54|42]] |
42 |
| Wikisource | w | 42@w"Chapter 1" | [[s:Page:FileName.pdf/Chapter_1|42]] |
42 |
| Google Books | g | 42 | ...&pg=PA42 |
42 |
| Google Books | g | 42@gPA42 | ...&pg=PA42 |
42 (PA is "Page Arabic") |
| Google Books | g | xiii | ...&pg=PR13 |
xiii |
| Google Books | g | xiii@gPR13 | ...&pg=PR13 |
xiii (PR is "Page Roman") |
| Google Books | g | cover@gPP1 | ...&pg=PP1 |
cover (PP is "Page Physical" or unnumbered pages, covers, blank pages etc) |
| Google Books | g | insert@gPT15 | ...&pg=PT15 |
insert (PT is "Page Text" unnumbered inserts, photo plates, etc) |
Search
[edit]Many digital libraries support a "search inside" feature that automatically highlights a specific word or phrase on the page when the reader opens the link. SSTS allows you to trigger this feature directly from the citation by enclosing your search term in square brackets [] within the |page= or |pages= parameter.
This syntax can be used on its own, or appended to the @ linking syntax.
- Basic search:
{{The Ottoman Empire |page=42 [Suleiman]}}
- Result: Links to printed page 42 and searches the text for the word "Suleiman", highlighting it on the digital scan.
- Combined with leaf linking:
{{The Ottoman Empire |page=xii@n7 [Constantinople]}}
- Result: Displays printed page "xii" in the citation, routes the reader to machine leaf "n7", and searches the page for "Constantinople".
- Multiple terms:
{{The Ottoman Empire |page=45 [military reform], 57-60 [justinian] }}
- Result: You can include multiple search terms one for each page grouping separated by a comma.
Please note that this feature relies on the destination host's capabilities. Based on current engine configurations, search-highlighting is supported by:
- Internet Archive
- HathiTrust
- Google Books
Dummy search
[edit]A core feature of this module is its handling of the Internet Archive's restricted viewing modes.
If an editor provides a page number, the module automatically appends that number as a "dummy" search string (e.g., ?q=42). This is a necessary architectural workaround: supplying a search string forces the IA viewer to open and highlight specific pages that might be blocked due to restrictions (similar to Google Books snippet view with search strings).
Documentation
[edit]The examples in this documentation are based on stock / generic page numbers and search terms; they may not work precisely for this particular book. For more details on the underlying system, see Wikipedia:SSTS.
TemplateData
[edit]TemplateData for Barrett: Illustrated Buyer's Guide Mercedes-Benz
Generates citations to Illustrated Buyer's Guide Mercedes-Benz (2 editions) by Frank Barrett.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| page | page | Page number
| String | optional |
| pages | pages | Multiple page numbers
| String | optional |
| chapter-page | chapter-page | Page number where the chapter begins (creates chapter URL)
| String | optional |
| quote | quote | Standard CS1 parameter for quote | String | optional |
| ref | ref | Standard CS1 parameter for ref | String | optional |
| chapter | chapter | Standard CS1 parameter for chapter | String | optional |
| edition | edition | Edition
| String | optional |
