ଛାଞ୍ଚ:Internet Archive author

Template documentation[view] [edit] [history] [purge]

Internet Archive author is a template to generate links to Internet Archive for works by or about a person. It is similar in purpose to {{Gutenberg author}} and {{Librivox author}} though not limited to authors. Musicians, film directors, etc.. any person with a work on Archive.org

Usage

New storage arrives at Internet Archive.

In most cases the template is used without parameters. For example:

           
==External links==
* {{Internet Archive author}}

Optional parameters to refine the search include the following.

• name: Change both the display & search name. Normally defaults to the page title. This is useful in a number of scenarios:

• The page title uses a shortened version of the name.

• Example for Benjamin W. Wells: {{Internet Archive author |name=Benjamin Willis Wells}} yields better search results.
• Example for Benjamin Farjeon: {{Internet Archive author |name=Benjamin Leopold Farjeon}} yields better search results.

• The page title is the real name of the person, but on Internet Archive it uses their pseudonym.

• Example for Berta Behrens aka "W. Heimburg": {{Internet Archive author |name=W. Heimburg}}

• To search on multiple names (such as multiple pseudonym), see custom search below.

• dname: Change the display name only.
• sname: Change the search name only. Name used when searching IA.

• Example for Constantine the Great: {{Internet Archive author|sname=Constantine I}}. This yields better search results.
• Example for Olympiodorus of Thebes: {{Internet Archive author|sname=Olympiodorus}}. Middle names of "the", "of" etc.. are often - though not always - better removed with sname. Test to see which returns the best results.

• birth: Change the birth year. Normally defaults to the year found in Wikidata. If no dates are showing in the search string, and there is an available birth date for the article, it means Wikidata is missing. You can either 1. Update Wikidata (recommended) or 2. Use the birth option in the template. The Wikidata page for Joseph Conrad shows an example entity that has complete data. For incomplete entities, the Property for birth is P569 and Property for death is P570 and can be added by clicking "Add" at the bottom of the "Statements" section.
• death: Change the death year. See comments for birth.

• Example for Albert Einstein: {{Internet Archive author|name=Albert Einstein|birth=1879|death=1955}}

• media: Specify a media collection(s) to search. Default is all of them: texts audio video

• Example for Edward Elgar: {{Internet Archive author|media=texts audio}} produces

Works by or about Edward Elgar at Internet Archive

• coda: Special message at end.

• Example for Claude Hagège: {{Internet Archive author|media=texts|coda=(scanned books)}} produces

Works by or about Claude Hagège at Internet Archive (scanned books)

• search: Custom search string. For when a person is searched using multiple names. See instructions/examples below.

BC dates

Currently the script does not automatically determine if a date is AD or BC eg. Category:63 BC births. This won't matter too much when searching Internet Archive. When setting dates via the options above, leave off AD/BC designator.

Custom search

It is possible to use a custom search. This is mainly useful when a person is known by multiple names, but also other scenarios (see examples).

Test the search on Internet Archive, when satisfied copy and paste it into the search argument.

• Example: {{Internet Archive author|search=(András Giró-Szász AND collection:audio_music)}} produces

ବ୍ୟବହାରକାରୀ:Green Cardamom/ia

• Note: a custom search is surrounded by () parenthesis when passed to the template. If Internet Archive returns an error about the search engine not working and try again later, it typically means the search parameter isn't enclosed in ()'s.

Example custom searches:

• For Ælfric of Eynsham: {{Internet Archive author |search=("Abbot of Eynsham" OR "Ælfric of Eynsham" OR "Aelfric of Eynsham")}}
• For Basil Valentine: {{Internet Archive author |search=("Basil Valentine" OR "Basilius Valentinus")}}
• For Aylmer and Louise Maude: {{Internet Archive author |search=(Aylmer Maude OR Louise Maude)}}

Searches for both "Aylmer Maude" and "Louise Maude"

• For Saint Augustine: {{Internet Archive author|search=("Bishop of Hippo" OR "Saint Augustine" OR "Augustine, Saint" OR "Aurelius Augustine" OR "Aurelius, Augustine" OR "Saint Austin" OR "Austin, Saint")}}

Example output

The script output is best shown by example. The following use name, birth and death parameters so it will work on this page; in practice this information is obtained automatically from Wikidata and no date parameters are needed.

2-word name

• {{Internet Archive author|name=Charles Dickens|birth=1812|death=1870}}

Results in:

Works by or about Charles Dickens at Internet Archive

