Advertisement
Skip to content
in: Template documentation

# Dialogue/doc

Template page |
< Template:Dialogue
Sign in to edit

- History
- Talk (0)

{{Dialogue}} facilitates the writing of dialogue in a standard format. The template can handle most standard formats of writing dialogue, and can be indented, bulleted or numbered. This template cannot be `subst:`'d.

This template uses the Lua templating language, and more information can be found on the Global Lua Module page. For a traditional wikitext version of this template, see Dialogue on Templates Wiki.

## Syntax[]

This is how to write the template in wikitext onto your article:

    {{dialogue
    |short=full
    |short=full
    |short=full
    ...
    |Character|Speech
    |Character|Speech
    |Character|Speech
    ...
    |cite = dialogue description
    }}

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:

    {{dialogue
    |short=full
    |short=full
    |short=full
    ...

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 "`mood1`", "`mood2`", "`mood3`", etc., up to "`mood10`", specify moods for the corresponding line number (e.g. "`mood1`" specifies line 1). They are placed in a line like this:

    ...
    |Character|Speech|mood1=angry
    |Character|Speech|mood2=quiet
    |Character|Speech|mood3=ecstatic
    ...

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

  `Parameter 1` (required)
    Character name speaking
  `Parameter 2` (optional)
    Line to speak
  `Parameter 3` (optional)
    Next character
  `Parameter 4` (optional)
    Next line
  `Parameter 5` (optional)
    Next character
  `Parameter 6` (optional)
    Next line
  `Parameter 7` (optional)
    so on...

Note: if any character is called "`action`" then that line will be construed as an action line. It still counts as a line nonetheless.

To write a dialogue description/source, use `cite =`

## Examples[]

Here is an example of a full template usage:

    {{dialogue
    |harry=Harry Enfield
    |bryan=Bryan Adams

    |harry|Hello!                |mood1=happy
    |bryan|Oh hello there        |mood2=surprised
    |harry|How are you?          |mood3=inquisitive
    |bryan|Quite fine thank you. |mood4=reserved
    |harry|Oh that's spiffing.   |mood5=spiffed
    |bryan|It is, isn't it?!     |mood6=multo-spiffed
    |harry|Quite so.             |mood7=bored
    |bryan|Well, I'm off!        |mood8=joyous
    |harry|Ta-ta!                |mood9=relieved
    |bryan|Au revoir!            |mood10=sarcastic
    }}

The above would generate:

> Harry Enfield (happy)
>   Hello!
> Bryan Adams (surprised)
>   Oh hello there
> Harry Enfield (inquisitive)
>   How are you?
> Bryan Adams (reserved)
>   Quite fine thank you.
> Harry Enfield (spiffed)
>   Oh that's spiffing.
> Bryan Adams (multo-spiffed)
>   It is, isn't it?!
> Harry Enfield (bored)
>   Quite so.
> Bryan Adams (joyous)
>   Well, I'm off!
> Harry Enfield (relieved)
>   Ta-ta!
> Bryan Adams (sarcastic)
>   Au revoir!

The below code demonstrates examples of extended use:

    {{dialogue
    |george=Georgie Boy
    |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.
    }}

The above would generate:

>   [Enter: George and Rachel]
> Georgie Boy (happy)
>   Good morrow dearest Rachel!
>   [Rachel turns to see him]
> Rachel
>   Oh, George, it's you!
> Georgie Boy
>   ...
> Rachel (worried)
>   Why won't you say anything?!
>   [Enter: Guards]
> Guards
>   We are announcing George's arrest!
> Rachel (horrified)
>   Oh my!
>   [George is dragged away.]

### Notes[]

You can number, bullet or indent your dialogue:

    :{{dialogue|Me|Hello|You|Howdido!}}

  > Me
  >   Hello
  > You
  >   Howdido!

    #{{dialogue|Me|Hello|You|Howdido!}}
    #{{dialogue|Them|Good afternoon|Us|What a load of rubbish!}}

1. > Me
   >   Hello
   > You
   >   Howdido!

2. > Them
   >   Good afternoon
   > Us
   >   What a load of rubbish!

    *{{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!}}

- > Fortitude
  >   I am an angel!
  > Crowd
  >   We don't believe you!

- > Fortitude
  >   But I'm being quite serious!
  > Crowd
  >   Too bad for you then!

You will get the odd spacing error (e.g. "Speech`<space>`") if you lay out your dialogue on multiple lines.

Advertisement