0ct0pu5/wesnoth
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update markup in terrain editor pages

Browse source
This commit is contained in:
Subhraman Sarkar 2024-08-19 18:17:07 +05:30 • committed by Celtic Minstrel
parent bbb728c927
commit b46a04bc1f
1 changed files with 51 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

103
data/core/editor/help.cfg
View file

@ -26,23 +26,24 @@
[topic]
id=editor_tool_paint
title= _ "Paint Tool"
text= "<img>src=icons/action/editor-tool-paint_60.png align=left box=yes</img>" + _ "Paint terrain tiles on the map.
text= "<table col=2/><img src=icons/action/editor-tool-paint_60.png align=left box=yes/><jump/>" + _ "Paint terrain tiles on the map.<br/><endtable/>" +
_"
The paint tool utilizes the brush sizes and the terrain palette.
<bold>text='Keyboard Modifiers'</bold>
<header>Keyboard Modifiers</header>
• Shift+mouse click: If a base terrain is selected, change the base without changing the overlay. If an overlay is selected, change the overlay without changing the base.
• Control+mouse click: Select the terrain under the mouse cursor, as if it had been selected on the terrain palette (picks up both base and overlay).
<bold>text='Brush Sizes'</bold>
<header>Brush Sizes</header>
The selected brush changes the size of the tool:" +
"<img>src=icons/action/editor-brush-1_30.png align=left box=yes</img>" + _ "Paint single hexes." +
"<img>src=icons/action/editor-brush-2_30.png align=left box=yes</img>" + _ "Paint seven hexes at a time." +
"<img>src=icons/action/editor-brush-3_30.png align=left box=yes</img>" + _ "Paint nineteen hexes at a time." +
"<img>src=icons/action/editor-brush-nw-se_30.png align=left box=yes</img>" + _ "Paint three hexes in a line." +
"<img>src=icons/action/editor-brush-sw-ne_30.png align=left box=yes</img>" + _ "Paint three hexes in a line."
"<table col=2/>" +
"<img src=icons/action/editor-brush-1_30.png align=left box=yes/><jump/>" + _ "Paint single hexes.<br/>" +
"<img src=icons/action/editor-brush-2_30.png align=left box=yes/><jump/>" + _ "Paint seven hexes at a time.<br/>" +
"<img src=icons/action/editor-brush-3_30.png align=left box=yes/><jump/>" + _ "Paint nineteen hexes at a time.<br/>" +
"<img src=icons/action/editor-brush-nw-se_30.png align=left box=yes/><jump/>" + _ "Paint three hexes in a line.<br/>" +
"<img src=icons/action/editor-brush-sw-ne_30.png align=left box=yes/><jump/>" + _ "Paint three hexes in a line.<br/>" +
"<endtable/>"
[/topic]
# wmllint: markcheck on
@ -50,7 +51,8 @@ The selected brush changes the size of the tool:" +
[topic]
id=editor_tool_fill
title= _ "Fill Tool"
text= "<img>src=icons/action/editor-tool-fill_60.png align=left box=yes</img>" + _ "Fill continuous regions of terrain with a different one.
text= "<img>src=icons/action/editor-tool-fill_60.png align=left box=yes</img>" + _ "
Fill continuous regions of terrain with a different one.
The fill tool utilizes the terrain palette.
@ -65,7 +67,8 @@ The fill tool utilizes the terrain palette.
[topic]
id=editor_tool_select
title= _ "Select Tool"
text= "<img>src=icons/action/editor-tool-select_60.png align=left box=yes</img>" + _ "Selects a set of hex fields, for use with with the cut, copy and fill-selection buttons below the menu bar.
text= "<img>src=icons/action/editor-tool-select_60.png align=left box=yes</img>" + _ "
Selects a set of hex fields, for use with with the cut, copy and fill-selection buttons below the menu bar.
<bold>text='Keyboard Modifiers'</bold>
@ -75,11 +78,11 @@ The fill tool utilizes the terrain palette.
<bold>text='Brush Sizes'</bold>
The selected brush changes the size of the tool:" +
"<img>src=icons/action/editor-brush-1_30.png align=left box=yes</img>" + _ "Select single hexes." +
"<img>src=icons/action/editor-brush-2_30.png align=left box=yes</img>" + _ "Select seven hexes at a time." +
"<img>src=icons/action/editor-brush-3_30.png align=left box=yes</img>" + _ "Select nineteen hexes at a time." +
"<img>src=icons/action/editor-brush-nw-se_30.png align=left box=yes</img>" + _ "Select three hexes in a line." +
"<img>src=icons/action/editor-brush-sw-ne_30.png align=left box=yes</img>" + _ "Select three hexes in a line."
"<table col=2/><img>src=icons/action/editor-brush-1_30.png align=left box=yes</img><jump/>" + _ "Select single hexes.<br/>" +
"<img>src=icons/action/editor-brush-2_30.png align=left box=yes</img><jump/>" + _ "Select seven hexes at a time.<br/>" +
"<img>src=icons/action/editor-brush-3_30.png align=left box=yes</img><jump/>" + _ "Select nineteen hexes at a time.<br/>" +
"<img>src=icons/action/editor-brush-nw-se_30.png align=left box=yes</img><jump/>" + _ "Select three hexes in a line.<br/>" +
"<img>src=icons/action/editor-brush-sw-ne_30.png align=left box=yes</img><jump/>" + _ "Select three hexes in a line.<br/>"
[/topic]
# wmllint: markcheck on
@ -87,17 +90,18 @@ The selected brush changes the size of the tool:" +
[topic]
id=editor_tool_paste
title= _ "Clipboard and Paste Tool"
text= "<img>src=icons/action/editor-paste_60.png align=left box=yes</img>" + _ "Rotate, flip and paste the terrain in the clipboard
text= "<img>src=icons/action/editor-paste_60.png align=left box=yes</img>" + _ "
Rotate, flip and paste the terrain in the clipboard
Hexes can be cut or copied to the clipboard using the <ref>dst='editor_tool_select' text='Select Tool'</ref>.
The paste tool shows an outline of the clipboard, which can be pasted with a mouse-click. Only the outline is shown, but mistakes can be corrected with the undo function, which is bound to both Control+Z and to the same key as the in-game undo function.
The paste tool also has some clipboard-manipulation functions:" +
"<img>src=icons/action/editor-clipboard-rotate-cw_30.png align=left box=yes</img>" + _ "Rotate clockwise by 60°." +
"<img>src=icons/action/editor-clipboard-rotate-ccw_30.png align=left box=yes</img>" + _ "Rotate counter-clockwise by 60°." +
"<img>src=icons/action/editor-clipboard-flip-horizontal_30.png align=left box=yes</img>" + _ "Flip horizontally" +
"<img>src=icons/action/editor-clipboard-flip-vertical_30.png align=left box=yes</img>" + _ "Flip vertically"
"<table col=2/><img>src=icons/action/editor-clipboard-rotate-cw_30.png align=left box=yes</img><jump/>" + _ "Rotate clockwise by 60°.<br/>" +
"<img>src=icons/action/editor-clipboard-rotate-ccw_30.png align=left box=yes</img><jump/>" + _ "Rotate counter-clockwise by 60°.<br/>" +
"<img>src=icons/action/editor-clipboard-flip-horizontal_30.png align=left box=yes</img><jump/>" + _ "Flip horizontally<br/>" +
"<img>src=icons/action/editor-clipboard-flip-vertical_30.png align=left box=yes</img><jump/>" + _ "Flip vertically<br/><endtable/>"
[/topic]
# wmllint: markcheck on
@ -107,7 +111,8 @@ The paste tool also has some clipboard-manipulation functions:" +
title= _ "Starting Locations Tool"
text= "<img>src=icons/action/editor-tool-starting-position_60.png align=left box=yes</img>" +
# po: the parts about "10" being shown as "Player 10" use the translatable string "Player $side_num" in the wesnoth-editor textdomain
_ "Defines the side leader starting position.
_ "
Defines the side leader starting position.
This tool sets the side leaders’ default starting locations, and named special locations. Both types of location are enabled in both <ref>dst='..editor_mode_terrain' text='Terrain Editor'</ref> and <ref>dst='..editor_mode_scenario' text='Scenario Editor'</ref> modes. The location names are shown as a list in the editor palette, clicking on the map will place that name on a hex, each location can only be placed on a single hex, and the editor will only allow one location per hex.
@ -131,19 +136,16 @@ Named locations can be accessed from WML using the Standard Location Filter’s
" +
# po: The images here have text, while they could be translated I assume editor-only images won’t be.
# po: In English the text is “IO” for impassable and “UO” for unwalkable.
_ "editor^<bold>text='Movement Overlays'</bold>
<img>src='terrain/grass/green.png~BLIT(terrain/impassable-editor.png~O(0.5))' align=here box=yes</img> <img>src='terrain/grass/green.png~BLIT(terrain/unwalkable-editor.png~O(0.5))' align=here box=yes</img> Impassable and Unwalkable
_ "editor^<header>Movement Overlays</header>
<img>src='terrain/grass/green.png~BLIT(terrain/impassable-editor.png~O(0.5))' box=yes</img><img>src='terrain/grass/green.png~BLIT(terrain/unwalkable-editor.png~O(0.5))' align=here box=yes</img><br/><bold>Impassable and Unwalkable</bold>
While easily noticeable in the editor, these are invisible in the game, so the mixed terrains created by them look like the base terrain. They create a mixed terrain with the movement costs set to “impassable” or “unwalkable” respectively." + "
" +
# po: The images here have text, while they could be translated I assume editor-only images won’t be.
# po: In English these images are the literal text “Castle overlay” and “Keep overlay”.
_ "editor^<bold>text='Castle Overlays'</bold>
<img>src='terrain/grass/green.png~BLIT(terrain/castle/castle-overlay-editor.png~O(0.5))' align=here box=yes</img> <img>src='terrain/grass/green.png~BLIT(terrain/castle/keep-overlay-editor.png~O(0.5))' align=here box=yes</img>
_ "editor^<header>Castle Overlays</header>
<img>src='terrain/grass/green.png~BLIT(terrain/castle/castle-overlay-editor.png~O(0.5))' align=here box=yes</img><img>src='terrain/grass/green.png~BLIT(terrain/castle/keep-overlay-editor.png~O(0.5))' align=here box=yes</img>
Adding either of these overlays to a passable hex allows units to be recruited onto a hex. The keep also allows a leader to recruit from there.
These can be added to an impassable hex to connect a castle to a visually-separate keep through an impassable wall. It’s also possible to create a castle that seems to have grassland between the keep and towers, however this requires the connecting hexes to be occupied or blocked to prevent units being recruited onto them." + "
@ -151,18 +153,14 @@ These can be added to an impassable hex to connect a castle to a visually-separa
" +
# po: The image here has text, while it could be translated I assume editor-only images won’t be.
# po: In English this image is the literal text “Village overlay”.
_ "editor^<bold>text='Village Overlay'</bold>
_ "editor^<header>Village Overlay</header>
<img>src='terrain/grass/green.png~BLIT(terrain/village/village-overlay-editor.png~O(0.5))' align=here box=yes</img>
This turns any base terrain into a village, providing income and healing." + "
" +
# po: The image is an “S” on a solid black background.
_ "editor^<bold>text='Fake Shroud'</bold>
_ "editor^<header>Fake Shroud</header>
<img>src=terrain/void/shroud-editor.png align=left box=yes</img>
Fake Shroud looks like an unexplored area, even in scenarios that have shroud disabled and even when the player’s units can see the hex."
[/topic]
@ -170,27 +168,27 @@ Fake Shroud looks like an unexplored area, even in scenarios that have shroud di
[topic]
id=editor_terrain_elevation
title= _ "Terrain Elevation Graphics"
text= "<img>src='icons/terrain/terrain_group_elevation_30.png~SCALE(60,60)' align=left box=yes</img> - " + _ "A cosmetic elevation effect that looks a little different in the editor than in the game due to visual aids in the editor; all the overlays described here are found in the terrain palette’s “elevation” group." + "
text="<img>src='icons/terrain/terrain_group_elevation_30.png~SCALE(60,60)' align=left box=yes</img><br/>" +
_ "A cosmetic elevation effect that looks a little different in the editor than in the game due to visual aids in the editor; all the overlays described here are found in the terrain palette’s “elevation” group.
" +
_ "editor^<header>Direct Overlays</header>" +
"<br/><img>src='terrain/elevation/bluffs-tile.png' box=yes</img><img>src='terrain/elevation/regular-tile.png' box=yes</img><br/>" +
_ "
<b>Bluffs and Gulch</b>
The bluffs, gulches, and similar variations are much like a standard terrain overlay, and can simply be used that way. However, for larger areas of the map, where you will want to allow the use of other overlay terrains, you will want to combine these with the “markers” described in the next section.
" +
_ "editor^<bold>text='Direct Overlays'</bold>" + "
<img>src='terrain/elevation/bluffs-tile.png' align=here box=yes</img> <img>src='terrain/elevation/regular-tile.png' align=here box=yes</img> " + _ "Bluffs and Gulch
The bluffs, gulches, and similar variations are much like a standard terrain overlay, and can simply be used that way. However, for larger areas of the map, where you will want to allow the use of other overlay terrains, you will want to combine these with the “markers” described in the next section." + "
" +
_ "editor^<bold>text='Elevation Floodfill'</bold>" + "
<img>src='terrain/grass/green.png~BLIT(terrain/floodfill/flood_high.png)' align=here box=yes</img> " + _ "Raised elevation on-map marker" + "
<img>src='terrain/floodfill/marker-high-tile.png' align=here box=yes</img>" + _ "Raised elevation editor palette icon
To make a patch of terrain higher or lower, and still be able to use other overlay terrains such as trees, you will need to use these markers. Placing one of these arrows on the map will flood-fill the map with a color-coded haze; neither the haze nor the arrow will be visible in game. The hazed area will have a border ledge, making it look higher or lower than the adjacent tiles.
_ "editor^<header>Elevation Floodfill</header>" +
"<br/><table col=2/><img>src='terrain/grass/green.png~BLIT(terrain/floodfill/flood_high.png)' box=yes</img><jump/>" + _ "Raised elevation on-map marker<br/>" +
"<img>src='terrain/floodfill/marker-high-tile.png' box=yes</img><jump/>" + _ "Raised elevation editor palette icon<br/><endtable/>" +
"To make a patch of terrain higher or lower, and still be able to use other overlay terrains such as trees, you will need to use these markers. Placing one of these arrows on the map will flood-fill the map with a color-coded haze; neither the haze nor the arrow will be visible in game. The hazed area will have a border ledge, making it look higher or lower than the adjacent tiles.
There are two high markers and two low markers, so it is possible to make terraces of up to five levels (lowest, lower, normal, higher, highest). Placing a high region next to a low region does not result in larger cliffs.
" + "
" +
_ "editor^<bold>text='How to Use'</bold>
_ "
editor^<header>How to Use</header>
The marker arrows are not very useful by themselves, but the bluffs/gulch-type terrains can be used to contain the floodfilled area.
@ -210,7 +208,8 @@ The graphics used to represent the ledge borders are determined by the base terr
title= _ "Deprecated Terrain"
# po: The main reason for choosing “D” is that the hole in the middle of the letter makes it easier to see which terrain is underneath it. This uses a hardcoded image and doesn’t expect the image to be translated.
# po: The Xol and ^Efs terrains’ help pages aren’t given hyperlinks, because they both have hide_help enabled. Even when on a map with Xol on it, ctrl+t will show the hidden page but the ref still won’t link to it.
text= _ "editor^<img>src='terrain/grass/green.png~BLIT(terrain/deprecated-editor.png)' align=left box=yes</img>The magenta ‘D’ (for “Deprecated”).
text= _ "editor^<img src='terrain/grass/green.png~BLIT(terrain/deprecated-editor.png)' box=yes/>
The magenta ‘D’ (for “Deprecated”).
This is shown in the editor over deprecated terrain codes. Examples are:
• the <ref>dst='terrain_fungus_grove_old' text='“^Uf” mushroom terrain'</ref>,