Difference between revisions of "DescriptionWML"
From The Battle for Wesnoth Wiki
				
				
		
		 (updated formatting, and clarified the meaning of =)  | 
				GrabberBot (talk | contribs)  m (automated change of forum links)  | 
				||
| Line 10: | Line 10: | ||
* '''*''' if it should be the default selection  | * '''*''' if it should be the default selection  | ||
| − | * '''&''image''=''text''''' image with text description  | + | * '''&''image''=''text''''' image with text description  | 
| − | * '''&''image''=''text''=''text2''''' image with two text descriptions  | + | * '''&''image''=''text''=''text2''''' image with two text descriptions  | 
| − | Single text items are always enclosed in '''  | + | Single text items are always enclosed in '''"''', and concatenated with '''+'''. This is useful so the text can contain translateable items (the '''_''' before a text), and so it can span multiple lines.  | 
for example:  | for example:  | ||
| − |   difficulty_descriptions=  | + |   difficulty_descriptions="&" + "elvish-fighter.png" + "=" + _"Fighter" + "=" + _"(easiest)" +  | 
| − | + |   	";*" + "&" + "elvish-hero.png" + "=" + _"Hero" +  | |
| − | + |   	";" + "&" + "elvish-champion.png" + "=" + _"Champion" + "=" + _"(hardest)"  | |
The utility macros (see [[UtilWML]]) '''{MENU_IMG_TXT ''icon'' ''text''}'''  | The utility macros (see [[UtilWML]]) '''{MENU_IMG_TXT ''icon'' ''text''}'''  | ||
| Line 26: | Line 26: | ||
can be used to create descriptions more easily. The above example would become:  | can be used to create descriptions more easily. The above example would become:  | ||
| − |   difficulty_descriptions={MENU_IMG_TXT2   | + |   difficulty_descriptions={MENU_IMG_TXT2 "elvish-fighter.png" _"Fighter" _"(easiest)"} +  | 
| − | + |   	";*" + {MENU_IMG_TXT "elvish-hero.png" _"Hero"} + ";" +  | |
| − |   	{MENU_IMG_TXT2   | + |   	{MENU_IMG_TXT2 "elvish-champion.png" _"Champion" _"(hardest)"}  | 
== See Also ==  | == See Also ==  | ||
Revision as of 16:35, 21 January 2006
Description texts
A description is a part of the value of a menu attribute. It is used to represent a single option in the menu which consists of an image(called the icon) followed by text.
A description has the format
- ; if another description precedes it
 
- * if it should be the default selection
 
- &image=text image with text description
 
- &image=text=text2 image with two text descriptions
 
Single text items are always enclosed in ", and concatenated with +. This is useful so the text can contain translateable items (the _ before a text), and so it can span multiple lines.
for example:
difficulty_descriptions="&" + "elvish-fighter.png" + "=" + _"Fighter" + "=" + _"(easiest)" + ";*" + "&" + "elvish-hero.png" + "=" + _"Hero" + ";" + "&" + "elvish-champion.png" + "=" + _"Champion" + "=" + _"(hardest)"
The utility macros (see UtilWML) {MENU_IMG_TXT icon text} and {MENU_IMG_TXT2 icon text text-2} can be used to create descriptions more easily. The above example would become:
difficulty_descriptions={MENU_IMG_TXT2 "elvish-fighter.png" _"Fighter" _"(easiest)"} +
	";*" + {MENU_IMG_TXT "elvish-hero.png" _"Hero"} + ";" +
	{MENU_IMG_TXT2 "elvish-champion.png" _"Champion" _"(hardest)"}