YaST Widget Demo

This repository is a demo for most of the widgets provided by the YaST user interface.

The main purpose is to provide an easily accessible sample of the widgets for editing Qt widget style sheets.

Building and Installing

• Make sure the yast-rake Ruby gem for your ruby version is installed (ruby2.7-rubygem-yast-rake at the time of this writing):

  sudo zypper install "ruby*-rubygem-yast-rake"
  

• Install:

  sudo rake install
  

How to Run

• Graphical (Qt) version:

  yast2 widget_demo
  

  or

  yast2 widget_demo_no_wizard_steps
  

• Text-based (NCurses) version:

  yast widget_demo
  

Testing in Installation

This demo application is also included in the openSUSE Tumbleweed installer and will be included in the openSUSE Leap 15.4 and SUSE Linux Enterprise 15 SP4 products.

1. Press the Ctrl+Shift+Alt+C key in graphical installation or Ctrl+D Shift+C in text mode installation anytime during the installation
2. Press the Expert Console button
3. In the displayed terminal run the widget_demo command to start the application

Running in a Docker Container

You can run the widget demo also in a Docker container, see more details in docker/README.md.

Permissions

No root privileges are required for this YaST module.

Using a Different Widget Style Sheet

The Qt UI uses one of the .qss widget style sheets in /usr/share/YaST2/theme/current/wizard. The default is style.qss.

Set the Y2STYLE environment variable to use a different style sheet:

Y2STYLE=installation.qss yast2 widget_demo

Once the demo is running, you can use the style sheet editor with Ctrl-Shift-Alt-S.

Screenshot

More screenshots at #2

Reference

• Qt widget style sheet reference

• YaST QSS for SLE

• YaST QSS for openSUSE Leap 15.3

  (switch to another branch in that repository for the theme of a different openSUSE distribution)

• YaST UI reference documentation

• YaST UI examples

• YaST documentation at readthedocs.io