Syl: 2 revisions imported

2024-07-23T13:45:48Z

2 revisions imported

← Older revision	Revision as of 13:45, 23 July 2024
(No difference)

Syl: 1 revision imported

2023-05-18T13:56:46Z

1 revision imported

← Older revision	Revision as of 13:56, 18 May 2023
(No difference)

w>Belbury: /* Examples */ edit extreme placeholders (a script that includes lines for "you"?) to mundane dialogue

2023-01-31T11:03:38Z

Examples: edit extreme placeholders (a script that includes lines for "you"?) to mundane dialogue

New page

{{Documentation subpage}}


This is a complex template designed to make it easy to write out lines of [[dialogue]]. '''This template ''cannot'' be <code>subst:</code>'d'''. The template can handle most standard formats of writing dialogue, and can be indented, bulleted or numbered.

{{tl|Dialogue}} facilitates the writing of [[dialogue]] in a standard format.

==Syntax==
This is how to write the template in [[wikitext]] onto your article:

<pre>{{dialogue
|short=full
|short=full
|short=full
...
|Character|Speech
|Character|Speech
|Character|Speech
...
}}</pre>

These parameters are explained more fully below.

==Parameters==

'''Named parameters specify name shortcuts. They are all optional.''' They are placed at the top of the template call, like this:

<pre>{{dialogue
|short=full
|short=full
|short=full
...</pre>

Name shortcuts apply to your main dialogue text. If you use a shortcut specified here for a character name, then the full name will be replaced for it.

Named parameters of the form "<code>mood1</code>", "<code>mood2</code>", "<code>mood3</code>", etc., up to "<code>mood10</code>", specify moods for the corresponding line number (e.g. "<code>mood1</code>" specifies line 1). They are placed in a line like this:

<pre>...
|Character|Speech|mood1=angry
|Character|Speech|mood2=quiet
|Character|Speech|mood3=ecstatic
...</pre>

Positional parameters form the text of the dialogue (i.e. any line not containing an "<code>=</code>" will be construed as part of the dialogue.

:;<code>Parameter 1</code> ''(required)'' : Character name speaking
:;<code>Parameter 2</code> ''(optional)'' : Line to speak
:;<code>Parameter 3</code> ''(optional)'' : Next character
:;<code>Parameter 4</code> ''(optional)'' : Next line
:;<code>Parameter 5</code> ''(optional)'' : Next character
:;<code>Parameter 6</code> ''(optional)'' : Next line
:;<code>Parameter 7</code> ''(optional)'' : so on...

This extends for 10 lines at maximum. After that, unfortunately the template will have to be manually called again from the code.

Note: if any character is called "<code>action</code>" then that line will be construed as an action line. It still counts as a ''line'' nonetheless.

==Examples==
Here is an example of a full template usage:

<pre>{{dialogue
|officer=Officer
|chicolini=Chicolini
|firefly=[[Rufus T. Firefly|Firefly]]
|officer|Chicolini, you're charged with high treason, and if found guilty, you will be shot.
|chicolini|I object.
|officer|Oh, you object? On what grounds?|mood3=derisively
|chicolini|I couldn't think of anything else to say.
|firefly|Objection sustained.|mood5=interrupting
|officer|Your Excellency, you sustained the objection?!|mood6=surprised
|firefly|Sure, I couldn't think of anything else to say, either. Why don't you object?
}}</pre>

The above would generate:

{{dialogue
|officer=Officer
|chicolini=Chicolini
|firefly=[[Rufus T. Firefly|Firefly]]
|officer|Chicolini, you're charged with high treason, and if found guilty, you will be shot.
|chicolini|I object.
|officer|Oh, you object? On what grounds?|mood3=derisively
|chicolini|I couldn't think of anything else to say.
|firefly|Objection sustained.|mood5=interrupting
|officer|Your Excellency, you sustained the objection?!|mood6=surprised
|firefly|Sure, I couldn't think of anything else to say, either. Why don't you object?
}}

The below code demonstrates examples of extended use:

<pre>{{dialogue
|george=George
|rachel=Rachel

|action|Enter: George and Rachel
|george|Good morrow dearest Rachel!|mood2=happy
|action|Rachel turns to see him
|rachel|Oh, George, it's you!
|george|
|rachel|Why won't you say anything?!|mood6=worried
|action|Enter: Guards
|Guards|We are announcing George's arrest!
|rachel|Oh my!|mood9=horrified
|action|George is dragged away.
}}</pre>

The above would generate:

{{dialogue
|george=George
|rachel=Rachel

|action|Enter: George and Rachel
|george|Good morrow dearest Rachel!|mood2=happy
|action|Rachel turns to see him
|rachel|Oh, George, it's you!
|george|
|rachel|Why won't you say anything?!|mood6=worried
|action|Enter: Guards
|Guards|We are announcing George's arrest!
|rachel|Oh my!|mood9=horrified
|action|George is dragged away.
}}

===Notes===

You can number, bullet or indent your dialogue:

<pre><blockquote>{{dialogue|Alice|Hello.|Bob|Good morning!}}</blockquote></pre>

<blockquote>{{dialogue|Alice|Hello.|Bob|Good morning!}}</blockquote>

<pre>#{{dialogue|Alice|Hello.|Bob|Good morning!}}
#{{dialogue|Carol|What lovely weather we're having.|Dan|I quite agree.}}</pre>

#{{dialogue|Alice|Hello.|Bob|Good morning!}}
#{{dialogue|Carol|What lovely weather we're having.|Dan|I quite agree.}}

<pre>*{{dialogue
|angel=Fortitude
|angel|I am an angel!|Crowd|We don't believe you!}}
*{{dialogue
|angel=Fortitude
|angel|But I'm being quite serious!|Crowd|Too bad for you then!}}</pre>

*{{dialogue
|angel=Fortitude
|angel|I am an angel!|Crowd|We don't believe you!}}
*{{dialogue
|angel=Fortitude
|angel|But I'm being quite serious!|Crowd|Too bad for you then!}}

You will get the odd spacing error (e.g. "Speech<code><space></code>") if you lay out your dialogue on multiple lines. If you need 11 or more lines, you must split the template up. Otherwise you'll see this:

{{dialogue|Line 10|21=Demonstration}}

==See also==
* {{Lts|line}}

<includeonly>

[[Category:Quotation templates]]


</includeonly>

Template:Dialogue/doc - Revision history

Syl: 2 revisions imported

Syl: 1 revision imported

w>Belbury: /* Examples */ edit extreme placeholders (a script that includes lines for "you"?) to mundane dialogue