Introducing Tome

2010/03/22

I have finally decided upon a name for the aforementioned documentation viewer for Linux that I previewed yesterday:

Tome

The rationale being that an existing Linux distro is  Tome of knowledge concerning system documentation, programming documentation etc I have yet to commit the code as I have a very busy schedule, a friend of mine is playing in a bar tonight, in less than an hour in fact, with a 20 minute bike ride and food still to do… However, I am still needing to do a lot but I will upload the code tomorrow night, hopefully i can get my head around  launchpad and “proper development procedures” by then. Of note it would be nice  to get some second opinions/help —first proper app you see— for:

  • Artwork — i can barely draw a circle in Inkscape 😉
  • Internationalisation
  • Code tidying
  • Parsing the “theList.txt”
  • Removing redundant entries

If you want to help drop us a line. I have created a launchpad project and my details should be there and will update it tomorrow night after work!

Also thanks to those behind: Quickly and Acire, I wouldn’t have been able to do something so fast so quickly.

Oh and yeah, here is the obligatory screen shot:


DocView Preview

2010/03/21

In recent weeks Ubuntu (or rather Jono Bacon) has been championing the cause of the Opportunistic Developer. As part of that drive, and for a while before, the community has developed several tools to aide the Opportunistic Developer in their goals and aims.  For example:

However one thing that is missing is within this landscape of developer aides is easy to access Developer documentation. That is a single app that presents the opportunistic developer with locally sourced docs that can hopefully help them with their project. To this end I decided to hack together such an application. It is presently called DocView (this is a tentative name) but an offical and proper name will be decided upon once I push the code to launchpad. Currently DocView is a simple python app that uses webkit to view a preselected choice of documentation that exists within the /usr/share/ directories.

Some of you might say:

What about DevHelp!?

DevHelp has pretty much exactly the same goals as my project that is providing developers with access to documentation, however, DevHelp is primarily aimed for GTK and Gnome and works with gtk-doc.  As such it does not include everything that exists within /usr/share , for instance: Doxygen and Java manuals are not included, while Python is. Moreover DevHelp integrates with a few apps such as Anjuta… so there is a bit of overlap. However I wish to keep this project quite simple at the moment.

Currently DocView is less than 2 hours old and is currently looking like this:

There is still a lot of work that still needs to be done on DocView. I still need to iron out several bits and pieces like:

  • How I am going to locate this documentation, currently, it is hardcoded as a list. Something which I want to avoid
  • How to group the items within the tree menu i.e.\ language, doc type
  • How to store the list of docs, CouchDB looks like the way to go.
  • And any other features that may be plausible for such a project.

I am also undecided given the substantial overlap with DevHelp if I should continue with this project. But who knows…