Help:Contributing/richMediaContent: Difference between revisions

From Wikibase
Jump to navigation Jump to search
← Older editNewer edit →

SeedBot (talk | contribs)

4 user groups
5,323 edits
Rename image section; add Embedding audio + Embedding video with live players; extend accepted formats (via update-page on MediaWiki MCP Server)
Clarify that the upload summary must describe the file content, with avoid/write examples (via update-page on MediaWiki MCP Server)
Line 9: Line 9:
* '''Source file''' — the file on your computer. This wiki accepts <syntaxhighlight lang="text" inline>png</syntaxhighlight>, <syntaxhighlight lang="text" inline>gif</syntaxhighlight>, <syntaxhighlight lang="text" inline>jpg</syntaxhighlight>, <syntaxhighlight lang="text" inline>jpeg</syntaxhighlight> and <syntaxhighlight lang="text" inline>webp</syntaxhighlight> for images, and <syntaxhighlight lang="text" inline>ogg</syntaxhighlight>, <syntaxhighlight lang="text" inline>ogv</syntaxhighlight>, <syntaxhighlight lang="text" inline>oga</syntaxhighlight> and <syntaxhighlight lang="text" inline>webm</syntaxhighlight> for audio and video.
* '''Source file''' — the file on your computer. This wiki accepts <syntaxhighlight lang="text" inline>png</syntaxhighlight>, <syntaxhighlight lang="text" inline>gif</syntaxhighlight>, <syntaxhighlight lang="text" inline>jpg</syntaxhighlight>, <syntaxhighlight lang="text" inline>jpeg</syntaxhighlight> and <syntaxhighlight lang="text" inline>webp</syntaxhighlight> for images, and <syntaxhighlight lang="text" inline>ogg</syntaxhighlight>, <syntaxhighlight lang="text" inline>ogv</syntaxhighlight>, <syntaxhighlight lang="text" inline>oga</syntaxhighlight> and <syntaxhighlight lang="text" inline>webm</syntaxhighlight> for audio and video.
* '''Destination filename''' — the name the file will have here, for example <syntaxhighlight lang="text" inline>Example.png</syntaxhighlight>. Choose a descriptive, unique name.
* '''Destination filename''' — the name the file will have here, for example <syntaxhighlight lang="text" inline>Example.png</syntaxhighlight>. Choose a descriptive, unique name.
* '''Summary''' — what the file shows and where it comes from.
* '''Summary''' — the file description: what the file contains or shows, and where it comes from. This text is what visitors see in [[Special:ListFiles]], so describe the file itself — not where it is used or how it was processed.


The size limit is 1 GiB. The form warns for files larger than 50 MB — the warning does not block the upload.
{| class="wikitable"
 
After uploading, the file lives at a page called <syntaxhighlight lang="text" inline>File:Name.ext</syntaxhighlight>. The page shows the media and its description. To replace a file, use "Upload a new version of this file" on the file page — the history keeps every version.
 
Files larger than roughly 100 MB are slow to upload in one request. Use chunked uploads through the API instead: see the MediaWiki official [https://www.mediawiki.org/wiki/API:Upload API:Upload] documentation.
 
== Embedding an image ==
 
The examples below use [[:File:Example.png|Example.png]], a public-domain NASA photograph of Earth. The '''You get''' column shows each example rendered live. Replace <syntaxhighlight lang="text" inline>Example.png</syntaxhighlight> with your file's name.
 
{| class="wikitable" style="width:100%"
|-
! You type !! What it does !! You get
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png]]</syntaxhighlight>
| Renders the image at full size, inline.
| [[File:Example.png]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png|thumb|Caption text]]</syntaxhighlight>
| A thumbnail floating right, with a caption. The most common choice on content pages.
| [[File:Example.png|thumb|Caption text]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png|300px]]</syntaxhighlight>
| Fixes the width to 300 pixels; the height keeps the proportions.
| [[File:Example.png|300px]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png|thumb|left|Caption text]]</syntaxhighlight>
| Thumbnail floating left. Use <syntaxhighlight lang="text" inline>left</syntaxhighlight>, <syntaxhighlight lang="text" inline>right</syntaxhighlight>, <syntaxhighlight lang="text" inline>center</syntaxhighlight> or <syntaxhighlight lang="text" inline>none</syntaxhighlight>.
| [[File:Example.png|thumb|left|Caption text]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png|alt=The Earth seen from Apollo 17]]</syntaxhighlight>
| Sets the alt text, read by screen readers and shown when the image cannot load. The visible render is unchanged.
| [[File:Example.png|alt=The Earth seen from Apollo 17]]
|-
|-
| <syntaxhighlight lang="text" inline>[[File:Example.png|link=Main Page]]</syntaxhighlight>
! Avoid — where the file is used or what was done to it !! Write this — what the file shows
| Clicking the image opens Main Page instead of the file page. The render looks the same.
| [[File:Example.png|link=Main Page]]
|-
|-
| <syntaxhighlight lang="text" inline>[[:File:Example.png]]</syntaxhighlight>
| "Sample video for Help:Contributing/richMediaContent" || NASA Apollo 11 television footage of Buzz Aldrin descending the lunar module ladder. Public domain (NASA).
| A text link to the file page — the leading colon prevents embedding.
| [[:File:Example.png]]
|-
|-
| <syntaxhighlight lang="text" inline>[[Media:Example.png]]</syntaxhighlight>
| "Resized to 600 × 600 to fit the help page" || Photograph of Earth, the "Blue Marble", taken by the Apollo 17 crew. Public domain (NASA).
| A direct link to the file itself; the reader downloads it instead of seeing it embedded.
| [[Media:Example.png]]
|}
|}


