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

Improve theming documentation #5180

Merged
merged 2 commits into from
Aug 22, 2021

Conversation

YuriSizov
Copy link
Contributor

@YuriSizov YuriSizov commented Aug 16, 2021

This is a rewrite of the GUI skinning/theming documentation, that builds upon #5162. I've written a new skinning tutorial that tries to explain the basic concepts of the control nodes and themes, and I've used the old article as a piece on the theme editor which I've also improved upon.

To wrap the whole thing a bit better I've also changed the index page for the user interface tutorials.

This probably needs some editing for style and whatnot, but from the content standpoint it should be better than we had before.


This shouldn't be cherrypicked for 3.4, as it features some concepts only available in master. It'd be better if I made a separate 3.4 PR when we finalize this one.

@Calinou Calinou marked this pull request as draft August 17, 2021 00:36
@YuriSizov YuriSizov marked this pull request as ready for review August 17, 2021 21:11
@YuriSizov
Copy link
Contributor Author

I've added a screenshot of a real game using heavily skinned controls, looks something like this now (permission, and that specific image, granted by developers):

image

Copy link
Member

@mhilbrunner mhilbrunner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small notes.

tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
@mhilbrunner
Copy link
Member

Also, cc @skyace65 as you've recently spent time on this and are familiar with the topic

Copy link
Contributor

@hpnrep6 hpnrep6 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor suggestions on wording, punctuation, and oxford comma usage.

tutorials/ui/gui_using_theme_editor.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_using_theme_editor.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_using_theme_editor.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_using_theme_editor.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_using_theme_editor.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
tutorials/ui/gui_skinning.rst Outdated Show resolved Hide resolved
@YuriSizov
Copy link
Contributor Author

Thanks, @hpnrep6. I've rephrased a couple of places completely based on your feedback.

@mhilbrunner
Copy link
Member

I think this is good to go :)

Thanks for working on this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants