Template:Infobox magazine/doc: Difference between revisions

Line 652: Line 652:

== Tracking category ==

* {{clc|Pages using infobox magazine with ~~unsupported~~ parameters}}

* {{clc|Pages using infobox magazine with parameters}}

== See also ==

This infobox should italicize the article title automatically. If this is not required, add |italic title=no to the list of parameters. If this is required but the title is not being italicized, try |italic title=force.

*{{{title}}}*
[[File:{{{logo}}}\|{{{logo_size}}}]]
[[File:{{{image_file}}}\|page={{{image_page}}}\|{{{image_size}}}\|alt={{{image_alt}}}]] {{{image_caption}}}
{{{editor_title}}}	{{{editor}}}
{{{editor_title2}}}	{{{editor2}}}
{{{editor_title3}}}	{{{editor3}}}
{{{editor_title4}}}	{{{editor4}}}
{{{editor_title5}}}	{{{editor5}}}
{{{editor_title6}}}	{{{editor6}}}
Former editors	{{{previous_editor}}}
Staff writers	{{{staff_writer}}}
Photographer	{{{photographer}}}
Categories	{{{category}}}
Frequency	{{{frequency}}}
Format	{{{format}}}
Circulation	{{{circulation}}}
Publisher	{{{publisher}}}
Paid circulation	{{{paid_circulation}}}
Unpaid circulation	{{{unpaid_circulation}}}
Total circulation ({{{circulation_year}}})	{{{total_circulation}}}
Founder	{{{founder}}}
Founded	{{{founded}}}
First issue	{{{firstdate}}}
Final issue Number	{{{finaldate}}} {{{finalnumber}}}
Company	{{{company}}}
Country	{{{country}}}
Based in	{{{based}}}
Language	{{{language}}}
Website	{{{website}}}
ISSN	{{{issn}}} (print) {{{eissn}}} (web)
OCLC	{{{oclc}}}
{{{module}}}

To use this template please add the following code to the top of the article.

Note: If you have no information for a certain parameter please just blank it rather than removing it so that other editors can see that it needs adding at a later stage

{{Infobox magazine
| title           = 
| logo            = 
| logo_size       = <!-- default is 180px -->
| image_file      = <!-- cover.jpg (omit the "file:" prefix) -->
| image_size      = <!-- default is 180px -->
| image_alt       = 
| image_caption   = 
| native_name     =
| editor          = <!-- up to |editor6= -->
| editor_title    = <!-- up to |editor_title6= -->
| previous_editor = 
| staff_writer    = 
| photographer    = 
| category        = 
| frequency       = 
| format          = 
| circulation     = 
| publisher       = 
| paid_circulation   = 
| unpaid_circulation = 
| circulation_year   = 
| total_circulation  = 
| founder         = 
| founded         = 
| firstdate       = <!-- {{Start date and age|YYYY|MM|DD}} -->
| finaldate       = <!-- {{End date and age|YYYY|MM|DD}} -->
| finalnumber     = 
| company         = 
| country         = 
| based           = 
| language        = 
| website         = <!-- {{URL|example.com}} -->
| issn            = 
| eissn           =
| oclc            = 
| module          = <!-- Other templates can be embedded here -->
}}

If the magazine is defunct, include the finaldate and finalnumber parameters. If the magazine is still publishing, then these parameters should be omitted entirely:

| finaldate       = 
| finalnumber     =

If a breakdown into paid, unpaid and total circulation figures is desired, use the following lines instead of the circulation parameter:

| paid_circulation   = 
| unpaid_circulation = 
| circulation_year   = 
| total_circulation  =

The company parameter should list the publishing company. The publisher parameter should be the named person who publishes the magazine.

The previous_editor parameter should include earlier, notable, editors. In particular, the founding editor (if different from current editor), to a reasonable maximum number.

If image_file is a .djvu and a particular page is desired, then use the image_page parameter:

If other editing positions are required (e.g. Senior Editor or Associate Editor), use the additional editor fields show below.

| editor2         = 
| editor_title2   = 
| editor3         = 
| editor_title3   = 
| editor4         = 
| editor_title4   = 
| editor5         = 
| editor_title5   = 
| editor6         =
| editor_title6   =

Parameter explanations and examples

[edit]

A list of each field, what it is for and an example entry. Required parameters are asterisked (*).

