Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
panel-plugins:xfce4-xkb-plugin:start [2019/11/10 14:28] – fixed image links kevinbowenpanel-plugins:xfce4-xkb-plugin:start [2025/01/09 01:09] (current) – Direct users to xfce4-settings:keyboard for the Settings menu screenshots and documenation newhoa
Line 1: Line 1:
-====== XKB ======+~~NOTOC~~ 
 +====== xfce4-xkb-plugin - multiple keyboard layout management ====== 
 +  * **[[#Usage|Usage]]** 
 +  * **[[#Limitations|Limitations]]** 
 +  * **[[#Screenshots|Screenshots]]** 
 +  * **[[#Latest Release|Latest Release]]** 
 +  * **[[#Source Code Repository|Source Code Repository]]** 
 +  * **[[#Reporting Bugs|Reporting Bugs]]** 
 + 
 +----
  
 ===== About ===== ===== About =====
Line 11: Line 20:
  
 NOTE: Lots of code was borrowed from the XfKC project by Gauvain Pocentek. NOTE: Lots of code was borrowed from the XfKC project by Gauvain Pocentek.
 +
 +----
  
 ===== Usage ===== ===== Usage =====
 +
 +  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
 +  - Right-click on the added plugin, select **Properties** to open the plugin's properties window. 
 +  - Right-click on the added plugin, select **Settings** to open the Xfce keyboard settings window.
 +
 Once the plugin is added to a panel, it displays the current keyboard layout configuration. Once the plugin is added to a panel, it displays the current keyboard layout configuration.
  
-The keyboard layouts, keyboard model and layout change shortcut key can be configured from the settings dialog. A default layout is selected through the list of the configured layouts and this layout is used for all new windows.+The **Properties** window allows configuration of the plugin's appearance, as well as whether the plugin manages the layout globally (one common layout for all windows), per application or per window.
  
-The plugin can manage the layout globally (one common layout for all windows), per application and per window.+Selecting **Settings** opens **[[xfce:xfce4-settings:keyboard| xfce4-keyboard-settings]]** where overall desktop keyboard settings can be set. The keyboard layouts, keyboard model and layout change shortcut key can be configured from the settings window. A default layout is selected through the list of the configured layouts and this layout is used for all new windows.
  
 If more than three layouts are configured, then, when clicked, the plugin pops-up a menu with the available layouts. If there are two layouts configured, then the layout is changed right away with a click on the plugin. If more than three layouts are configured, then, when clicked, the plugin pops-up a menu with the available layouts. If there are two layouts configured, then the layout is changed right away with a click on the plugin.
Line 25: Line 41:
 The plugin handles runtime layout configuration changes and configures it's settings accordingly. The plugin handles runtime layout configuration changes and configures it's settings accordingly.
  
-===== Limitations and bugs =====+---- 
 + 
 +===== Limitations =====
  
 Currently the plugin cannot handle well most of the XKB options. Actually it will overwrite all but the first group: option found in the running configuration. This will change in future versions. Currently the plugin cannot handle well most of the XKB options. Actually it will overwrite all but the first group: option found in the running configuration. This will change in future versions.
 +
 +----
 +[[|Back To Top]]
  
 ===== Screenshots ===== ===== Screenshots =====
-  * The plugin in action:\\ 
-{{:panel-plugins:xfce4-xkb-plugin-0.5.3-plugin.png|:projects:panel-plugins:xfce4-xkb-plugin-0.5.3-plugin.png}} 
  
-  * The settings dialog:\\ +Below you fill find screenshots of the Xkb Plugin Panel Indicator and the Xkb Plugin Properties dialog. As the Settings menu item is simply a launcher for xfce4-keyboard-settings, which is where you can set system-wide keyboard layouts and settings, please see the **[[xfce:xfce4-settings:keyboard| Keyboard section of xfce4-settings]]** for screenshots and further documentation of the Settings dialog window. 
-{{:panel-plugins:xfce4-xkb-plugin-0.5.3-settings.png|:projects:panel-plugins:xfce4-xkb-plugin-0.5.3-settings.png}}+ 
 +<figure "Xkb Plugin Panel Indicator and Dropdown Selection Menu"> 
 +{{:panel-plugins:xkb-plugin_panel_indicator_dropdown.png|Xkb Plugin Panel Indicator and Dropdown Selection Menu}} 
 +</figure> 
 + 
 +<figure "Xkb Plugin Layout Properties Dialog Window"> 
 +{{:panel-plugins:xkb-plugin_layout_properties.png|Xkb Plugin Layout Properties Dialog Window}} 
 +</figure> 
 + 
 +[[|Back To Top]] 
 +---- 
 + 
 +===== Latest Release ===== 
 + 
 +{{rss>https://archive.xfce.org/feeds/project/xfce4-xkb-plugin 1 date 2h}} 
 + 
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-xkb-plugin/-/blob/master/NEWS|Read the CHANGELOG]] 
 + 
 +  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-xkb-plugin/|Download current release]]** (older versions of this component are also available here) 
 + 
 +[[|Back to Top]] 
 + 
 +----
  
-===== Releases ===== 
-==== Old ==== 
-  * [[http://archive.xfce.org/src/panel-plugins/xfce4-xkb-plugin/0.5/|See Archives]] 
-==== Current ==== 
-  * [[http://archive.xfce.org/src/panel-plugins/xfce4-xkb-plugin/0.5/xfce4-xkb-plugin-0.5.4.3.tar.bz2|xfce4-xkb-plugin-0.5.4.3.tar.bz2]] 
 ===== Dependencies ===== ===== Dependencies =====
 +
   * libgtk+ >= 2.6.0   * libgtk+ >= 2.6.0
   * libxfce4panel >= 4.8.0   * libxfce4panel >= 4.8.0
Line 49: Line 86:
   * librsvg >= 2.18   * librsvg >= 2.18
   * libwnck >= 2.12   * libwnck >= 2.12
 +
 +----
 +
 +===== Source Code Repository =====
 +
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-xkb-plugin]]
 +
 +----
  
 ===== Reporting Bugs ===== ===== Reporting Bugs =====
  
-Bugs should be reported to the [[http://bugzilla.xfce.org|Xfce bug tracking system]] (product ''Xfce Panel Plugins'', component ''xkb'').+  * **[[:panel-plugins:xfce4-xkb-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports 
 + 
 + 
 +[[|Back To Top]] 
 +---- 
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]