office/okular
office/okular
1
0
Fork 0
mirror of https://invent.kde.org/graphics/okular synced 2024-11-05 18:34:53 +00:00
Code Issues Projects Releases Packages Wiki Activity

This package has been converted to DocBook :

Browse source 
- index.sgml and index.nif are converted into index.docbook
- html files are removed from the CVS tree
  they will be regenerated at packaging time
- logotp3.png has been removed from the CVS tree
  it will be stored in $KDEDIR/share/en/doc/common on the user's hard disk
  a symbolic link named "common" will point to that directory
- index.cvlog contains a summary of conversion warnings
  this file is necessary for manual cleanup
  it will be removed after the cleanup process

The Makefiles have not been updated yet ; they should make the "common" symbolic link at install time

All files are guaranteed to conform DocBook 3.1

svn path=/trunk/kdegraphics/doc/kdvi/; revision=31729
This commit is contained in:
Éric Bischoff 1999-10-24 19:39:06 +00:00
parent 62a6790662
commit 68ce972a11
15 changed files with 301 additions and 716 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
doc/index-1.html
View file

@ -1,48 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: USAGE</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-2.html">Next</A>
Previous <A HREF="index.html#toc1">Table of Contents</A>
</P>
<H3><A NAME="s1">1. USAGE</A></H3>
<P>The dvi viewer may be started using a file name to display a file, e.g:
<PRE>
kdvi somepath/paper.dvi
</PRE>
or without a file name as
<PRE>
kdvi
</PRE>
kdvi will then allow a file to be opened from a dialog or a menu of recently used files. This menu can also be popped up by clicking the File button with the right mouse button.
<P>The usual parameters handled by Qt and KDE applications also work:
<PRE>
kdvi -style windows -display :0 -geometry 400x400+0+0 -caption "DVI"
</PRE>
For integration with TeX the opened DVI file is automatically reloaded when changed.
<P ALIGN="RIGHT">
<A HREF="index-2.html">Next</A>
Previous <A HREF="index.html#toc1">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

51
doc/index-2.html
View file

@ -1,51 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Using keyboard</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-3.html">Next</A>
<A HREF="index-1.html">Previous</A>
<A HREF="index.html#toc2">Table of Contents</A>
</P>
<H3><A NAME="keyboard"></A> <A NAME="s2">2. Using keyboard</A></H3>
<P>Most keyboard commands are displayed in the menus as accelerator keys.
The defaults follow KDE standard when applicable.
You can define your prefered key bindings using the KDE standard key
configuration dialog available from the menu Options/Keys.
<P>Note also that you can reach most menu commands with a couple of key presses,
e.g. to show the Help/About is done by Alt-h a. You can also use
cursor keys to move around in menus.
Here is a list of invisible bindings (these are not configurable):
<UL>
<LI>SPACE moves down then to top of next page similar to Advance button.</LI>
<LI>Cursor keys scroll in obvious way. With Control-modifier they use a very
small step size for accurate control.</LI>
<LI>Home scrolls to top of page.</LI>
<LI>End scrolls to bottom of page.</LI>
</UL>
<P ALIGN="RIGHT">
<A HREF="index-3.html">Next</A>
<A HREF="index-1.html">Previous</A>
<A HREF="index.html#toc2">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

51
doc/index-3.html
View file

@ -1,51 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Moving around</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-4.html">Next</A>
<A HREF="index-2.html">Previous</A>
<A HREF="index.html#toc3">Table of Contents</A>
</P>
<H3><A NAME="s3">3. Moving around</A></H3>
<P>You can scroll the page with various ways: Using keyboard
<A HREF="index-2.html#keyboard">keyboard</A>
, using the scrollbars, using the scroller
widget located above the page list or by dragging the display with
left mouse button.
<P>The Page menu provides commands for changing the displayed page. A
primitive dialog is available to enter a page number. The scroller
widget allows you to move to the next or the previous page by clicking
the right or middle mouse button. The page list can be clicked with
the left mouse button to select a page.
<P>The button bar provides buttons to change pages: First, Previous,
Advance, Next and Last. In the middle of these is the Advance button
which can be used to easily read through many partly displayed pages:
it scrolls down until at the bottom of page and then to the top of the
next page.
<P ALIGN="RIGHT">
<A HREF="index-4.html">Next</A>
<A HREF="index-2.html">Previous</A>
<A HREF="index.html#toc3">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

