GNOME Vazaar
Thursday 20th 2008f November 2008

Site Index



About
Vazaar is an item manager applet for GNOME. 


General Information
    The idea behind this project is help you to keep sorted the info that you 
get with the less effort possible. Vazaar works with tags. Items must belong at 
least to one tag. The difference with others projects is that it lets you add 
files (browsing your hardisk or via drag'n'drop) and urls from internet. 

Vazaar will try to detect its MIME type. At this momemnt only can handle: 
plain text, images and urls (a very basic browser has been integrated into the
program).

   If you want help me (with suggestions, patches, translations, ideas, advices 
or with my english) please mail me at kaskaras@gmail.com
   
   Also, you can find more information in http://www.kaskaras.net/vazaar
   
   
Features:
  - Vazaar follows tags philosophy (one item can belongs to many categories or 
    tags)
  - Data about categories and items are stored in XML format under $HOME/.vazaar
    directory. Item's contents are stored in a centralized repository under 
    $HOME/.vazaar/store with a unique id (MD5 sum of its name). You can not 
    store two items with the same name
  - Foreach item, Vazaar detects its MIME Type and tries to handle it only if 
    it is:
     - An image (need improvements)
     - A webpage (minibrowser integrated -need improvements-)
     - Text (generic text, scripts, source, ...)
        - If Vazaar detects an item as script it uses syntax highlighting.
  - Drag and drop support
  - You can launch thoses applications which are associated to your items for 
    editing them or simply for opening them in your preferred application.
  - You can show/hide categories and item's menu navigation for a better 
    experience using this application
  - At the momment Vazaar is translated to english, spanish, czech and polish


Licensing
   Vazaar is Free Software and it is released under the terms of GPL (see 
   COPYING file for more details).


Compiling & installing
   This program requires gnome-core to be installed. To build it, additional
   libraries may be needed.

   Dependencies:
	libpanelapplet-2.0	(applet)
	glib-2.0 
	libgnome-2.0
	libgnomeui-2.0
	gtk+-2.0
	pango
	libglade-2.0 
	libxml-2.0
	gconf-2.0 
	firefox-dev/mozilla-dev	(embed mozilla)
	gtksourceview-1.0	(syntax highlighting)
	gnet-2.0		(MD5 operations)

   Compile:
	./configure --prefix=/usr && make
	It isn't a good idea to compile programs with prefix=/usr but I think is
	mandatory in order to this applet works fine.
	
	If you wish to debug this application you can use '--with-debug' and
	'--with-debugging-output' options in the configure script. When you 
	install the applet you must do the next thing: in a terminal execute
	'/usr/libexec/vazaar' first and after add the applet from the panel. In 
	this way, you will see the debuggin output.

   Installing:
   	'sudo make install' (if you are a normal user) or 'make install' as 
	root.


Running Vazaar
   You can run this application adding the applet from the GNOME panel under
   'Accesories' category. If you are unable to find it, log out from your current
   session and log in again.


Observations
   Previous versions used hierchical categories and they were stored in the same
   way. Now, Vazaar use a simple list of categories and read/save the XML data 
   in a different way.
   
   If you installed a previus version of this program (< 0.2.8) please, rename
   your .vazaar directory in order to do a clean installation. If you are
   worried because of you have a lot of data in Vazaar mail me and I'll try to
   make a special 'import' function to solve this specific topic.
   
   I've thought in this but I preffered leave it and concentrate my efforts in
   convert Vazaar from a simple application into a GNOME applet. Anyway, I think
   Vazaar is still in a early stage of development and many things can change
   although (I think) is already useful.

   Thanks for using Vazaar and contribute