Template:Information/doc: Difference between revisions

Safer nicotine wiki Tobacco Harm Reduction
Jump to navigation Jump to search
m (1 revision imported)
m (1 revision imported)
Line 1: Line 1:
{{Lua|Module:Information}}
{{Documentation subpage}}
{{TemplateBox
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
|name = Information
|desc = '''Please give full information for the ''description'', ''date'', ''source'' and ''author'' fields.'''


The date of a photograph must be when the original photograph was created, and not the date of upload, nor the date of scanning or digitizing. If the photographic image has been modified please give author, date and license for each modification. Please use template {{tl|Artwork}} or {{tl|Art photo}} if the image is of a painting, sculpture or other artwork and {{tl|Book}} if the image is a part of a complete set of page scans of a book (or in the case of DjVu and PDF, one file may comprise all the pages).
== Usage ==


{{Nobold|This template is used to provide formatting to the basic information for files (description, source, author, etc.), and it is automatically inserted by the upload tools. All the field names are not case sensitive. The template is able to access information in [[com:SDC|Structured Data on Commons]] (SDC), so if proper SDC data is used some or even all the fields can be ommited.}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
 
<pre>{{Information
For a full usage description of the template, see [[Commons:First steps/Quality and description]].
|Description=
 
|Source=
|namespace=File
|Date=
|usergroup=all
|Author=
 
|other_versions=
|1=description
}}</pre>
|1aliases = Description
<!-- Categories go here and interwikis go in Wikidata. -->
|1d-en = Description of the image or other media file. The '''content''' of the description should provide brief (if possible) but complete information about the image. It should:
* Identify subject like notable people (use {{tl|Depicted person}} template), animals, objects, cars, weapons, etc.
* Identify location (if relevant) by text, like: city, country, building name or address, etc.
* Note that location coordinates are not directly included as separate field in the "Information" template. Template {{tl|location}} (for camera location and heading, preferred) and/or {{tl|object location}} (for the depicted objects) should be used. Template {{tl|location}} should be placed directly above or below {{tl|Information}}.<br /><small>Note: some users prefer to include location template(s) into the "Description" field of {{tl|Information}} template in order to group all location information together—this solution is fully serviceable but objections are in point of graphic design not ideal adjusted for such use. See [[Template talk:Information/Archive 2#Location template|this]] discussion and also [[Template talk:Information/Archive 2#Suggestions|this]] one.</small>
* In general, description should provide information to support all subject categories of the file.
* In case of group pictures or other images where image details might warrant separate description please use [[Commons:Image annotations|image annotations]], but remember that those annotations might not be visible on Wikipedias which did not adopt the gadget to display them.
The description '''format''' should use:
* {{C|Language templates}} like {{tl|en}} or {{tl|de}} to specify the language of the description.
* [[:w:Hyperlink|Wikilinks]] to Wikipedia articles, [[Commons:Galleries|Commons galleries]] or [[Commons:Categories|Commons categories]]. This helps with disambiguation and allows shorter format.
When the ''name of the file'' is enough descriptive that it could be used in the file description without alteration, the short notation [[Template:F/doc#descr|<nowiki>{{F|F}}</nowiki>]] can be used (with or without additional text) e.g. <code><nowiki>|description={{en|{{F|F}}.}}</nowiki></code>
An alternative or complement to this field is a [[com:File_captions|structured data caption]].
|1d-td-en = Description of the image or media file, including subject and location.
|1d-td-de = Beschreibung dieser Mediendatei.
|1stat=required
|1label-en = Description
|1label-de = Beschreibung
|1type=string
|1def=[[com:SDC|SDC]]'s captions followed by {{tl|Description missing}}
 
|2=date
|2aliases = Date
|2d-en = Date of creation, when the original source (such as photograph of 3-D scene, digital file, or original 2-D artwork, or SVG drawing) was created. Possible '''formats:'''<!--Keep an empty paragraph between this para and the list start to avoid borking the formatting inside a table:-->
 
* [[:en:ISO 8601|ISO 8601]] is the preferred format, e.g. "2006-01-15" for "15 January 2006". Dates following this format are processed by {{tl|ISOdate}}. The following formats are recognized:
** YYYY
** YYYY-MM
** YYYY-MM-DD
** YYYY-MM-DD hh:mm<ref name="d">Date should be a date, preferred without any timestamping</ref>
** YYYY-MM-DD hh:mm:ss<ref name="d"/>
* Use {{tl|other date}} for less precise dates, like: circa…, after…, spring of…, between…, etc.
* It is possible to use {{tl|date}} template. For example "<code>date=2008-06-09</code>" is equivalent to "<code>date={{tlx|date|2008|6|9}}</code>", but [[:en:ISO 8601|ISO 8601]] format is preferred.<br /> In many cases multiple dates and/or extra explanations are required:
* For photos, we have special templates {{tl|Taken on}} and {{tl|Taken in}} to indicate when the photograph was taken and to distinguish it from the creation date of the depicted work, or from the creation date of the derivative work (modified or cropped photo, collage etc.). Those templates use ISO format (e. g. {{tld|Taken on|YYYY-MM-DD hh:mm}} or {{tld|Taken in|YYYY}}).
* If the date is missing, but the digital file has [[:en:EXIF|EXIF]] data, then the {{tl|According to EXIF data}} template can be added (usually done by a [[Commons:Bots|bot]]). The templates use the ISO format (e. g. {{tld|According to EXIF data|YYYY-MM-DD}}).
* If the creation date of a file moved from other project is unknown, {{tl|Original upload date}} can be used — this template should be also used (in addition) if the first publication date (outside Commons) is relevant in relation to copyright. This template also uses the ISO format.
* If the creation date of a file (not moved from other project) is unknown, {{tl|Upload date}} can be used. This template also uses the ISO format.
* If the file is a modified or derivative work, then both the date of the original (source) work and the date of the last version (derivative work) should be stated with appropriate comments or notes.
* If the date has to be furnished with some specifying text, not covered by one of the above templates, (e. g. "date of creation", "date of the first publication", "date of modification" etc.) then dates have to be specified using {{tl|ISOdate}} (i.e. {{tld|ISOdate|2009-08-18}} (''date of creation'')) or {{tl|date}} (i.e. {{tld|date|2008|6|9}} (''date of modification'')) templates.
* If the file is not a simple copy of the depicted work, the date or year of the creation of the depicted work should be stated rather in the "description" field.
An alternative to using this field is to use [[com:SDC|SDC]]'s {{P|P571}} property. See [[Commons:Structured data/Modeling/Date]] for supported formats.


|2d-td-en = When the original source was created.
}}</includeonly>
|2d-td-de = Erstellungsdatum des Originals.
|2stat=suggested
|2label-en = Date of creation
|2label-de = Erstellungsdatum
|2type=string/line
|2def=[[com:SDC|SDC]]'s {{P|P571}}


|3=source
|3aliases = Source
|3d-en = Information about where the file is from (own files should be tagged with {{tl|own}}); if the file is based on other files then the original files should also be uploaded (if possible) and referenced. Possible content:<!--Keep an empty paragraph between this para and the list start to avoid borking the formatting inside a table:-->


* {{tl|own}} for works uploaded by the author
* {{tl|own based}} for works based on other images already on Commons. This template takes its own parameters for the names of the files on which the image is based, and is used thus: {{tld|own based|name of first file.jpg|name of second file.svg}} Please note that {{tl|own based}} may also be used to indicate the (data) source used to generate a diagram etc.
* {{tl|sf}} for photos created by the author
* {{tl|private correspondence}} for previously unpublished works uploaded at the behest of a third party who wishes to remain confidential (such works must be connected with an [[Commons:OTRS|OTRS ticket]] and the tag {{tlsx|OP}} should be added to the file after an email with a permission statement has been sent to OTRS)
* [[:en:URL|URL]] where the file was found on the web, i.e. its url or its web address
* {{tl|Derived from}} when it is derived from other files, a list of those files
* Book reference (using {{tl|scan}} and {{tl|Cite book}} templates) for images scanned from a book. If image was scanned by the uploader that should be mentioned too: {{tl|own scan}}
{{see|Commons:Essential information}}
An alternative to using this field is to use [[com:SDC|SDC]]'s {{P|P7482}} property. See [[Commons:Structured data/Modeling/Source]] for supported formats.


|3d-td-en = Where the file is from. Your own files should be tagged with {{own}}.
|3stat=required
|3label-en = Source
|3label-de = Quelle
|3type=string/line
|3def=[[com:SDC|SDC]]'s {{P|P7482}},<br/>{{tl|Source missing}}
|4=author
|4aliases = Author
|4d-en = Original author<ref>Author should be a link, but without the link to a user talk space</ref> of the file; where appropriate, use {{tld|Creator|Name Surname}}.  If the work is derived from or depicts works by someone other than the author, the author of the original work should also be mentioned. For example, for a photograph of a sculpture, make a mention of both the sculptor and the photographer; for vectorizing, use the template {{tl|AutVec}}. This field should ''not be used'' to specify the name of the person who is the scanner, finder, or uploader of the image – these things do not make that person the author.
An alternative to using this field is to use [[com:SDC|SDC]]'s {{P|P170}} property. See [[Commons:Structured data/Modeling/Author]] for supported formats.
|4d-td-en = Original author of the file; where appropriate, use {{Creator|Name Surname}}.
|4stat=required
|4label-en = Author
|4label-de = Autor/Urheber
|4type=string/line
|4def=[[com:SDC|SDC]]'s {{P|P170}},<br/>{{tl|Author missing}}
|5=permission
|5aliases = Permission
|5d-en = {{Anchor|permission}}License and other usage limitations and warnings. Due to the size of many license templates, they are often placed in a separate section below {{tl|information}} template, e.g. the <code><nowiki>== {{int:license-header}} ==</nowiki></code>. In such a case, '''please ''<u>leave this field blank</u>'''''!<br />The license is related primarily to the file itself. If need to state a license of the depicted (or other source) work, include it additionally with appropriate comment. If needed, use relevant [[:Category:FoP templates|FoP templates]]. You can use {{tl|Artwork}} instead of {{tl|Information}} for simple copies of artworks.
|5d-td-en = License and other usage limitations and warnings.
|5stat=optional
|5label-en = Permission
|5label-de = Genehmigung
|5type=string
|5def=
|6=other versions
|6aliases = Other versions/other_versions/Other_versions
|6d-en = Links to files with very similar content or derived files; use thumbnails with {{tl|F}} or {{W|Wikipedia:Gallery tag|gallery tag}}s, e.g. {{tl|G}}.
If&nbsp;appropriate, {{tl|Derivative versions}} is useful.  See also: {{C|Other versions templates}}.
|6d-td-en = Links to files with very similar content or derived files.
|6stat=optional-
|6label-en = Other versions
|6label-de = Andere Versionen
|6type=string
|6def=
|7=other fields
|7aliases = Other fields/other_fields/Other_fields
|7d-en = Additional table fields added on the bottom of the template. You have to use {{tl|Information field}}/{{tl|InFi}} <small>or a specialized template, such as {{tl|Credit line}}, {{tl|Image generation}}, {{tl|Taken with ...}}, {{tl|Created with code}},
{{tl|Tincture}}, or {{tl|Tbc}} to populate this field.</small>
|7d-td-en = Additional table fields added on the bottom of the template.
|7label-en = Other fields
|7label-de = Andere Felder
|7type=string
|7stat=optional-
|7def=
|8=other fields 1
|8aliases = Other fields 1/other_fields_1/Other_fields_1
|8d-en = Additional table fields added between ''Description'' and ''Date'' rows. You have to use {{tl|Information field}}/{{tl|InFi}} <small>or a specialized template e.g. {{tl|Credit line}}, {{tl|Image generation}}, {{tl|Taken with ...}}, {{Tl|Created with code}},
{{tl|Tincture}}, {{tl|Tbc}} to populate this field.</small>
|8d-td-en = Additional table fields added between Description and Date rows.
|8stat=optional-
|8label-en = Other fields 1
|8label-de = Andere Felder 1
|8type=string
|8def=
|usage-notes=
|type=marker
|example=
|i18n-method=mediawiki-msg
|i18n-desc=
|seealso=
|setscats=[[:Category:Author matching Creator template, Creator template not used]] when appropriate
|relieson=[[Template:ISOdate]], [[Template:Parse source]], [[Module:TemplatePar]]
References: <references/>
|print=infobox
|shorthand=
}}
== TemplateData ==
<templatedata>
<templatedata>
{
{
"description": {
"description": "A template for showing data on files",
"en": "This template is used to provide formatting to the basic information for files (description, source, author, etc.). For a full usage description of the template, see Commons:First steps/Quality and description.",
"fr": "Ce modèle permet de fournir les informations de base spécifique aux fichiers (description, auteur, source etc.). Pour une aide détaillée, se rendre sur la page Commons:First_steps/Quality_and_description/fr"
},
"format": "{{_\n| ______________ = _\n}}\n",
"params": {
"params": {
"description": {
"Description": {
"aliases": [
"label": "Description",
"Description"
"description": "A description of the file",
],
"type": "string",
"label": {
"suggested": true
"en": "Description",
},
"fr": "Description"
"Source": {
},
"label": "Source",
"description": {
"description": "Where the file is from",
"en": "Description of the image or media file, including subject and location",
"fr": "Description du fichier, notamment le/les sujet(s) exposé(s) et l'emplacement."
},
"example": "Photo of a penguin in Antarctica",
"type": "string",
"type": "string",
"default": "{{description missing}}",
"suggested": true
"required": true
},
},
"date": {
"Date": {
"aliases": [
"label": "Date",
"Date"
"description": "File creation date",
],
"type": "date",
"label": {
"suggested": true
"en": "Date of creation",
"fr": "Date de création"
},
"description": {
"en": "When the original source was created",
"fr": "Date où le fichier fut créé, par exemple quand la photo a été prise."
},
"example": "2001-12-31",
"suggested": true,
"type": "date"
},
},
"source": {
"Author": {
"aliases": [
"label": "Author",
"Source"
"description": "Who made the file",
],
"label": {
"en": "Source",
"fr": "Source"
},
"description": {
"en": "Where the file is from. Your own files should be tagged with {{own}}.",
"fr": "Endroit d'où provient le fichier. Si vous l'avez vous-même créé (travail personnel), utilisez {{own}}."
},
"default": "{{source missing}}",
"required": true,
"type": "string"
"type": "string"
},
},
"author": {
"Permission": {
"aliases": [
"label": "Permission",
"Author"
"description": "Custom reuse information"
],
"label": {
"en": "Author",
"fr": "Auteur"
},
"description": {
"en": "Original author of the file; where appropriate, use {{Creator:Name Surname}}.",
"fr": "Personne ou institution à l'origine du fichier."
},
"default": "{{author missing}}",
"required": true,
"type": "line"
},
"permission": {
"aliases": [
"Permission"
],
"label": {
"en": "Permission",
"fr": "Permission"
},
"description": {
"en": "License and other usage limitations and warnings",
"fr": "Licence et autres restrictions d'utilisation. Utilisez les modèles appropriés."
},
"type": "content"
},
"other versions": {
"aliases": [
"other_versions"
],
"label": {
"en": "Other versions",
"fr": "Autre version du fichier"
},
"description": "Links to files with very similar content or derived files",
"type": "wiki-file-name"
},
"other fields": {
"aliases": [
"other_fields",
"Other_fields",
"Other fields"
],
"label": {
"en": "Other fields",
"fr": "Autre commentaire"
},
"description": "Additional table fields added on the bottom of the template",
"type": "wiki-file-name"
},
"other fields 1": {
"aliases": [
"other_fields_1",
"Other_fields_1",
"Other fields 1"
],
"label": {
"en": "Other fields 1"
},
"description": "Additional table fields added between Description and Date rows",
"type": "wiki-file-name"
}
}
},
}
"paramOrder": [
"description",
"date",
"source",
"author",
"permission",
"other versions",
"other fields",
"other fields 1"
]
}
}
</templatedata>
</templatedata>
== Example usage ==
=== Example for photograph ===
For example the source code of the description of photograph [[:File:Piers Sellers spacewalk.jpg]] is:
{{pre2|scroll|<nowiki>
{{Information
|Description=
{{de|Astronaut [[:de:Piers John Sellers|Piers Sellers]] bei einem Außenbordeinsatz während der Space-Shuttle-Mission [[:de:STS-121|STS-121]], bei dem er Reparaturtechniken für den Hitzeschutzschild der Raumfähre testet. Der Außenbordeinsatz dauerte 7 Stunden und 11 Minuten.}}
{{en|Astronaut [[w:Piers Sellers|Piers Sellers]] during the third spacewalk of STS-121, a demonstration of orbiter heat shield repair techniques.}}
{{fr|L'astronaute [[:fr:Piers Sellers|Piers Sellers]] durant sa troisième sortie dans l'espace au cours du vol STS-121, une démonstration des techniques de réparation du bouclier thermique.}}
{{it|L'astronauta [[:it:Piers Sellers|]] durante la terza camminata nello spazio nel corso della missione STS-121 mentre esegue un test di riparazione delle mattonelle rinforzate carbonio-carbonio dello Shuttle.}}
{{nds|De Astronaut [[Piers Sellers]] de drüdde Kehr, dat he mit’n Ruumantog in’n apen Weltruum togang weer. Sellers wiest Reparaturtechniken för den Hittschild von’n Orbiter.}}
{{ru|Астронавт [[:ru:Селлерс, Пирс Джон|Пирс Селлерс]] во время третьего выхода в открытый космос (STS-121) при ремонте орбитального теплового экрана.}}
{{fi|Astronautti [[:fi:Piers Sellers|Piers Sellers]] avaruussukkulalento STS-121:n kolmannella avaruuskävelyllä. Avaruuskävelyn tehtävänä oli kokeilla sukkulan lämpökilven korjaustekniikoita.}}
|Date=2006-07-12
|Source=[http://www.nasa.gov/news/highlights/index.html NASA News & Events] – http://www.nasa.gov/externalflash/121_gallery/hi-resjpgs/14.jpg, from http://www.nasa.gov/externalflash/121_gallery/index_noaccess.html
|Author=NASA, astronaut [[w:Michael E. Fossum|Michael Edward Fossum]]
|Permission=
|Other versions=
}}
</nowiki>}}
The code hereinbefore produces the following information table:
{{Information
|Description=
{{de|Astronaut [[:de:Piers John Sellers|Piers Sellers]] bei einem Außenbordeinsatz während der Space-Shuttle-Mission [[:de:STS-121|STS-121]], bei dem er Reparaturtechniken für den Hitzeschutzschild der Raumfähre testet. Der Außenbordeinsatz dauerte 7 Stunden und 11 Minuten.}}
{{en|Astronaut [[w:Piers Sellers|Piers Sellers]] during the third spacewalk of STS-121, a demonstration of orbiter heat shield repair techniques.}}
{{fr|L'astronaute [[:fr:Piers Sellers|Piers Sellers]] durant sa troisième sortie dans l'espace au cours du vol STS-121, une démonstration des techniques de réparation du bouclier thermique.}}
{{it|L'astronauta [[:it:Piers Sellers|Piers Sellers]] durante la terza camminata nello spazio nel corso della missione STS-121 mentre esegue un test di riparazione delle mattonelle rinforzate carbonio-carbonio dello Shuttle.}}
{{nds|De Astronaut [[Piers Sellers]] de drüdde Kehr, dat he mit’n Ruumantog in’n apen Weltruum togang weer. Sellers wiest Reparaturtechniken för den Hittschild von’n Orbiter.}}
{{ru|Астронавт [[:ru:Селлерс, Пирс Джон|Пирс Селлерс]] во время третьего выхода в открытый космос (STS-121) при ремонте орбитального теплового экрана.}}
{{fi|Astronautti [[:fi:Piers Sellers|Piers Sellers]] avaruussukkulalento STS-121:n kolmannella avaruuskävelyllä. Avaruuskävelyn tehtävänä oli kokeilla sukkulan lämpökilven korjaustekniikoita.}}
|Date=2006-07-12
|Source=[http://www.nasa.gov/news/highlights/index.html NASA News & Events] – http://www.nasa.gov/externalflash/121_gallery/hi-resjpgs/14.jpg, from http://www.nasa.gov/externalflash/121_gallery/index_noaccess.html
|Author=NASA, astronaut [[w:Michael E. Fossum|Michael Edward Fossum]]
|Permission=
|Other versions=
}}
=== Example other_fields ===
Example using the ''other fields'' parameter to display a [[Commons:Credit line|credit line]]:
<pre>
{{Information
| Description  = Description
| Date        = 2008-06-09
| Source      = {{own}}
| Author      = John Doe
| Other fields = {{Credit line |Author = © John Doe | Other = Wikimedia Commons |License = CC-BY-3.0 & GFDL}}
}}
</pre>
will produce:
{{Information
| Description  = Description
| Date        = 2008-06-09
| Source      = {{own}}
| Author      = John Doe
| Other fields = {{Credit line |Author = © John Doe | Other = Wikimedia Commons |License = CC-BY-3.0 & GFDL}}
}}
=== Recommendations ===
For many media it is desirable to use a [[:Category:Geocoding templates|geocoding template]] in addition to the Information template.
== Microformat ==
This template also emits an [[W:HCalendar|hCalendar]] [[W:microformat|microformat]] marking the creation of the image as an event. To do this, it requires the {{tl|Date}} template, and takes the file name as the "summary" property. Optionally, it can include the {{tl|Creator}} as an attendee and an [[w:HCard|hCard]] microformat, and use the contents of {{tl|Description}} as the hCalendar's "description" property. Coordinates may be included by use of {{tl|Location}} or {{tl|Object location}}.
See also [[Commons:Machine-readable data]].
== See also ==
* [[Commons:Infobox templates]]; for a more complete overview of provided templates see the [[:Category:Infobox templates]]
* {{tl|Artwork}} for specialized infobox template used for artworks
* {{tl|Book}} for specialized infobox template used for book page scans
* {{tl|Information field}} and {{tl|Credit line}}
* {{tl|Translation table}} and {{tl|mld}} for category descriptions
* {{tl|Photograph}} for photographs held by museums, archives, and other GLAM institutions
* {{tl|Art photo}} for photographs of artworks with more fields for photographer metadata
* {{tl|Map}} for maps
* {{tl|Musical work}} for music files
<noinclude>
[[Category:Infobox templates: based on Information template]]
</noinclude><includeonly>
{{DEFAULTSORT:Information}}
[[Category:Infobox templates]]
[[Category:License-related tags|*]]
[[Category:Templates generating hCalendars]]
[[Category:Structured Data on Commons templates]]
</includeonly>

Revision as of 19:39, 4 December 2021

Usage

A template for showing data on files

Template parameters

ParameterDescriptionTypeStatus
DescriptionDescription

A description of the file

Stringsuggested
SourceSource

Where the file is from

Stringsuggested
DateDate

File creation date

Datesuggested
AuthorAuthor

Who made the file

Stringoptional
PermissionPermission

Custom reuse information

Unknownoptional