Template:Hastranscript/doc: Difference between revisions

From RuneRealm Wiki
Jump to navigation Jump to search
Content added Content deleted
(Replaced content with "{{Documentation}} Subtemplate of Template:Hastranscript that handles formatting the 'transcript is on another page' notice. Generally shouldn't be used directly, only through hastranscript. <includeonly>Category:Transclusion templates</includeonly>")
Tag: Replaced
No edit summary
 
Line 1: Line 1:
{{Documentation}}
{{Documentation}}
The {{t|Hastranscript}} template is used to indicate and link to/transclude a transcript page for any given article.
Subtemplate of [[Template:Hastranscript]] that handles formatting the 'transcript is on another page' notice. Generally shouldn't be used directly, only through hastranscript. <includeonly>[[Category:Transclusion templates]]</includeonly>

==Usage==
<pre>
{{hastranscript|type|link}}

{{hastranscript|transclude=yes}}
{{hastranscript|page|transclude=yes}}
{{hastranscript|page1|page2|...|transclude=yes}}
</pre>

==Parameters==
There are two forms of usage for hastranscript. The first generates a messagebox linking to the full transcript page (and that's it); this box is generated by [[Template:Hastranscript/t]]. The second will transclude the contents of the transcript page onto the current page; this should be used for shorter transcripts, generally.

===Link box===
*'''type''' - Optional (required if specifying link). Possible types are:
** <code>npc</code> - This option also adds a link to a list of other transcripts (currently available on the wiki) the NPC speaks in; the list is populated via [[Template:Transcript list]].
** <code>pet</code>
** <code>quest</code>
** <code>miniquest</code>
** <code>event</code>
** <code>item</code>
** <code>scenery</code>
*'''link''' - Optional. If the dialogue page is not found at <nowiki>Transcript:{{PAGENAME}}</nowiki> (which should only be the case in exceptional circumstances), used in place of the default link.

===Transclusion===
*'''transclude=yes''' - required to enable transclusion
*'''page''' - optional, the name of the page to transclude (without 'Transcript:'); will default to <nowiki>{{PAGENAME}}</nowiki> if not specified
**'''page1, page2, ..., pageN''' - multiple pages to transclude, if desired

==Examples==
===Link box===
<pre>{{hastranscript}}</pre> produces:
{{hastranscript}}

<pre>{{hastranscript|npc}}</pre> produces:
{{hastranscript|npc}}

===Transclusion===
<pre>{{hastranscript|Lift manual|transclude=yes}}</pre> produces:
{{hastranscript|Lift manual|transclude=yes}}

{{TemplateData|<templatedata>
{
"params": {
"1": {
"description": "The type of article the dialogue belongs to (one of: npc, pet, quest, miniquest, event, item). When the template is transcluding, this should be the Transcript page name instead.",
"example": "npc",
"type": "line"
},
"2": {
"description": "Link to the dialogue page if it is not Transcript:{{PAGENAME}} (this should only be needed in exceptional circumstances)",
"type": "line"
},
"transclude": {
"description": "Switch this template into transclusion mode. See documentation for details.",
"example": "yes",
"type": "boolean"
}
},
"description": "This template is used to indicate and link to a dialogue page for any given article.",
"format": "inline"
}
</templatedata>}}<includeonly>[[Category:Transclusion templates|{{PAGENAME}}]][[Category:Message box templates|{{PAGENAME}}]]</includeonly>

Latest revision as of 11:42, 17 October 2024

This is a documentation subpage for Template:Hastranscript.
It contains usage information, categories, and other content that is not part of the original template page.
Template:Hastranscript invokes function main in Module:Hastranscript using Lua.

The {{Hastranscript}} template is used to indicate and link to/transclude a transcript page for any given article.

Usage

{{hastranscript|type|link}}

{{hastranscript|transclude=yes}}
{{hastranscript|page|transclude=yes}}
{{hastranscript|page1|page2|...|transclude=yes}}

Parameters

There are two forms of usage for hastranscript. The first generates a messagebox linking to the full transcript page (and that's it); this box is generated by Template:Hastranscript/t. The second will transclude the contents of the transcript page onto the current page; this should be used for shorter transcripts, generally.

Link box

  • type - Optional (required if specifying link). Possible types are:
    • npc - This option also adds a link to a list of other transcripts (currently available on the wiki) the NPC speaks in; the list is populated via Template:Transcript list.
    • pet
    • quest
    • miniquest
    • event
    • item
    • scenery
  • link - Optional. If the dialogue page is not found at Transcript:{{PAGENAME}} (which should only be the case in exceptional circumstances), used in place of the default link.

Transclusion

  • transclude=yes - required to enable transclusion
  • page - optional, the name of the page to transclude (without 'Transcript:'); will default to {{PAGENAME}} if not specified
    • page1, page2, ..., pageN - multiple pages to transclude, if desired

Examples

Link box

{{hastranscript}}

produces:

This article has an associated transcript page.
Click here for the transcript.
{{hastranscript|npc}}

produces:

This article on an NPC has an associated dialogue page.
Click here for a transcript of possible conversations with this NPC.Expression error: Unrecognized word "span".

Transclusion

{{hastranscript|Lift manual|transclude=yes}}

produces:

Transcript:Lift manual does not exist. Please create this page or correct this query.

Template data

Show/hide template's data

The following information is used by extensions and applications, such as VisualEditor, to help users implement this template onto pages. Please ensure that it is up-to-date.

This template is used to indicate and link to a dialogue page for any given article.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
11

The type of article the dialogue belongs to (one of: npc, pet, quest, miniquest, event, item). When the template is transcluding, this should be the Transcript page name instead.

Example
npc
Lineoptional
22

Link to the dialogue page if it is not Transcript:{{PAGENAME}} (this should only be needed in exceptional circumstances)

Lineoptional
transcludetransclude

Switch this template into transclusion mode. See documentation for details.

Example
yes
Booleanoptional