01b626
I. CHANGES FROM UPSTREAM
01b626
01b626
Latexmk almost works out of the box.  Three changes have been made to
01b626
conform to Fedora Core conventions.  First, the default DVI, PostScript,
01b626
and PDF previewers have been changed to 'xdg-open'; see below for more
01b626
information. Second, the script has been altered so that it does not
01b626
search for the perl binary; perl is in a known location on Fedora Core
01b626
systems.  Finally, the site-wide configuration file is /etc/latexmk.conf
01b626
only, as opposed to the list of names searched by the original latexmk.
01b626
01b626
II. PREVIEWERS
01b626
01b626
The command xdg-open views a file using the viewer selected by the user
01b626
for that type of file.  See the xdg-mime(1) command for more
01b626
information.  Unfortunately, the use of xdg-open precludes the updating
01b626
of the previewing application, as latexmk cannot know which application
01b626
is doing the previewing.  It also breaks viewing of landscape documents
01b626
for some previewers.  For best results, you should customize latexmk for
01b626
the particular previewers you intend to use.  Following are the settings
01b626
for some commonly used previewers, to be placed in the site, user, or
01b626
project configuration file.  Note that an update method of 1 means that
01b626
there is no way for latexmk to cause the program to refresh; you have to
01b626
take some action of your own to see changes to the document.
01b626
01b626
   A. DVI PREVIEWERS
01b626
01b626
      1. xdvi
01b626
01b626
         $dvi_previewer = 'start xdvi';
01b626
         $dvi_previewer_landscape = 'start xdvi -paper usr';
01b626
         $dvi_update_method = 2;
01b626
01b626
      2. pxdvi
01b626
01b626
         $dvi_previewer = 'start pxdvi';
01b626
         $dvi_previewer_landscape = 'start pxdvi -paper usr';
01b626
         $dvi_update_method = 2;
01b626
01b626
      3. kdvi
01b626
01b626
         $dvi_previewer = 'start kdvi';
01b626
         $dvi_previewer_landscape = 'start kdvi';
01b626
         $dvi_update_method = 0;
01b626
01b626
   B. POSTSCRIPT PREVIEWERS
01b626
01b626
      1. gv
01b626
01b626
         $ps_previewer = 'start gv -watch';
01b626
         $ps_previewer_landscape = 'start gv -swap -watch';
01b626
         $ps_update_method = 0;
01b626
01b626
      2. evince
01b626
01b626
         $ps_previewer = 'start evince';
01b626
         $ps_previewer_landscape = 'start evince';
01b626
         $ps_update_method = 1;
01b626
01b626
      3. kghostview
01b626
01b626
         $ps_previewer = 'start kghostview';
01b626
         $ps_previewer_landscape = 'start kghostview --orientation=landscape';
01b626
         $ps_update_method = 1;
01b626
01b626
         If you can remember to set the "Watch File" option in
01b626
         kghostview, then instead set:
01b626
01b626
         $ps_update_method = 0;
01b626
01b626
         Unfortunately, there appears to be no command line argument to
01b626
         set the "Watch File" option.
01b626
01b626
   C. PDF PREVIEWERS
01b626
01b626
      1. gv
01b626
01b626
         $pdf_previewer = 'start gv -watch';
01b626
         $pdf_update_method = 0;
01b626
01b626
      2. evince
01b626
01b626
         $pdf_previewer = 'start evince';
01b626
         $pdf_update_method = 1;
01b626
01b626
      3. kghostview
01b626
01b626
         $pdf_previewer = 'start kghostview';
01b626
         $pdf_update_method = 1;
01b626
01b626
	 See the remark on the "Watch File" option above.
01b626
01b626
      4. kpdf
01b626
01b626
         $pdf_previewer = 'start kpdf;
01b626
         $pdf_update_method = 1;
01b626
01b626
	 The "Watch File" remark above for kghostview applies to kpdf also.
01b626
01b626
      5. acroread
01b626
01b626
         $pdf_previewer = 'start acroread';
01b626
         $pdf_update_method = 1;