Mngr: Mngr moved page ICT:FinalConfig - Template Asset Presentation to ICT:Documentation:Template Asset Presentation without leaving a redirect

2026-02-20T13:19:29Z

Mngr moved page ICT:FinalConfig - Template Asset Presentation to ICT:Documentation:Template Asset Presentation without leaving a redirect

← Older revision	Revision as of 13:19, 20 February 2026
(No difference)

Mngr: Created page with "= Explanation of Presentation Section in Template:Asset = This page documents the purpose and meaning of the presentation lines at the bottom of '''Template:Asset'''. These lines are sometimes perceived as "mystery lines". They are NOT magic, NOT required for Cargo, and NOT required for Page Forms. They exist only to control how an Asset page looks when viewed by humans. ---- == Big Picture == Template:Asset has two distinct roles: # '''Data role''' #* Declares th..."

2026-02-20T13:10:00Z

Created page with "= Explanation of Presentation Section in Template:Asset = This page documents the purpose and meaning of the presentation lines at the bottom of '''Template:Asset'''. These lines are sometimes perceived as "mystery lines". They are NOT magic, NOT required for Cargo, and NOT required for Page Forms. They exist only to control how an Asset page looks when viewed by humans. ---- == Big Picture == Template:Asset has two distinct roles: # '''Data role''' #* Declares th..."

New page

= Explanation of Presentation Section in Template:Asset =

This page documents the purpose and meaning of the presentation lines
at the bottom of '''Template:Asset'''.

These lines are sometimes perceived as "mystery lines".
They are NOT magic, NOT required for Cargo, and NOT required for Page Forms.

They exist only to control how an Asset page looks when viewed by humans.

----

== Big Picture ==

Template:Asset has two distinct roles:

# '''Data role'''
#* Declares the Cargo schema
#* Stores Asset data using <code>#cargo_store</code>
# '''Presentation role'''
#* Renders a readable Asset page

This document explains ONLY the presentation role.

The presentation section does NOT affect:
* saving
* Cargo storage
* Page Forms
* automation
* JavaScript
* Lua

It only affects what users see when they open an Asset page.

----

== The Presentation Section ==

The following lines appear at the bottom of Template:Asset:

<pre>
== {{{Label|}}} ==
{{DISPLAYTITLE:{{{Label}}}}}

{{#if:{{{File|}}}|'''File:''' [[{{{File}}}]]}}

{{#if:{{{OriginalFilename|}}}|'''Original filename:''' {{{OriginalFilename}}}}}

{{#if:{{{Parent|}}}|'''Parent asset:''' [[{{{Parent}}}]]}}

'''Description:'''
{{{Description|}}}

'''Notes:'''
{{{Notes|}}}
</pre>

Each line is explained below.

----

== Section Heading Using the Label ==

<pre>
== {{{Label|}}} ==
</pre>

What it does:
* Creates a section heading
* The heading text is the value of the <code>Label</code> field
* If Label is empty, nothing is shown

Why it exists:
* Makes the Asset page readable
* Shows the identifier clearly inside the page body

If removed:
* The page still works
* The page becomes visually empty and confusing

----

== Display Title Override ==

<pre>
{{DISPLAYTITLE:{{{Label}}}}}
</pre>

What it does:
* Changes the title shown to users
* The actual page name remains unchanged
* Example:
* Page name: <code>Asset:CH03-BER-0007</code>
* Displayed title: <code>CH03-BER-0007</code>

Why it exists:
* Removes namespace noise
* Makes Asset pages look like archival records

If removed:
* The page title will show the full namespace
* Functionality is unaffected

----

== Conditional Display of File ==

<pre>
{{#if:{{{File|}}}|'''File:''' [[{{{File}}}]]}}
</pre>

What it does:
* Checks whether the File field is non-empty
* If yes, shows a clickable file link
* If no, shows nothing

Why it exists:
* Prevents empty labels from appearing
* Allows draft or incomplete Assets to render cleanly

If removed:
* The file still exists
* The file link is no longer visible on the Asset page

----

== Conditional Display of Original Filename ==

<pre>
{{#if:{{{OriginalFilename|}}}|'''Original filename:''' {{{OriginalFilename}}}}}
</pre>

What it does:
* Displays the original filename selected on the user's computer
* Only shown if the field is filled

Why it exists:
* Provides provenance information
* Reassures users after upload
* Supports archival traceability

If removed:
* The value is still stored in Cargo
* Users cannot see provenance on the page

----

== Conditional Display of Parent Asset ==

<pre>
{{#if:{{{Parent|}}}|'''Parent asset:''' [[{{{Parent}}}]]}}
</pre>

What it does:
* Displays a clickable link to the parent Asset
* Only shown if a parent exists

Why it exists:
* Makes derivation relationships visible
* Supports navigation between original and derived Assets

If removed:
* The relationship still exists
* It becomes invisible unless queried via Cargo

----

== Description Field ==

<pre>
'''Description:'''
{{{Description|}}}
</pre>

What it does:
* Always shows the label "Description:"
* Shows the content if present

Why it exists:
* Description is expected for every Asset
* Even when empty, it signals what should be written there

If removed:
* Asset pages become harder to understand
* Narrative context is lost

----

== Notes Field ==

<pre>
'''Notes:'''
{{{Notes|}}}
</pre>

What it does:
* Displays free-form notes
* Intended for technical or archival remarks

Why it exists:
* Separates descriptive text from technical commentary

----

== Important Reminder ==

Everything in this presentation section uses basic MediaWiki features only:

* <code>{{{ }}}</code> – template parameters
* <code>{{#if:}}</code> – conditional display
* <code>[[ ]]</code> – links
* <code>'''</code> – bold text
* <code>== ==</code> – headings

There is:
* no Cargo logic here
* no Page Forms logic
* no JavaScript
* no Lua

----

== Mental Model to Keep ==

You can safely remember:

* Top of Template:Asset = data structure
* Bottom of Template:Asset = page layout

The presentation section can be changed, rewritten, or redesigned
without affecting data integrity.

----

== Status ==

This explanation is stable documentation.

It exists to support long-term understanding and memory retention.

ICT:Documentation:Template Asset Presentation - Revision history

Mngr: Mngr moved page ICT:FinalConfig - Template Asset Presentation to ICT:Documentation:Template Asset Presentation without leaving a redirect