|
|
| Line 1: |
Line 1: |
| '''{{tl|title}}''' is for the manipulation of page titles. For instance, if I wanted to change this page's title from {{PAGENAME}} to something else, I could use {{tl|title}} to do that. It is principally used to ''italicise'' story titles (like ''[[The Masque of Mandragora]]''), or of things that would normally get italics in common written English (ship names, some works of art, book names, periodical titles, and the like). Guidance on what should and should not be italicised by be obtained at [[Tardis:Manual of Style|our manual of style]]. | | '''{{tl|title}}''' is a legacy template that used to be used to manipulate page titles, mainly for the purposes of putting them in italics. This feature is now a native part of the MediaWiki software, and so this template is no longer necessary. |
|
| |
|
| == Usage examples ==
| | '''As of 2 October 2013, Tardis no longer uses this template, and we make no guarantees that we will maintain the javascript and CSS necessary to support it. Please see [[Thread:142395]] for more details.''' |
| Let's look at some practical usages first, and then discuss what might be some implications of these usages.
| |
| * <code><nowiki>{{Title}}</nowiki></code> ''removes namespace''
| |
| * <code><nowiki>{{Title|Foo Bar}}</nowiki></code> ''custom title
| |
| * <code><nowiki>{{Title|align=center}}</nowiki></code> ''centered''
| |
| * <code><nowiki>{{Title|align=right}}</nowiki></code> ''aligned to the right''
| |
| * <code><nowiki>{{Title|Foo Bar|align=center}}</nowiki></code> ''etc''
| |
| | |
| Note how free-form the template is. You could literally change the title into whatever you wanted it to be. Of course, this template doesn't ''actually'' change the title; it only changes the way it ''looks''. So if you changed this page to '''Foo Bar''' it would still be '''{{FULLPAGENAME}}'''. Thus, trying to link to the changed title wouldn't work: [[Foo Bar]] means nothing to the wiki software.
| |
| | |
| Though the freedom of being able to call a page anything has its drawbacks — it could be abused, or the editor might make a typo — its advantages far outstrip them. Without the freedom to manipulate the title at will, it wouldn't be possible to ''partially'' italicise a title, as is useful in the following examples:
| |
| * [[Doctor Who universe|''Doctor Who'' universe]]
| |
| * [[The Sarah Jane Adventures novelisations|''The Sarah Jane Adventures'' novelisations]]
| |
| * [[Castrovalva (TV story)|''Castrovalva'' (TV story)]]
| |
|
| |
| Obviously, we should be italicising every instance of the name of one of the four main programmes we cover: ''[[Torchwood (TV series)|Torchwood]]'', ''[[K9 (TV series)|K9]]'', ''[[Doctor Who]]'', and ''[[The Sarah Jane Adventures]]''. This template allows us to do that, no matter the circumstance. But it also allows us great flexibility with disambiguated names.
| |
| == General implementation compared to disambiguated usage ==
| |
| Note that most of time the preferred syntax for this template is fairly simple:
| |
| <pre>{{title|''{{PAGENAME}}''}}</pre>
| |
| By using the PAGENAME [[Help:magic word|magic word]], we don't have to do any work at all. Put that onto any page and it'll ''automatically'' italicise the title.
| |
| | |
| However, if you were to put that onto, say, [[Castrovalva (TV story)]] then it would render the slightly unsatisfying, ''[[Castrovalva (TV story)]]''. What we want is something that italicises the name of the [[serial]], but leaves the disambiguation — that is, the '''(TV story)''' bit — alone. We could laboriously type out:
| |
| <pre>{{title|''Castrovalva'' (TV story)}}</pre>
| |
| but the problem is that would ''only'' work on the Castrovalva page. If we want something that will work on more than that page, we can use something slightly more automated:
| |
| <pre>{{title|''{{#explode:{{PAGENAME}}|(|0}}'' ({{#explode:{{PAGENAME}}|(|1}}}}</pre>
| |
| What this does is to separate the page name into two parts, left of the "(" and right of it; the left part gets italics but the right part doesn't.
| |
| == As compared with DISPLAYTITLE ==
| |
| DISPLAYTITLE is a magic word whose programming has been greatly enhanced as of [[January]] [[2011]], or MediaWiki version 1.16.1. It, too, can be used to italicize titles. However, as of 1.16.1, this expression does not parse well for users who are not logged in. Thus, we have chosen to implement the javascript-powered solution of {{tl|title}}, and once it's on the page, there's little likelihood that it will be replaced, even if and when MediaWiki fully implements DISPLAYTITLE to the standard of {{tl|title}}.
| |
| | |
| '''Please do not use DISPLAYTITLE on this wiki, as it will make subsequent changes harder if some pages are using DISPLAYTITLE and some are using {{tl|title}}.'''
| |
| <noinclude>[[category:template documentation|{{PAGENAME}}]]</noinclude> | | <noinclude>[[category:template documentation|{{PAGENAME}}]]</noinclude> |
