Template:Reflib/Domain doc
This is
Introduction
An article domain is a topic area in which a group of related articles have shared citations; that is, citations which are used, or are likely to be used, in more than one article in the domain. It is by design a vetted repository of citations to reliable sources where new or veteran editors can come and find useful sources for their topic, already formatted properly as
Instead of having to copy and paste full citations among numerous articles in the domain and keep them in sync,
Usage
Sections
This article domain library is a repository for unique citations which may be used in multiple articles in the same domain. Full citations may be added to this library when they are likely to be used in more than one article: create a new section name that is unique to this page, and add your citation to the section. It does not matter whether or not there is a blank line after the
Modify as necessary, to make the section header unique on the page. For authors with multiple works in the same year, you may use: Smith-2004a, Smith-2004b, and so on. If there are several different Smiths, then you may, if you wish, disambiguate with initials of given name(s): SmithA-2004, SmithCJ-2004, SmithM-2004, and so on, but any method that results in a unique section header is acceptable.
If a citation is likely to be used in only one article, there is no need to place it here; just add it to the "Works cited" or "Sources" section as usual.
Please keep sections on the page in alphabetical order, to make it easier to manage, and to more easily spot duplicates. Higher level sections such as letter indexes (A – D; E – J; etc.) are fine, as long as the citation section headers remain unique.
Citations
Because this is designed to be used with articles that use
Normally, there should be one citation per section; more than one is not recommended, but if used, will bring in all of the citations in the section. One reason you might do this is when using template {{
}} to specify a number of chapters belonging to the same book; in this case, it is better to keep them all together in one section for simplicity, even if your article doesn't cite each of the chapters.The CITEREF generated from the citation (usually by concatenating the values of (all of the) |lastN=
and |year=
) should be unique, in order to avoid generating a duplicate target error.
Updating domain containers
Prerequisites
It is recommended that only editors experienced in using
Adding a new reference section
You can add a new reference section at any time, by inserting a new section header and pasting a citation template from an article, or creating a new citation template for it. You can choose any section name that is unique on the page and complies with
If the citation template contains a |ref=
param, such as might be the case when an author has multiple publications in the same year, then use its value instead; for example, for |ref=Einstein1905d
tagging his fourth publication that year, you could use section header "Einstein 1905d". The section name doesn't *have* to match the template params, that is just a suggestion for most cases; if a mnemonic name better brings to mind what citation is involved, then use that; for example, for Einstein's fourth paper in 1905, you could use a section header of "Einstein special relativity" instead of "Einstein 1905d" if desired.
Please keep sections in alphabetical order.
Use one citation per section
Generally speaking, it is recommended that a reference section should contain just one citation. There are exceptions, such as for books containing multiple, independently citable chapters defined by {{
Renaming or deleting a reference section
Renaming a section header of a reference on a library page, or deleting a section containing a reference will cause any articles transcluding those sections via the template to generate an
Example: if you wish to delete or rename section § Bell-2008, search for use of that section by going to Special:Search and pasting this search query:
The search result page will list all articles using that section; these are the articles that will need to be updated if the section is renamed or removed.
New domains
To define a new domain, start by creating a new domain library page containing section names and citations as described above. Name the page something that is
Once the new domain library page is saved under its correct name, it is available for immediate use by the template. To enable the shortcut(s), make an
You do not need to create a documentation page for your new article domain; documentation is generated on the fly by transcluding this page and passing the domain name.
Notes
- ^ In CITEREF terms, the optimal section header name is the CITEREF destination anchor associated with the citation, minus the 'CITEREF' prefix, and with the concatenated template param values joined with blanks or hyphens. For example, for citation
{{cite book|last1=Watson|last2=Crick
we have citeref 'CITEREFWatsonCrick1953' and recommended section header name "Watson Crick 1953" or "Watson-Crick-1953". If param
|title=The Double Helix|year=1953}}|ref=
is in use, then the CITEREF will reflect that instead, and so should the section name. - Template:Reflib/FCL § Tomlinson-1999.