Template:Dialogue section/doc

This template is useful for documenting dialogues. It is implemented by Module:Dialogue.

Description
Each invocation of this template generates a single dialogue section. A single dialogue consists of one or more dialogue sections.

Each dialogue has a dialogue ID, which must be unique for each NPC, but may be the same for different NPCs. It is used in generating HTML IDs for dialogue sections, and these IDs must be unique. The preferred format for dialogue IDs is lowercase, with parts separated by hyphens (e. g. ).

Each dialogue section has a section ID, which is a short internal ID of that section (often just a number). Section IDs must be unique for each dialogue, but may be the same for different dialogues and dialogue sections. Typically, the starting section has ID. Recommended format for question list section IDs is  for the list itself, and   for each question (i. e.   for question 1,   for question 2, et cetera).

Each dialogue section has an NPC name, which is the name of the other side of the dialogue as shown in the dialogue window.

Each dialogue section has dialogue text, which is the text of the dialogue as provided by the game. In case the dialogue text is split into two or more parts (separated by player interaction, who must press "Continue.", which is the sole option, to advance dialogue), these several parts should be merged into one section, and separated by paragraphs containing nothing but.

Each dialogue section has a list of dialogue options, which are variants of responses a player can select for their character to use. Each option has:
 * a type, which is equivalent to the icon displayed in-game next to the option and typically corresponds to the outcome of choosing that option;
 * a text, which is the text of that option as displayed in game;
 * a description, which describes the outcome of choosing that option.

There are four option types:
 * [[File:Dialogue icon more.png]] more options are shown with a speech bubble icon next to them. They often do nothing but advance dialogue. Options that allow to turn in completed quests also use this type.
 * [[File:Dialogue icon accept quest.png]] accept-quest options are shown with a green check mark icon next to them. These options allow to accept new quests or get new objectives for existing quests.
 * [[File:Dialogue icon decline quest.png]] decline-quest options are shown with a red diagonal cross icon next to them. These options allow to decline a new quest or objective. They typically do nothing but end dialogue.
 * [[File:Dialogue icon end.png]] end options are shown with an icon of an open door with an arrow pointing into it. These options always end the dialogue, and often do nothing else.

There are several standard templates for option descriptions:
 * is used when the option advances the dialogue to another section. For example,  is used when the option advances the dialogue to section  . In the output, the section ID is converted to upper case.
 * is used when the option immediately advances the conversation to another dialogue. This is often encountered when turning in quests. As an example,  will describe a jump to section 2 of the dialogue dialogue-2 by the same NPC, describing that dialogue as the quest turn in dialogue.
 * works similar to, but inserts only a link and allows to customize its text.
 * inserts the sentence.

Parameters

 * – specifies the dialogue ID (see description). If not specified, the latest specified ID on this page is used. If not specified and never specified before on the page, an error is shown.
 * – specifies the section ID (see description). If not specified, an error is shown.
 * – specifies the NPC name (see description). If not specified, the latest specified NPC name on this page is used. If not specified and never specified before on the page, the name of the page is used instead.
 * – specifies the dialogue text (see description).
 * – specifies the type for option  (e. g.   specifies the type for option 1). If not specified for an option, the type is assumed to be.
 * – specifies the text for option  (e. g.   specifies the text for option 1). The first option for which text is not specified is assumed to mark the end of the option list.
 * – specifies the description for option  (e. g.   specifies the description for option 1). If not specified:
 * If the option's type is  or , a description of   is automatically inserted.
 * Otherwise, no description is inserted.

Example


