Template:File/doc

Revision as of 15:38, 29 August 2025 by Raven.Familiar (talk | contribs) (Created page with "{{Documentation/Header}} Template to make it easier to fill files with categories, sources and characters. ==Syntax== {{T|File |p1 =categories = |p2 =featuring = |p3 =characters = |p4 =soundtracks = |p5 =caption = |p6 =sourcelink1 = |p7 =sourcelabel1 = |p8 =sourcelink2 = |p9 =sourcelabel2 = |p10=sourcelink3 = |p11=sourcelabel3 = |p12=artistlink = |p13=artist = |p14=lang = |p15=date = |p16=gallery...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
This is the documentation page for File.
It contains usage information, categories, and other content not part of the original template page.

Template to make it easier to fill files with categories, sources and characters.

Syntax

{{File
|categories    =
|featuring     =
|characters    =
|soundtracks   =
|caption       =
|sourcelink1   =
|sourcelabel1  =
|sourcelink2   =
|sourcelabel2  =
|sourcelink3   =
|sourcelabel3  =
|artistlink    =
|artist        =
|lang          =
|date          =
|gallery       =
|description   =
|transcription =
|alt           =
|annotations   =
}}

  • featuring — To be used only on videos distinctly about a character. A colon-separated list of page names for things featured in a video, which will appear as a sentence underneath the video thumbnail in {{Videos by Category Table}}. If character pages are added here, this does not replace their mention in characters, which should list them all the same.
    • If manual phrasing and linking is preferred, for cases where everything might not have a page, append _ManualPhrasing: in front of the content.
    • Usage of this param is not generalized as the focus of many media types can be unclear. Additions to the list must first be discussed with other editors.
  • characters — An exhaustive colon-separated list of characters seen or heard in the file.
  • soundtracks — A colon-separated list of soundtracks featured in a video, in order of appearance. Displays the list as links and adds categories accordingly, to be detected and/or displayed by {{Videos by Category Table}}, {{Files by Category Gallery}} and {{Soundtrack Usage}}. Special keywords are to be used for unreleased soundtracks:
    • _unreleased if the soundtrack is unreleased and its name is unknown.
    • _variant if the soundtrack is an unreleased arrangement of a released soundtrack, such as a concert version, a remix or a variant with additional instruments. The related soundtrack's name is to be specified after a space after using this keyword, for example _variant Her Legacy.
  • sources — The first source will be displayed in pages using {{Phantom File Gallery}}, while any subsequent sources after that will only be visible on the file's page.
    • The sources are formatted using numbered sourcelink and sourcelabel parameters.
    • The labels should be formatted as such: Official Honkai: Nexus Anima Twitter, Official HoYoLAB Post, Official Honkai: Nexus Anima Japanese Twitter, etc.
  • date — The date refers to the date of publication or release. It is used to sort the file within Category:Files by Date as well as assign a relevant year's category.
  • artist — This should link to the artist's social media.
    • {{File|lang = language code}} can be used to specify the language of the text.
    • Adding the name of the artist without adding an artistlink will place the file in Category:Files Missing Artist Link so that it can be researched later.
  • caption — This text will replace the default caption (which is based on the file name) which would appear in pages using {{Phantom File Gallery}}. The template {{No Selflink}} can be used to create elegant captions that look good in multiple galleries across the site.
  • description — The description of the file will not be placed within the table. This should reflect the official description from when the file was posted on Honkai: Nexus Anima media and can be displayed on pages with {{Artwork by Category Table}}. {{Lang|vertical = 1}} can be used to add descriptions from other languages. For YouTube videos, should contain only the actual description and featured VAs and characters lists, but should omit the list of Honkai: Nexus Anima social media appended on every video upload.
  • alt — See WebAIM for a guide to writing alt text.
  • annotations — Transcludes the page with the identical name (without .png extension) from the Map namespace under a Translated Annotations section when set to 1.

Examples

{{File
|categories = Character Splash Art
|characters = Kiana
|date       = 2025-08-29
}}

yields:

Category
Character
DateAugust 29, 2025 (Before the game's release)

Template Data

Template to make it easier to fill files with categories, sources and characters.

Template parameters

This template has custom formatting.

ParameterDescriptionTypeStatus
Categorycategories 1

List of categories separated by ;

Stringrequired
Characterscharacters

List of characters separated by ;

Stringsuggested
Soundtrackssoundtracks

For videos, a colon-separated list of the soundtracks used, in featuring order.

Example
La vaguelette;_unknown;_variant Jolts in the Forest
Stringoptional
Source Link 1sourcelink1 sourcelink slink slink1

no description

URLsuggested
Source Label 1sourcelabel1 sourcelabel slabel slabel1

Label for Source Link 1

Default
Source
Example
Official Honkai: Nexus Anima Twitter
Stringsuggested
Source Link 2sourcelink2 slink2

no description

URLoptional
Source Label 2sourcelabel2 slabel2

Label for Source Link 2

Stringoptional
Source Link 3sourcelink3 slink3

no description

URLoptional
Source Label 3sourcelabel3 slabel3

Label for Source Link 3

Stringoptional
Artist Linkartistlink

Link to the artist's page.

URLsuggested
Artistartist

Name of the artist.

Stringsuggested
Artist's Name languagelang

Applies "lang" in the cell for the name of the artist.

Default
en
Example
zh
Stringsuggested
Datedate

use format YYYY-MM-DD. Allows sorting by date. Refers to the publishing date (in case of images from social media) or release date (in case of assets of characters or npcs).

Datesuggested
Gallerygallery

Name(s) of page galleries which the file should be included in.

Example
Prince
Stringsuggested
Captioncaption

Caption of file to describe the file.

Stringsuggested
Descriptiondescription

Transcribed description from original source.

Stringoptional
transcriptiontranscription

Transcript of text in file, where applicable/not already given.

Stringoptional
altalt

Alt text for accessibility.

Stringoptional
Versionversion

Alternative to the date parameter for when the date is on a Version's release

Example
3.4
Stringoptional
Annotationsannotations

Transcludes the page with the identical name (without .png extension) from the Map namespace under a Translated Annotations section when set to 1.

Booleanoptional