Module:SST/shards/H

Module documentationviewedithistorypurge

Note: This is part of the WP:SSTS system see that page for complete documentation

This page contains the data configurations for Module:SST ("Single-source templates") for all book keys starting with the letter "H".

Create a new shard entry

All book metadata is stored in "shards" which are Lua Modules that contain simple tables.

There are two types of shards:

• Single - A single book. They share shard files. For example, all single books that start with "A" are in Module:SST/shards/A
• Sets - Works that have multiple volumes or editions e.g. an Encyclopedia or a 3-edition book. Each one has their own private shard file stored in Module:SST/shards/sets for example Module:SST/shards/sets/THE_CAMBRIDGE_HISTORY_OF_IRAN.

To add a new book, navigate to the correct shard and add a new table. The template documentation page will show where the shard is located.

Naming the book key

When creating a new table, use a unique, recognizable book key in ALL CAPS, with spaces converted to underscores. For single shards it must start with the letter of the shard it is placed in. Generally a good idea to start with the author's last name then a short version of the title.

• Example: library['IMBER_THE_OTTOMAN_EMPIRE'] = { ... }

When creating a multi-edition or volume set of books, name each book followed by a number for volumes e.g. _1 and _2 .. or by a year of publication e.g. _1990 and _2002 for editions.

• Example single edition

BOWEN_THE_LIFE_AND_TIMES_OF_AL_IBN_ISA

• Example multi-edition set

IMBER_THE_OTTOMAN_EMPIRE_2002

IMBER_THE_OTTOMAN_EMPIRE_2009

• Example multi-volume set

BYZANTINE_SEALS_1

BYZANTINE_SEALS_2

Host

The |host= sets which digital library the citation will link to.

Example: Host

library['IMBER_THE_OTTOMAN_EMPIRE'] = {
    ['host'] = "ia",
    ['cite_params'] = {
    .....
    }

Valid values for |host= are "ia", "guten", "hathi", "wikisrc", "gbook", "web" and "physical" (not online). These map to a corresponding |id= in the |hosts= entry (see below). Improper values or lack of a host will default to "physical" (no external links).

If a |host= is changed (e.g. from "hathi" to "ia") this will impact the Leaf page designations for every template on Wikipedia. For example Hathi uses 42@s54 while IA uses 42@n34. A change of |host= is disruptive, causing URLs to land on the wrong page. Tools will be in development to make |host= changes easier by automating the update of templates. Until then, it is better to consider the host "locked".

Citation Parameters

A table of CS1 parameters displayed by default. (Users can override these within the invoking templates.)

• |_template=: Optional. Defaults to cite book, can also be set to cite encyclopedia (more template support in future).
• |last=, |first=, |quote=, |ref=, etc. = Standard CS1 parameters.

Example: Citation Parameters

    ['host'] = "ia",
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Birtchnell",
        ['first'] = "Percy Charles",
        ['author-link'] = "Percy Birtchnell",
        ['title'] = "A Short History of Berkhamsted",
        ['year'] = "1972",
        ['edition'] = "Revised",
        ['publisher'] = "Privately printed",
        ['place'] = "Berkhamsted",
        ['oclc'] = "737328"
    },

Hosts

A nested table defining where the book can be found online and how the routing engines should handle it. Supported host keys are |ia= (Internet Archive), |hathi= (HathiTrust), |guten= (Project Gutenberg), |wikisrc= (Wikisource), |gbook= (Google Books), |web= (Other website), and |physical= (No digital host). You can add multiple hosts for each book, which one is used is defined by |host= (see above).

• |id= = The host-specific identifier.
  • IA: The ID from the URL. Multiple IDs for the same edition can be defined see Example setup.
  • Hathi: The handle ID
  • GBook: The 12-character ID
  • Wikisource: The full Page namespace name, including extension
  • Web: For a web host, omit id. See Example setup.

• Physical: A physical copy only - for books without a digital host. See Example setup.

Example: Host Configurations

• IA: The ID from the URL

    ['hosts'] = {
        ['ia'] = {
            ['id'] = "encyclopaediabrit01chisrich",
        }
    }