Generated search string: (subject:"Dickens, Charles, 1812-1870" OR subject:"Dickens, Charles" OR subject:"Charles Dickens, 1812-1870" OR subject:"Charles Dickens" OR creator:"Dickens, Charles, 1812-1870" OR creator:"Dickens, Charles" OR creator:"Charles Dickens, 1812-1870" OR creator:"Charles Dickens" OR title:"Charles Dickens" OR description:"Dickens, Charles, 1812-1870" OR description:"Dickens, Charles" OR description:"Charles Dickens, 1812-1870" OR description:"Charles Dickens")

Internet Archive often uses the author's date of birth/death in the metadata.

3-word name

• {{Internet Archive author|name=Harriet Beecher Stowe|birth=1811|death=1896}}

Results in:

Works by or about Harriet Beecher Stowe at Internet Archive

Generated search string: (subject:"Stowe, Harriet Beecher" OR subject:"Stowe, Harriet B." OR subject:"Stowe, H. B." OR subject:"Harriet Beecher Stowe" OR subject:"Harriet B. Stowe" OR subject:"H. B. Stowe" OR subject:"Stowe, Harriet" OR subject:"Harriet Stowe" OR creator:"Harriet Beecher Stowe" OR creator:"Harriet B. Stowe" OR creator:"H. B. Stowe" OR creator:"H. Beecher Stowe" OR creator:"Stowe, Harriet Beecher" OR creator:"Stowe, Harriet B." OR creator:"Stowe, H. B." OR creator:"Stowe, H. Beecher" OR creator:"Harriet Stowe" OR creator:"Stowe, Harriet" OR title:"Harriet Beecher Stowe" OR title:"Harriet B. Stowe" OR title:"H. B. Stowe" OR title:"Harriet Stowe" OR description:"Harriet Beecher Stowe" OR description:"Harriet B. Stowe" OR description:"H. B. Stowe" OR description:"Stowe, Harriet Beecher" OR description:"Stowe, Harriet B." OR description:"Harriet Stowe" OR description:"Stowe, Harriet")

Three words creates many more possible combinations.

4-word name

• {{Internet Archive author|name=Johann Heinrich Samuel Formey|birth=1711|death=1797}}

Results in:

Works by or about Johann Heinrich Samuel Formey at Internet Archive

Generated search string: (subject:"Formey, Johann Heinrich Samuel, 1711-1797" OR subject:"Johann Heinrich Samuel Formey" OR creator:"Formey, Johann Heinrich Samuel, 1711-1797" OR creator:"Johann Heinrich Samuel Formey" OR creator:"Formey, J. H. S." OR title:"Johann Heinrich Samuel Formey" OR description:"Johann Heinrich Samuel Formey" OR Johann Heinrich Samuel Formey)

2-word name, missing DOB or DOD with accented characters

• {{Internet Archive author|name=Claude Hagège|birth=1936}}

Results in:

Works by or about Claude Hagège at Internet Archive

Generated search string: (subject:"Hagège, Claude" OR subject:"Claude Hagège" OR creator:"Hagège, Claude" OR creator:"Claude Hagège" OR title:"Claude Hagège" OR description:"Hagège, Claude" OR description:"Claude Hagège" OR Claude Hag*ge)

Accented characters ("è") may exist on Internet Archive as "e" and thus a wildcard (*) search is initiated in the last statement.

Information

• The script produces an optimized Internet Archive search string. By way of background, Internet Archive metadata is inconsistent. This is because the works are entered into the catalog by thousands of independent entities (libraries, persons, etc). Each may choose to use some metadata fields or not others. And the field contents are inconsistent, for example there are many ways to enter a 3-word name (John H. Smith, J.H. Smith, "Smith, J. H. (1900-1970)", etc.. ). Thus, simply entering a name into the IA search box will often miss many works that are cataloged under other variations, or in different fields besides author name. The search strategy used in this script is based on the number of words in a name so that various combination possibilities can be built.

• For technical notes see the Lua source code.

• The produced URL is Protocol Relative. See WP:PRURL.

• Internet Archive as of 2015 has two sites, a regular and Beta. The regular site uses the Lucene search engine for which this module is optimized. The Beta site uses Elasticsearch which will probably have different search syntax once it goes live sometime in the future. It may impact articles using the custom search switch.

See also

• External Link Discovery - tool for finding articles in need of this and other author templates.
• {{Internet Archive}} - general purpose IA search not limited to books. Uses a simple search.
• {{OL author}} - includes copyright books. OL is a catalog not a repository (an opensource WorldCat)

The above documentation is transcluded from ଛାଞ୍ଚ:Internet Archive author/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.