
   `xdvipresent' provides glue for developing slides for on-line
presentation using `LaTeX' and `xdvi', and a (portable) computer with
a XGA (1024x768), SVGA (800x600), VGA (640x480), or SUN (1152x900)
screen running Xwindows.

   This documentation corresponds to version 0.6#12 (1999/11/11,
12:31:46 MET).

   Copyright (C) Manuel Hermenegildo and The CLIP Group

   This document may be freely read, stored, reproduced,
disseminated, translated or quoted by any means and on any medium
provided the following conditions are met:

  1. Every reader or user of this document acknowledges that is aware
     that no guarantee is given regarding its contents, on any
     account, and specifically concerning veracity, accuracy and
     fitness for any purpose.

  2. No modification is made other than cosmetic, change of
     representation format, translation, correction of obvious
     syntactic errors, or as permitted by the clauses below.

  3. Comments and other additions may be inserted, provided they
     clearly appear as such; translations or fragments must clearly
     refer to an original complete version, preferably one that is
     easily accessed whenever possible.

  4. Translations, comments and other additions or modifications must
     be dated and their author(s) must be identifiable (possibly via
     an alias).

  5. This licence is preserved and applies to the whole document with
     modifications and additions (except for brief quotes),
     independently of the representation format.

  6. Any reference to the "official version", "original version" or
     "how to obtain original versions" of the document is preserved
     verbatim. Any copyright notice in the document is preserved
     verbatim. Also, the title and author(s) of the original document
     should be clearly mentioned as such.

  7. In the case of translations, verbatim sentences mentioned in
     (6.) are preserved in the language of the original document
     accompanied by verbatim translations to the language of the
     traslated document. All translations state clearly that the
     author is not responsible for the translated work. This license
     is included, at least in the language in which it is referenced
     in the original version.

  8. Whatever the mode of storage, reproduction or dissemination,
     anyone able to access a digitized version of this document must
     be able to make a digitized copy in a format directly usable,
     and if possible editable, according to accepted, and publicly
     documented, public standards.

  9. Redistributing this document to a third party requires
     simultaneous redistribution of this licence, without
     modification, and in particular without any further condition or
     restriction, expressed or implied, related or not to this
     redistribution. In particular, in case of inclusion in a
     database or collection, the owner or the manager of the database
     or the collection renounces any right related to this inclusion
     and concerning the possible uses of the document after
     extraction from the database or the collection, whether alone or
     in relation with other documents.


   Any incompatibility of the above clauses with legal, contractual
or judiciary decisions or constraints implies a corresponding
limitation of reading, usage, or redistribution rights for this
document, verbatim or modified.

   1

Slide Presentations Using LaTeX/xdvi
************************************

   This documentation corresponds to version 0.6#12 (1999/11/11,
12:31:46 MET).

Summary
*******

   `xdvipresent' provides glue for developing slides for on-line
presentation using `LaTeX' and `xdvi', and a (portable) computer with
a XGA (1024x768), SVGA (800x600), VGA (640x480), or SUN (1152x900)
screen running Xwindows.

xdvipresent
***********

   `xdvipresent' provides glue for developing slides for on-line
presentation using `LaTeX' and `xdvi', and a (portable) computer with
a XGA (1024x768), SVGA (800x600), VGA (640x480), or SUN (1152x900)
screen running Xwindows.The idea is that you prepare the slides in
LaTeX with the enclosed style file(s) and you use the "`xdvipresent'"
script (which simply calls `xdvi' with an appropriate set of options)
to show the slides on the screen. The package also provides tips on
preparing presentations with `xdvi', for starting `xdvipresent' from
emacs, etc.

Installation
============

Installation using (g)make
--------------------------

   * Uncompress and untar the distribution in a suitable directory.

   * Set `STYDIR' in Makefile to a place where LaTeX can find style
     files.

   * Set `BINDIR' in Makefile to a place where executables can be
     found.

   * Type `gmake install'.

   * The `doc' directory contains this manual in several formats
     (postscript, emacs info, manl, ...). You should probably install
     them in a public area.

   * Make sure you read the rest of this manual for important
     instructions on how to prepare the presentations (and try out
     the installation using the example provided)!

*Note:* Depending on your system setup you may need to be root to
complete one or more of the steps above.

Manual installation
-------------------

   If you find problems with the procedure above, you can perform the
installation as follows:

   * Copy the files in the `images' directory (.ps files to make the
     slides more appealing) to a place where LaTeX can find them.

   * Copy the class/style files (`*.cls',`*.sty') to a place where
     LaTeX can find it (otherwise, put the whole path when using it).

   * Copy `xdvipresent' to a place that is in your executable (bin)
     search path.

   * Type `texhash' (this depends a bit on your LaTeX installation)
     so that LaTeX can find the new styles and files.

   * The `doc' directory contains this manual in several formats
     (postscript, emacs info, manl, ...). You should probably install
     them in a public area.

   * Make sure you read the rest of this manual for important
     instructions on how to prepare the presentations (and try out
     the installation using the example provided)!

*Note:* Depending on your system you may need to be root to complete
one or more of the steps above.

Preparing the slides
====================

   Use the file `example.tex' as a template. Observe how the front
