DjVu: A Tutorial

Configuring your Web Server for DjVu

Multipurpose Internet Mail Extensions (MIME)

MIME allows web developers to include documents other than HTML in their web pages. It is a standard way of associating other software (called helper applications) to file types. When you install the DjVu plug-in, this is automatically done for your browser. However, if you want to view DjVu files using direct linking, your web server must also support the MIME types. The DjVu MIME types are:

In order for the web server to correctly handle DjVu files, it must be configured to understand the MIME type.

If you do not have access to configure your web server, you need to embed the DjVu document in your web page as described in the previous chapters, or you need to contact your provider and instruct them to configure their web servers to support the new MIME type. We have provided a form letter to help you do this.

Configuring Your Web Server to Support DjVu

The following instructions show how to configure many of the popular web servers for the DjVu MIME type. If your web server is not listed, consult your web server documentation.

[IIS 4.0] - [Apache] - [NCSA HTTPd] - [O'Reilly Website] - [CERN HTTPD] - [Roxen Challenger/Spinner] - [Netscape] - [EMWAC] - [Webstar] - [Glaci HTTPd]

Internet Information Services 4.0

1. Open the Microsoft Management Console (MMC).
2. Right-click the Computer and choose Properties to open the Master properties for the server.
3. Select the File Types button to configure Multipurpose Internet Mail Extensions (MIME) mappings.
4. Click the New Type button in the File Types dialog box. In the File Type dialog box, type the following extension:

   djvu

5. In the Content Type (MIME) box, type:

   image/x.djvu

6. Click OK to commit to your changes.
7. Click the New Type button in the File Types dialog box. In the File Type dialog box, type the following extension:

   djv

8. In the Content Type (MIME) box, type:

   image/x.djvu

9. Click OK to commit to your changes, click OK to close the File Types dialog box, and then click OK to close the Master Properties dialog box.

Apache

For System Administrators^{[Note 1]}

1. Using a text editor, edit the file specified by the TypesConfig variable in the file [apache_root]/etc/httpd/conf/srm.conf usually [apache_root]/etc/mimes.types. Add the following line at the end of the file or where the other image/ entries are found^{[Note 2]}:

   image/x.djvu djvu djv

2. Save your changes, exit the file, and restart Apache.

For Users

1. Using a text editor, create a file named .htaccess in the same directory as your DjVu files.
2. Add the following line to the file:

   AddType image/x.djvu djvu djv

NCSA HTTPd^{[Note 1]}

1. Using a text editor, edit the file [httpd_root]/conf/mimes.types. Add the following line at the end of the file or where the other image/ entries are found^{[Note 2]}:

   image/x.djvu djvu djv

2. Save your changes, exit the file, and restart NCSA HTTPd.

O'Reilly Website

1. Click on the ORA Website yellow gear icon (right by the clock on the Taskbar), select Server Properties, and choose the Mapping tab.
2. In the List Selector section, select the Content Types button.
3. In the File Extension (class) field, type:

   .djvu

4. In the MIME Content Type field, type:

   image/x.djvu

5. Click Add, and then click Apply.
6. In the File Extension (class) field, type:

   .djv

7. In the MIME Content Type field, type:

   image/x.djvu

8. Click Add, and then click Apply. Click OK. Restart O'Reilly Website.

CERN HTTPD^{[Note 1]}

1. Using a text editor, edit the file [httpd_root]/conf/mimes.types. Add the following line at the end of the file or where the other AddType ... image/ entries are found^{[Note 2]}:

   AddType .djvu image/x.djvu binary AddType .djv image/x.djvu binary

2. Save your changes, exit the file, and restart CERN HTTPD.

Roxen Challenger/Spinner^{[Note 1]}

1. Use a text editor to edit the file [webserver_root]/etc/extensions. Add the following lines to the end of the file:

   djvu image/x.djvu djv image/x.djvu

2. Save your changes, exit the file, and restart Roxen Challenger/Spinner.

Netscape Web Servers^{[Note 1]}

1. Use a text editor to edit the file [netscape-server_root]\config\mime.types. Add the following line at the end of the file or where the other type= image/ entries are found^{[Note 2]}:

   type= image/x.djvu exts=djvu,djv

2. Save your changes, exit the file, and restart the Netscape web server.

EMWAC for NT^{[Note 1]}

1. Open the HTTP server Control Panel applet and click the New Mapping button.
2. Type the following into the extension field:

   djvu

3. Type the following into the text box for MIME type:

   image/x.djvu

4. Click OK.
5. Click the New Mapping button.
6. Type the following into the extension field:

   djv

7. Type the following into the text box for MIME type:

   image/x.djvu

8. Click OK, close the HTTP server Control Panel applet, and restart the EMWAC for NT web server.

WebSTAR/WebSTAR PS (Macintosh)

1. Choose the Suffix Mapping item in the WebSTAR Admin Settings window to open the Suffix Mapping Table.
2. To make a new Suffix Mapping entry, decide where you want it to be in the list. WebSTAR will use the first entry it can find. Then select the entry before the new entry, and click the New button.
3. Set Action to BINARY,
   set File Suffix to .djvu,
   set File Type to *,
   set MIME type to image/x.djvu,
   set Creator to *,
   and then click Add.
4. Set Action to BINARY,
   set File Suffix to .djv,
   set File Type to *,
   set MIME type to image/x.djvu,
   set Creator to *,
   and then click Add.
5. Click Update to apply the changes.

Glaci HTTPd (NetWare)^{[Note 1]}

1. Using a text editor, edit the file [glaci_root]\mimetype.cfg where [glaci_root] is usually sys:\etc. Add the following line at the end of the file or where the other image/ entries are found^{[Note 2]}:

   image/x.djvu djvu djv

2. Save the changes to the file.