Options are separated by pipes, in any order. Any parameter that is not an option becomes the caption. A red link means the file does not exist — check the spelling or upload the file first.
The summary cannot be edited in place. To correct it, upload a new version of the file (it may be the same file) with the corrected summary. The text on the file page — what visitors see under the media — is separate and can be edited like any page; keep it consistent with the summary.


Add categories at the bottom of the file page, just like on any page.
The size limit is 1 GiB. The form warns for files larger than 50 MB — the warning does not block the upload.


== Embedding audio ==
After uploading, the file lives at a page called <syntaxhighlight lang="text" inline>File:Name.ext</syntaxhighlight>. The page shows the media and its description. To replace a file, use "Upload a new version of this file" on the file page — the history keeps every version.


The examples below use [[:File:Example.ogg|Example.ogg]], a public-domain NASA recording of Apollo 11 launch-day communications. Audio plays in the browser; transcoding for compatibility happens automatically in the background.
Files larger than roughly 100 MB are slow to upload in one request. Use chunked uploads through the API instead: see the MediaWiki official [https://www.mediawiki.org/wiki/API:Upload API:Upload] documentation.
 
{| class="wikitable" style="width:100%"
|-
! You type !! What it does !! You get
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogg]]</syntaxhighlight>
| An inline audio player, with play/pause and a progress bar.
| [[File:Example.ogg]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogg|thumb|Caption text]]</syntaxhighlight>
| The player inside a framed box with a caption.
| [[File:Example.ogg|thumb|Caption text]]
|-
| <syntaxhighlight lang="text" inline>[[Media:Example.ogg]]</syntaxhighlight>
| A text link to the file itself; the reader downloads it instead of playing it inline.
| [[Media:Example.ogg]]
|}
 
Accepted audio formats are <syntaxhighlight lang="text" inline>ogg</syntaxhighlight> and <syntaxhighlight lang="text" inline>oga</syntaxhighlight> (Vorbis or Opus).
 
== Embedding video ==
 
The examples below use [[:File:Example.ogv|Example.ogv]], a public-domain NASA television clip of Buzz Aldrin descending the lunar module ladder. Video plays in the browser; transcoding for compatibility happens automatically in the background.
 
