[v1.2] New re-design with icons only instead of labels.
[indicator-keyboard-led.git] / README.md
index efa8f2f..cf90a7b 100644 (file)
--- a/README.md
+++ b/README.md
@@ -6,9 +6,6 @@ Num lock and Scroll lock) without requiring any mouse or keyboard action. It
 also allows the lock keys to be toggled with mouse clicks, which could be
 useful for keyboards without Scroll lock keys or malfunctioning keyboards.
 
-**Note**: This indicator is known to not work on Xfce / Xubuntu.
-For more details, see [#6](https://github.com/adrianiainlam/indicator-keyboard-led/issues/6).
-
 ## Screenshots
 
 ![indicator default][sc1]  
@@ -19,9 +16,6 @@ off.
 Menu of the indicator, shown on click. The locks can be toggled by clicking
 the respective item in the menu.
 
-![indicator short][sc3]  
-Alternative (short) appearance of the indicator.
-
 ## Installation from Ubuntu PPA
 
     sudo add-apt-repository ppa:adrianiainlam/indicator-keyboard-led
@@ -31,14 +25,6 @@ Alternative (short) appearance of the indicator.
 After installation the postinst script will prompt you for preferences
 configuration. These config are explained here:
 
-### Short label
-
-The default appearance of the indicator has long labels:  
-![⚫Num ⚫Caps ⚫Scroll][sc1]
-
-On small displays it may be preferable to use short labels:  
-![⚫N ⚫C ⚫S][sc3]
-
 ### Order
 
 This option allows you to reorder the locks and also to hide
@@ -48,24 +34,18 @@ Use a string consisting of zero or one occurrence of the
 characters 'N', 'C' and 'S' to set this option.
 
 For exampe, the default order is "Num Caps Scroll".  
-![⚫Num ⚫Caps ⚫Scroll][sc1]
+![Num Caps Scroll][sc1]
 
 **CNS** changes this to "Caps Num Scroll".  
-![⚫Caps ⚫Num ⚫Scroll][sc4]
+![Caps Num Scroll][sc4]
 
 **NC** hides Scroll lock from the default appearance.  
-![⚫Num ⚫Caps][sc5]
-
-**C**, combined with the previous *short* option,
-would give a very compact Caps lock indicator.  
-![⚫C][sc6]
+![Num Caps][sc5]
 
 [sc1]: screenshots/sc1.png
 [sc2]: screenshots/sc2.png
-[sc3]: screenshots/sc3.png
 [sc4]: screenshots/sc4.png
 [sc5]: screenshots/sc5.png
-[sc6]: screenshots/sc6.png
 
 ### xdotool
 
@@ -109,7 +89,7 @@ It seems to be a common problem that Scroll Lock is not usable in Ubuntu.
 To solve this, do the following (assuming US keyboard):
 
  >     # backup your symbols file
- >     sudo cp /usr/share/X11/xkb/symbols/us{,.distribution} 
+ >     sudo cp /usr/share/X11/xkb/symbols/us{,.distribution}
  >
  > Add the following line in the `xkb_symbols "basic" {` section. Do not worry
  > if that second line is not there, it is only there for some languages and
@@ -117,7 +97,7 @@ To solve this, do the following (assuming US keyboard):
  >
  >     ...
  >         modifier_map Mod3   { Scroll_Lock }; <==<< Add this line
- > 
+ >
  >         include "level3(ralt_switch)" <==<< before this line
  >     };
  >
@@ -156,13 +136,26 @@ is correct and is an executable regular file.
 
 ## Localization
 
-As motivated by Issue #1, this script has been localized to French (with
-the assistance of Wikipedia and Google Translate). Corrections to the
-translation, as well as translations to other languages, are welcome.
-Feel free to create a pull request or open an issue.
+Unfortunately, in order to work-around labels not being shown on newer
+non-Unity-based Ubuntus, I have re-designed the indicators to be based
+purely on icons instead. This means there will no longer be labels to
+localize, and I instead have hardcoded icons.
+
+The icons are SVGs so you can still manually edit them if you want.
+Look for the `<text>` tag at the end of the SVGs.
+
+The menu items shown on click are still localized.
+
+I have included a screenshot below to show the old design (version 1.1)
+which you can still install manually if you wish.
 
-![indicator default, French locale][sc7]  
-Default appearance in a French locale.
+> As motivated by Issue #1, this script has been localized to French (with
+> the assistance of Wikipedia and Google Translate). Corrections to the
+> translation, as well as translations to other languages, are welcome.
+> Feel free to create a pull request or open an issue.
+>
+> ![indicator default, French locale][sc7]  
+> Default appearance in a French locale.
 
 [sc7]: screenshots/sc7.png
 
@@ -171,7 +164,7 @@ Default appearance in a French locale.
 The program "indicator-keyboard-led.py" is released under the MIT License.
 Please refer to the file for the full text of the license.
 
-The icon "indicator-keyboard-led.svg" is released to the public domain.
+The icons "indicator-keyboard-led*.svg" are released to the public domain.
 
 ## Credits
 
@@ -179,7 +172,7 @@ I would like to thank [Tobias Schlitt](https://github.com/tobyS), who wrote
 [indicator-chars](https://github.com/tobyS/indicator-chars) which I used
 as a reference when writing this software.
 
-The icon used in the indicator (indicator-keyboard-led.svg) is modified
+The icons used in the indicator (indicator-keyboard-led*.svg) are modified
 from the file "emblem-readonly.svg" by
 [Jakub Steiner](http://jimmac.musichall.cz)
 who released it to the public domain for the