ଛାଞ୍ଚ:Internet Archive author/doc ନିମନ୍ତେ ଆଧାର ଦେଖିବେ

<!-- Please do not rename without discussion/consensus. See talk page -->
{{Documentation subpage}}
{{lua|Module:Internet Archive}}
'''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 {{tl|Gutenberg author}} and {{tl|Librivox author}} though not limited to authors. Musicians, film directors, etc.. any ''person'' with a work on Archive.org

== Usage ==
[[File:Incoming additional storage at Internet Archive.jpg|thumb|right|New storage arrives at Internet Archive.]]
In most cases the template is used without parameters. For example:
<pre>           
==External links==
* {{Internet Archive author}}
</pre>

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]]: <nowiki>{{Internet Archive author |name=Benjamin Willis Wells}}</nowiki> yields better search results.
:::*Example for [[Benjamin Farjeon]]: <nowiki>{{Internet Archive author |name=Benjamin Leopold Farjeon}}</nowiki> 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": <nowiki>{{Internet Archive author |name=W. Heimburg}}</nowiki>
::*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]]: <nowiki>{{Internet Archive author|sname=Constantine I}}</nowiki>. This yields better search results. 
:::*Example for [[Olympiodorus of Thebes]]: <nowiki>{{Internet Archive author|sname=Olympiodorus}}</nowiki>. 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 [https://www.wikidata.org/wiki/Q82925 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]]: <nowiki>{{Internet Archive author|name=Albert Einstein|birth=1879|death=1955}}</nowiki>
:* '''media''': Specify a media collection(s) to search. Default is all of them: texts audio video 
:::*Example for [[Edward Elgar]]: <nowiki>{{Internet Archive author|media=texts audio}}</nowiki> produces
::::::{{Internet Archive author|name=Edward Elgar|media=texts audio}} 
:* '''coda''': Special message at end.
:::*Example for [[Claude Hagège]]: <nowiki>{{Internet Archive author|media=texts|coda=(scanned books)}}</nowiki> produces
::::::{{Internet Archive author|name=Claude Hagège|media=texts|coda=(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: <nowiki>{{Internet Archive author|search=(András Giró-Szász AND collection:audio_music)}}</nowiki> produces
::::::{{User:Green Cardamom/ia|name=András Giró-Szász|search=(András Giró-Szász AND collection:audio_music)}}
*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]]: <nowiki>{{Internet Archive author |search=("Abbot of Eynsham" OR "Ælfric of Eynsham" OR "Aelfric of Eynsham")}}</nowiki>
*For [[Basil Valentine]]: <nowiki> {{Internet Archive author |search=("Basil Valentine" OR "Basilius Valentinus")}}</nowiki>
*For [[Aylmer and Louise Maude]]: <nowiki> {{Internet Archive author |search=(Aylmer Maude OR Louise Maude)}}</nowiki> 
::Searches for both "Aylmer Maude" and "Louise Maude"
*For [[Saint Augustine]]: <nowiki>{{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")}}</nowiki>

==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'''
*<nowiki>{{Internet Archive author|name=Charles Dickens|birth=1812|death=1870}}</nowiki> 
:::::Results in:
:{{Internet Archive author|name=Charles Dickens|birth=1812|death=1870}}
:::::Generated search string: <code>(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")</code>

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

'''3-word name'''
*<nowiki>{{Internet Archive author|name=Harriet Beecher Stowe|birth=1811|death=1896}}</nowiki>
:::::Results in:
:{{Internet Archive author|name=Harriet Beecher Stowe|birth=1811|death=1896}}
:::::Generated search string: <code>(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")</code>

:''Three words creates many more possible combinations.''  

'''4-word name'''
*<nowiki>{{Internet Archive author|name=Johann Heinrich Samuel Formey|birth=1711|death=1797}}</nowiki>
:::::Results in:
:{{Internet Archive author|name=Johann Heinrich Samuel Formey|birth=1711|death=1797}}
:::::Generated search string: <code>(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)</code>

'''2-word name, missing DOB or DOD with accented characters'''
*<nowiki>{{Internet Archive author|name=Claude Hagège|birth=1936}}</nowiki>
:::::Results in:
:{{Internet Archive author|name=Claude Hagège|birth=1936}}
:::::Generated search string: <code>(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)</code>

:''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==
*[http://tools.wmflabs.org/ext-lnk-discover/ External Link Discovery] - tool for finding articles in need of this and other [[:Category:Authors and writers external links templates|author templates]].
*{{tl|Internet Archive}} - general purpose IA search not limited to books. Uses a simple search.
*{{tl|OL author}} - includes copyright books. OL is a catalog not a repository (an opensource WorldCat)

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Internet Archive templates]]
[[Category:Authors and writers external links templates]]
}}</includeonly>