50
doc/index-4.html
View file

@ -1,50 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Changing magnification</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-5.html">Next</A>
<A HREF="index-3.html">Previous</A>
<A HREF="index.html#toc4">Table of Contents</A>
</P>
<H3><A NAME="s4">4. Changing magnification</A></H3>
<P>The View menu offers entries to step through available magnifications:
Zoom in and Zoom out. The available magnifications corresponds to the
base resolution of the used pk-font and its reductions by integer
factors.
<P>The button bar presents these same commands plus two fixed
magnifications for quick selection. You can use these to switch
between a readable text size and a magnified view (there is no
separate magnifier window) or between a readable size and a full page
view. You can configure these fixed sizes with preferences dialog.
<P>One non-obvious feature is the selection of scaling center. You can
select with left mouse button the point on the page that does not move
(if possible) when changing the magnification. Use this by clicking
with left mouse button at the detail you want to see magnified and
then push the magnified view button.
<P ALIGN="RIGHT">
<A HREF="index-5.html">Next</A>
<A HREF="index-3.html">Previous</A>
<A HREF="index.html#toc4">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

43
doc/index-5.html
View file

@ -1,43 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Marking pages</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-6.html">Next</A>
<A HREF="index-4.html">Previous</A>
<A HREF="index.html#toc5">Table of Contents</A>
</P>
<H3><A NAME="s5">5. Marking pages</A></H3>
<P>You can mark pages for printing. The marks are visible in the page list.
<P>The current page can be marked by selecting the entry 'Mark page' from
the RMB popup menu of the viewing area. The page list gives more
options for marking: you can mark all, even, odd or current page and
unmark current or all pages and toggle marks using the RMB popup menu
of page list. Clicking or dragging the middle mouse button also
toggles the marks.
<P ALIGN="RIGHT">
<A HREF="index-6.html">Next</A>
<A HREF="index-4.html">Previous</A>
<A HREF="index.html#toc5">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

50
doc/index-6.html
View file

@ -1,50 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Printing</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-7.html">Next</A>
<A HREF="index-5.html">Previous</A>
<A HREF="index.html#toc6">Table of Contents</A>
</P>
<H3><A NAME="s6">6. Printing</A></H3>
<P>This version has a print setup dialog (available from the print
dialog) that lets you configure the printing method, n-up program,
printer names and spooler command. Printing method selects the
external program to use for printing. Available choices are dvips and
dvilj4. If you use dvips, you can also have an n-up program called to
make 2 or 4 pages per sheet. Select psnup (preferred) or mpage (may
work) if you have that installed in your system.
<P>You may add printer names that will be available in the print dialog.
<P>And last you can change the spooler command (defaults to lpr) that is
supposed to read standard input. Option -P is appended when printing
to nondefault printer.
<P>Having setup printing you can use the print dialog where you can
select the pages to be printed, which printer or file to use for
output and more.
<P ALIGN="RIGHT">
<A HREF="index-7.html">Next</A>
<A HREF="index-5.html">Previous</A>
<A HREF="index.html#toc6">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

63
doc/index-7.html
View file

