# Document $Id: README,v 1.3 2006/05/02 13:19:55 dleidert Exp $ # Summary Important infos about the chemical-mime-data project.
- About chemical-mime-data
- Copyright and License
- Introduction and configuration
- Status information
- Associate your chemical application with a chemical MIME type
- Sources and Footnotes
The chemical-mime-data package is a collection of data files which tries give support for various chemical MIME types (chemical/x-*) on Linux/UNIX desktops, such as KDE  and GNOME . Chemical MIME's  have been proposed in 1995, though it seems they have never been registered with IANA . Most data is taken from the list of Henry Rzepa , but this compilation is written by Egon Willighagen and Daniel Leidert (see the AUTHORS file for a list of who has contributed to this project).
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
Please see the file COPYING or visit http://www.gnu.org to obtain a copy of the GNU Lesser General Public License.
See the files AUTHORS and THANKS for a list of who has contributed to this project.
Newer desktop systems need to know the MIME type to associate applications with it. Chemical application writers will use this feature as any other application developer too.
Newer GNOME (also ROX) desktops use the Shared MIME-info Database  to determine MIMEs. We provide a file chemical-mime-data.xml which has be installed into the 'packages' sub-directory. It follows the freedesktop.org specification . After running 'update-mime-database' the chemical MIME types are registered. To associate an icon for a MIME type, the icon has to installed into the hicolor-theme  and named, e.g.:
The syntax is easy:
If the icon naming scheme follows this direction, the MIME type is automatically associated with the icon. This should work for all systems and applications mentioned under >Status Information<. You will need the shared-mime-info package for your distribution 
Older GNOME desktops use the mime-info path with .keys and .mime files to determine MIME stuff. Icons are installed into the pixmaps directory. GNOME 2.6
KDE desktops use the mimelnk path with .desktop files to determine MIME stuff. The .desktop format is developed by the freedesktop.org project  and specified on . These files can be validated with the desktop-file-utils tool 'desktop-file-validate'.
If you want to know more about status, then have a look at . There you will find the following status notes about the shared MIME info database:
- ROX has used the system since ROX-Filer 1.3.3 (July 2002).
- GTK has support since version 2.4 (Mar 2004).
- GNOME uses the system since version 2.8 (Sep 2004).
- XFCE uses the system since version 4.2.0 (Jan 2005).
- KDE is planning to support it for their next major release. (Note from authors: This is hopefully KDE 3.4.)
To build and install chemical-mime-data from CVS:
- install autoconf, automake, intltool/gettext, xsltproc
- get the CVS sources
- run autogen.sh (./autogen.sh)
- see next part ...
To build and install chemical-mime-data from release tarballs:
- Get the required applications:
- intltool/gettext, pkg-config
- RSVG2 or imagemagick
- gnome-mime-data, shared-mime-info
- Configure and compile:
(see ./configure --help for possible configure options) $ ./configure [options-you-like-most-here] $ make
- Install everything: $ su # make install
($: means user-shell, #: means root-shell)
The file INSTALL contains some generic installation instructions.
To associate the chemical MIME types with a special application, you need to do the following:
- KDE: , newer freedesktop.org support in $datadir/applications/kde
- GNOME (all versions): 
The desktop-file-utils  package contains command-line applications to validate, manipulate and install .desktop files in $datadir/applications(/kde) and to update the database ($datadir/applications/mimeinfo.cache), which holds information about applications and associated MIME types.
 http://www.iana.org/assignments/media-types/  http://www.freedesktop.org/
 http://www.freedesktop.org/wiki/Standards_2fshared_2dmime_2dinfo_2dspec  http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html  http://freedesktop.org/Software/shared-mime-info  http://standards.freedesktop.org/desktop-entry-spec/latest/  http://www.kde.org/areas/sysadmin/fsh.php  http://www.gnome.org/learn/ (GNOME 2 Desktop System Administrator's Guide,
chapter 4 in your GNOME version)