FANDOM


m (It would make more sense to refer to the article subject as "file description page"; links, formatting; what is a <longdesc> tag?)
 
(17 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[File:FileDescriptionPage.png|thumb|right|300px|An image description page.]]
+
[[File:FileDescriptionPage.png|thumb|right|300px|A file description page.]]
Each [[Help:Uploading files|uploaded file]] has an associated '''file description page''' which gives information about the source, licensing and technical details of the file.
+
When you [[help:Uploading files|upload a file]], it is placed on the server and a '''file description page''' is created. It is intended to provide information such as:
   
== What are the parts of the page? ==
+
* The description of the file and any other information relevant to the file, such as transcripts of its contents, intended usage, etc.
The description page consists of four parts:
+
* The origin of the file (author and source)
# The image itself, or a link to a non-image file
+
* [[Help:Licensing|Licensing]]
#* The description page shows either the full-size image, or a reduced-size version with a link to the full version labeled "Full resolution".
+
* [[Help:Category|Categorization]]
#* Displayed images can be slightly different to the original upload, as images are automatically optimised for use on the web. A "download" link is available to obtain the original file.
+
* Additional technical information, such as other versions of the file
  +
  +
Note that files aren't limited to just images: Sound clips, videos, fonts, PDF documents and other file types that can be uploaded to the wiki all have description pages associated with them.
  +
  +
:''All files are placed in the '''''File:''''' [[Help:Namespace|namespace]]. Other terms include '''''namespace 6 page''''' or the deprecated '''''image description page'''''.''
  +
  +
== How do file description pages work? ==
  +
{{TOCright}}The description page consists of four parts:
  +
# The file itself (if it can be previewed, like image files) or a link to it (for eg. PDF documents)
  +
#* When the file is an '''image''', the description page will display it in its base resolution (if smaller than 1024px) or as a thumbnail 1024px wide (larger images). In the latter case, links to other sizes and the full resolution will be displayed below.
  +
#* If a thumbnail is generated, the image might be subtly different, as thumbnails are generated by MediaWiki and optimized for the web.
 
# An "About" tab that contains:
 
# An "About" tab that contains:
#* a description of the image/sound, which you can add or edit by editing the image page
+
#* An editable description of the file (see below for details)
#* a list of pages on which the image appears (not including pages that simply ''link'' to the image page)
+
#* A list of pages on which the file '''appears'''. This list only includes pages where the image is displayed. It does not include ''links'' to the file description page, or direct links to the file from CSS, JavaScript, or [[Special:ThemeDesigner]].
 
# A "File History" tab that contains:
 
# A "File History" tab that contains:
#* The history of uploads for that image (see also [[Help:Page history|page history]])
+
#* The history of uploads for that file, which also allows for reverting to earlier versions
#* A link to upload a new version of that image
+
#* A link to upload a new version of that file
# A "Metadata" tab, when metadata of the image is available.
+
# A "Metadata" tab, if additonal metadata of the file is available.
   
== How do I update the page? ==
+
== How do you link to a file without displaying it? ==
The description text under the "About" tab can be edited like normal article text - by clicking the "Edit" button. This will also allow you to categorize the image.
+
File description pages have another useful purpose beyond information: You can use a leading colon in the link to the description page to create a link instead of displaying the image.
  +
:''For example: <code><nowiki>[[:File:Flower.png]]</nowiki></code> or <code><nowiki>[[:File:Rainbow.jpg]]</nowiki></code>.''
   
The image itself can be updated by uploading a new image with the same name via upload tools, or by using the "Upload a new version of this file" link at the bottom of the "File history" tab.
+
If you want to [[Help:Links|pipe trick]] the namespace name away, you can just do this: <code><nowiki>[[:File:Flower.png|]]</nowiki></code>, which results in [[:file:Flower.png|Flower.png]]. Pipe tricking can be very useful in discussions about a file, in case your community is divided about which file to use in a certain situation.
  +
==How to replace a file?==
  +
{{main|Help:Uploading files}}
  +
The image itself can be updated by uploading a new image with the same name via upload tools, or by using the "Upload a new version of this file" link at the bottom of the "File history" tab.
   
== What information should be placed on the "About" tab? ==
+
== How to edit a file description? ==
This area allows normal article [[Help:Wikitext|wikitext]]. Initially the description automatically contains the [[Help:Edit summary|upload summary]] supplied by the user when uploading the first version (this text also shows up in the "File history" section in the "Comment" column).
+
The description visible through the "About" tab can be edited like normal article text by clicking the "Edit" button.
  +
  +