matter, slide boundaries, headers and footers, etc. are set up.
Essentially:

   * Use `xdvislides' as the document class, using the type of
     display on which you will present. For example, use

     `\documentclass[svga]{xdvislides}'

     if you plan to view the slides on an SVGA screen, and

     `\documentclass[a4paper]{xdvislides}'

     if you plan to print them on A4 paper. There is also a special
     option, `htmlslides', which is intended for generating an HTML
     version of the slides using `latex2html'. The idea is that
     simpler macros are used which do not confuse `latex2html'.

   * Nice headers and footers can be set: see the examples in
     `example.tex'.

   * It is nice to use (possibly nested) item lists (`\itemize'),
     because the style typesets them in color.

   * Put each slide title inside `\subsection{...}'. This has the
     advantage that `latex2html' creates a new HTML page for each
     slide.

   * The use of Helvetica fonts, which are very readable on a
     computer screen is highly recommended. With latex2e, simply add:
     `\fontfamily{phv} \selectfont' just after `\begin{document}', as
     in the `example.tex' file.

Displaying slides on the screen
===============================

   Once installation is completed, you are ready to test the package.
To test viewing on, for example, an svga screen:

   * Edit `example.tex' and comment in and out the right lines at the
     beginning of `example.tex' as appropriate for producing
     svga-sized output.

   * If you use the `emacs' editor, also move the uncommented line to
     the top (this is so that AucTeX can see the format that you have
     chosen -See *Note Automating xdvi startup from emacs/AucTeX::).

   * Run LaTeX to generate the .dvi file for `example.tex'.

   * (Make sure you are running Xwindows!)

   * Type: `xdvipresent svga example.dvi'

This should start an `xdvi' window containing the slides. The `xdvi'
window should *cover the whole screen*, and should have *no controls
or sliders*, i.e., only the slides should appear, and covering the
whole screen. If this is not the case, this is probably due to your
window manager settings. Right "out of the box" `xdvipresent' is
tuned for `fvwm'. If you use `fvwm' then simply add the line:

   `Style xdvi Notitle'

   to your `.fvwmrc' file to ensure that the `xdvi' window started by
`xdvipresent' does not have a title bar (which would take up precious
display space). Otherwise, things should work right away, unless you
have set unusually wide borders for the windows. If you use other
window managers then you may want to fine tune some things (see later
for explanations on how to do this).

Printing the slides
===================

   To print the slides, uncomment the appropriate line in the
`example.tex' file (e.g., the one containing `[a4paper]'), run LaTeX
again to generate the appropriate `.dvi' file, and print normally,
using a command such as:

   `dvips -P <printer> example.dvi'

   Selecting printing options, such as "`[a4paper]'", produces output
in which the slides have a border (note that this border looks good
on paper but would only take up precious screen space duing a
presentation).

More details on what it does and why and some usage tips
========================================================

   You may ask, why use `xdvi' and not, e.g.,
`ghostscript'/`ghostview'? I prefer `xdvi' for a number of reasons.
First, `xdvi' seems to do much better dithering of the fonts on the
screen, which means that the text is more readable. Also, `xdvi' can
be started with no borders or buttons, which is more difficult to do
with, e.g., `ghostview'. Also, with `xdvi' it is very easy and quick
to move forwards and backwards with the keyboard during the
presentation. The big drawback is that `xdvi' does not show (at least
at the time time of writing this) text in color, such as that
generated when using the `colordvi' package. Another alternative is
to use `html' (perhaps generated with `latex2html', in order to be
able to have nice math notation) and a browser, but I find that it is
very difficult to produce consistent results with this approach.

   Given the considerations above, and assuming that you buy the idea
