Template:London Gazette/doc

This is a documentation subpage for Template:London Gazette.
It contains usage information, categories and other content that is not part of the original template page.

This template uses Lua:

Module:London Gazette util

This template is used to provide references to pages in the London Gazette online archive website. The London Gazette is the official newspaper of the British government for England and Wales in which all official notices are published. The template is provided to simplify the entering of addresses. An index by number/date (i.e. if you know the number or date you can find the document) is at WP:London Gazette Index.

The template may also be used to provide references to pages in the of the Edinburgh Gazette online archives and to Belfast Gazette online archives.

Usage

Basic form using minimum parameters to link to the reference (when used as an inline reference, the <ref></ref> tags must be added separately):

{{London Gazette |issue= |date= }} (For an entire issue)
{{London Gazette |issue= |date= |page= }} (For a single page)

Using pages to refer to a range of pages in the link: {{London Gazette |issue= |date= |pages= }}

Using city to refer to a page in the Edinburgh or Belfast Gazette in the link: {{London Gazette |issue= |date= |page= |city= }}

Using supp to link to a page in a supplement to a Gazette {{London Gazette |issue= |date= |page= |supp= }}

All parameters, delete those you don't need {{London Gazette |issue= |date= |page= |pages= |supp= |display-supp= |city= |nolink= |postscript= |mode= |title= |ref= |quote=}}

All parameters, vertical format:

{{London Gazette
 | issue =
 | date =
 | page =
 | pages =
 | supp =
 | display-supp =
 | nolink =
 | city =
 | title =
 | quote =
 | mode =
 | ref =
 | postscript =
}}

Required parameters

issue: The issue number of the referenced Gazette (to find this from the date, consult WP:London Gazette Index)
date: The publication date of the referenced Gazette. This should be in the format day month year.

Transclusions which lack any of the required parameters are added to Category:Articles missing Template:London Gazette required parameter.

Optional parameters

For use where a single page is to be referenced:

page: The page of the referenced Gazette on which the citation is found (if a page range is required see pages below)—also use this option when citing a whole issue, for example for the Birthday Honours List.

For use where a range of pages is to be referenced:

pages: first and last pages of a page range separated with an en dash: 1–12; or, comma separated list of page numbers: 1, 12; or a mix of both: 1–3, 6, 8.

For a link to the Edinburgh, Belfast Gazette or Oxford Gazette:

city: Either |city=e for Edinburgh Gazette, |city=b for Belfast Gazette or |city=o for the Oxford Gazette as the first 23 issues of the London Gazette were titled. The city names may also be spelt out in full if you prefer, e.g. |city=Edinburgh

To display the name of the Gazette without a wikilink (e.g. if there are multiple uses of the template, allow the link on the first but disable the rest):

nolink: Set |nolink=y to display the name of the Gazette without a wikilink (e.g. if there are multiple uses of the template on the same page)

The punctuation used to separate elements in the rendered citation:

mode: see Help:Citation Style 1#Display options. Setting |mode=cs2 changes the style to ensure consistency with Citation style 2, as produced by {{Citation}}.

To remove the final period, or change it to any other character:

postscript: Using |postscript= see Help:Citation Style 1#Display options — now semi-redundant, consider using |mode=.

Others

title: see Help:Citation Style 1.

ref: set by default to CITEREFGazetteissue can be altered as described in Help:Citation Style 1#Anchors.

quote: see Help:Citation Style 1#Quote

title: defaults to "No. issue", but can be overwritten with any title (in which case "No. issue" displays elsewhere in the template). See also Help:Citation Style 1#Title

Specifying a supplement to a Gazette:

supp: To correctly format the URL to link to a Gazette supplement, set this parameter to y, or the one or two digit number of the supplement—numbers 1 to 99 are supported. Usually this will be to an unnumbered or first supplement (|supp=1). There are exceptions. See display-supp and the table.
display-supp: Sometimes issues and supplements at the London Gazette website aren't where they would be expected. Sometimes issues are located at a supplement URL and sometimes supplements are located at an issue URL. When this is the case, use |display-supp= with |supp= to direct the template to select the correct URL and render the correct display. See the table.