@ -1,63 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: Q &amp; A</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-8.html">Next</A>
<A HREF="index-6.html">Previous</A>
<A HREF="index.html#toc7">Table of Contents</A>
</P>
<H3><A NAME="s7">7. Q &amp; A</A></H3>
<P>Q: Why is kdvi not displaying anything but a busy cursor?<BR>
A: It is
possible, that kdvi is searching for the pk-fonts from wrong places,
and this can be very time consuming if these include network mounted
filesystems. You can check for this with strace and see below for a
cure.
<P>Q: What can I do when kdvi does not find my PK-fonts?<BR>
A: You must have correct settings for resolution and Metafont mode.<BR>
If this does not help, you may set the field
'PK Font Path' in Preferences/Fonts to point to the list of directories
to be searched for pk-fonts:<BR>
/var/lib/texmf/fonts/pk/ljfour/:/some/other/place<BR>
You can make kdvi search recursively by adding an extra / at the end of
directory name:<BR>
/var/lib/texmf/fonts//<BR>
(This works like xdvi's XDVIFONTS environment variable.
There is also good (gnu info) documentation available for the kpathsea library
that kdvi uses for font searching.)<BR>
This makes kdvi usable when you have some other tex system than tetex and don't
have the texmf.cnf file.
<P>Q: How do I get the font generation to work?<BR>
A: If you like to enable automatic font generation using MakeTeXPK,
you must also supply correct Metafont mode in preferences dialog.
When automatic pk-font generation is disabled (menu option)
the missing fonts will be logged to file missfont.log in the current directory.
It is a good idea to check that the font generation commands in
missfont.log are correct before enabling font generation.
<P ALIGN="RIGHT">
<A HREF="index-8.html">Next</A>
<A HREF="index-6.html">Previous</A>
<A HREF="index.html#toc7">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

49
doc/index-8.html
View file

@ -1,49 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: BUGS</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-9.html">Next</A>
<A HREF="index-7.html">Previous</A>
<A HREF="index.html#toc8">Table of Contents</A>
</P>
<H3><A NAME="s8">8. BUGS</A></H3>
<P>Known bugs:
<UL>
<LI> Changes in paper size only get applied correctly after restart.</LI>
<LI> When showing PS the gs process seems to hang sometimes. Killing gs helps.</LI>
<LI> When showing PS the rendered image is not always updated. Scrolling the
view helps.</LI>
<LI> You need to have xdvi installed and accessible via the program search path.
You can replace the actual file with an empty executable though.</LI>
</UL>
<P>Unknown bugs:
<UL>
<LI>Probably many</LI>
</UL>
<P ALIGN="RIGHT">
<A HREF="index-9.html">Next</A>
<A HREF="index-7.html">Previous</A>
<A HREF="index.html#toc8">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

54
doc/index-9.html
View file

@ -1,54 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual: TO DO</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
Next <A HREF="index-8.html">Previous</A>
<A HREF="index.html#toc9">Table of Contents</A>
</P>
<H3><A NAME="s9">9. TO DO</A></H3>
<P>
<UL>
<LI>Document info dialog</LI>
<LI>More paper types, currently only those from xdvi are available</LI>
<LI>Better onitemne help</LI>
<LI>Internal printing using QPrinter</LI>
<LI>Redirect error messages to a window (partly done)</LI>
<LI>Better Postscript handling (currently not very robust)
<UL>
<LI>anti-aliasing</LI>
</UL>
</LI>
<LI>More background processing to keep the UI responsive</LI>
<LI>Magnifier window </LI>
<LI>Two page view</LI>
<LI>Support for more TeX specials</LI>
<LI>Network URL support</LI>
</UL>
<P>Anything else? Feel free to make suggestions and report any problems you have.
<P>Markku Hihnala<BR>
<A HREF="mailto:mah@ee.oulu.fi">mah@ee.oulu.fi</A><P ALIGN="RIGHT">
Next <A HREF="index-8.html">Previous</A>
<A HREF="index.html#toc9">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

28
doc/index.cvlog Normal file
View file

@ -0,0 +1,28 @@
=== LinuxDoc conversion errors ===================
-> Check if any important attributes have been left behind.
INPUT OUTPUT
Line Tag Line Tag
7 `HTMLURL' 0 `<affiliation><address><email><ulink>'
7 `' 0 `'
! Check the authorname (<collab><collabname> instead of <author><name>?)
15 `VERB' 0 `<literal remap="verb">'
! Check and correct manually
15 `VERB' 0 `<literal remap="verb">'
! Check and correct manually
17 `VERB' 0 `<literal remap="verb">'
! Check and correct manually
20 `' 0 `'
! check if reference ID keyboard was meant for a section (if not, change manually)
41 `REF' 0 `<xref>'
103 `NEWLINE' 0 `'
110 `NEWLINE' 0 `'
110 `NEWLINE' 0 `'
115 `NEWLINE' 0 `'
117 `NEWLINE' 0 `'
120 `NEWLINE' 0 `'
122 `NEWLINE' 0 `'
123 `NEWLINE' 0 `'
129 `NEWLINE' 0 `'
168 `NEWLINE' 0 `'
168 `HTMLURL' 0 `<ulink>'
=== NIF conversion errors ========================

