1NSDEJAVU(1) DjVuLibre-3.5 NSDEJAVU(1)
2
6 nsdejavu - DjVu browser plugin
7
10 /usr/lib64/netscape/plugins/nsdejavu.so
11
14 The shared library nsdejavu.so uses the Netscape browser plugin API to
15 display DjVu images in in a number of popular web browsers. Different
16 web browsers provide various level of support for Netscape plugins.
17 Please check section "Browser Compatibility" for instructions on how to
18 enable the DjVu browser plugin.
19 The DjVuLibre browser plugin works by invoking a standalone viewer with
21 the special command line option -netscape. The plugin first searches a
22 program named djview. If this program cannot be found, it searches for
23 djview4 and finally djview3. It is always possible to override this
24 search strategy by setting the environment variable NPX_DJVIEW to the
25 full path of the desired executable.
26
30 Typing the URL of a recognized DjVu document in your web browser should
31 automatically invoke the DjVu browser plugin. Each browser uses dif‐
32 ferent methods to determine that a particular URL is in fact a DjVu
33 document. Web server normally provide a MIME type to web browsers.
34 The official MIME type for DjVu documents is image/vnd.djvu. For com‐
35 patibility with ancient versions of the DjVu viewer, it is common to
36 use instead the experimental MIME type image/x-djvu or image/x.djvu.
37 Web servers should be configured to send the proper MIME type for DjVu
38 documents. Most web browsers also recognize files ending with .djvu or
39 .djv as DjVu files.
40 An easy way to check if an http server is giving an appropriate con‐
42 tent-type is to invoke the following command with a URL corresponding
43 to an actual DjVu file on the server.
44 curl -u URL | grep Content-Type
46 The result should be one of the following, preferably the first.
48 Content-Type: image/vnd.djvu
50 Content-Type: image/x.djvu
51 Content-Type: image/x-djvu
52 Any other MIME type indicates a server misconfiguration.
54
58 The behavior of the DjVu browser plugin can be specified by augmenting
59 the URL using a syntax similar to that used by the CGI programs. This
60 syntax is described by the following template:
61 http://.../file.djvu?djvuopts&keyword=value&keyword=value&...
63 The DjVu browser plugin only recognizes keywords that appear after the
65 word djvuopts. The keywords recognized by each viewer are listed in
66 the man pages for djview3(1) and djview4(1) Unrecognized keywords are
67 ignored. The most common keywords are:
68 page=pagenum_or_pagename
70 Specify the initial page to be displayed. Page numbers are num‐
71 bered from 1.
72 zoom=zoomfactor
74 Specify the initial zoom factor. Legal values for zoomfactor
75 are shown in the below:
76 ┌───────────────────────────────────────────────────────┐
78 │number Magnification factor in range 10% to 999%. │
79 │one2one Select the "one-to-one" mode. │
80 │width Select the "fit width" mode. │
81 │page Select the "fit page" mode. │
82 │stretch Stretch the image to the plugin window size. │
83 └───────────────────────────────────────────────────────┘
84
87 You can integrate DjVu content on an HTML web page with the <embed>
88 tag. This method is that it will work even if your web server does not
89 support the DjVu MIME type. The CGI style flags can be directly used
90 as attributes of the embedding tag. The following example shows the
91 W3C standard syntax with the OBJECT tag:
92 <object data="myfile.djvu" type="image/x-djvu"
94 width="100%" height="100%" >
95 <param name="page" value="iii">
96 <param name="zoom" value="stretch">
97 This browser cannot render djvu data.
98 </object>
99 And this is the customary syntax with the EMBED tag:
101 <embed src="myfile.djvu" type="image/x-djvu"
103 width="100%" height="100%"
104 page="iii" zoom="stretch"></embed>
105
107 The DjVu browser plugin has been tested with several popular web
108 browsers:
109 NETSCAPE 4
111 The DjVu browser plugin is normally installed in directory
112 /usr/local/lib/netscape/plugins. This is sufficient to enable the DjVu
113 browser plugin because Netscape 4 always searches this directory for
114 plugins. You might have to first remove previous version of the
115 DjVuLibre plugin. Selecting menu Help->About Plugins in netscape dis‐
116 plays the current list of plugins. Previous versions of the plugin
117 might be installed in one of the following locations:
118 $HOME/.netscape/plugins/nsdejavu.so
120 /usr/lib/netscape/plugins/nsdejavu.so
121 /opt/netscape/plugins/nsdejavu.so
122 More complicated cases can be solved by creating a symbolic link into
124 your personal plugin directory:
125 cd $HOME/.netscape/plugins
127 ln -s /usr/lib/netscape/plugins/nsdejavu.so .
128 You must not copy nsdejavu.so but create a symbolic link. This is nec‐
130 essary because nsdejavu.so first locates its normal installation direc‐
131 tory by following the symbolic link. The Netscape plugin search rules
132 are explained in the README file that comes with the Netscape distribu‐
133 tion. Also check option -fix of program djview3.
134 NETSCAPE 6
136 The DjVuLibre plugin works nicely with Netscape 6.1 or better. It
137 seems that Netscape 6 only recognize plugins installed inside its own
138 plugin directory. This can be done using a symbolic link. Let us
139 assume that Netscape 6 is installed in /usr/local/netscape6. The fol‐
140 lowing commands should do the trick:
141 cd /usr/local/netscape6/plugins
143 ln -s /usr/lib/netscape/plugins/nsdejavu.so .
144 MOZILLA
146 The DjVuLibre plugin works nicely with Mozilla 0.9.5 or better. You
147 must establish a link from the Mozilla plugin directory. Assuming that
148 Mozilla is installed under /usr/lib/mozilla-1.1:
149 cd /usr/lib/mozilla-1.1/plugins
151 ln -s /usr/lib/netscape/plugins/nsdejavu.so .
152 You can then restart mozilla and select menu Help->About Plugins to
154 check whether the DjVuLibre plugin is properly recognized.
155 GALEON
157 Galeon internally uses the Mozilla rendering engine. Install the plug‐
158 in for Mozilla and it should also work for Galeon.
159 FIREFOX
161 The DjVuLibre plugin works nicely with Firefox or better. You must
162 establish a link from the Firefox plugin directory. Assuming that
163 Firefox is installed under /usr/lib/mozilla-firefox:
164 cd /usr/lib/mozilla-firefox/plugins
166 ln -s /usr/lib/netscape/plugins/nsdejavu.so .
167 KONQUEROR
169 The DjVuLibre plugin works with KDE-2.2 or better. You must first make
170 sure that konqueror recognizes the DjVU plugin. In Konqueror, select
171 Settings->Configure Konqueror. When the dialog appears, select the
172 icon Netscape Plugins. Make sure that directory /usr/lib/net‐
173 scape/plugins appears in the list of plugin directories. Then press
174 button Scan for new plugins. Clicking the Plugins tab button should
175 display a list of recognized plugins. Check that nsdejavu.so appears
176 there.
177 OPERA
179 The DjVuLibre plugin works with Opera-6. As explained in the Opera
180 software support pages, you must have the OpenMotif libraries
181 installed.
182
185 This program was written by Andrei Erofeev <andrew_erofeev@yahoo.com>
186 and was then improved by Bill Riemers <docbill@sourceforge.net> and
187 Léon Bottou <leonb@users.sourceforge.net>.
188
191 djvu(1), ddjvu(1), djview4(1) djview3(1)
192DjVuLibre-3.5 1/4/2006 NSDEJAVU(1)