Module:Find sources/doc
 | This is a documentation subpage for Module:Find sources. It may contain usage information, categories and other content that is not part of the original module page. |
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.
From Lua
Load the module with the following code:
local mFindSources = 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. 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 |
Link codes
The following table contains all available codes for search engine links, 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, the flagship search engine from Google Inc. | |||
| 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 |
Documentation
The documentation for individual templates is generated by Module:Find sources/autodoc.