273
doc/index.docbook Normal file
View file

@ -0,0 +1,273 @@
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="en">
<bookinfo>
<title>kdvi TeX DVI viewer - User Manual</title>
<authorgroup>
<author>
<firstname>Markku</firstname>
<surname>Hihnala</surname>
<affiliation>
<address><email><ulink url="mailto:mah@ee.oulu.fi">mah@ee.oulu.fi</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<keywordset>
<keyword>KDE</keyword>
<keyword>dvi</keyword>
<keyword>DVI</keyword>
<keyword>TeX</keyword>
<keyword>tex</keyword>
<keyword>LaTeX</keyword>
<keyword>latex</keyword>
<keyword>device-independent</keyword>
<keyword>viewer</keyword>
<keyword>dvi viewer</keyword>
<keyword>kdvi</keyword>
<keyword>xdvi</keyword>
</keywordset>
</bookinfo>
<chapter id="USAGE">
<title>USAGE</title>
<note>
<para>kdvi is a DVI viewer based on xdvik version 18f by many authors (see file AUTHORS). My additions to the earlier work are distributed under the GPL (see file COPYING).</para>
<para>This is an alpha release of kdvi. See file README.kdvi for release notes.</para>
</note>
<para>The dvi viewer may be started using a file name to display a file, e.g: <literal remap="verb">kdvi somepath/paper.dvi</literal>or without a file name as <literal remap="verb">kdvi</literal> kdvi will then allow a file to be opened from a dialog or a menu of recently used files. This menu can also be popped up by clicking the File button with the right mouse button.</para>
<para>The usual parameters handled by Qt and KDE applications also work: <literal remap="verb">kdvi -style windows -display :0 -geometry 400x400+0+0 -caption "DVI"</literal> For integration with TeX the opened DVI file is automatically reloaded when changed.</para>
</chapter>
<chapter id="keyboard">
<title>Using keyboard</title>
<para>Most keyboard commands are displayed in the menus as accelerator keys.
The defaults follow KDE standard when applicable.
You can define your prefered key bindings using the KDE standard key
configuration dialog available from the menu Options/Keys.</para>
<para>Note also that you can reach most menu commands with a couple of key presses,
e.g. to show the Help/About is done by Alt-h a. You can also use
cursor keys to move around in menus.
Here is a list of invisible bindings (these are not configurable):
<itemizedlist>
<listitem>
<para>SPACE moves down then to top of next page similar to Advance button.</para>
</listitem>
<listitem>
<para>Cursor keys scroll in obvious way. With Control-modifier they use a very
small step size for accurate control.</para>
</listitem>
<listitem>
<para>Home scrolls to top of page.</para>
</listitem>
<listitem>
<para>End scrolls to bottom of page.</para>
</listitem>
</itemizedlist>
</para>
</chapter>
<chapter id="Movingaround">
<title>Moving around</title>
<para>You can scroll the page with various ways: Using keyboard <xref linkend="keyboard">, using the scrollbars, using the scroller
widget located above the page list or by dragging the display with
left mouse button.</para>
<para>The Page menu provides commands for changing the displayed page. A
primitive dialog is available to enter a page number. The scroller
widget allows you to move to the next or the previous page by clicking
the right or middle mouse button. The page list can be clicked with
the left mouse button to select a page.</para>
<para>The button bar provides buttons to change pages: First, Previous,
Advance, Next and Last. In the middle of these is the Advance button
which can be used to easily read through many partly displayed pages:
it scrolls down until at the bottom of page and then to the top of the
next page.</para>
</chapter>
<chapter id="Changingmagnification">
<title>Changing magnification</title>
<para>The View menu offers entries to step through available magnifications:
Zoom in and Zoom out. The available magnifications corresponds to the
base resolution of the used pk-font and its reductions by integer
factors.</para>
<para>The button bar presents these same commands plus two fixed
magnifications for quick selection. You can use these to switch
between a readable text size and a magnified view (there is no
separate magnifier window) or between a readable size and a full page
view. You can configure these fixed sizes with preferences dialog.</para>
<para>One non-obvious feature is the selection of scaling center. You can
select with left mouse button the point on the page that does not move
(if possible) when changing the magnification. Use this by clicking
with left mouse button at the detail you want to see magnified and
then push the magnified view button.</para>
</chapter>
<chapter id="Markingpages">
<title>Marking pages</title>
<para>You can mark pages for printing. The marks are visible in the page list.</para>
<para>The current page can be marked by selecting the entry 'Mark page' from
the RMB popup menu of the viewing area. The page list gives more
options for marking: you can mark all, even, odd or current page and
unmark current or all pages and toggle marks using the RMB popup menu
of page list. Clicking or dragging the middle mouse button also
toggles the marks.</para>
</chapter>
<chapter id="Printing">
<title>Printing</title>
<para>This version has a print setup dialog (available from the print
dialog) that lets you configure the printing method, n-up program,
printer names and spooler command. Printing method selects the
external program to use for printing. Available choices are dvips and
dvilj4. If you use dvips, you can also have an n-up program called to
make 2 or 4 pages per sheet. Select psnup (preferred) or mpage (may
work) if you have that installed in your system.</para>
<para>You may add printer names that will be available in the print dialog.</para>
<para>And last you can change the spooler command (defaults to lpr) that is
supposed to read standard input. Option -P is appended when printing
to nondefault printer.</para>
<para>Having setup printing you can use the print dialog where you can
select the pages to be printed, which printer or file to use for
output and more.</para>
</chapter>
<chapter id="QampA">
<title>Q &amp; A</title>
<para>Q: Why is kdvi not displaying anything but a busy cursor?
A: It is
possible, that kdvi is searching for the pk-fonts from wrong places,
and this can be very time consuming if these include network mounted
filesystems. You can check for this with strace and see below for a
cure.</para>
<para>Q: What can I do when kdvi does not find my PK-fonts?
A: You must have correct settings for resolution and Metafont mode.
If this does not help, you may set the field
'PK Font Path' in Preferences/Fonts to point to the list of directories
to be searched for pk-fonts:
/var/lib/texmf/fonts/pk/ljfour/:/some/other/place
You can make kdvi search recursively by adding an extra / at the end of
directory name:
/var/lib/texmf/fonts//
(This works like xdvi's XDVIFONTS environment variable.
There is also good (gnu info) documentation available for the kpathsea library
that kdvi uses for font searching.)
This makes kdvi usable when you have some other tex system than tetex and don't
have the texmf.cnf file.</para>
<para>Q: How do I get the font generation to work?
A: If you like to enable automatic font generation using MakeTeXPK,
you must also supply correct Metafont mode in preferences dialog.
When automatic pk-font generation is disabled (menu option)
the missing fonts will be logged to file missfont.log in the current directory.
It is a good idea to check that the font generation commands in
missfont.log are correct before enabling font generation.</para>
</chapter>
<chapter id="BUGS">
<title>BUGS</title>
<para>Known bugs:
<itemizedlist>
<listitem>
<para> Changes in paper size only get applied correctly after restart.</para>
</listitem>
<listitem>
<para> When showing PS the gs process seems to hang sometimes. Killing gs helps.</para>
</listitem>
<listitem>
<para> When showing PS the rendered image is not always updated. Scrolling the
view helps.</para>
</listitem>
<listitem>
<para> You need to have xdvi installed and accessible via the program search path.
You can replace the actual file with an empty executable though.</para>
</listitem>
</itemizedlist>
</para>
<para>Unknown bugs:
<itemizedlist>
<listitem>
<para>Probably many</para>
</listitem>
</itemizedlist>
</para>
</chapter>
<chapter id="TODO">
<title>TO DO</title>
<para><itemizedlist>
<listitem>
<para>Document info dialog</para>
</listitem>
<listitem>
<para>More paper types, currently only those from xdvi are available</para>
</listitem>
<listitem>
<para>Better onitemne help</para>
</listitem>
<listitem>
<para>Internal printing using QPrinter</para>
</listitem>
<listitem>
<para>Redirect error messages to a window (partly done)</para>
</listitem>
<listitem>
<para>Better Postscript handling (currently not very robust)
<itemizedlist>
<listitem>
<para>anti-aliasing</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para>More background processing to keep the UI responsive</para>
</listitem>
<listitem>
<para>Magnifier window </para>
</listitem>
<listitem>
<para>Two page view</para>
</listitem>
<listitem>
<para>Support for more TeX specials</para>
</listitem>
<listitem>
<para>Network URL support</para>
</listitem>
</itemizedlist>
</para>
<para>Anything else? Feel free to make suggestions and report any problems you have.</para>
<para>Markku Hihnala
<ulink url="mailto:mah@ee.oulu.fi">mah@ee.oulu.fi</ulink></para>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