This area allows normal article [[Help:Wikitext|wikitext]]. The initial description is updated with the contents of the [[Help:Edit summary|upload summary]] supplied by the user when uploading the first version. This text also shows up in the "File history" section in the "Comment" column.
   
 
=== Description of the image ===
 
=== Description of the image ===
Example: "Image of a goldfish in a small tank". This is useful for users who do not have direct access to the image.
+
You may wish to describe the image, providing a short summary of its contents or intended use. This is useful for users who do not have direct access to the image or use screen readers.
  +
  +
:''For example, "Image of a goldfish in a small tank".''
   
 
=== Author and source information ===
 
=== Author and source information ===
Always provide as much information as you can about the creator of the image, and where you got the image (i.e. a website, scanned from a book, took a photo yourself).
+
[[File:FileAboutTab.png|thumb|right|300px|An example of reasonable sourcing and licensing information in an "About" tab]]
  +
Wikis are a community effort and crediting creators of files uploaded to wikis is a big part of that. It's good practice to provide general information about the author and source when uploading, both to keep track of sources used on the wiki and to allow verification and updating of files when possible.
   
If the image is licensed under a CC-BY license (or most similar licenses) it must be attributed to the copyright holder (usually the photographer).  If this is not done, your upload violates the terms of the license, and is a copyright violation.
+
If the image is licensed under a Creative Commons Attribution license (CC-BY) or similar, attributing the copyright holder is mandatory to avoid violating the terms of the license and causing a copyright violation.
   
Even if the image is public domain or is under a license that doesn't require attribution, please provide source information anyway to make verification easy. Remember that your community might be around for ten, twenty, or a hundred years, and later readers or editors may have different needs for verifying the source of an image.
+
Note that even if the image is public domain or under a license that doesn't require attribution, including sources is simply good practice: Your wiki might be around for ten, twenty, or a hundred years, and subsequent readers or editors may find this information useful to verify, expand, or improve upon the wiki.
   
 
=== Licensing information ===
 