Parameter	Explanation	Example
title*	The name of the magazine.	`The Wikipedian`
logo	A logo relevant to the magazine.	`Logo.png`
logo_size	The size of the logo.	`200px` (Will default to 180px if no size is stated)
image_file	An image relevant to the magazine. (Usually the cover).	`Image.png`
image_size	The size of the image.	`200px` (Will default to 180px if no size is stated)
image_alt	A description of the image’s visual appearance, suitable for someone who cannot see the image. See WP:ALT.	`Mostly-assembled globe of puzzle pieces, each with a letter in a different script. The caption says "WikipediA: The Free Encyclopedia".`
image_page	The desired page (for .djvu files).	`7`
image_caption	A description of the image.	`The Wikipedian Issue 169, cover dated 31 November 1909`
native_name	The name of the magazine in its native language and script
editor	The name of the editor of the magazine. (Must be used in conjunction with editor_title field)	`[[John Smith]]`
editor_title	The editor’s job title. Editor, Editor-in-Chief etc.	`Editor`
editor2	The name of second editor.
editor_title2	The second editor’s job title.
editor3	The name of third editor.
editor_title3	The third editor’s job title.
previous_editor	Notable preceding Editors. (See Long Lists section below)	`[[Jim Smith]]`
staff_writer	Staff Writer(s). (Please break multiple lines with <br />) (See Long Lists section below)	`[[Alan Smithee]]<br />[[Jane Smithee]]`
photographer	Photographer(s). (Please break multiple lines with <br />) (See Long Lists section below)	`[[Annie Smithee]]<br />[[Judy Smithee]]`
category*	The subject group of the magazine, e.g., Sport, Nature, History. Use as many as necessary.	`Science, Sport, History`
frequency*	Monthly, weekly, daily, etc.	`Monthly`
format*	paper size	`A4`
circulation	Circulation figures. (If circulation breakdown required/available, leave this field blank and see fields lower down this table).	`50,000`
publisher	The person that publishes the magazine. (Do not put companies in this field. Use the company field below.)	`[[John Smith]]`
founder	The person that founded the magazine. (Do not put companies in this field. Use the company field below.)	`[[John Smith]]`
founded	The date the magazine company was founded. Do not use both firstdate and founded if they are equivalent.	`{{start date\|1998\|3\|13\|df=y}}`
firstdate*	The date of publication of the first issue of the magazine. Do not use both firstdate and founded if they are equivalent.	`{{start date\|1998\|3\|13\|df=y}}`
finaldate	The date of the final issue of the magazine. (Only use if the magazine has ceased publication)	`31 April 1999`
finalnumber	The edition number of the final issue. (Only use if the magazine has ceased publication)	`Vol 77 No 88`
company	The company that publishes the magazine.	`[[The magazine publishing company]]`
country*	Country of origin. e.g. United Kingdom	`United Kingdom`
based	The town/city that the magazine is based in.	`[[Wiki Town]], [[Wikiville]]`
language	The language the magazine is printed in.	`English` or, for language names unlikely to be familiar to readers, `[[Xyzish language\|Xyzish]]`
website	The official website of the magazine.	`{{URL\|example.com}}`
issn	The International Standard Serial Number of the magazine. If the magazine has both a print and electronic version with separate ISSNs, use `issn` and `eissn`.
oclc	the OCLC number of the magazine (automatically linked to http://WorldCat.org)
Circulation breakdown parameters
paid_circulation	The circulation of “paid for” copies of the magazine.
unpaid_circulation	The circulation of free copies of the magazine.
circulation_year	The year for which the total_circulation figure is provided
total_circulation	The total circulation of the magazine.

Where long lists of names are required and may cause excessive lengthening of the Infobox, please use the {{hidden}} template. An example usage is shown below.

`\| staff_writer = {{hidden\|ta1=left\|Staff writers\| Tim Edwards<br />Graham Smith<br />Tony Ellis<br />Craig Pearson<br />Tom Francis<br />Richard Cobbett<br />Jim Rossignol<br />John Walker<br />Alec Meer<br />Matt Avery<br />Chris Buxton<br />Michael Gapper<br />[[Kieron Gillen]]<br />Mike Channell<br />Tim Stone<br />Adam Oxford<br />Quintin Smith<br />[[Duncan Harris]]<br />Drew Northcott<br />David Lyttleton }}`

Periodical circulation data is collected by independent auditing organizations. Basic circulation totals are often available free of charge via the web:

Alliance for Audited Media: Total Circ
BPA Worldwide: Media Stats
Audit Bureau of Circulations (UK): Print, Digital and Event Figures

Infobox for magazines.

Template parameters

This template prefers block formatting of parameters.
Parameter		Description	Type	Status
DO NOT ADD ANYTHING HERE	`italic title`	This is automatically filled by the template. Do not touch this.	String	optional
Title	`title`	Name of the magazine.	String	required
Logo	`logo`	no description	File	suggested
Logo size	`logo_size`	The size of the logo image.	Number	optional
Image	`image_file`	An image relevant to the magazine. Usually the cover.	File	suggested
Image size	`image_size`	no description	Number	optional
Image alt text	`image_alt`	A description of the image’s visual appearance, suitable for someone who cannot see the image. Example Mostly-assembled globe of puzzle pieces, each with a letter in a different script. The caption says “WikipediA: The Free Encyclopedia”.	Content	optional
Page of image?	`image_page`	The desired page (for .djvu files). Example 7	String	optional
Image caption	`image_caption` `caption`	no description Example <em>The Wikipedian</em> Issue 169, cover dated 31 November 1909	Content	suggested
Editor	`editor`	The name of the editor of the magazine. Must be used in conjunction with the “Editor title” field. Example [[John Smith]]	String	suggested
Editor title	`editor_title`	The editor’s job title. Example Editor-in-Chief	String	optional
Editor 2	`editor2`	The name of the second editor.	String	optional
Editor 2’s title	`editor_title2`	The second editor’s job title.	String	optional
Editor 3	`editor3`	I think you see where this is going.	String	optional
Editor 3’s title	`editor_title3`	no description	String	optional
Editor 4	`editor4`	no description	String	optional
Editor 4’s title	`editor_title4`	no description	String	optional
Editor 5	`editor5`	no description	String	optional
Editor 5’s title	`editor_title5`	no description	String	optional
Editor 6	`editor6`	no description	String	optional
Editor 6’s title	`editor_title6`	no description	String	optional
Former editor(s)	`previous_editor`	Notable preceding editor(s).	Content	optional
Staff writer(s)	`staff_writer`	no description	Content	optional
Photographer(s)	`photographer`	no description	Content	optional
Categories	`category`	The subject group of the magazine, e.g., Sport, Nature, History. Use as many as necessary. Example Science, Sport, History	Content	required
Frequency	`frequency`	Frequency of the magazine. Monthly, weekly, daily, etc.	String	required
Format	`format`	Paper size. Example A4	String	optional
Circulation	`circulation`	Circulation figures. If circulation breakdown available, leave this field blank and see fields lower down. Example 50,000	String	optional
Publisher	`publisher`	The person that publishes the magazine. Do not put companies in this field.	String	optional
Founder	`founder` `creator`	The person that founded the magazine. Do not put companies in this field.	String	optional
Founded	`founded`	The date the magazine company was founded. Do not use both firstdate and founded if they are equivalent. Example {{start date\|1998\|3\|13\|df=y}}	String	suggested
First issue	`firstdate`	The date of publication of the first issue of the magazine. Do not use both firstdate and founded if they are equivalent. Example {{start date\|1998\|3\|13\|df=y}}	String	required
Final issue	`finaldate` `lastdate`	The date of the final issue of the magazine. Example 31 April 1999	String	optional
Final issue number	`finalnumber`	The edition number of the final issue. Example Vol 77 No 88	String	optional
Company	`company`	The company that publishes the magazine.	String	suggested
Country	`country`	Country of origin. Example United Kingdom	String	required
Based in	`based`	The town/city that the magazine is based in. Example [[Los Angeles]], California, United States	String	suggested
Language	`language`	The language the magazine is printed in. Example English	String	suggested
Website	`website`	The official website of the magazine.	URL	optional
ISSN	`issn` `ISSN`	The International Standard Serial Number of the magazine. If the magazine has both a print and electronic version with separate ISSNs, use parameters “ISSN” and “eISSN”.	String	optional
eISSN	`eissn` `eISSN`	no description	String	optional
OCLC	`oclc` `OCLC`	The OCLC number of the magazine (automatically linked to http://WorldCat.org).	String	optional
Paid circulation	`paid_circulation`	The circulation of “paid for” copies of the magazine.	String	optional
Unpaid circulation	`unpaid_circulation`	The circulation of free copies of the magazine.	String	optional
Circulation year	`circulation_year`	The year for which the “Total circulation” figure is provided.	String	optional
Total circulation	`total_circulation`	The total circulation of the magazine.	String	optional

The HTML mark-up produced by this template includes an hProduct microformat that makes a product’s details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

If the product has a URL, use {{URL}} to include it.

Classes used

The HTML classes of this microformat include:

brand
category
description
fn
hproduct
identifier
listing
photo
price
review
type
url
value

Please do not rename or remove these classes
nor collapse nested elements which use them.

Parameter explanations and examples

Must Read

Leave a Comment Cancel Reply

Leave a Comment