that xdvi is the way to go, there are two main problems that this
package solves:

   * Giving the presentation a little color. As mentioned before, at
     the time of this writing `xdvi' unfortunately does not
     understand color commands included in the LaTeX source (e.g., by
     using \package{colordvi}). However, embedded postscript figures
     are rendered in color. This is used in the style definition to
     include some color in the presentation: a blue line between the
     slide title and the body, colored buttons as item bullets, and a
     red line to separate the footer. This is done in the
     `*.cls/*.sty' style files. When printing on a B/W printer this
     is all really superfluous and a different style, which uses no
     color, is used. For printing on a color printer the slides
     prepared for on-line presentation can be used.

   * Forcing LaTeX and `xdvi' to produce output in such a way that it
     fits exactly on the screen of a portable. This is solved by:

        * Giving suitable page sizes and offsets to LaTeX, which is
          included in the `xdvislides.cls' (and the older
          `xdvi_slide.sty') format. See `example.tex' for a typical
          use. Note that some lines in the LaTeX file have to be
          commented out and others in depending on whether the file
          should be formatted for a vga screen, an svga screen, an
          xga screen, a sun screen, or a printer.

        * Making `xdvi' start with the right parameters, by using the
          `xdvipresent' script instead of calling `xdvi' directly.
          The idea is to make the image fit exactly in the screen and
          avoid the presence of side bars, buttons, etc. The script
          takes at least two arguments. The first argument must be
          `vga', `svga', `a4paper', etc., depending on the display to
          be used (entries such as `a4paper' mean view the slides as
          they will be printed). The second argument must be the .dvi
          file name (including the suffix). Any other arguments are
          passed directly to `xdvi'. Here are some possibilities:

         -bg <color>
               to change the color of the background (but note that
               white (the default) is often best for low-contrast
               displays)

         -fg <color>
               to change the color of the foreground (text, etc.)

         -geometry <xsize>x<ysize>+<xoffset>+<yoffset>
               the default values are, for example, "630x470+0+0" for
               vga (640x480 screen) and "790x590+0+0" for svga
               (800x600 screen) Note that 10 points are left for the
               window border, whose standard size is 5pt on each side
               under `fvwm' (this may need adjustment for other
               window managers). It is also assumed that the `xdvi'
               window does not have a title bar (which would take up
               precious display space). In order to ensure this in
               `fvwm', add the line

               `Style xdvi Notitle'

               to your `.fvwmrc' (similar commands should be
               available in other window managers). If your setting
               is different from that assumed, you may have to tweak
               these values a bit.

               In `fvwm' and other window managers that support
               several working spaces it is sometimes useful to
               display the slides in another "page" of the display.
               This can be done by adding offsets (which will be
               applied >from the page in which the `xdvi' is
               started). E.g., `-geometry 790x590+0+1024' will start
               the `xdvi' in the screen below the current one in a
               standard X86Free 1280x1024 virtual display.

         -display <displayname>
               Useful for running LaTeX on one machine but showing
               the slides on another (e.g., `-display
               <machine_name>:0.0').

          (see the `xdvi' documentation for more details on options).

Automating xdvi startup from emacs/AucTeX
=========================================

   If you are using AucTeX and `emacs', then by putting some
additional lines in the `tex-site.el' file it is possible to make
`emacs' automatically invoke `xdvipresent' with the right parameters
when doing `C-c C-c View' or `C-c C-c Print'. The selection will be
based automatically on the presentation option (vga, svga, xga, sun,
a4paper, letterpaper, ...) that you are using in the `documentclass'
line in the latex file. Note that if you change this you will have to
delete the buffer and open the file again for `emacs' to notice the
changes. Also note that, if another, commented out `documentclass'
line appears in the file before the one being used, then the
commented one may be one seen by `emacs' instead. Thus, it is best to
keep the *active* `documentclass' line the first one in the file.

   These are examples of the entries that you may want to add to the
`tex-site.el' file:

     (defvar TeX-view-style '(
         ;; xdvipresent entries
         ("^sun$" "xdvipresent sun %d")
         ("^xga$" "xdvipresent xga %d")
         ("^svga$" "xdvipresent svga %d")
         ("^vga$" "xdvipresent vga %d")
         ("^a4paper$" "xdvipresent a4paper %d")
         ("^letterpaper$" "xdvipresent letterpaper %d")
         ;;
         ("^landscape$" "xdvi %d -paper a4r -s 4")
         ("^a5$" "xdvi %d -paper a5")
         ("." "xdvi %d -s 7 -hushspecials -hl green -bd red -cr blue
              -expert -paper a4 -geometry -0+0")
         )

(Note that if you are indeed an emacs/AucTex user you could also
simply copy the `xdvi' commands with the right parameters from the
`xdvipresent' script into this file and not use the `xdvipresent'
script at all!)

   In a portable, and running a window manager that supports several
work surfaces, such as `fvwm', it is convenient to start the `xdvi'
in an adjacent work surface. These are examples:

     (defvar TeX-view-style '(
         ;; xdvipresent entries
         ("^sun$" "xdvipresent sun %d -geometry 1014x758+0+900")
         ("^xga$" "xdvipresent xga %d -geometry 1014x758+0+768")
         ("^svga$" "xdvipresent svga %d -geometry 790x590+0+1024")
         ("^vga$" "xdvipresent vga %d -geometry 630x470+0+800")
         ("^a4paper$" "xdvipresent a4paper %d")
         ("^letterpaper$" "xdvipresent letterpaper %d")
         ;;
         ("^landscape$" "xdvi %d -paper a4r -s 4")
         ("^a5$" "xdvi %d -paper a5")
         ("." "xdvi %d -s 7 -hushspecials -hl green -bd red -cr blue
               -expert -paper a4 -geometry -0+0")
         )

   In your `.emacs' file you should put something like:

       ;; Auc-TeX
       (setq load-path (cons "....../auctex-9.6" load-path))
       (load "tex-site")
       (setq-default TeX-parse-self t) ;; Forces parsing of options in file!

Version/Change Log
******************

*Version 0.6#12 (1999/11/11, 12:31:46 MET)*
     Fixed minor bug with recent versions of xdvi: -hushspecials
     (still in documentation) does not work any more. (Manuel
     Hermenegildo)

*Version 0.6#11 (1999/9/29, 12:25:19 MEST)*
     Fixed yet another minor installation problem (dist dir not used
     now in installation). (Manuel Hermenegildo)

*Version 0.6#10 (1999/9/28, 11:52:28 MEST)*
     Improved documentation a bit. (Manuel Hermenegildo)

*Version 0.6#9 (1999/9/28, 10:57:50 MEST)*
     Improved installation procedure. (Manuel Hermenegildo)

*Version 0.6#8 (1999/4/28, 13:49:20 MEST)*
     Minor changes to installation. (Manuel Hermenegildo)

*Version 0.6#7 (1999/2/19, 8:59:42 MET)*
     Added sun option (1152x900). (Manuel Hermenegildo)

*Version 0.6#6 (1999/2/15, 19:38:41 MET)*
     Updated distribution scripts. (Manuel Hermenegildo)

*Version 0.6#5 (1999/2/15, 18:40:30 MET)*
     Improved the documentation somewhat. (Manuel Hermenegildo)

*Version 0.6#4 (1999/2/15, 17:15:18 MET)*
     Added xga option (1024x768). (Manuel Hermenegildo)

*Version 0.6#3 (1999/2/15, 17:14:16 MET)*
     Offsets now set in style file instead of using xdvi options
     (since the -offset option does not seem to work in newer
     versions of Linux xdvi). (Manuel Hermenegildo)

*Version 0.6#2 (1998/11/18, 10:50:22 MET)*
     Fixed installation instructions (they were outdated). (Manuel
     Hermenegildo)

*Version 0.6#1 (1998/11/6, 18:56:46 MET)*
     Added htmlslides option for easier generation of html slides
     using latex2html (changes by Manuel Carro). (Manuel Hermenegildo)

*Version 0.6 (1998/8/13, 18:14:45 MET DST)*
     Modified for standard installation. (Manuel Hermenegildo)

