Template:AIA Guide to Boston

Template documentationview edit history purge

This template uses Lua:

This template uses WP:SSTS; see that page for complete system documentation.

This template generates citations to the book AIA Guide to Boston by Susan Southworth et al..

The key=value parameters such as |author=, |title=, etc., are defined in Module:SST/shards/S under the book key SOUTHWORTH_AIA_GUIDE_TO_BOSTON.

Usage

Default

{{AIA Guide to Boston}}

Southworth, Susan & Southworth, Michael (2008). AIA Guide to Boston (3rd ed.). Guilford, Connecticut: Globe Pequot Press. ISBN 978-0-7627-4337-7.

Single Page

{{AIA Guide to Boston |page=42}}

Southworth, Susan & Southworth, Michael (2008). AIA Guide to Boston (3rd ed.). Guilford, Connecticut: Globe Pequot Press. p. 42. ISBN 978-0-7627-4337-7.

Multiple Pages

{{AIA Guide to Boston |pages=42-43, 44-45, 250}}

Southworth, Susan & Southworth, Michael (2008). AIA Guide to Boston (3rd ed.). Guilford, Connecticut: Globe Pequot Press. pp. 42-43, 44-45, 250. ISBN 978-0-7627-4337-7.

Chapter

{{AIA Guide to Boston |chapter=Chapter Title |pages=198–250 |chapter-page=198}}

Southworth, Susan & Southworth, Michael (2008). "Chapter Title". AIA Guide to Boston (3rd ed.). Guilford, Connecticut: Globe Pequot Press. pp. 198–250. ISBN 978-0-7627-4337-7.

Short citations

To create a short inline citation that links to this template, use:

{{sfn|Southworth|Southworth|2008}}

Note: This assumes {{AIA Guide to Boston}} exists elsewhere in the article.

Options

Supplement and Override

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

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

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

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

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

Leaf numbers

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@n7 means 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@gPR13 means 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

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

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

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

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:AIA Guide to Boston in articles based on its TemplateData.

TemplateData for AIA Guide to Boston

Generates citations to AIA Guide to Boston by Susan Southworth ''et al.''.

Template parameters[Edit template data]
Parameter		Description	Type	Status
page	`page`	Page number Example 113	String	optional
pages	`pages`	Multiple page numbers Example 42, 56, 301-350	String	optional
chapter-page	`chapter-page`	Page number where the chapter begins (creates chapter URL) Example 12	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
ia-search	`ia-search`	Custom search term to highlight. Use 'none' to disable. Example Empire State	String	optional
ia-display	`ia-display`	Use 'full screen' to bypass the 2-up reader. Example full screen	String	optional