Skip to content

Inline comments rewrite: Theme colors  #382

Closed
@swebra

Description

@swebra

While developing my own theme, I have spent some time trying to improve the inline comments for the theme colors. I have re-ordered the colors into an arrangement that makes a little more sense to me, and with the help of @Fuhrmann's theme builder, I have written comments for each individual color value.

This does not necessarily need to be the final version of these comments, but hopefully it's a good enough start to keep any further theme developers from having to figure these out on there own.

# Colors
# * Accepted formats:
#   * The following CSS formats: #RGB, #RRGGBB, rgb(R,G,B), rgba(R,G,B,A)
#     Notes:
#     * Negative values are not accepted
#     * The rgba() form is accepted but the alpha component is forced to 100%
#     * More info at https://www.w3.org/TR/css3-color/#colorunits
#   * Both "Basic" and "Extended" color keywords are supported
#     https://www.w3.org/TR/css3-color/#svg-color
# * Examples for the red color:
#     color_accent = #ff0000
#     color_accent = rgb(255, 0, 0)
#     color_accent = rgb(100%,0,0)
#     color_accent = rgb(1.0, 0, 0)
#     color_accent = red
# * Tips:
#   * the config value interpolation supported by Keypirinha may come handy
#     here as shown as an example in some of the values below.
#     Example:
#       color_title = ${color_foreground}
#   * an online tool may be helpful to vizualize the color codes
#     https://www.w3schools.com/colors/colors_picker.asp
# * General Colors:
#   * "color_background" is the background color of the LaunchBox's container
#   * "color_foreground" is the main font color used in the LaunchBox
#   * "color_textbox_back" is the background textbox color for the typed text
#   * "color_faded" is a legacy value that has no effect, but should be defined
#     in your theme for consistency.
# * List Colors:
#   * "color_listitem_back" is the background color for the listed items
#   * "color_listitem_title" is the text color of a listed item's title
#   * "color_listitem_desc" is the text color of a listed item's description
#   * "color_listitem_tips" is the color of a listed item's tips (Dial numbers,
#     the number of actions, etc.)
# * Selection Colors:
#   * "color_accent" is the color used by "list_selmark", the selection
#     indicator
#   * "color_listitem_selected_back" is the background color for the selected
#     item
#   * "color_listitem_selected_title" is the text color of the selected item's
#     title
#   * "color_listitem_selected_desc" is the text color of the selected item's
#     description
#   * "color_listitem_selected_tips" is the color of a listed item's tips (Dial
#     numbers, the number of actions, etc.)
# * Other Colors:
#   * "color_title" is the color used by the title in actions view (top left
#     text when you "ctrl+enter" on a selected item)
#   * "color_status" is the color used by "status", the bottom status bar
#   * "color_warn" is the color used by ERROR items
#
#color_background = #484848
#color_foreground = #f2f2f2
#color_textbox_back = #303030
#color_faded = #a2a2a2
#
#color_listitem_back = #383838
#color_listitem_title = ${color_foreground}
#color_listitem_desc = ${color_faded}
#color_listitem_tips = ${color_faded}
#
#color_accent = #a6e5ff
#color_listitem_selected_back = #2f2f2f
#color_listitem_selected_title = ${color_accent}
#color_listitem_selected_desc = ${color_foreground}
#color_listitem_selected_tips = ${color_accent}
#
#color_title = ${color_foreground}
#color_status = ${color_faded}
#color_warn = #eb6420

My only other suggestions would maybe be some variable reworking, but I understand that backwards compatibility is important. Considering that any theme can declare their own local variables, maybe having color_legacy being required for distribution is unnecessary. I also find color_titled to be a little unintuitive, though I don't have any better suggestions other than color_actions_title. Finally, if we are being nitpicky, maybe color_listitem_selected_x could be shortened to something like color_selecteditem_x, but that's very minor.

Thanks as always for your continued support!

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions