Template:London Gazette/doc
This is a documentation subpage for Template:London Gazette. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 35,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
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
[edit]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=y }}
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
[edit]- 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 issue of the Gazette (typically found under the title block on the first page and at the top of each succeeding page).
Transclusions which lack any of the required parameters are added to Category:Articles missing Template:London Gazette required parameter.
Optional parameters
[edit]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
- city: Either
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)
- nolink: Set
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}}
.
- mode: see Help:Citation Style 1#Display options. Setting
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=
.
- postscript: Using
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.
- supp: To correctly format the URL to link to a Gazette supplement, set this parameter to
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
[edit]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:
- The issue number. This may be up to five digits and also appear in the URL after ".../issue/".
- The page number. This may be up to five digits and also appears as the last group of characters in the URL.
- 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
- If from a standard gazette issue, the following will be included in the URL, ".../page/..." and no action is required.
- 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
[edit]Some standard use cases
- {{London Gazette
|issue=33000
|date=9 December 1924
|page=8957
}}
→ "No. 33000". The London Gazette. 9 December 1924. p. 8957.
- {{London Gazette
|issue=34000
|date=1 December 1933
|pages=7765–7766
}}
→ "No. 34000". The London Gazette. 1 December 1933. pp. 7765–7766.
- {{London Gazette
|issue=31712
|date=30 December 1919
|page=1
|supp=4
}}
→ "No. 31712". The London Gazette (4th supplement). 30 December 1919. p. 1.
- {{London Gazette
|issue=17039
|date=11 July 1815
|page=1409
|display-supp=1
}}
→ "No. 17039". The London Gazette (1st supplement). 11 July 1815. p. 1409.
- {{London Gazette
|issue=34000
|date=1 December 1933
|pages=7765–7766
}}
→ "No. 34000". The London Gazette. 1 December 1933. pp. 7765–7766.
A link to a page in the Edinburgh gazette
- {{London Gazette
|issue=11370
|date=3 January 1902
|page=1
|city=e
}}
→ "No. 11370". The Edinburgh Gazette. 3 January 1902. p. 1.
A link to a page in the Oxford gazette
- {{London Gazette
|issue=1
|date=7 November 1665
|page=1
|city=o
}}
→ "No. 1". The Oxford Gazette. 7 November 1665. p. 1.
No parameters (error)
- {{London Gazette}}
→
You must specify issue= and date= when using {{London Gazette}}.
Error messages
[edit]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
- the single letter
- 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
[edit]TemplateData for London Gazette
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 Edinburgh Gazette online archives and to the Belfast Gazette online archives.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Issue | issue | The issue number of the referenced Gazette (to find this from the date, consult WP:London Gazette Index)
| Number | required |
Date | date | The publication date of the referenced Gazette. This should be in the format day month year.
| Date | required |
Page | page | 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.
| Page name | optional |
Pages | pages | The page range of the reference Gazette in the form number–number where the two page numbers are separated by a ndash
| Page name | optional |
Supplement | supp | 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.
| Number | optional |
Display-supplement | display-supp | Some supplements are accessed without an alteration to the standard URL in which case use this parameter and not the supp parameter.
| Number | optional |
nolink | nolink | 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)
| String | optional |
City | 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
| String | optional |
Title | title | Sets a title
| String | optional |
Quote | quote | Appends a quote to the end of the template. | String | optional |
Ref | ref | Used in conjunction with the harv template. It can be altered to any value
| Unknown | optional |
Mode | mode | Setting ''mode=cs2'' changes the style to ensure consistency with Citation style 2, as produced by the Citation template
| String | optional |
Postscript | postscript | To remove the final period, or change it to any other character — now semi-redundant use the <code>mode</code> parameter instead.
| String | optional |
Maintenance categories
[edit]