Commit graph

230 commits

Author SHA1 Message Date
Wedge009
45e537505f Use 'curly' quotes as per typography standard.
[ci skip]
2023-10-23 09:44:50 +02:00
Wedge009
918ae0b56a
wesnoth-lib review
* Duplicated text
* Favour generic term 'file manager' over Microsoft terminology.
* Clarify language code use.
* Replace inconsistent spelling of 'add-on'.
2023-09-12 19:06:28 +02:00
Pentarctagon
cbd0d6bd9a
Add help information for the :benchmark command. 2021-08-12 00:52:34 -05:00
kabachuha
d445cb36dc Paraphrased allied orbs description to remove outdated color reference 2021-07-26 14:56:15 +03:00
Celtic Minstrel
0c42cdc038
Enable translation mark validation by the schema (#5800)
- The t_string type is now a schema built-in type and no longer attempts a regex match.
- You can also specify that non-t_string types may be optionally-translatable; this case supports a regex match on the string (but note that the translation mark is not part of the match).
- Error messages involving keys with very large values ( > 128 characters) will now truncate the value.
- To account for occasional cases where the schema is intentionally violated, the --validate command-line option now automatically defines the SCHEMA_VALIDATION preprocessor define.

A key validates as type t_string if one of the following is true:
- The key is not present
- The key has at least one segment with a translation mark
- The key is blank (an empty string)

Any type other than t_string is not allowed to be translatable by default, unless you specify allow_translatable=yes in the [type] tag.

An optionally-translatable string could also be defined as a union of t_string and some other type.
2021-06-14 23:59:52 -04:00
Pentarctagon
7b92aa3a8b
Add :fps file creation to the help+man page. 2021-05-17 10:51:37 -05:00
Steve Cotton
4a43d00522 Show a two-color tennis ball orb for the disengaged state (#5155)
As the disengaged state is part-way between the "partial" and "moved" states,
the orb has parts in each color. On the minimap these units are shown in the
partial color (which is also the color that would be used before this change).

This will match the mounted Quenoth units' "disengage" skill, when they
can still move but can't attack. It should also trigger for some UMC abilities
that get extra moves after a character attacks.

During testing, I found that TSG allows some of the bandits to attack on the
first turn of the bandit branch. There's no gameplay change there, but the orbs
make it much clearer that some units can still attack.

I think there are already too many preferences for orbs, so reused the existing
settings for the colors. A new "show disengaged orb" preference is added, which
when disabled shows the old partial orb instead.

Update the orb and ellipse sections of doc/manual/.

Notes about how I created the new orb image:

* create a color range to_ellipse_red with rgb=FF0000,FF0000,000000,FF0000
* wesnoth --render-image 'misc/orb.png~RC(magenta>to_ellipse_red)' images/misc/orb-ellipse-red.png
* open the orb.png and orb-ellipse-red.png images as layers in Gimp, add a layer mask to both of them
* use the layer mask to get each pixel from exactly one of the layers
2021-02-13 18:28:33 +01:00
Andrey Bienkowski
5cb1790669 Cleanup wmllint: display on/off
https://github.com/wesnoth/wesnoth/pull/5481 removed the check that made
wmllint: display on and wmllint: display off necessary.
This PR removes now redundant wmllint comments.

find ./data/ -name '*.cfg' -exec sed -ri '/^ *# *wmllint *:? *display *(on|off) *$/d; s/ *# *wmllint *:? *display *(on|off) *$//' '{}' ';'
2021-02-02 18:36:28 +03:00
Wedge009
c0393d2394 Clarify what is meant by 'broken version'.
[ci skip]
2020-11-21 20:15:44 +11:00
Steve Cotton
b523297c2a Add docs about crowns and ellipses
The image added here is a grass background to draw units on via Image Path
Functions. For the documentation, a square image looks better than a hexagon
that has black borders.
2020-10-26 16:07:12 +01:00
Wedge009
e123956524 Minor prose corrections.
[ci skip]
2020-10-21 15:09:22 +11:00
gfgtdf
b21c110f30 run wmlindent 2020-10-19 23:53:52 +02:00
Steve Cotton
b38d272c4c During allies' turns, their units' orbs show the move status (#1424)
Instead of using the allied orb during their turn, the unmoved, moved and
partial orbs are shown. The player's own units will be shown with the moved orb
during the ally's turn, which matches the previous behavior. This is intended for
co-operative MP campaigns, where it will make it easier for players to discuss
possible moves. The UX is also visible in SP scenarios with allied sides, HttT's
first scenario is an easy place to see what it does.

If another status is added to the orb_status enum, this code is likely to
support it with no changes needed for the parts in this commit. For example,
issue #5155's proposed orb_status::disengaged has been tested with this.

Updated the documentation about orb colors. In these docs I've moved all of
the images to a single line above the bullet-pointed list, as otherwise the
layout looked bad once a line wrapped - the first line appeared
horizontally-aligned with the center of the image, the second started under the
image.

Added documentation about the delay in multiplayer games, as the purpose of this
orb-coloring feature is to assist discussion in multiplayer games.
2020-10-17 14:11:10 +02:00
Steve Cotton
e0103c2cb5 Update the docs for ":droid full" in the help browser
This command and the documentation provided by ":help droid" were updated
in efd808ea84, but we missed that this command
is also documented in the help browser's (Commands, General Commands) page.

The docs here are more verbose than in ":help", so the text is newly written
instead of being copied from the existing location.
2020-09-27 20:58:57 +02:00
Steve Cotton
ba690adc41 Save-loading: remove "under discussion", add hint about accepting losses
This removes some subtle todo text that didn't have a explicit "TODO" in
the text, although it was tracked as part of #4280. The discussion ended
without a conclusion about whether those statements were correct for all
mainline campaigns.

The existing text in this help topic represented paragraphs by having
translatable strings that start with whitespace (two newlines), as described in
issue #4480. As this commit already needed to change all but two of the
paragraphs, I've switched them all to using non-translatable paragraph
separators.  Even though the whole save-loading topic is new in 1.15, it has
already been translated in some languages, and making this consistent means two
unnecessary fuzzy strings. Sorry to the translators, but I think it's
worthwhile.
2020-08-19 16:11:35 +02:00
Steve Cotton
4a16b9d3ff
Help dealing with losses: remove todo for linking to the forums (#5077)
This simply removes the todo. Conclusions from trying to add a link:

* Any link should be to something more specific than the "Mainline Campaigns
Feedback" forum, which is a set of sub-forums that may or may not have any
recent and-or useful information for the particular scenario that the user is
having trouble with. For replays in particular, some (most?) don't have replays
that have been uploaded to the feedback threads, and given Wesnoth's
incompatibility with previous stable branches the replays that are there might
not be usable.

*`The forums are English, so might want a note in all the non-English
translations that isn't in the English text.
2020-08-15 22:57:48 +02:00
Steve Cotton
2546446122
Help about losing: remove reference to specific difficulties (#5076)
Part of resolving issue #4280.
2020-08-15 17:49:21 +02:00
Elvish_Hunter
f0bdd01918 help.cfg: fixed wmllint warnings about translation marks
Fixes some of the warnings listed in #4494
2019-11-10 15:45:04 +01:00
josteph
74589a642c Fixes from SpellingMistakes 2019-10-19 21:32:24 +00:00
Steve Cotton
ed611f9438 Re-enable the editor help, and use it to document the keyboard modifiers (#4414)
... with the idea that these pages will either be improved or hidden again
before 1.16.0. I think the terrain-editor part will be good enough to stay in
1.16, but the scenario editor part needs to be updated by someone familiar with
it.

This puts the two tips that are currently in https://wiki.wesnoth.org/MapEditor
in to the in-game text.
2019-10-08 19:22:34 +02:00
josteph
dfe7347718 help: Break the new saveload and whylost topics into paragraphs for translation. 2019-09-30 22:49:33 +00:00
josteph
ea16e832ed Help: Add screenshots to "income and upkeep" 2019-09-14 13:30:38 +00:00
josteph
4912c5e934 help: Add a screenshot to the combat screen 2019-09-14 13:00:09 +00:00
josteph
0a0b70c5a9 Clarify descriptions of income and upkeep. 2019-09-14 07:58:12 +00:00
jostephd
0a6ed0ae4f
help: Add 'Why did I lose?' help topic (#4217)
* Draft 'Why did I lose?' help topic

* fixup! Draft 'Why did I lose?' help topic

Implement @beetlenaut's suggestions

* help: Change to title case for consistency with the rest of the section

* help: Explain the term 'foreknowledge'
2019-08-16 00:30:50 +00:00
josteph
0b0569457d help: Fix punctuation 2019-08-10 13:28:49 +00:00
Severin Glöckner
b7234a48b2 help: use no pango markup
Pango support for the help has been reverted together with the help's GUI2 port.
[ci skip]
2019-08-04 22:21:46 +02:00
Steve Cotton
862e482895 Add a hint about not save-loading, and link to it from the "Back to ..." menu 2019-08-03 20:05:27 +02:00
Andrius Štikonas
ce8c8b74e6 Remove a stray foo. 2019-01-22 10:57:11 +11:00
jostephd
21c20b951d
Help: Document campaign 'level' and 'difficulty'. (#3781) 2018-12-29 17:11:57 +00:00
josteph
35828b1d32 Help: Document more cases lit terrains. Linkify oasis 2018-11-18 11:02:55 +00:00
Celtic Minstrel
7b358440f6 Merge pull request #2664 from holius-fr/liminal_bonus 2018-11-17 13:04:49 -05:00
Iris Morelle
e58098609d Hide Editor help section
See isssue #2964.

[ci skip]

(cherry picked from commit 722637c59a)
2018-10-28 02:53:00 +00:00
Charles Dang
05ad78335d Help: removed sort_sections key with invalid value
[ci skip]

At no point is "generated" checked for as value of that key (the only valid value is "yes").
"generated" is a valid value for sort_topics, however. As for whether we want sorting or not
for Eras, I don't think so. The era order as displayed seems logical enough since it groups
each era and Age of Heroes variant together.

(cherry picked from commit 6b20ccdb62)
2018-10-28 02:52:54 +00:00
josteph
5e92b8e80d Help: Fix some broken links in the Gameplay section.
The abilities help topic id structure is intentional, according to
generate_ability_topics() (src/help/help_impl.cpp:514).
2018-10-22 00:10:28 +00:00
josteph
606ac386e1 Help: Fix fatal error in the "Recruiting and Recalling" page.
The error message was, upon opening the page:

```
Parse error when parsing help text: 'Error when parsing help markup as WML: 'Unexpected characters after variable name (expected , or =)
at <unknown>:2''
```

The <bold> tag in question can be seen on old_master_20181015 here:
71a6daf961/data/core/help.cfg (L199)
2018-10-22 00:04:35 +00:00
Jyrki Vesterinen
f6eac474c3 Help: update the "Installing Add-ons" page (addresses #2703)
[ci skip]

(cherry-picked from commit fb5f46c52a)
2018-10-07 03:24:01 +00:00
Jyrki Vesterinen
81ea32e4d4 Help: document cores (#2703)
[ci skip]

(cherry-picked from commit 40205c55fb)
2018-10-07 03:24:01 +00:00
Wedge009
8516e1f1e7 Update text to match game-play changes (fixes #2950).
[ci skip]

(cherry-picked from commit d85e2a2886)
2018-10-07 03:20:34 +00:00
Wedge009
0b98ddd96b Update text to match changes in dialogues (fixes #2882).
[ci skip]

(cherry-picked from commit f1bcdc7f1b)
2018-10-07 03:20:34 +00:00
fsd
78c71dc753 update help to reflect the liminal change 2018-03-16 09:46:57 +01:00
Charles Dang
044dedb43a Removed Credits section from help browser (fixes #2555)
I had disabled this when I redid the End Credits screen in GUI2 (476027f) since (IIRC)
I didn't want to figure out about parsing the new config-based credits storage. The topic
remained in Help, empty. We've decided the new End Credits screen is a better method for
viewing the credits anyway, so I'm now removing the topic.
2018-03-03 21:27:19 +11:00
Matthias Krüger
b11d3fdcbe fix a bunch of typos found by codespell in data directory.
https://github.com/lucasdemarchi/codespell
2018-02-06 23:03:06 +11:00
josteph
4ac110b8b5 core: Fix grammar and punctuation
Split from #2390 at @GregoryLundberg's request.
2018-02-03 14:04:42 +11:00
Bär Halberkamp
ce05a573cf Run wmlindent 2016-09-15 18:04:37 +02:00
ln-zookeeper
15241cd0a6 Convert remaining – to × in strings describing attack stats 2016-09-07 10:43:30 +03:00
Bär Halberkamp
4e71bbe448 Generate trait help instead of hardcoding
Introduces a new key "help_text=" in [trait]
2016-07-29 18:44:10 -04:00
ln-zookeeper
626bf687a1 Re-simplified explanation of healing, with nicer formatting 2016-03-04 18:35:36 +02:00
Vasya Novikov
fa7a342c2f help.cfg: healing clarification 2016-02-18 01:26:23 +03:00
ln-zookeeper
59ba795de4 Mention lvl0 units as the exception to ZoC generation 2016-02-01 22:40:44 +02:00