Feature request: style the :guilabel: role

[wkschwartz]

As is visible on the demo site, the :guilabel: role has no styling different from normal paragraph text, leaving it hard to tell that it's different.

[choldgraf]

could you give an example of how this role is used? E.g. what would be some minimal rST that highlight the use of this role? Is it meant to look like a button or something?

alternatively - could you propose some CSS rules that would make it look as you would expect it to look?

[wkschwartz]

From the docs:

Labels presented as part of an interactive user interface should be marked using guilabel. This includes labels from text-based interfaces such as those created using curses or other text-based libraries. Any label used in the interface should be marked with this role, including button labels, window titles, field names, menu and menu selection names, and even values in selection lists.

Changed in version 1.0: An accelerator key for the GUI label can be included using an ampersand; this will be stripped and displayed underlined in the output (example: :guilabel:`&Cancel`). To include a literal ampersand, double it.

Here's an excerpt from how I'm using it to explain how to install MSVC:

One way to install it is to `download the Build Tools installer`_,
run it, select :guilabel:`C++ build tools` in the :guilabel:`Workloads` tab,
and click :guilabel:`Install`.

.. _download the Build Tools installer: 
   https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16

The Sphinx Read The Docs theme has the same demo site, rendered here, as pydata-sphinx-theme. The former's rendering of :guilabel: looks good ot me, but I don't know nothin' about colors and stuff. The CSS they use (and I have adopted as a stopgap in the meantime) is something like this

.guilabel {
	border: 1px solid #7fbbe3;
	background: #e7f2fa;
	font-size: 80%;
	font-weight: 700;
	border-radius: 4px;
	padding: 2.4px 6px;
	margin: auto 2px;
}

[choldgraf]

ah very cool! thanks for pointing to the RTD docs, I always forget those exist but they are super helpful 👍

and thanks for the suggestion, it is much appreciated!

[wkschwartz]

To be clear, there's also a distinct :menuselection: role. For example, I probably could have written

One way to install it is to `download the Build Tools installer`_,
run it, select :menuselection:`Workloads --> C++ build tools`,
and click :guilabel:`Install`.

[choldgraf]

nice - I've added the CSS you suggested here: #278