= Welcome to Lucide =
[[PageOutline]]

Lucide is a plugin based document viewer for eComStation. In its first incarnation it supports PDF, !DjVu and JPEG files but new document types can easily be added to it.

Lucide itself is currently released as binary-only, the plugin sourcecode is available so developers can use this as a base for more plugins. The binary is not available at netlabs.org, you need an eComStation account to get it.

== Mailinglist ==
We did two mailinglists for Lucide, one for users and one for developers. If you want to join them please read [http://wiki.netlabs.org/index.php/Mailinglists the instructions] in our Wiki. You can also access them online:

 * http://news.gmane.org/gmane.org.netlabs.lucide.devel
 * http://news.gmane.org/gmane.org.netlabs.lucide.general

== Bugs & Features ==
Lucide is not yet a finished product, some features are missing and some are not fully tested yet. If you encounter any bugs you are welcome to register it as a new [http://svn.netlabs.org/lucide/newticket ticket]. Please make sure you check the list of open tickets first to see if the bug was already registered once.
Also try to assign it to the correct component, it is quite easy to do with TRAC. 

Anonymous access to the ticket system has been restricted due to multiple attacks of stupid spammers we've been suffering from lately. In order to create a new ticket or comment the existing one, you need to login with your Netlabs login id.
If you do not have a login id, you can request one at [http://www.netlabs.org/en/site/member/member.xml].
We are sorry for inconvenience, but at the present time this is the only way to avoid extremely annoying spam. 
[[br]][[br]]

== Developers ==
While the core of Lucide is not released to the public the sourcecode for the plugins is freely available. This means third party programmers can contribute their own plugins for Lucide.
=== Plugin API ===
The plugin API is using SOM, this allows programmers to write their own plugin without the need of recompiling it every time a new Lucide release is done. It's up to the developer to decide if the plugin he/she writes will be open source or not, Lucide will work with both type of plugins.

Please read [wiki:LucidePluginsGuide How to write your own plugins for Lucide].

=== Plugin Sourcecode ===
You can download the sourcecode of all our plugins in one zip file. If you have any problems please post to the developer list.

 * [ftp://ftp.netlabs.org/pub/lucide/lucidesource-beta1.zip beta-1 sourcecode] - contains all external libraries (poppler, libdjvu, libjpg) and the source for all Lucide plugins. (Note: outdated!)

 * [http://www.eros2.info/download/lucide-tk-20070807.zip lucide-tk-20070807.zip] - latest headers and plugin sources (no external libraries).

=== Building Lucide ===

 * BuildingInstructions - this is not interesting for the common developer because you can't access the source :-)