Thank you for using Bib2Web! The following is meant to help you clear up some problems that occur sometimes when people serve DjVu documents for the first time.

If you get garbled output when attempting to view DjVu documents from your web page using Netscape, it means your web browser software is not configured to serve the DjVu mime.type. The bib2web automatically includes a hidden file named .htaccess in the output tar or zip file. This hidden file tells your web server to serve .djvu files with the image/x.djvu mime.type. However, certain types of web servers do not recognize this file, in which case you must ask your system administrator to configure your web server to serve DjVu files properly.

If your Web server runs the Apache web server, please follow the instructions below. If your server runs another Web server than Apache, please visit http://djvuzone.org/support/tutorial/chapter-serving.html#mime2 for instructions on how to configure it to serve DjVu documents.

Configuring Apache to serve DjVu documents.

  1. login as root

  2. Using a text editor, edit the file mimes.types file 
     used by your Web server (generally /etc/mime.types) 
     and add to following line to it:

              image/x.djvu djvu djv

     If there is no file /etc/mime.types, look for the values of
     TypesConfig variable in your Web server's configuration file
     (generally /etc/httpd/conf/httpd.conf or /etc/httpd/conf/srm.conf).
     The value of TypesConfig is the name of the mime.types file used
     by your server.

  3. Save your changes, exit the file, and restart Apache
     (generally this mean typing "/etc/rc.d/init.d/httpd restart").

You will find a directory named "log" in your output package. There are two log files here, "friendly.log" and "generator.log", which contain information about the file upload/download and the DjVu conversion processes. These log files may be of use in debugging any problems with the DjVu conversion or the assigment of meta-information about the files.