interaction between |supp= and |display-supp=
row	\|display-supp=	\|supp=	condition	displayed result	url	comment
1	–	–	–	<no supplement display>	`/page/`	most common non-supplement form
2	–	y	–	Supplement	`/supplement/`	unnumbered supplement
3	–	##	–	`{{{supp}}}`<suffix> supplement	`/supplement/`	specific numbered supplement
4	–	<text>	–	`invalid` `\|supp=`	`/page/`	invalid or out of range
5	`none`	y	–	<no supplement display>	`/supplement/`	when page not at `/page/` url
6	y	–	–	Supplement	`/supplement/`	when unnumbered supplement not at `/supplement/` url
7	##	–	–	`{{{display-supp}}}`<suffix> supplement	`/page/`	when supplement not at `/supplement/` url
8	##	y	–	`{{{display-supp}}}`<suffix> supplement	`/supplement/`	specific numbered supplement (similar to 3)
9	##	##	`{{{supp}}} == {{{display-supp}}}`	`{{{display-supp}}}`<suffix> supplement	`/supplement/`	\|supp= and \|display-supp= must agree
10	##	##	`{{{supp}}} != {{{display-supp}}}`	`invalid` `\|supp=`	`/supplement/`	ambiguous; which supplement number is correct?
11	<text>	–	–	`{{{display-supp}}}`	`/page/`	user specified text; not at `/supplement/` url
12	<text>	y	–	`{{{display-supp}}}`	`/supplement/`	user specified text
13	<text>	##	–	`{{{display-supp}}}`	`/supplement/`	user specified text
14	<text>	<text>	–	`invalid` `\|supp=`	`/supplement/`	`\|supp=` invalid or out of range
key
–		parameter is empty or missing; a condition does not apply
##		a number greater than zero and less than 100
<suffix>		the appropriate ordinal suffix: 1st, 2nd, 3rd, 4th, ...
<text>		any characters that are not ## or the letter y (or, for `\|disp-supp=`, not the keyword `none`)
`==`		logical equality; the statement A == B is true when A and B hold the same value
`!=`		logical inequality; the statement A != B is true when A and B hold different values

Source of information for parameters

To find the information to put into the parameters:

Visit the Gazette website search page: The Gazette
Enter search terms into the search fields including a date range and a choice of Gazette edition(s)
When the list of matching Gazette issues is displayed, click on a link and the site will open a window with a PDF image of a page of the gazette. From the heading above the page image note:
1. The issue number. This may be up to five digits and also appear in the URL after ".../issue/".
2. The page number. This may be up to five digits and also appears as the last group of characters in the URL.
3. The publication date
If the reference needs to refer to a range of pages, find the last relevant page and note the page number as before.
Check if the page is part of an issue or a supplement
1. If from a standard gazette issue, the following will be included in the URL, ".../page/..." and no action is required.
2. If the page is part of a supplement to an issue, the following will be included in the URL, ".../supplement/..." , the parameter |supp= must be added to the template. Any character may follow, as long as it is not left blank.
When referencing the Belfast or Edinburgh Gazettes, use |city=b or |city=e. When referencing the first 23 issues of the London Gazette (published as the Oxford Gazette) use |city=o. Setting |city=l explicitly refers to the London Gazette. Omitting, leaving the parameter blank, or specifying any other value but b, e, l, or o, will cause the template to default to the London Gazette.
Add each of these to the template
Add the Retrieval date

Examples

Some standard use cases

{{London Gazette |issue=33000 |date=9 December 1924 |page=8957 }}
→ No. 33000. 9 December 1924. p. 8957. https://www.thegazette.co.uk/London/issue/33000/page/8957

{{London Gazette |issue=34000 |date=1 December 1933 |pages=7765–7766 }}
→ No. 34000. 1 December 1933. pp. 7765–7766. https://www.thegazette.co.uk/London/issue/34000/page/7765

{{London Gazette |issue=31712 |date=30 December 1919 |page=1 |supp=4 }}
→ No. 31712. 30 December 1919. p. 1. https://www.thegazette.co.uk/London/issue/31712/supplement/1

{{London Gazette |issue=17039 |date=11 July 1815 |page=1409 |display-supp=1 }}
→ No. 17039. 11 July 1815. p. 1409. https://www.thegazette.co.uk/London/issue/17039/page/1409

{{London Gazette |issue=34000 |date=1 December 1933 |pages=7765–7766 }}
→ No. 34000. 1 December 1933. pp. 7765–7766. https://www.thegazette.co.uk/London/issue/34000/page/7765

A link to a page in the Edinburgh gazette

{{London Gazette |issue=11370 |date=3 January 1902 |page=1 |city=e }}
→ No. 11370. 3 January 1902. p. 1. https://www.thegazette.co.uk/Edinburgh/issue/11370/page/1