• IA: Multiple IDs. Spreads the load and helps to mitigate global viewing limits. IDs must be for identical books ie. the same year, publisher, page 42 etc. For different editions, generate new table entries with a unique BOOK_KEY_1990 / BOOK_KEY_1, one complete table entry for each edition / volume.

    ['hosts'] = {
        ['ia'] = {
            ['id'] = { 
                "nebraskaplacenam00fitz", 
                "nebraskaplacenam0000fitz" 
            }
        }
    }

• Hathi: The handle ID

    ['hosts'] = {
        ['hathi'] = {
            ['id'] = "iau.31858015245842",
        }
    }

• GBook: The 12-character ID

    ['hosts'] = {
        ['gbook'] = {
            ['id'] = "-CNkywAACAAJ",
        }
    }

• Wikisource: The full Page namespace name, including extension

    ['hosts'] = {
        ['wikisrc'] = {
            ['id'] = "Page:The Fun of It.pdf",
        }
    }

• Web: For a web host, omit id and use url inside the web host block instead.

    ['hosts'] = {
        ['web'] = {
            ['url'] = "http://www.uscoldwar.com/overview.htm",
        }
    }

• Physical: A physical copy only - for books without a digital host. This explicitly declares the book is offline.

    ['hosts'] = {
        ['physical'] = {}
    }

• Internet Archive Options:

• query = (Internet Archive only). Optional. Use instead of `id` for multi-volume works. Links the main title to an IA search page. Page linking will output as unlinked plain text. (ex. `query = 'title:"Encyclopaedia Britannica" AND date:1911'`)
• iadisplay = "full screen" (Internet Archive only). Optional. Opens the book in full-screen mode instead of the default 2-up view.
• iasearch = "none" or "pagenum" (Internet Archive only). Optional. Set to "none" to disable the dummy search for PD books.

Example: Internet Archive Options

• Custom Search Query instead of an id

    ['hosts'] = {
        ['ia'] = {
            ['query'] = "title:Britannica AND year:1911",
        }
    }

• Disable dummy search for PD texts. Enable full screen mode.

    ['hosts'] = {
        ['ia'] = {
            ['id'] = "encyclopaediabrit01chisrich",
            ['iasearch'] = "none",
            ['iadisplay'] = "full screen"
        }
    }

Multiple IDs

Some hosts have multiple copies of the same book+edition. This can be useful to mitigate viewing limits. Many hosts only allow X number of views per day per book. By including multiple IDs, you can spread the load across multiple IDs. Because the template randomly chooses real-time, it is important each book be identical ie. published in the same year, same publisher, each open to the same page 42 etc.. How to add multiple identical books:

    ['hosts'] = {
        ['ia'] = {
            ['id'] = { 
                "nebraskaplacenam00fitz", 
                "nebraskaplacenam0000fitz" 
            }
        }
    }

Load sharing is not available across hosts (inter-host), only within hosts (intra-host).

The above documentation is transcluded from Module:SST/shards/H/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

local library = {}

-- US Nuclear Weapons: The Secret History by Aerofax
-- Template:Book-Hansen-US Nuclear Weapons
library['HANSEN_US_NUCLEAR_WEAPONS'] = {
    host = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['title'] = "US Nuclear Weapons: The Secret History",
        ['last'] = "Hansen",
        ['first'] = "Chuck",
        ['author-link'] = "Chuck Hansen",
        ['year'] = "1988",
        ['publisher'] = "Aerofax",
        ['isbn'] = "0517567407",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "usnuclearweapons0000hans"
        }
    }
}

-- Power from Steam by Cambridge University Press
-- Template:Book-Hills-Power from Steam
library['HILLS_POWER_FROM_STEAM'] = {
    host = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Hills",
        ['first'] = "Richard L.",
        ['author-link'] = "Richard L. Hills",
        ['title'] = "Power from Steam",
        ['year'] = "1989",
        ['publisher'] = "[[Cambridge University Press]]",
        ['isbn'] = "0-521-45834-X",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "powerfromsteamhi0000hill"
        }
    }
}

