Template:Dialogue/doc

This is the documentation subpage of Template:Dialogue. It contains usage information that is not part of the underlying template page.

{{Dialogue|<nowiki>
...
</nowiki>}}

This template formats quest or NPC dialogue in a presentable manner.

Syntax

For the most part, dialogue can be copied and pasted directly from the in-game chat log into this template with no additional formatting. Wikitext can be added for words rendered in italics and for other purposes, and there is some additional syntax for various other features.

Each dialogue box must be on a single line; for dialogue boxes with line breaks, use <br> instead.

Example	Output
{{Dialogue|<nowiki> Alphinaud: Lorem Alisaie: ''Ipsum''<br>Dolor </nowiki>}}	Alphinaud Lorem Alisaie Ipsum Dolor

Wrapping the input in a nowiki tag is required. This nowiki tag doesn't actually prevent wikitext in dialogue from being rendered, like a normal nowiki tag would; it is specially handled by the underlying module in order to enable processing of custom syntax on top of normal wikitext.

Speakers

A colon separates the speaker from the rest of a message. By default, each speaker name will be linked to its wiki page. If you want to change the target of the link, or not have it link, use the following:

• Change target of the link: Target of link@Speaker name in game
• No link: x@Speaker name in game.

Example	Output
{{Dialogue|<nowiki> Alphinaud@Smart Elezen Teenager: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. x@Imposing Sign: Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. </nowiki>}}	Smart Elezen Teenager Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Imposing Sign Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

For backwards-compatibility with an old dialogue format the wiki previously used, wikitext bold markers (''') surrounding the speaker section will be discarded. Do not rely on this behavior; support will be removed in the future.

Example	Output
{{Dialogue|<nowiki> '''Alphinaud''': This works! '''Alisaie:''' This also works! Please don't use either of these on purpose though! </nowiki>}}	Alphinaud This works! Alisaie This also works! Please don't use either of these on purpose though!

System speakers

Certain speaker names are special and are used to display non-dialogue text such as system messages. These are:

• "System" for system messages that appear in the chat log.
• "Popup" for pop-up/fly-in messages that appear during duties and certain in-world events, e.g. when a quest spawns enemies which must be defeated to progress. This should be used for both the old style and the new red gimmick text introduced in Dawntrail.
  • This style is visually identical to "System" at the moment, but its style will change in the future.
• "Question" for a prompt given when the player has a choice to make.

Example	Output
{{Dialogue|<nowiki> System: This is a system message. Popup: This is a popup. Question: This is a question. Thancred: This is Thancred. </nowiki>}}	This is a system message. This is a popup. This is a question. Thancred This is Thancred.

Placeholders

For dialogue text which varies to reflect details about your character or progression, placeholders in square brackets can be used. Placeholders render a dotted underline, and hovering over a placeholder shows a more detailed description of what information is displayed there in-game.

Several placeholders are supported:

• [Forename] and [Surname]: Character's first or last name. Use both together when referred to by full name.
• [GC Rank]: Rank in the player's current grand company.
• [Job]: Player's current job.
• [Companion]: Name of the player's chocobo companion.

Example	Output
{{Dialogue|<nowiki> Raubahn: [GC Rank] [surname], how kind of you to join us. </nowiki>}}	Raubahn GC Rank Surname, how kind of you to join us.

Alternate phrases

The {{alternatives}} template can be used within dialogue lines to render words phrases within a line that can vary for different players, e.g. race- or gender-specific phrases. In the future, this template will get more styling and options.

Example	Output
{{Dialogue|<nowiki> Baderon: Someone get this {{alternatives|lad|lass}} a drink! </nowiki>}}	Baderon Someone get this lad/lass a drink!

Non-dialogue lines

Any line which doesn't contain a speaker will be rendered as normal wikitext. This can be used to add headings for different sections of a quest's dialogue (usually by journal objective), or for adding descriptions of what's happening during a cutscene. This should only be used for text which doesn't appear in-game at all.

If your markup needs to contain a colon (e.g. when including an image), you can also force the template to treat a line as raw wikitext by putting a colon (:) at the start of the line, with no whitespace afterwards.

Example	Output
{{Dialogue|<nowiki> ===Speak with Minfilia=== Minfilia: Thank you for speaking with me! ===Examine the crumpled letter=== :[[File:Crumpled letter icon1.png|right|thumb|The letter in question]] ''The WoL picks up a piece of paper from the table.'' System: Dear Scions... </nowiki>}}	Speak with Minfilia Minfilia Thank you for speaking with me! Examine the crumpled letter The letter in question The WoL picks up a piece of paper from the table. Dear Scions...

Dialogue Choices

Use > to denote potential answers to questions. Combine this with a "Question:" line to display the prompt that's shown when the user is selecting. The responses (if present) to each answer will be shown in collapsible boxes that are collapsed by default. Once the entire section with optional responses ends, use --- in its own line to denote the end of the section.

Example	Output
{{Dialogue|<nowiki> Question: What will you say? > Option A Alphinaud: Lorem ipsum dolor sit amet > Option B Alphinaud: Ut enim ad minim veniam > Option C (this does not have a unique response) --- Alphinaud: Duis aute irure dolor </nowiki>}}	What will you say? Option A Alphinaud Lorem ipsum dolor sit amet Option B Alphinaud Ut enim ad minim veniam Option C (this does not have a unique response) Alphinaud Duis aute irure dolor

Dialogue choices can be nested by using multiple > to signify the level of nesting. Using --- after nested choices "goes down" a single nesting level; use multiple as needed to escape the full stack of nested choices.

Example	Output
{{Dialogue|<nowiki> Top level > Option 1 Response to 1 >> 1.1 Response to 1.1 >> 1.2 Response to 1.2 > 2 Response to 2 >> 2.1 Response to 2.1 >> 2.2 Response to 2.2 --- Response to 2 continued --- Top level continued </nowiki>}}	Top level Option 1 Response to 1 1.1 Response to 1.1 1.2 Response to 1.2 2 Response to 2 2.1 Response to 2.1 2.2 Response to 2.2 Response to 2 continued Top level continued

Optional Dialogue

Use -optional start in its own line to denote optional dialogue. When the optional dialogue concludes, write -optional end in its own line.

Example

Output

{{Dialogue|<nowiki> Alphinaud: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Alphinaud: Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Alphinaud: Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. -optional start Alphinaud: Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. -optional end Alisaie: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. </nowiki>}}

Alphinaud Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Optional dialogue Alphinaud Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Alisaie Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Cutscenes

Use -cutscene start or -voiced cutscene startin its own line to denote the start of a cutscene. Use -cutscene end in its own line to denote the end of a cutscene.

Example

Output

{{Dialogue|<nowiki> Alphinaud: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. -voiced cutscene start Alphinaud: Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Alphinaud: Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Alisaie: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. -cutscene end Alphinaud: Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. </nowiki>}}

Alphinaud Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Start of voiced cutscene. Alphinaud Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Alisaie Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. End of cutscene. Alphinaud Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Quest Accepted/Complete

Put -quest accepted or -quest complete in its own line in the appropriate section of the dialogue to display a "Quest Accepted/Complete" image.

Example	Output
{{Dialogue|<nowiki> Alphinaud: Good work. As in tradition, your next quest will begin with speaking to Wuk Lamat. -quest complete </nowiki>}}	Alphinaud Good work. As in tradition, your next quest will begin with speaking to Wuk Lamat.