From ac46111f61d7bd1fecee9bda5174e38b62909a17 Mon Sep 17 00:00:00 2001 From: Stefan Kebekus Date: Fri, 23 Jun 2000 00:23:55 +0000 Subject: [PATCH] updating documentation svn path=/trunk/kdegraphics/doc/kdvi/; revision=54063 --- doc/index.docbook | 146 ++++++++++++++++++++++++++++++--------- doc/optionrequester1.png | Bin 0 -> 4807 bytes 2 files changed, 113 insertions(+), 33 deletions(-) create mode 100644 doc/optionrequester1.png diff --git a/doc/index.docbook b/doc/index.docbook index fd4b4a249..bce67596c 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -11,6 +11,12 @@
mah@ee.oulu.fi
+ +Stefan +Kebekus + +
mah@ee.oulu.fi
+ 25/05/2000 1.00.00 @@ -30,45 +36,119 @@ usage - -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). +kdvi is a plugin for the kviewshell program which allows kviewshell to +display dvi-files which are produced by the TeX typesetting system. More +information about TeX and DVI can be found on the homepage of the TeX user +group. kdvi 0.9 supports the inclusion of PostScript graphics and it supports +hyperlinks. More details and the technical specifications can be found +in a separate document. + +kdvi 0.9 is based on based on the stand-alone-program kdvi 0.4.3 by +Markku Hihnala. That program in turn base based on xdvik version 18f which +has many authors. + +For convenience there exists a command kdvi which calls kviewshell +with the kdvi-plugin preloaded. The viewer may thus be started using +the command + +kdvi somepath/paper.dvi + +or without a file name as kviewshell 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. + +The usual parameters handled by Qt and KDE applications also work: + +kdvi -style windows -display :0 -geometry 400x400+0+0 -caption "DVI" + +For integration with TeX the opened DVI file is automatically reloaded +when changed. -This is an alpha release of kdvi. See file README.kdvi for release notes. - -The dvi viewer may be started using a file name to display a file, e.g: kdvi somepath/paper.dvior without a file name as kdvi 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. - -The usual parameters handled by Qt and KDE applications also work: kdvi -style windows -display :0 -geometry 400x400+0+0 -caption "DVI" For integration with TeX the opened DVI file is automatically reloaded when changed. - -Using keyboard +The option dialog -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. +

first page

+The following picture shows the options dialog of kdvi. +
+

+ + + + + + + + + + + + + + + + + + + + +
Resolution/ +
Metafont mode		These options specify the fonts which kdvi will use for rendering. +By carefully optimizing the settings here it is possible to improve on +the display. However, unless you are an expert in MetaFont and know what +you are doing, it is absolutely no good idea to change these options. Save +values are "600" and "ljfour" for good quality or "300" and "cx" for medium +quality and faster display.
Generate fontsCheck this if you want kdvi to call the MetaFont program in the likely +case that kdvi wants to display documents which use fonts which are not +yet readily made. You most certainly want to set this option.
PK font pathIf this is not empty, it point to a list of directories to be searched +for pk-fonts, e.g.  +
/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. Again this +option is strikly for the experts only.
+ +

+second page

+The following picture shows the second options dialog of kdvi. +
+

+ + + + + + + + + + + + + +
PostScriptIf this options is checked, kdvi will display PostScript graphics which +are embedded into the dvi file. If an external PostScript file could not +be found, kdvi will draw a red warning box in its place. Unfortunately, +rendering PostScript graphics is very slow in the current version of kdvi. +We will improve on the speed in later versions. If this option is off, +kdvi will either draw a grey box as a placeholder for the graphics, or +it will leave the space blank. +
Note: there is no standard way to embed PostScript graphics +into a dvi file. It may therefore happen that kdvi cannot properly display +a graphic which works fine with other programs. Older versions of xdvi +and dvips support the execution of external commands. This is a hight security +risk and therefore deliberately not implemented in kdvi. Technical information +about supported ways to include PostScript can be found in an external +document.
HyperlinksCheck this if you want kdvi to display hyperlinks. The appropriate +parts of the text will be underlined in blue.
-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): - - -SPACE moves down then to top of next page similar to Advance button. - - -Cursor keys scroll in obvious way. With Control-modifier they use a very -small step size for accurate control. - - -Home scrolls to top of page. - - -End scrolls to bottom of page. - - - diff --git a/doc/optionrequester1.png b/doc/optionrequester1.png new file mode 100644 index 0000000000000000000000000000000000000000..3020a2d12e1328aa85e8acd635654697827f24cc GIT binary patch literal 4807 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 bXn$T|X93=0KjH#Wh5$NRP|X^3hgW|GWOQQI literal 0 HcmV?d00001