Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clearer crafting search description #26452

Merged

Conversation

jbytheway
Copy link
Contributor

Summary

SUMMARY: Interface "Clearer crafting search help window"

Purpose of change

The current help window for crafting search is confusing to newcomers. The special characters are presented in two ways, with the syntax away from the description.

Also, people generally try q when they want Q.

Describe the solution

New window:
cata-crafting-search-2

  • Swap q and Q.
  • Reorganise the search window so that examples are next to descriptions.
  • Change colour scheme to highlight relevant words.
  • Assemble the content from a table of small strings rather than one large one. This should make it easier to add more in the future (translators will not have to retranslate the whole thing).

I've implemented my own "align strings in columns of the correct width" code here, which perhaps already exists elsewhere, but I couldn't find it. display_table does something similar, but not the same.

Fixes #26311.

Describe alternatives you've considered

We could have a better description without swapping q and Q, but I really think they should be swapped.

Additional context

I noticed that the keys used for searches are hardcoded and cannot be changed in translation. That may not be ideal, but that's not something I want to address here.

@jbytheway
Copy link
Contributor Author

Build failures because master is broken right now.

@jbytheway jbytheway force-pushed the crafting_search_description branch from b721924 to 7fbd822 Compare October 30, 2018 17:02
@jbytheway
Copy link
Contributor Author

Rebased on hopefully-fixed master.

@jbytheway jbytheway force-pushed the crafting_search_description branch from 7fbd822 to 7d1bf1f Compare October 31, 2018 21:36
@mlangsdorf mlangsdorf added Info / User Interface Game - player communication, menus, etc. [C++] Changes (can be) made in C++. Previously named `Code` <Bugfix> This is a fix for a bug (or closes open issue) labels Nov 1, 2018
@kevingranade
Copy link
Member

I don't know if it's related to your change, but I got this result:
2018-11-03-042401_1366x768_scrot

@jbytheway
Copy link
Contributor Author

I don't know if it's related to your change, but I got this result:

Interesting. I'm guessing that's on curses? Didn't test curses. Will look into it.

Try to present the options in a less confusing manner.

Now each one has a single row, rather than a definition and an example
somewhere else.

Colour highlighting to draw out the important parts.

Intended to be sorted roughly in decreasing order of how often you will
want them.

Fixes CleverRaven#26311.
@jbytheway jbytheway force-pushed the crafting_search_description branch from 7d1bf1f to c4ba469 Compare November 3, 2018 10:42
@jbytheway
Copy link
Contributor Author

It was a classic mistake in string constructor argument ordering. Unnoticed because the tiles build happens to render '\x11' as a space. Good catch. Should be fixed now.

@kevingranade kevingranade merged commit 5b5fa3f into CleverRaven:master Nov 3, 2018
@jbytheway jbytheway deleted the crafting_search_description branch November 4, 2018 21:35
@Pupsi-Mupsi
Copy link
Contributor

Soon after the last i18n-update (commit: 3e5c5a1) i found part of the 'german-crafting-search-help-window' - great work btw - already pretranslated. which imho could be very misleading, because you can't really search for h:ja / h:nein or m:ja / m:nein - at least one does not get any results out of those searches. Maybe in this particular case yes or no shouldn't be translatable. Alternatively they could be, if they would lead to the same results.

Personally, i don't feel that either hidden nor memorized work very well as search-filters. Searching for h:no for example just shows what you are already seeing without even searching. hidden and memorized could be excellent toggles though. "Press h or H and you can toggle between hidden or none hidden recipes..."

german-crafting-search-help-window -> post-3e5c5a1:
grafik

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
<Bugfix> This is a fix for a bug (or closes open issue) [C++] Changes (can be) made in C++. Previously named `Code` Info / User Interface Game - player communication, menus, etc.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants