Fixing Confusing Visual Cues In Zeal Offline Documentation Browser

in linux •  8 months ago


I am learning to code on Linux. I use the Interwebs to find answers all the time, but I view the official documentation using the offline docset viewer Zeal as an alternative to Dash for macOS. The problem I ran into was the ambiguity of the visual cues (read icons). When I do a search for "some method" with the documentation for both Python 2 and Python 3 installed it is difficult to know which docset the data is coming from. Solution for Zeal 0.6.0 installed on Ubuntu 18.04:

  1. Open ~/.local/share/Zeal/Zeal/docsets/Python_2.docset in your file browser (I assume all docsets will be setup in a similar way)
  2. Open icon.png and icon@2x.png in your favorite image editor and edit them. I chose to desaturate the Python 2 icons because it seemed like a logical representation of it being the older information.

Now when I do a search, the icons clearly show which docset I am pulling my information from as shown below.


Authors get paid when people like you upvote their post.
If you enjoyed what you read here, create your account today and start earning FREE STEEM!
Sort Order:  

That's really cool :)

What made you switch to Linux (or stay)? I dual-boot, but I haven't found any reason so far to switch from Windows.


Long story short, Windows gets on my nerves and macOS is getting there...Apple in general is really getting annoying. I have an entry level HP laptop and Linux is much more efficient with the limited resources. At first I thought it would be an experiment, and now I cannot imagine going back to Windows. In the end, there are pros and cons to each OS. I still have a Mac Mini that the family uses, I used to have Windows running in a VM, but I lost it in an upgrade and have not needed it in months.


Do you play games? That's the one reason that I could never switch, I've always had trouble with WINE.


I am not a gamer so that is not a concern. There is one piece of software for which there is no 1:1 equivalent on the Linux side, but it runs on my Mac and iPhone so when I need it I use it there...because I could not get it to work using WINE. I know there are lots of people that disagree, but WINE has always been so hit and miss for me that I do not even bother with it.