A link to a page in the Oxford gazette

{{London Gazette |issue=1 |date=7 November 1665 |page=1 |city=o }}
→ No. 1. 7 November 1665. p. 1. https://www.thegazette.co.uk/London/issue/1/page/1

No parameters (error)

{{London Gazette}}
→

You must specify issue= and date= when using {{London Gazette}}.

Error messages

Certain combinations of parameters are invalid or inappropriate. The template attempts to make sense of all parameter values. When that is not possible, it emits error messages. These messages are:

invalid |supp= – |supp= accepts a limited range of parameter values. The values are:
the single letter y

one or two digit numbers in the range of 1 to 99 inclusive
more than one of |page= and |pages= – simultaneous use of these is not permitted; choose the appropriate parameter
London Gazette uses unsupported parameters – these parameters no longer supported:
|ps= – use |postscript=

|separator= – use |mode=

|startpage= – use |page= or |pages=

|endpage= – use |page= or |pages=

|accessdate= – remove

|access-date= – remove

Template Data

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for London Gazette

<templatedata> { "params": { "issue": { "label": "Issue", "description": "The issue number of the referenced Gazette (to find this from the date, consult WP:London Gazette Index)", "example": "33000", "type": "number", "required": true }, "date": { "label": "Date", "description": "The publication date of the referenced Gazette. This should be in the format day month year.", "example": "9 December 1924", "type": "date", "required": true }, "page": { "label": "Page", "description": "The page of the referenced Gazette on which the citation is found - Except when citing a whole issue, for example for the Birthday Honours List.", "example": "123", "type": "wiki-page-name" }, "pages": { "label": "Pages", "description": "The page range of the reference Gazette in the form number–number where the two page numbers are separated by a ndash", "example": "123–124", "type": "wiki-page-name" }, "supp": {

                       "label": "Supplement",

"description": "For a link in a supplement to a Gazette - To correctly format the URL to link to a page in a Gazette supplement, set this parameter to the number of the supplement (typically, supp=1); otherwise omit it.", "example": "1",

                       "type": "number"

},

               "display-supp": {
                       "label": "Display-supppement",
                       "description":  "Some supplements are accessed without an alteration to the standard ULR in which case use this parameter and not the supp parameter.",

"example": "1",

                       "type": "number"
                },

"nolink": { "description": "To display the name of the Gazette without a wikilink (e.g. if there are multiple uses of the template on the same page, allow the link on the first but disable the rest)", "example": "y", "type": "string" }, "city": { "label": "City", "description": "Either |city=e for Edinburgh Gazette, |city=b for Belfast Gazette or |city=o for the Oxford Gazette as the first 23 issues of the London Gazette were titled. The city names may also be spelt out in full if you prefer, e.g. |city=Edinburgh", "example": "e", "type": "string", "default": "London", "autovalue": "" }, "title": {

                       "label": "Title",
                       "description": "Sets a title",

"type": "string",

                       "default": "No. issue"
               },

"quote": {

                       "label": "Quote",
                       "description": "Appends a quote to the end of the template.",

"type": "string"

},

"ref": {

                       "label": "Ref",
                       "description": "Used in conjunction with the harv template. It can be altered to any value",
 			"default": "Gazette issue"
               },
               "mode": {
                       "label": "Mode",
                       "description": "Setting mode=cs2 changes the style to ensure consistency with Citation style 2, as produced by the Citation template",

"type": "string", "default": "cs1"

},

"postscript": {

                       "label": "Postscript",

"description": "To remove the final period, or change it to any other character — now semi-redundant use the mode parameter instead.", "type": "string", "default": "." }, }, "description": "This template is used to provide references to pages in the London Gazette online archive website. The London Gazette is the official newspaper of the British government for England and Wales in which all official notices are published. The template is provided to simplify the entering of addresses. An index by number/date (i.e. if you know the number or date you can find the document) is at WP:London Gazette Index.\n\nThe template may also be used to provide references to pages in the of the Edinburgh Gazette online archives and to Belfast Gazette online archives.", "paramOrder": [ "issue", "date", "page", "pages", "supp",

               "display-supp",

"nolink", "city",

               "title",
               "quote",
               "ref",
               "mode",

"postscript", ], "format": "block" } </templatedata>

Maintenance categories

Category:Pages containing London Gazette template with parameter supp set to y (59)