Template:PageTitle: Difference between revisions

Latest revision as of 22:55, October 4, 2023

Purpose & Usage

Used at top of pages to include a standardized page-title header. Transclusion of this template onto a subpage will preserve the breadcrumb link to the parent root page.

NOTE

This template allows the use of any image uploaded to the wiki. DM an administrator to add an image to this template if it does not exist.

The image size minimum for logos is 105x105 pixels. Recommended size is approximately 512x512 pixels, which will be shrunk to fit the template.
This template includes the __NOTITLE__ behavior switch by default; therefore, it's not necessary to include it on a page when the PageTitle template is used.

Required Parameters

title - Sets the title

Values

Default: n/a, title=TitleHere

Optional Parameters

logo - Displays a logo to the left of the content

Values

Default: logo=delta

General Logos

delta

mo, mo2

Game Logos

fo3

fo4

fnv

morrowind

nomanssky, nms

oblivion

skyrimle

skyrimse

starfield

subtitle - Activates and sets a subtitle line displayed below the title

Values

Default: n/a, subtitle=SubtitleHere

author - Activates and sets an author line displayed below the title or subtitle

Values

Default: n/a, author=Author(s)Here

forumtid - Activates and sets a forum link for the page. The ForumTopicID is found in the topic's URL:

https://stepmodifications.org/forum/topic/14917-system-setup-guide/

Values

Default: n/a, forumtid=14917

Examples

Default Call

The simplest call returns defaults for the template.

Code: {{PageTitle|title=Title Here}}

Result:

Title Here

Example 01 (all options)

Code:

{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}

Result:

Your Title Here

Your subtitle text here

by: Team XYZ | Forum Topic

Example 02 (alternate logo)

Code:

{{PageTitle|logo=fo3|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}

Result:

Your Title Here

Your subtitle text here

by: Team XYZ | Forum Topic

Example 03

No Subtitle

Code:

{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}

Result:

Your Title Here

by: Team XYZ | Forum Topic

@@ Line 1: / Line 1: @@
-<includeonly><div class="pagetitle">
+<includeonly>__NOTOC____NOTITLE__<div class="media pagetitle mt-1"><div class="align-self-center mr-3">[[File:{{#switch:{{{logo|}}}| delta=Delta_c.png
-<div style="display: table-row-group;">
+| fo3=Fo3_flare.png
-<div style="display: table-row;">
+| fo4=Fo4_flare.png
-<div style="display:table-cell; vertical-align:bottom; {{#if:{{{logo|}}}| padding-right:0.2em; | padding:0;}}">
+| fnv=Fnv_flare.png
-{{#if:{{{logo|}}}|[[File:{{#switch:{{{logo}}}|delta=Delta_c.png|#default={{{logo}}} }}|110px|none|bottom]]| }}</div>
+| mo=Moicon.png
-<div style="display: table-cell; width: 100%; overflow:hidden; {{#if:{{{subtitle|}}}|{{#if:{{{author|}}}|{{#if:{{{forumtid|}}}|padding-bottom:0.2em;| }} | }} | }}">
+| mo2=Moicon.png
-<div class="pagetitle-title">{{{title}}}</div>
+| morrowind=Morrowind_flare.png
-<div class="pagetitle-subtitle">{{#if:{{{subtitle|}}}|{{{subtitle}}}}}</div>
+| nms=Nomanssky_flare.png
-<div class="pagetitle-extra">{{#if:{{{author|}}}|''by: {{{author}}}''}}</div>
+| nomanssky=Nomanssky_flare.png
-<div class="pagetitle-extra">{{#if:{{{forumtid|}}}|[https://forum.step-project.com/topic/{{{forumtid}}}- '''Forum Topic''']}}</div></div></div></div></div>{{clear}}</includeonly><noinclude>__NOTOC__ __NOTITLE__ [[Category:Formatting Templates]]
+| oblivion=Oblivion_flare.png
+| skyrim
+| skyrimle=Skyrim_flare.png
+| skyrimse=Skyrimse_flare.png
+| starfield=Starfield_flare.png
+| #default=Delta_c.png }}|105px]]</div><div class="media-body align-self-center mt-1"><p class="pagetitle-title mb-0">{{{title}}}</p>{{#if:{{{subtitle|}}}|<p class="pagetitle-subtitle mt-n2 mb-1">{{{subtitle}}}</p>}}{{#if:{{{author|}}}|<p class="mb-0">''by: {{{author}}}''}} {{#if:{{{forumtid|}}}|&nbsp;{{!}}&nbsp;[https://stepmodifications.org/forum/topic/{{{forumtid}}}-- '''Forum Topic''']</p>|{{#if:{{{forumtid|}}}|<p class="mb-0">[https://stepmodifications.org/forum/topic/{{{forumtid}}}-- '''Forum Topic''']</p>}}}}</div></div>{{#ifeq: {{#titleparts: {{FULLPAGENAME}} | | -1 }} | {{FULLPAGENAME}} | | <div class="container mt-n4 mb-4 pl-0" style="font-size:0.9rem"><i class="fas fa-chevron-left pr-2"></i> [[{{NAMESPACEE}}:{{ROOTPAGENAMEE}}|{{ROOTPAGENAME}}]]</div> | }}</includeonly><noinclude>__NOTOC__[[Category:Formatting Templates]][[Category:Layout Templates]][https://stepmodifications.org/forum/topic/15978-pagetitle/ '''Forum Topic''']
 ==Purpose & Usage==
-Used at top of pages to include a standardized page-title header. This template relies upon global CSS classes.
+Used at top of pages to include a standardized page-title header. Transclusion of this template onto a subpage will preserve the breadcrumb link to the parent root page.
+{{Alert|type=notice|text=This template allows the use of any image uploaded to the wiki. DM an administrator to add an image to this template if it does not exist.
+* The image size minimum for logos is 105x105 pixels. Recommended size is approximately 512x512 pixels, which will be shrunk to fit the template.
+* This template includes the <code><nowiki>__NOTITLE__</nowiki></code> behavior switch by default; therefore, it's not necessary to include it on a page when the PageTitle template is used.}}
-===Parameters:===
+=== Required Parameters ===
-* '''''logo'':''' (optional) Displays a logo to the left of the content
+<span class="salmontx">'''title'''</span> - Sets the title
-** fill with the file name (with extension) of an uploaded image (e.g. Delta_c.png )
+: '''Values'''
-** if ''logo=delta'', then the Step delta logo will be displayed
+:: Default: n/a, <code>title=''TitleHere''</code>
-* '''''title''''': is the text for the title
-* '''''subtitle''''': (optional) this is this the text that appears below the title.
-* '''''author''''': (optional) field for the author(s)
-* '''''forumtid''''': (optional) use a ''forum topic's ID'' to include a link to related forum topic
-==Example 01 (title only)==
+=== Optional Parameters ===
-'''Code:'''
+<span class="salmontx">'''logo'''</span> - Displays a logo to the left of the content
-<pre><nowiki>{{PageTitle|title=Your Title Here}}</nowiki></pre>
+: '''Values'''
-'''Result:'''
+:: Default: <code>logo=delta</code>
-{{PageTitle|title=Your Title Here}}
+====General Logos====
-<br/>
+: {{GallerySimple|id=1|width=95|img=File:Delta_c.png|caption=delta}}{{GallerySimple|id=1|width=95|img=File:Moicon.png|caption=mo, mo2}}
+{{clear}}
+====Game Logos====
+: {{GallerySimple|id=1|width=95|img=File:Fo3_flare.png|caption=fo3}}{{GallerySimple|id=1|width=95|img=File:Fo4_flare.png|caption=fo4}}{{GallerySimple|id=1|width=95|img=File:Fnv_flare.png|caption=fnv}}{{GallerySimple|id=1|width=95|img=File:Morrowind_flare.png|caption=morrowind}}{{GallerySimple|id=1|width=95|img=File:Nomanssky_flare.png|caption=nomanssky, nms}}{{GallerySimple|id=1|width=95|img=File:Oblivion_flare.png|caption=oblivion}}{{GallerySimple|id=1|width=95|img=File:Skyrim_flare.png|caption=skyrimle}}{{GallerySimple|id=1|width=95|img=File:Skyrimse_flare.png|caption=skyrimse}}{{GallerySimple|id=1|width=95|img=File:Starfield_flare.png|caption=starfield}}
+{{clear}}
-==Example 02 (all options w/default logo)==
+<span class="salmontx">'''subtitle'''</span> - Activates and sets a subtitle line displayed below the '''title'''
-'''Code:'''
+: '''Values'''
-<pre><nowiki>{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}</nowiki>}</pre>
+:: Default: n/a, <code>subtitle=''SubtitleHere''</code>
-'''Result:'''
-{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
-==Example 03 (all options w/custom logo)==
+<span class="salmontx">'''author'''</span> - Activates and sets an author line displayed below the '''title''' or '''subtitle'''
-'''Code:'''
+: '''Values'''
-<pre><nowiki>{{PageTitle|logo=[[File:Fallout3.png|115px|left]]|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</nowiki></pre>
+:: Default: n/a, <code>author=''Author(s)Here''</code>
-'''Result:'''
-{{PageTitle|logo=Fallout3.png|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
-==Example 04 (wo/subtitle)==
+<span class="salmontx">'''forumtid'''</span> - Activates and sets a forum link for the page. The '''ForumTopicID''' is found in the topic's URL:<br>
-'''Code:'''
+: {{Fc|dim|<nowiki>https://stepmodifications.org/forum/topic/</nowiki>{{Fc|instruction|'''14917'''}}<nowiki>-system-setup-guide/</nowiki>}}
-<pre><nowiki>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}</nowiki></pre>
+: '''Values'''
-'''Result:'''
+:: Default: n/a, <code>forumtid=''14917''</code>
-{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}
+==Examples==
+===Default Call===
+The simplest call returns defaults for the template.
+: '''Code:''' <code><nowiki>{{PageTitle|title=Title Here}}</nowiki></code>
+: '''Result:'''
+:: {{PageTitle|title=Title Here}}
+<hr>
+<hr>
+===Example 01 (all options)===
+: '''Code:'''
+:: <code><nowiki>{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</nowiki></code>
+: '''Result:'''
+:: {{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
+<hr>
+<hr>
+===Example 02 (alternate logo) ===
+: '''Code:'''
+:: <code><nowiki>{{PageTitle|logo=fo3|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</nowiki></code>
+: '''Result:'''
+:: {{PageTitle|logo=fo3|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
+<hr>
+<hr>
+===Example 03 ===
+==== No Subtitle ====
+: '''Code:'''
+:: <code><nowiki>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}</nowiki></code><br>
+: '''Result:'''
+:: {{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}
 </noinclude>