=== Licensing information ===
Please include an [[Help:Image copyright tags|image copyright tag]], either by typing the correct template (such as <code><nowiki>{{Fairuse}}</nowiki></code> by hand, or choosing from a license selector dropdown, if available on your wiki.
+
All files should be provided with a [[Help:Image copyright tags|file copyright tag]] to establish its license.
   
If applicable, provide a link to documentation of the licensing terms (i.e. a "Terms of use" or "About" page for the website where you got the image).
+
You can do this by:
  +
* Adding the correct template (such as <code><nowiki>{{Fairuse}}</nowiki></code> by hand.
  +
* Choosing from a license selector dropdown at the time you upload the file.
  +
  +
If applicable, provide a link to documentation of the licensing terms (i.e. a "Terms of use" or "About" page for the website where you got the file).
  +
  +
===Categorization===
  +
By adding a [[Help:Category|category]] tag on the file page, files can be in the same category as other pages, but they are not included in the count of articles in the category, and are displayed in a separate section, with a thumbnail and the name for each.
  +
  +
The [[Special:Upload|upload form]] starts with a blank field blank for introducing an "upload summary", you can place categories here, and thereby apply a category to an image without editing the file description page later. You can also add categorization code to your [[Help:Image copyright tags|file copyright tags]], allowing you to automatically apply categories just because you've used a certain copyright tag.
  +
  +
:''Remember: Categorization works the same way for articles and file description pages.''
   
 
=== Other versions ===
 
=== Other versions ===
Line 43: Line 43:
 
* ''<nowiki>[[File:Goldfish-in-tank2.jpg|different camera angle]] ([[:File:Goldfish-in-tank2.jpg|info]])</nowiki>''
 
* ''<nowiki>[[File:Goldfish-in-tank2.jpg|different camera angle]] ([[:File:Goldfish-in-tank2.jpg|info]])</nowiki>''
 
* ''<nowiki>[[File:Goldfish-in-tank-textfree.jpg|text-free version]] ([[:File:Goldfish-in-tank-textfree.jpg|info]])</nowiki>''
 
* ''<nowiki>[[File:Goldfish-in-tank-textfree.jpg|text-free version]] ([[:File:Goldfish-in-tank-textfree.jpg|info]])</nowiki>''
Text-free versions may be useful for using across different languages.
+
Text-free versions may be useful when using the same image in different languages.
   
== Can I categorize images? ==
+
== Is it possible to prevent editing a file? ==
By adding a [[Help:Category|category]] tag on the image page, images can be in the same category as other pages, but are treated a little differently: they are not included in the count of articles in the category, and they are displayed in a separate section, with a thumbnail and the name for each.
+
[[Help:User rights#Administrators|Administrators]] and [[Help:User rights#Content Moderators|content moderators]] can [[Help:Page protection|protect]] a file description page, which automatically protects the file itself, preventing users without specified rights from re-uploading that file or uploading an file of the same name.
   
A category can either mix articles and images about a subject, or you can create separate image categories. An image category is typically a subcategory of the general category about the same subject, and a subcategory of a wider image category.
+
Use this ability sparingly. In general, files should only be protected if they're the subject of an edit war (for instance, multiple different versions are uploaded in a short span of time) or used widely across the wiki and uploading new versions without due consideration might adversely affect the wiki's functionality. Locking ''every'' file on a wiki should never be done.
 
For categorizing a brand new image, the image page does not even have to be edited: the category code can be included in the upload summary.
 
 
== Can images be protected? ==
 
[[Help:User rights#Administrators|Administrators]] and [[Help:User rights#Content Moderators|content moderators]] can [[Help:Page protection|protect]] an image description page, which automatically protects the image itself, preventing users without specified rights from reuploading that image or uploading an image of the same name.
 
 
== How do I link to an image page without displaying the image? ==
 
To make a link to the image description page of an image without including the actual image, use a leading colon in the link, like: <code><nowiki>[[:File:Image.png]]</nowiki></code> or <code><nowiki>[[:File:Image.jpg]]</nowiki></code>. The colon prevents the image being embedded in the article, and instead makes an ordinary internal link.
 
   
 
== See also ==
 
== See also ==
* Learn about [[Help:Uploading files|uploading files]]
+
* [[Help:Uploading files|Uploading files]]
* Learn about [[Help:Image copyright tags|image copyright tags]]
+
* [[Help:Image copyright tags|Image copyright tags]]
   
 
== Further help and feedback ==
 
== Further help and feedback ==
{{Help and feedback section}}
+
{{Help and feedback section}}[[de:Hilfe:Dateibeschreibungsseite]]
 
[[de:Hilfe:Dateibeschreibungsseite]]
 
 
[[es:Ayuda:Página de descripción de imagen]]
 
[[es:Ayuda:Página de descripción de imagen]]
 
[[fi:Ohje:Tiedoston kuvaussivu]]
 
[[fi:Ohje:Tiedoston kuvaussivu]]
Line 64: Line 64:
 
[[pt:Ajuda:Página de descrição de imagem]]
 
[[pt:Ajuda:Página de descrição de imagem]]
 
[[ru:Справка:Описание изображения]]
 
[[ru:Справка:Описание изображения]]
  +
[[tr:Yardım:Dosya açıklama sayfası]]
  +
[[vi:Trợ giúp:Trang mô tả ảnh]]
 
[[zh:Help:圖像描述頁]]
 
[[zh:Help:圖像描述頁]]
 
[[Category:Help]]
 
[[Category:Help]]

Latest revision as of 11:31, September 17, 2020

FileDescriptionPage

A file description page.

When you upload a file, it is placed on the server and a file description page is created. It is intended to provide information such as:

  • The description of the file and any other information relevant to the file, such as transcripts of its contents, intended usage, etc.
  • The origin of the file (author and source)
  • Licensing
  • Categorization
  • Additional technical information, such as other versions of the file

Note that files aren't limited to just images: Sound clips, videos, fonts, PDF documents and other file types that can be uploaded to the wiki all have description pages associated with them.

All files are placed in the File: namespace. Other terms include namespace 6 page or the deprecated image description page.

How do file description pages work? Edit

The description page consists of four parts:
  1. The file itself (if it can be previewed, like image files) or a link to it (for eg. PDF documents)
    • When the file is an image, the description page will display it in its base resolution (if smaller than 1024px) or as a thumbnail 1024px wide (larger images). In the latter case, links to other sizes and the full resolution will be displayed below.
    • If a thumbnail is generated, the image might be subtly different, as thumbnails are generated by MediaWiki and optimized for the web.
  2. An "About" tab that contains:
    • An editable description of the file (see below for details)
    • A list of pages on which the file appears. This list only includes pages where the image is displayed. It does not include links to the file description page, or direct links to the file from CSS, JavaScript, or Special:ThemeDesigner.
  3. A "File History" tab that contains:
    • The history of uploads for that file, which also allows for reverting to earlier versions
    • A link to upload a new version of that file
  4. A "Metadata" tab, if additonal metadata of the file is available.

How do you link to a file without displaying it? Edit

File description pages have another useful purpose beyond information: You can use a leading colon in the link to the description page to create a link instead of displaying the image.

For example: [[:File:Flower.png]] or [[:File:Rainbow.jpg]].

If you want to pipe trick the namespace name away, you can just do this: [[:File:Flower.png|]], which results in Flower.png. Pipe tricking can be very useful in discussions about a file, in case your community is divided about which file to use in a certain situation.

How to replace a file?Edit

Welcome to Community Central.
We are currently editing over 27,146 articles, and you can help

About this wiki | New pages | Categories | Wiki tutorial | Help pages

Community Central Edit

You can add a description of this wiki here.

To write a new Community Central article, enter the page title in the box below.

Articles Edit

"add yours"
  • Example


The image itself can be updated by uploading a new image with the same name via upload tools, or by using the "Upload a new version of this file" link at the bottom of the "File history" tab.

How to edit a file description? Edit

The description visible through the "About" tab can be edited like normal article text by clicking the "Edit" button.

This area allows normal article wikitext. The initial description is updated with the contents of the upload summary supplied by the user when uploading the first version. This text also shows up in the "File history" section in the "Comment" column.

Description of the image Edit

You may wish to describe the image, providing a short summary of its contents or intended use. This is useful for users who do not have direct access to the image or use screen readers.

For example, "Image of a goldfish in a small tank".

Author and source information Edit

FileAboutTab

An example of reasonable sourcing and licensing information in an "About" tab

Wikis are a community effort and crediting creators of files uploaded to wikis is a big part of that. It's good practice to provide general information about the author and source when uploading, both to keep track of sources used on the wiki and to allow verification and updating of files when possible.

If the image is licensed under a Creative Commons Attribution license (CC-BY) or similar, attributing the copyright holder is mandatory to avoid violating the terms of the license and causing a copyright violation.

Note that even if the image is public domain or under a license that doesn't require attribution, including sources is simply good practice: Your wiki might be around for ten, twenty, or a hundred years, and subsequent readers or editors may find this information useful to verify, expand, or improve upon the wiki.

Licensing information Edit

All files should be provided with a file copyright tag to establish its license.

You can do this by:

  • Adding the correct template (such as {{Fairuse}} by hand.
  • Choosing from a license selector dropdown at the time you upload the file.

If applicable, provide a link to documentation of the licensing terms (i.e. a "Terms of use" or "About" page for the website where you got the file).

CategorizationEdit

By adding a category tag on the file page, files can be in the same category as other pages, but they are not included in the count of articles in the category, and are displayed in a separate section, with a thumbnail and the name for each.

The upload form starts with a blank field blank for introducing an "upload summary", you can place categories here, and thereby apply a category to an image without editing the file description page later. You can also add categorization code to your file copyright tags, allowing you to automatically apply categories just because you've used a certain copyright tag.

Remember: Categorization works the same way for articles and file description pages.

Other versions Edit

If other versions (especially a larger version) of the same image exists, it can be helpful to link to them. For example:

  • [[File:Goldfish-in-tank-large.jpg|larger version]] ([[:File:Goldfish-in-tank-large.jpg|info]])
  • [[File:Goldfish-in-tank2.jpg|different camera angle]] ([[:File:Goldfish-in-tank2.jpg|info]])
  • [[File:Goldfish-in-tank-textfree.jpg|text-free version]] ([[:File:Goldfish-in-tank-textfree.jpg|info]])

Text-free versions may be useful when using the same image in different languages.

Is it possible to prevent editing a file? Edit

Administrators and content moderators can protect a file description page, which automatically protects the file itself, preventing users without specified rights from re-uploading that file or uploading an file of the same name.

Use this ability sparingly. In general, files should only be protected if they're the subject of an edit war (for instance, multiple different versions are uploaded in a short span of time) or used widely across the wiki and uploading new versions without due consideration might adversely affect the wiki's functionality. Locking every file on a wiki should never be done.

See also Edit

Further help and feedback Edit

Community content is available under CC-BY-SA unless otherwise noted.