64
doc/index.html
View file

@ -1,64 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>kdvi TeX DVI viewer - User Manual</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<P ALIGN="RIGHT">
<A HREF="index-1.html">Next</A>
Previous Table of Contents</P>
<H1>kdvi TeX DVI viewer - User Manual</H1>
<SMALL><I>
Markku Hihnala (
<A HREF="mailto:mah@ee.oulu.fi">mah@ee.oulu.fi</A>)
</I></SMALL>
<P>kdvi is a DVI viewer based on xdvik version 18f by many authors (see file AUTHORS). My additions to the earlier work are distributed under the GPL (see file COPYING).
<P>This is an alpha release of kdvi. See file README.kdvi for release notes.
<P>
<H2><A NAME="toc1">1.</A> <A HREF="index-1.html">USAGE</A></H2>
<P>
<H2><A NAME="toc2">2.</A> <A HREF="index-2.html">Using keyboard</A></H2>
<P>
<H2><A NAME="toc3">3.</A> <A HREF="index-3.html">Moving around</A></H2>
<P>
<H2><A NAME="toc4">4.</A> <A HREF="index-4.html">Changing magnification</A></H2>
<P>
<H2><A NAME="toc5">5.</A> <A HREF="index-5.html">Marking pages</A></H2>
<P>
<H2><A NAME="toc6">6.</A> <A HREF="index-6.html">Printing</A></H2>
<P>
<H2><A NAME="toc7">7.</A> <A HREF="index-7.html">Q &amp; A</A></H2>
<P>
<H2><A NAME="toc8">8.</A> <A HREF="index-8.html">BUGS</A></H2>
<P>
<H2><A NAME="toc9">9.</A> <A HREF="index-9.html">TO DO</A></H2>
<P ALIGN="RIGHT">
<A HREF="index-1.html">Next</A>
Previous Table of Contents</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
</BODY>
</HTML>

