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>__NOTITLE__
+<includeonly>__NOTOC____NOTITLE__<div class="media pagetitle mt-1"><div class="align-self-center mr-3">[[File:{{#switch:{{{logo|}}}| delta=Delta_c.png
-{| class="pagetitle"
+| fo3=Fo3_flare.png
-|-
+| fo4=Fo4_flare.png
-| rowspan="3" | {{#if:{{{logo|}}}|[[File:{{#switch:{{{logo}}}|delta=Delta_c.png|#default={{{logo}}} }}|105px]]| }}
+| fnv=Fnv_flare.png
-| class="pagetitle-title" | {{{title}}}
+| mo=Moicon.png
-|-
+| mo2=Moicon.png
-| class="pagetitle-subtitle" | {{#if:{{{subtitle|}}}|{{{subtitle}}}|&nbsp;}}
+| morrowind=Morrowind_flare.png
-|-
+| nms=Nomanssky_flare.png
-| class="pagetitle-extra" | {{#if:{{{author|}}}|{{#if:{{{forumtid|}}}|''by: {{{author}}}'' &nbsp;{{!}}&nbsp; [https://stepmodifications.org/forum/topic/{{{forumtid}}}-- '''Forum Topic''']|''by: {{{author}}}''}}|{{#if:{{{forumtid|}}}|[https://stepmodifications.org/forum/topic/{{{forumtid}}}-- '''Forum Topic''']|&nbsp;}} }}
+| nomanssky=Nomanssky_flare.png
-|}
+| oblivion=Oblivion_flare.png
-</includeonly><noinclude>__NOTOC__ __NOTITLE__ [[Category:Formatting Templates]]
+| 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
-{{alert small|type=notice|text=Includes the <code><nowiki>__NOTITLE__</nowiki></code> by default, therefore, it's not necessary to include it on the page when the PageTitle template is used.}}
+=== Optional Parameters ===
+<span class="salmontx">'''logo'''</span> - Displays a logo to the left of the content
+: '''Values'''
+:: Default: <code>logo=delta</code>
+====General Logos====
+: {{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 01 (title only)==
+<span class="salmontx">'''subtitle'''</span> - Activates and sets a subtitle line displayed below the '''title'''
-'''Code:'''
+: '''Values'''
-<pre>{{PageTitle|title=Your Title Here}}</pre>
+:: Default: n/a, <code>subtitle=''SubtitleHere''</code>
-'''Result:'''
-{{PageTitle|title=Your Title Here}}
-<br/>
-<br/>
-==Example 02 (all options w/default logo)==
+<span class="salmontx">'''author'''</span> - Activates and sets an author line displayed below the '''title''' or '''subtitle'''
-'''Code:'''
+: '''Values'''
-<pre>{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</pre>
+:: Default: n/a, <code>author=''Author(s)Here''</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">'''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>{{PageTitle|logo=Fallout3.png|title=Your Title Here|subtitle=Your subtitle text here|author=Team XYZ|forumtid=423}}</pre>
+: '''Values'''
-'''Result:'''
+:: Default: n/a, <code>forumtid=''14917''</code>
-{{PageTitle|logo=Fallout3.png|title=Your Title Here|subtitle=Your subtitle text here|author=Team XYZ|forumtid=423}}
-'''Code:'''
+==Examples==
-<pre>{{PageTitle|logo=TechGuideImage.png|title=Your Title Here|subtitle=Your subtitle text here|author=Team XYZ|forumtid=423}}</pre>
+===Default Call===
-'''Result:'''
+The simplest call returns defaults for the template.
-{{PageTitle|logo=TechGuideImage.png|title=Your Title Here|subtitle=Your subtitle text here|author=Team XYZ|forumtid=423}}
+: '''Code:''' <code><nowiki>{{PageTitle|title=Title Here}}</nowiki></code>
+: '''Result:'''
+:: {{PageTitle|title=Title Here}}
+<hr>
+<hr>
-==Example 04 (wo/subtitle)==
+===Example 01 (all options)===
-'''Code:'''
+: '''Code:'''
-<pre>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}</pre>
+:: <code><nowiki>{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</nowiki></code>
-'''Result:'''
+: '''Result:'''
-{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ|forumtid=423}}
+:: {{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
+<hr>
+<hr>
-==Example 05 (wo/subtitle or forum topic)==
+===Example 02 (alternate logo) ===
-'''Code:'''
+: '''Code:'''
-<pre>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ}}</pre>
+:: <code><nowiki>{{PageTitle|logo=fo3|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}</nowiki></code>
-'''Result:'''
+: '''Result:'''
-{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ}}
+:: {{PageTitle|logo=fo3|title=Your Title Here|subtitle=Your subtitle text here|author= Team XYZ|forumtid=423}}
+<hr>
-==Example 06 (wo/author or forum topic)==
+<hr>
-'''Code:'''
-<pre>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ}}</pre>
-'''Result:'''
-{{PageTitle|logo=delta|title=Your Title Here|subtitle=Your subtitle text here}}
-==Example 07 (wo/author, subtitle or forum topic)==
-'''Code:'''
-<pre>{{PageTitle|logo=delta|title=Your Title Here|author= Team XYZ}}</pre>
-'''Result:'''
-{{PageTitle|logo=delta|title=Your Title Here}}
+===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>