Jump to content
Wikipedia The Free Encyclopedia

Module:Find sources

From Wikipedia, the free encyclopedia
Module documentation[view] [edit] [history] [purge]
Warning This Lua module is used on approximately 1,590,000 pages, or roughly 2% of all pages .
To avoid major disruption and server load, any changes should be tested in the module's /sandbox or /testcases subpages, or in your own module sandbox. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.
This module is rated as ready for general use. It has reached a mature state, is considered relatively stable and bug-free, and may be used wherever appropriate. It can be mentioned on help pages and other Wikipedia resources as an option for new users. To minimise server load and avoid disruptive output, improvements should be developed through sandbox testing rather than repeated trial-and-error editing.
Page template-protected This module is currently protected from editing.
See the protection policy and protection log for more details. Please discuss any changes on the talk page; you may submit an edit request to ask an administrator to make an edit if it is uncontroversial or supported by consensus. You may also request that this page be unprotected.

This module produces a list of links to search engines to help editors find sources about a given subject. It implements {{find sources }} and other similar templates. It is highly extensible; new templates and new link types can be added easily and by any user.

Usage

From wikitext

Usually, from wikitext this module should be used via a template, e.g. {{find sources }}. However, it is also possible to use it directly from #invoke, like this:

{{#invoke:Find sources|template|search term 1|search term 2|...}}
  • template is the name of the template that should be called. It must be the full page name of the template, without the namespace, and with the correct capitalisation. So, for Template:Find sources, the template name should be "Find sources"; "find sources" with a lower-case "f" would cause an error. This parameter is required.
  • search term 1, search term 2, etc., are the terms to be searched for in each of the search engine links. The first search term will appear in quotation marks, and subsequent search terms will be added without quotation marks. Each term will be separated by spaces. These parameters are all optional. If no parameters are given, the current page name will be used as a search term.

Alternatively the following can be used, which will convert any title to a search query, with the main portion of the title in quotation marks, and any parenthetical disambiguator outside quotation marks.

{{#invoke:Find sources|template|title=title}}
  • template as above, is the name of the template that should be called. It must be the full page name of the template, without the namespace, and with the correct capitalisation. So, for Template:Find sources, the template name should be "Find sources"; "find sources" with a lower-case "f" would cause an error. This parameter is required.
  • title the title to be converted to a search query. This is processed in the same way as the subpage name of the page if no parameters are used.

From Lua

Load the module with the following code:

localmFindSources=require('Module:Find sources')

You can then produce the list of search links like this:

mFindSources._main(template,searchTerms)
  • template is the template name, as outlined in the #From wikitext section above. This parameter is required.
  • searchTerms is an array of search terms. Each item in the array corresponds to a numbered search term as outlined in the #From wikitext section above. Alternatively, an empty table with the title key set will automatically generate a query as described above. This parameter is optional.

Example syntax:

mFindSources._main('Find sources',{'Albert Einstein','-"Marilyn Monroe"','relativity','science'})

Available templates

The following templates are available for use:

Template Description Example Configuration
Find general sources The most widely used source-finding template. Until September 2014 it was transcluded on all AfD discussion pages. Find sources: Google (books · news · scholar · free images · WP refs· FENS  · JSTOR · TWL main, documentation
Find sources mainspace A source-finding template for use in mainspace. Used in Template:Notability. Find sources: "Example" – news · newspapers · books · scholar · JSTOR main, documentation
Find sources medical No description available Find medical sources: Source guidelines  · PubMed · Cochrane  · DOAJ  · Gale  · OpenMD · ScienceDirect · Springer · Trip  · Wiley · TWL main, documentation
Find sources video games The source-finding template transcluded on AfD pages for video games and related topics. Find video game sources: "Example" – news · newspapers · books · scholar · JSTOR · free images · free news sources · TWL · NYT · WP reference · VG/RS · VG/RL · WPVG/Talk main, documentation

Making new templates

There are two basic ingredients to making a new source-finding template. The first is the template configuration module, and the second is the template invocation on the template page.

Template configuration page

To find the name of the template configuration page, take the page name of your proposed template without the namespace prefix, and add it to the base page of "Module:Find sources/templates/". For example, for Template:Find sources, the configuration page is located at Module:Find sources/templates/Find sources. Note that the template must be capitalised exactly as the page name is, otherwise the arguments will not be passed through from the template page to the module.

The template configuration page should look something like this:

return{
blurb="Find sources for 1ドル – 2ドル",
introLink={code='google'},
links={
{code='google news',display='news'},
{code='google newspapers',display='newspapers',tooltip='Search newspapers with Google Books'}
},
separator=', ',
isUsedInMainspace=true,
class='custom-class',
style='color: green; font-size: 110%;'
}
  • blurb - the text presented to users. There are two parameters available in the blurb, 1ドル and 2ドル. 1ドル is the intro link, if specified, and 2ドル represents the other links. This field is required.
  • introLink - an optional introductory link. If specified, this must be a link table. If the display value in the link table is not set, the search terms that the user entered will be used instead.
  • links - an array of link tables defining the main links to be used by the template. This field is required.
  • separator - the text separating the search engine links. This field is optional; the default value is taken from MediaWiki:Dot-separator.
  • isUsedInMainspace - set this to true if the template will be used in the main namespace. If this is not set, when the template is used in the main namespace it will produce an error and be put in Category:Pages with templates in the wrong namespace.
  • class - a custom HTML class to apply to the template text. The "plainlinks" class is added by default. This field is optional.
  • style - custom CSS to apply to the template text. This field is optional.

Once you have created your template configuration page, you need to add the template to Module:Find sources/templates in order for it to show up in the table of templates on this documentation page.

Link tables are used in the "introLink" and "links" fields of the template configuration. They can contain three fields, "code", "display", and "tooltip". The "code" field is required, and must be one of the link codes listed in the table below. The "display" field is optional, and specifies a custom display value for that link to be used by the template. If the display field is not set, a default value is set by the module. The "tooltip" field is also optional, and specifies a custom tooltip for the link. HTML reserved characters are escaped by the module. If the field is absent, no tooltip is displayed. For the "introLink" field, the default value is the search text entered by the user; for the "links" field, the default value is defined in the link configuration modules.

The following table contains all the available link codes, with descriptions and examples.

Code Description Example Notes
ap The Associated Press, an American news agency Associated Press
archive.org The Internet Archive, a digital library of public websites. Archive.org
bbc BBC, British public broadcaster BBC
bing Bing, Microsoft's flagship search engine. Bing
britannica Encyclopedia Britannica Encyclopedia Britannica
british library National library of the United Kingdom British Library
ccsearch CC Search: The official search engine of Creative Commons CC Search
cochrane Cochrane Library: Leading publisher of systematic reviews. Cochrane
doaj DOAJ: Directory of Open Access Journals DOAJ
duckduckgo DuckDuckGo, a search engine that emphasizes protecting searchers' privacy and avoiding the "filter bubble" of personalized search results. DuckDuckGo
eowb No description available Encyclopedia of World Biography
free news sources No description available free news sources
gale Gale Academic OneFile: Academic publisher portal from Gale. Access via Wikipedia Library Gale Academic OneFile
gin No description available GIN guidelines
globe and mail The website of The Globe and Mail , a newspaper of record for Canada. The Globe and Mail
google Google, the flagship search engine from Google Inc. Google
google books Google Books, Google's search engine for books. Google Books
google free images Google Images, Google's search engine for images. Only images compatible with Wikipedia's licensing are included. Free Google Images
google news Google News, Google's search engine for news sites. Google News In the past this link searched news archives, but this functionality has been removed by Google. Currently, only recent news articles are searched.
google newspapers Google Newspapers, a search of Google's digital archive of print newspapers. Google Newspapers
google scholar Google Scholar, Google's search engine for academic papers and other scholarly research. Google Scholar
haaretz The website of Haaretz , a newspaper of record for Israel. Haaretz
infoplease No description available Infoplease
internet archive scholar The Internet Archive Scholar, a digital library of open access academic journals. IA scholar
jstor JSTOR, an online library containing digitised versions of academic journals. Requires a subscription. JSTOR
library of congress U.S. Library of Congress Library of Congress
mail and guardian The website of the Mail & Guardian , a newspaper of record for South Africa. Mail & Guardian
medrs MEDRS: Ideal sources for biomedical material include recent literature reviews and medical guidelines; learn how to identify reliable sources for medical content. find medical sources
muse No description available MUSE
new york times The website of The New York Times , a newspaper of record for the United States. New York Times
new zealand herald The website of The New Zealand Herald , a newspaper of record for New Zealand. The New Zealand Herald
openlibrary No description available OpenLibrary
openmd OpenMD: Search engine for medical literature. OpenMD
pubmed PubMed: Search engine for biomedical literature from NLM. PubMed
reuters Reuters, an international news agency Reuters
sciencedirect ScienceDirect: Elsevier's scientific, technical, and medical research portal. ScienceDirect
south china morning post The website of the South China Morning Post , a newspaper of record for Hong Kong. South China Morning Post
springer Springer Nature's portal for journals, books, and reference works. Springer
statpearls StatPearls: the largest provider of healthcare continuing education worldwide, providing peer-reviewed practice-guiding knowledge authored by clinical experts. StatPearls
straits times The website of The Straits Times , a newspaper of record for Singapore. The Straits Times
sydney morning herald The website of The Sydney Morning Herald , a newspaper of record for Australia. The Sydney Morning Herald
the age The website of The Age , a newspaper of record for Australia. The Age
the guardian The Guardian newspaper, U.K. The Guardian
the hindu The website of The Hindu , a newspaper of record for India. The Hindu
the times The website of The Times , a newspaper of record for the United Kingdom. The Times
times of india The website of The Times of India , a newspaper of record for India. The Times of India
trip Trip Database: Search engine for clinical research evidence. Trip Database
uptodate No description available UpToDate
vgrl Wikipedia:WikiProject Video games/Reference library internal archive search. VGRL
vgrs Google RS, a custom Google search engine that limits the search to sites listed in Wikipedia:WikiProject Video games/Sources. VGRS
vgtalk A search in the WikiProject Video games talk page and its archives under Wikipedia talk:WikiProject Video games. WPVG Talk
wikipedia library Search results from dozens of services provided via EBSCOhost to Wikipedians via Wikipedia:The Wikipedia Library. TWL
wikipedia reference search Wikipedia Reference Search, a Google search that only searches sites vetted by Wikipedians. Wikipedia Reference Search
wiley Wiley Online Library: Wiley's portal for academic articles, books, and collections. Wiley
wsj The website of The Wall Street Journal , a newspaper of record for the United States. Wall Street Journal

Template invocation

The template invocation on the template page itself should look like this:

{{#invoke:Find sources|template}}<noinclude>
{{#invoke:Find sources/autodoc|template}}
</noinclude>

This activates the template code and also provides automatic documentation. template is the name of the template without the namespace prefix, and must be correctly capitalised.

If you want to use custom documentation from a /doc subpage instead of the automatic documentation, use this invocation instead:

{{#invoke:Find sources|template}}<noinclude>
{{documentation}}
<!-- Categories go on the /doc subpage, and interwikis go on Wikidata. -->
</noinclude>

New links are added to Module:Find sources/links. Link codes should be short but descriptive, and should be in lower case. For example, the link code for Google search is "google".

The link configuration page should look something like this:

return{
url='//www.google.com/search?as_eq=wikipedia&q=1ドル',
display='Google',
description='[[Google]], the flagship search engine from Google Inc.',
}
Parameters
Parameter Description
url The url to perform the search. This field takes a parameter 1,ドル which is the URL-encoded search text entered by the user. This field is required.
display If a display value is not specified in the template configuration, this value is used instead. This field is required.
separator This is used to separate the search terms entered by the user. This is optional, and defaults to "+" (a URL-encoded space).
description a brief description of what the search engine link does. This is used in the template documentation to generate the list of link descriptions, and also to make the descriptions in the table of link codes above. This is optional, but recommended.
notes notes about the search engine link. These are put in the table of link codes above, but they are not put in the template documentation for individual source-finding templates. This field is optional.

Automatic documentation

Automatic documentation is provided for templates based on this module; the documentation is generated by Module:Find sources/autodoc. The autodoc module uses the following pages:

Template documentation configuration page

This page is located at the "/autodoc" subpage of the template configuration page. It is only used to generate the documentation, not to generate any of the actual template output, so it does not need to be protected. It should look something like this:

return{
shortcuts={'shortcut1','shortcut2'},
description='This template is used to provide source links on [[WP:AFD|AfD]] pages',
docIntro='This template produces a series of search-engine links to be used on [[WP:AFD|AfD]] pages.'
}
  • shortcuts - an array of shortcuts that redirect to the template page. These are displayed on the template documentation page using the {{template shortcut }} template.
  • description - a brief description of what the template does. This is displayed on this documentation page in the table of available templates.
  • docIntro - text to be used instead of the first sentence of the template documentation for individual source-finding templates. This is optional, and the default value is "This template produces a series of links to various search interfaces to help find additional reference material for articles."

Configuration

The messages used in this module can be found at Module:Find sources/config and Module:Find sources/autodoc/config. This can be helpful for translating this module for use in other languages. Note that any template and link configuration used must also be translated.

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

 -- This module implements {{find sources}} and other similar templates, and
 -- also provides a mechanism to easily create new source-finding templates.

 -- Define constants
 localROOT_PAGE='Module:Find sources'
 localTEMPLATE_ROOT=ROOT_PAGE..'/templates/'-- for template config modules
 localLINK_CONFIG=ROOT_PAGE..'/links'-- for link config modules
 localCONFIG_PAGE=ROOT_PAGE..'/config'-- for global config

 -- Load required modules
 localcheckType=require('libraryUtil').checkType
 localcfg=mw.loadData(CONFIG_PAGE)

 localp={}

 localfunctionmaybeLoadData(page)
 localsuccess,data=pcall(mw.loadData,page)
 returnsuccessanddata
 end

 localfunctionsubstituteParams(msg,...)
 returnmw.message.newRawMessage(msg,...):plain()
 end

 localfunctionrenderSearchString(searchTerms,separator,transformFunc)
 -- This takes a table of search terms and turns it into a search string
 -- that can be used in a URL or in a display value. The transformFunc
 -- parameter can be used to transform each search term in some way (for
 -- example, URL-encoding them).
 localsearchStrings={}
 fori,sinipairs(searchTerms)do
 searchStrings[i]=s
 end
 iftransformFuncthen
 fori,sinipairs(searchStrings)do
 searchStrings[i]=transformFunc(s)
 end
 end
 returntable.concat(searchStrings,separator)
 end

 functionp._renderLink(code,searchTerms,display,tooltip)
 -- Renders the external link wikicode for one link, given the link code,
 -- a table of search terms, and an optional display value and tooltip.

 -- Get link config.
 locallinks=maybeLoadData(LINK_CONFIG)
 locallinkCfg=links[code]
 ifnotlinkCfgthen
 error(string.format(
 "invalid link code '%s'; no link config found at [[%s]]",
 code,
 LINK_CONFIG
 ))
 end

 -- Make URL.
 localurl
 do
 localseparator=linkCfg.separatoror"+"
 localsearchString=renderSearchString(
 searchTerms,
 separator,
 mw.uri.encode
 )
 url=substituteParams(linkCfg.url,searchString)
 end

 iftooltipthen
 returnstring.format('<span title="%s" style="border-bottom: 1px dotted;">[%s %s]</span>',
 mw.text.encode(tooltip),url,displayorlinkCfg.display)
 else
 returnstring.format('[%s %s]',url,displayorlinkCfg.display)
 end
 end

 functionp._main(template,args)
 -- The main access point from Lua.
 checkType('_main',1,template,'string')
 checkType('_main',2,args,'table',true)
 args=argsor{}
 localtitle=mw.title.getCurrentTitle()

 -- Get the template config.
 localtemplateCfgPage=TEMPLATE_ROOT..template
 localtemplateCfg=maybeLoadData(templateCfgPage)
 ifnottemplateCfgthen
 error(string.format(
 "invalid template name '%s'; no template config found at [[%s]]",
 template,templateCfgPage
 ))
 end

 -- Namespace check.
 ifnottemplateCfg.isUsedInMainspaceandtitle.namespace==0then
 localformatString='<strong class="error">%s</strong>'
 ifcfg['namespace-error-category']then
 formatString=formatString..'[[%s:%s]]'
 end
 returnstring.format(
 formatString,
 cfg['namespace-error'],
 mw.site.namespaces[14].name,
 cfg['namespace-error-category']
 )
 end

 -- Get the search terms from the arguments.
 localsearchTerms={}
 fori,sinipairs(args)do
 searchTerms[i]=s
 end
 ifnotsearchTerms[1]then
 -- Use the current subpage name as the default search term, unless 
 -- another title is provided. If the page uses a disambiguator like
 -- "Foo (bar)", make "Foo" the first term and "bar" the second.
 localsearchTitle=args.titleortitle.subpageText
 localterm,dab=searchTitle:match('^(.*) (%b())$')
 ifdabthen
 dab=dab:sub(2,-2)-- Remove parens
 end
 iftermanddabthen
 searchTerms[1]=term
 searchTerms[2]=dab
 else
 searchTerms[1]=searchTitle
 end
 end
 searchTerms[1]='"'..searchTerms[1]..'"'

 -- Make the intro link
 localintroLink
 iftemplateCfg.introLinkthen
 localcode=templateCfg.introLink.code
 localdisplay=templateCfg.introLink.displayorrenderSearchString(
 searchTerms,
 '&nbsp;'
 )
 localtooltip=templateCfg.introLink.tooltip
 introLink=p._renderLink(code,searchTerms,display,tooltip)
 else
 introLink=''
 end

 -- Make the other links
 locallinks={}
 localseparator=templateCfg.separatororcfg['default-separator']
 localsep=''
 fori,tinipairs(templateCfg.links)do
 links[i]=sep..p._renderLink(t.code,searchTerms,t.display,t.tooltip)..
 (t.afterDisplayor'')
 sep=t.separatororseparator
 end
 links=table.concat(links)

 -- Make the blurb.
 localblurb=substituteParams(templateCfg.blurb,introLink,links)
 localspan=mw.html.create('span')
 span
 :addClass('plainlinks')
 :addClass(templateCfg.class)
 :cssText(templateCfg.style)
 :wikitext(blurb)

 returntostring(span)
 end

 setmetatable(p,{__index=function(t,template)
 -- The main access point from #invoke.
 -- Invocations will look like {{#invoke:Find sources|template name}},
 -- where "template name" is a subpage of [[Module:Find sources/templates]].
 localtname=template
 iftname:sub(-8)=='/sandbox'then
 -- This makes {{Find sources/sandbox|Albert Einstein}} work.
 tname=tname:sub(1,-9)
 end
 returnfunction(frame)
 localargs=require('Module:Arguments').getArgs(frame,{
 wrappers=mw.site.namespaces[10].name..':'..tname
 })
 returnt._main(template,args)
 end
 end})

 returnp

AltStyle によって変換されたページ (->オリジナル) /