21
doc/index.nif
View file

@ -1,21 +0,0 @@
<--A-->
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDE, dvi, DVI, TeX, tex, LaTeX, latex, device-independent, viewer, dvi viewer, kdvi, xdvi">
<META NAME="description" CONTENT="Kdvi Documentation">
<--B-->
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000">
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.png" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>
<--C-->
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>
</FONT>
<--BarTags1-->
<P ALIGN="RIGHT">
<--BarTags2-->
</P>

172
doc/index.sgml
View file

@ -1,172 +0,0 @@
<!DOCTYPE linuxdoc system>
<LINUXDOC>
<ARTICLE>
<TITLEPAG>
<TITLE>kdvi TeX DVI viewer - User Manual</TITLE>
<AUTHOR>
<NAME>Markku Hihnala (<HTMLURL URL="mailto:mah@ee.oulu.fi" NAME="mah@ee.oulu.fi">)</NAME>
</AUTHOR>
</TITLEPAG>
<P>kdvi is a DVI viewer based on xdvik version 18f by many authors (see file AUTHORS). My additions to the earlier work are distributed under the GPL (see file COPYING).</P>
<P>This is an alpha release of kdvi. See file README.kdvi for release notes.</P>
<SECT>
<HEADING>USAGE</HEADING>
<P>The dvi viewer may be started using a file name to display a file, e.g: <VERB>kdvi somepath/paper.dvi</VERB>or without a file name as <VERB>kdvi</VERB> kdvi will then allow a file to be opened from a dialog or a menu of recently used files. This menu can also be popped up by clicking the File button with the right mouse button.</P>
<P>The usual parameters handled by Qt and KDE applications also work: <VERB>kdvi -style windows -display :0 -geometry 400x400+0+0 -caption "DVI"</VERB> For integration with TeX the opened DVI file is automatically reloaded when changed.</P>
</SECT>
<SECT>
<HEADING>Using keyboard<LABEL ID="keyboard"></HEADING>
<P>Most keyboard commands are displayed in the menus as accelerator keys.
The defaults follow KDE standard when applicable.
You can define your prefered key bindings using the KDE standard key
configuration dialog available from the menu Options/Keys.</P>
<P>Note also that you can reach most menu commands with a couple of key presses,
e.g. to show the Help/About is done by Alt-h a. You can also use
cursor keys to move around in menus.
Here is a list of invisible bindings (these are not configurable):
<ITEMIZE>
<ITEM>SPACE moves down then to top of next page similar to Advance button.</ITEM>
<ITEM>Cursor keys scroll in obvious way. With Control-modifier they use a very
small step size for accurate control.</ITEM>
<ITEM>Home scrolls to top of page.</ITEM>
<ITEM>End scrolls to bottom of page.</ITEM>
</ITEMIZE>
</P>
</SECT>
<SECT>
<HEADING>Moving around</HEADING>
<P>You can scroll the page with various ways: Using keyboard <REF ID="keyboard">, using the scrollbars, using the scroller
widget located above the page list or by dragging the display with
left mouse button.</P>
<P>The Page menu provides commands for changing the displayed page. A
primitive dialog is available to enter a page number. The scroller
widget allows you to move to the next or the previous page by clicking
the right or middle mouse button. The page list can be clicked with
the left mouse button to select a page.</P>
<P>The button bar provides buttons to change pages: First, Previous,
Advance, Next and Last. In the middle of these is the Advance button
which can be used to easily read through many partly displayed pages:
it scrolls down until at the bottom of page and then to the top of the
next page.</P>
</SECT>
<SECT>
<HEADING>Changing magnification</HEADING>
<P>The View menu offers entries to step through available magnifications:
Zoom in and Zoom out. The available magnifications corresponds to the
base resolution of the used pk-font and its reductions by integer
factors.</P>
<P>The button bar presents these same commands plus two fixed
magnifications for quick selection. You can use these to switch
between a readable text size and a magnified view (there is no
separate magnifier window) or between a readable size and a full page
view. You can configure these fixed sizes with preferences dialog.</P>
<P>One non-obvious feature is the selection of scaling center. You can
select with left mouse button the point on the page that does not move
(if possible) when changing the magnification. Use this by clicking
with left mouse button at the detail you want to see magnified and
then push the magnified view button.</P>
</SECT>
<SECT>
<HEADING>Marking pages</HEADING>
<P>You can mark pages for printing. The marks are visible in the page list.</P>
<P>The current page can be marked by selecting the entry 'Mark page' from
the RMB popup menu of the viewing area. The page list gives more
options for marking: you can mark all, even, odd or current page and
unmark current or all pages and toggle marks using the RMB popup menu
of page list. Clicking or dragging the middle mouse button also
toggles the marks.</P>
</SECT>
<SECT>
<HEADING>Printing</HEADING>
<P>This version has a print setup dialog (available from the print
dialog) that lets you configure the printing method, n-up program,
printer names and spooler command. Printing method selects the
external program to use for printing. Available choices are dvips and
dvilj4. If you use dvips, you can also have an n-up program called to
make 2 or 4 pages per sheet. Select psnup (preferred) or mpage (may
work) if you have that installed in your system.</P>
<P>You may add printer names that will be available in the print dialog.</P>
<P>And last you can change the spooler command (defaults to lpr) that is
supposed to read standard input. Option -P is appended when printing
to nondefault printer.</P>
<P>Having setup printing you can use the print dialog where you can
select the pages to be printed, which printer or file to use for
output and more.</P>
</SECT>
<SECT>
<HEADING>Q &amp; A</HEADING>
<P>Q: Why is kdvi not displaying anything but a busy cursor?<NEWLINE>
A: It is
possible, that kdvi is searching for the pk-fonts from wrong places,
and this can be very time consuming if these include network mounted
filesystems. You can check for this with strace and see below for a
cure.</P>
<P>Q: What can I do when kdvi does not find my PK-fonts?<NEWLINE>
A: You must have correct settings for resolution and Metafont mode.<NEWLINE>
If this does not help, you may set the field
'PK Font Path' in Preferences/Fonts to point to the list of directories
to be searched for pk-fonts:
<NEWLINE>
/var/lib/texmf/fonts/pk/ljfour/:/some/other/place
<NEWLINE>
You can make kdvi search recursively by adding an extra / at the end of
directory name:
<NEWLINE>
/var/lib/texmf/fonts//
<NEWLINE>
(This works like xdvi's XDVIFONTS environment variable.
There is also good (gnu info) documentation available for the kpathsea library
that kdvi uses for font searching.)<NEWLINE>
This makes kdvi usable when you have some other tex system than tetex and don't
have the texmf.cnf file.</P>
<P>Q: How do I get the font generation to work?<NEWLINE>
A: If you like to enable automatic font generation using MakeTeXPK,
you must also supply correct Metafont mode in preferences dialog.
When automatic pk-font generation is disabled (menu option)
the missing fonts will be logged to file missfont.log in the current directory.
It is a good idea to check that the font generation commands in
missfont.log are correct before enabling font generation.</P>
</SECT>
<SECT>
<HEADING>BUGS</HEADING>
<P>Known bugs:
<ITEMIZE>
<ITEM> Changes in paper size only get applied correctly after restart.</ITEM>
<ITEM> When showing PS the gs process seems to hang sometimes. Killing gs helps.</ITEM>
<ITEM> When showing PS the rendered image is not always updated. Scrolling the
view helps.</ITEM>
<ITEM> You need to have xdvi installed and accessible via the program search path.
You can replace the actual file with an empty executable though.</ITEM>
</ITEMIZE></P>
<P>Unknown bugs:
<ITEMIZE><ITEM>Probably many</ITEM></ITEMIZE></P>
</SECT>
<SECT>
<HEADING>TO DO</HEADING>
<P><ITEMIZE>
<ITEM>Document info dialog</ITEM>
<ITEM>More paper types, currently only those from xdvi are available</ITEM>
<ITEM>Better onitemne help</ITEM>
<ITEM>Internal printing using QPrinter</ITEM>
<ITEM>Redirect error messages to a window (partly done)</ITEM>
<ITEM>Better Postscript handling (currently not very robust)
<ITEMIZE><ITEM>anti-aliasing</ITEM></ITEMIZE></ITEM>
<ITEM>More background processing to keep the UI responsive</ITEM>
<ITEM>Magnifier window </ITEM>
<ITEM>Two page view</ITEM>
<ITEM>Support for more TeX specials</ITEM>
<ITEM>Network URL support</ITEM>
</ITEMIZE></P>
<P>Anything else? Feel free to make suggestions and report any problems you have.</P>
<P>Markku Hihnala<NEWLINE>
<HTMLURL URL="mailto:mah@ee.oulu.fi" NAME="mah@ee.oulu.fi"></P>
</SECT>
</ARTICLE>
</LINUXDOC>

BIN
doc/logotp3.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 2.7 KiB