{| class="wikitable" style="width:100%"
|-
! You type !! What it does !! You get
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogv]]</syntaxhighlight>
| An inline video player at the file's native size.
| [[File:Example.ogv]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogv|thumb|Caption text]]</syntaxhighlight>
| A thumbnail-sized player floating right, with a caption.
| [[File:Example.ogv|thumb|Caption text]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogv|300px]]</syntaxhighlight>
| Fixes the width to 300 pixels; the height keeps the proportions.
| [[File:Example.ogv|300px]]
|-
| <syntaxhighlight lang="text" inline>[[File:Example.ogv|start=0:05|end=0:15]]</syntaxhighlight>
| Plays only the given time range, written as minutes:seconds.
| [[File:Example.ogv|start=0:05|end=0:15]]
|-
| <syntaxhighlight lang="text" inline>[[Media:Example.ogv]]</syntaxhighlight>
| A text link to the file itself; the reader downloads it instead of playing it inline.
| [[Media:Example.ogv]]
|}
 
Accepted video formats are <syntaxhighlight lang="text" inline>ogv</syntaxhighlight> and <syntaxhighlight lang="text" inline>webm</syntaxhighlight> (Theora, VP8 or VP9).
 
== Files and entities ==
 
A file is not an entity and has no Q number: it cannot carry statements itself. To attach a file to an item, add a statement on the item with the [[Property:P32|image property (P32)]], whose datatype is Url, and put the file page URL as the value.
 
Example — the item [[Item:Q162|Blue Marble (photograph)]] carries the statement:
 
* <syntaxhighlight lang="text" inline>image</syntaxhighlight> → <syntaxhighlight lang="text" inline>https://wikibase.ronzz.org/wiki/File:Example.png</syntaxhighlight>
 
Open [[Special:EntityPage/Q162]] to see it live: the statement links to the file page, and the file page renders the image. Because the value is a plain URL, the same property works for any file you can link to — an upload on this wiki, a picture hosted elsewhere, or a file on Wikimedia Commons.
 
The statement workflow is the usual one: [[Help:Contributing/entities|Items and properties]].
 
== See also ==
 
* [https://www.mediawiki.org/wiki/Help:Images Help:Images] (MediaWiki official) — the complete image syntax reference
* [https://www.mediawiki.org/wiki/Help:Linking_to_files Help:Linking to files] (MediaWiki official) — linking and download behavior
* [https://www.mediawiki.org/wiki/Help:Extension:TimedMediaHandler Help:Extension:TimedMediaHandler] (MediaWiki official) — audio and video embedding reference
* [https://www.mediawiki.org/wiki/API:Upload API:Upload] (MediaWiki official) — uploads, including chunked uploads
* [[Help:Contributing]] — the contributor hub

Revision as of 16:07, 19 August 2026

Languages: English · français · Esperanto

Files on this wiki are classic wiki pages in the File: namespace, not Wikibase entities. The media workflow has two steps: upload the file, then embed it in a page.

Uploading a file

You must be logged in — anonymous visitors are read-only. Open Special:Upload, or use the "Upload file" link in the toolbox on the left.

The form asks for three things:

  • Source file — the file on your computer. This wiki accepts png, gif, jpg, jpeg and webp for images, and ogg, ogv, oga and webm for audio and video.
  • Destination filename — the name the file will have here, for example Example.png. Choose a descriptive, unique name.
  • Summary — the file description: what the file contains or shows, and where it comes from. This text is what visitors see in Special:ListFiles, so describe the file itself — not where it is used or how it was processed.
Avoid — where the file is used or what was done to it Write this — what the file shows
"Sample video for Help:Contributing/richMediaContent" NASA Apollo 11 television footage of Buzz Aldrin descending the lunar module ladder. Public domain (NASA).
"Resized to 600 × 600 to fit the help page" Photograph of Earth, the "Blue Marble", taken by the Apollo 17 crew. Public domain (NASA).

The summary cannot be edited in place. To correct it, upload a new version of the file (it may be the same file) with the corrected summary. The text on the file page — what visitors see under the media — is separate and can be edited like any page; keep it consistent with the summary.

The size limit is 1 GiB. The form warns for files larger than 50 MB — the warning does not block the upload.

After uploading, the file lives at a page called File:Name.ext. The page shows the media and its description. To replace a file, use "Upload a new version of this file" on the file page — the history keeps every version.

Files larger than roughly 100 MB are slow to upload in one request. Use chunked uploads through the API instead: see the MediaWiki official API:Upload documentation.

Retrieved from "https://wikibase.ronzz.org/index.php?title=Help:Contributing/richMediaContent&oldid=781"