Template:Blake: Disraeli/doc

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).

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

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).