-- The History of Yolo County, California by Historic Record Company
-- Template:History of Yolo County
library['HISTORY_OF_YOLO_COUNTY'] = {
    host = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Gregory",
        ['first'] = "Thomas Jefferson",
        ['year'] = "1913",
        ['title'] = "History of Yolo County, California",
        ['publisher'] = "Historic Record Company",
        ['location'] = "Los Angeles, Cal.",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "historyofyolocou00greg",
            ['iadisplay'] = "full screen",
            ['iasearch'] = "none"
        }
    }
}

-- Swords of Armageddon: U.S. Nuclear Weapons Development since 1945 by Chukelea Publications
-- Template:Book-Hansen-Swords of Armageddon
library['HANSEN_SWORDS_OF_ARMAGEDDON'] = {
    host = 'web', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Hansen",
        ['first'] = "Chuck",
        ['author-link'] = "Chuck Hansen",
        ['title'] = "Swords of Armageddon: U.S. Nuclear Weapons Development since 1945",
        ['format'] = "PDF: CD-ROM & download available",
        ['publisher'] = "Chukelea Publications",
        ['location'] = "Sunnyvale, CA",
        ['orig-year'] = "1995",
        ['year'] = "2007",
        ['isbn'] = "978-0-9791915-0-3",
        ['edition'] = "2nd",
    },
    ['hosts'] = {
        ['web'] = {
            ['url'] = "http://www.uscoldwar.com/overview.htm",
        }
    }
}
-- Kalifen und Assassinen: Ägypten und der vordere Orient zur Zeit der ersten Kreuzzüge, 1074–1171 by C. H. Beck
-- Template:Kalifen und Assassinen
library['HALM_KALIFEN_UND_ASSASSINEN'] = {
    host = 'gbook', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Halm",
        ['first'] = "Heinz",
        ['author-link'] = "Heinz Halm",
        ['year'] = "2014",
        ['title'] = "Kalifen und Assassinen: Ägypten und der vordere Orient zur Zeit der ersten Kreuzzüge, 1074–1171",
        ['trans-title'] = "Caliphs and Assassins: Egypt and the Near East at the Time of the First Crusades, 1074–1171",
        ['language'] = "de",
        ['publisher'] = "C. H. Beck",
        ['location'] = "Munich",
        ['doi'] = "10.17104/9783406661648-1",
        ['isbn'] = "978-3-406-66163-1",
    },
    ['hosts'] = {
        ['gbook'] = {
            ['id'] = "AtfNAgAAQBAJ",
        }
    }
}

-- Warfare, State and Society in the Byzantine World, 565–1204 by [[John Haldon]]
-- Template:Warfare, State and Society in the Byzantine World, 565–1204
library['HALDON_WARFARE_STATE_AND_SOCIETY_IN_THE_BYZANTINE_WORLD'] = {
    host = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['title'] = "Warfare, State and Society in the Byzantine World, 565–1204",
        ['last'] = "Haldon",
        ['first'] = "John",
        ['author-link'] = "John Haldon",
        ['year'] = "1999",
        ['isbn'] = "1-85728-495-X",
        ['location'] = "London",
        ['publisher'] = "UCL Press",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "warfarestatesoci0000hald",
        },
        ['gbook'] = {
            ['id'] = "5G1rV7tS79sC",
        }
    }
}

-- Die Kalifen von Kairo: Die Fatimiden in Ägypten, 973–1074 by [[Heinz Halm]]
-- Template:Die Kalifen von Kairo
library['HALM_DIE_KALIFEN_VON_KAIRO'] = {
    ['host'] = 'gbook', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Halm",
        ['first'] = "Heinz",
        ['author-link'] = "Heinz Halm",
        ['title'] = "Die Kalifen von Kairo: Die Fatimiden in Ägypten, 973–1074",
        ['language'] = "de",
        ['trans-title'] = "The Caliphs of Cairo: The Fatimids in Egypt, 973–1074",
        ['publisher'] = "C. H. Beck",
        ['location'] = "Munich",
        ['year'] = "2003",
        ['isbn'] = "3-406-48654-1",
    },
    ['hosts'] = {
        ['gbook'] = {
            ['id'] = "Hj2bhVntO3EC",
        }
    }
}
-- Das Reich des Mahdi: Der Aufstieg der Fatimiden by [[Heinz Halm]]
-- Template:Das Reich des Mahdi
library['HALM_DAS_REICH_DES_MAHDI'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Halm",
        ['first'] = "Heinz",
        ['author-link'] = "Heinz Halm",
        ['title'] = "Das Reich des Mahdi: Der Aufstieg der Fatimiden",
        ['language'] = "de",
        ['trans-title'] = "The Empire of the Mahdi: The Rise of the Fatimids",
        ['publisher'] = "C. H. Beck",
        ['location'] = "Munich",
        ['year'] = "1991",
        ['isbn'] = "978-3-406-35497-7",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- The Australian Wine Encyclopedia by [[James Halliday (wine)|James Halliday]]
-- Template:Halliday-AustWineEncyc
library['HALLIDAY_THE_AUSTRALIAN_WINE_ENCYCLOPEDIA'] = {
    ['host'] = 'ia', 
    ['cite_params'] = {
        ['_template'] = 'cite encyclopedia',
        ['last'] = "Halliday",
        ['first'] = "James",
        ['author-link'] = "James Halliday (wine)",
        ['year'] = "2009",
        ['encyclopedia'] = "The Australian Wine Encyclopedia",
        ['location'] = "Prahran, Vic",
        ['publisher'] = "Hardie Grant Books",
        ['isbn'] = "9781740667746",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "australianwineen0000hall",
        }
    }
}
-- The Australian Wine Pictorial Atlas by Thomas K. Hardy
-- Template:Hardy-AustWinePictAtlas
library['HARDY_THE_AUSTRALIAN_WINE_PICTORIAL_ATLAS'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Hardy",
        ['first'] = "Thomas K.",
        ['year'] = "1997",
        ['title'] = "The Australian Wine Pictorial Atlas",
        ['location'] = "Linden Park, SA",
        ['publisher'] = "Vintage Image Productions",
        ['isbn'] = "187630300X",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- The Australian Wine Compendium by [[James Halliday (wine)|James Halliday]]
-- Template:Halliday-AustWineCompend
library['HALLIDAY_THE_AUSTRALIAN_WINE_COMPENDIUM'] = {
    ['host'] = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Halliday",
        ['first'] = "James",
        ['author-link'] = "James Halliday (wine)",
        ['year'] = "1985",
        ['title'] = "The Australian Wine Compendium",
        ['location'] = "North Ryde, NSW",
        ['publisher'] = "[[Angus & Robertson]]",
        ['isbn'] = "0207151377",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "australianwineco0000hall_i0m6",
        }
    }
}
-- Die S-Klasse von Mercedes-Benz: von der Kultur des Fahrens by Heribert Hofner
-- Template:Hofner: Die S-Klasse von Mercedes-Benz
library['HOFNER_DIE_S_KLASSE_VON_MERCEDES_BENZ'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Hofner",
        ['first'] = "Heribert",
        ['year'] = "1997",
        ['title'] = "Die S-Klasse von Mercedes-Benz: von der Kultur des Fahrens",
        ['trans-title'] = "The S-Class from Mercedes-Benz: from the culture of driving",
        ['location'] = "Augsburg",
        ['publisher'] = "Bechtermünz Verlag",
        ['isbn'] = "3860475894",
        ['language'] = "de",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- The Last American Convertibles by Jay Hirsch ''et al.''
-- Template:Hirsch: The Last American Convertibles
library['HIRSCH_THE_LAST_AMERICAN_CONVERTIBLES'] = {
    ['host'] = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last1'] = "Hirsch",
        ['first1'] = "Jay",
        ['last2'] = "Weith",
        ['first2'] = "Warren",
        ['year'] = "1979",
        ['title'] = "The Last American Convertibles",
        ['location'] = "New York",
        ['publisher'] = "Collier Books; London: Collier Macmillan",
        ['isbn'] = "0-02-080010-X",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "lastamericanconv0000hirs",
        }
    }
}
-- The Ultimate Guide to SUVs and Off-Road Vehicles by Peter Henshaw
-- Template:Henshaw: The Ultimate Guide to SUVs and Off-Road Vehicles
library['HENSHAW_THE_ULTIMATE_GUIDE_TO_SUVS_AND_OFF_ROAD_VEHICLES'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Henshaw",
        ['first'] = "Peter",
        ['year'] = "2005",
        ['title'] = "The Ultimate Guide to SUVs and Off-Road Vehicles",
        ['location'] = "Edison, NJ, US",
        ['publisher'] = "Chartwell Books",
        ['isbn'] = "0785818200",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- Mercedes-Benz – The Large Coupés: The brochures since 1951 by Martin Häußermann
-- Template:Häußermann: Mercedes-Benz: The Large Coupes
library['HUERMANN_MERCEDES_BENZ_THE_LARGE_COUPS'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Häußermann",
        ['first'] = "Martin",
        ['year'] = "2006a",
        ['title'] = "Mercedes-Benz – The Large Coupés: The brochures since 1951",
        ['series'] = "Archive edition of the DaimlerChrysler Group Archive",
        ['location'] = "Bielefeld, Germany",
        ['publisher'] = "Delius Klasing",
        ['isbn'] = "3-7688-1833-0",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- Mercedes-Benz S-Class: The brochures since 1952 by Martin Häußermann
-- Template:Häußermann: Mercedes-Benz S-Class
library['HUERMANN_MERCEDES_BENZ_S_CLASS'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Häußermann",
        ['first'] = "Martin",
        ['year'] = "2006b",
        ['title'] = "Mercedes-Benz S-Class: The brochures since 1952",
        ['series'] = "Archive edition of the DaimlerChrysler Group Archive",
        ['location'] = "Bielefeld, Germany",
        ['publisher'] = "Delius Klasing",
        ['isbn'] = "3-7688-1720-2",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- Das große Mercedes-Cabrio-Buch by Matthias Hartmann
-- Template:Hartmann: Das große Mercedes-Cabrio-Buch
library['HARTMANN_DAS_GROE_MERCEDES_CABRIO_BUCH'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Hartmann",
        ['first'] = "Matthias",
        ['year'] = "2017",
        ['title'] = "Das große Mercedes-Cabrio-Buch",
        ['trans-title'] = "The Big Mercedes Cabrio Book",
        ['location'] = "Königswinter, Germany",
        ['publisher'] = "Heel Verlag",
        ['isbn'] = "9783958435810",
        ['language'] = "de",
        ['edition'] = "reprint of the original 1992",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- Ultimate Convertibles: Roofless Beauty by Mark Holmes
-- Template:Holmes: Ultimate Convertibles
library['HOLMES_ULTIMATE_CONVERTIBLES'] = {
    ['host'] = 'physical', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['last'] = "Holmes",
        ['first'] = "Mark",
        ['year'] = "2007",
        ['title'] = "Ultimate Convertibles: Roofless Beauty",
        ['location'] = "London",
        ['publisher'] = "Kandour",
        ['isbn'] = "978-1-905741-62-5",
    },
    ['hosts'] = {
        ['physical'] = {}
    }
}
-- Armenian Van/Vaspurakan by Mazda Publishers
-- Template:Hovannisian: Armenian Van-Vaspurakan
library['HOVANNISIAN_ARMENIAN_VAN_VASPURAKAN'] = {
    ['host'] = 'ia', -- WARNING: Changing host breaks page numbers in Wikipedia articles. See WP:SSTS#changehost
    ['cite_params'] = {
        ['_template'] = 'cite book',
        ['editor-last'] = "Hovannisian",
        ['editor-first'] = "Richard G.",
        ['editor-link'] = "Richard G. Hovannisian",
        ['title'] = "Armenian Van/Vaspurakan",
        ['series'] = "Historic Armenian Cities and Provinces",
        ['year'] = "2000",
        ['publisher'] = "Mazda Publishers",
        ['location'] = "Costa Mesa, California",
    },
    ['hosts'] = {
        ['ia'] = {
            ['id'] = "armenianvanvaspu00rich",
        }
    }
}
return library