<
 
 
 
 
×
>
hide
You are viewing a Web site, archived on 12:42:43 Oct 31, 2004. It is now a Federal record managed by the National Archives and Records Administration.
External links, forms, and search boxes may not function within this collection.

Using TeX and LaTeX

With NSF FastLane


Submission of DVI Files and Figures

A Brief Explanation

TeX/LaTeX users should convert their source (.tex) files to DVI (.dvi) files. If the document is self-contained (e.g., does not have associated PostScript figures), you can upload the DVI file directly to FastLane. A common example may be the project summary. The file should have the .dvi filename extension to allow appropriate handling.

If you have Encapsulated PostScript figures defined in your .tex file, common for project descriptions, you will need to include them in the file you upload. To do this, first create your .dvi file from your TeX/LaTeX file. Ensure that the references to figures in your TeX/LaTeX file contain the file name of the figure but not the directory path (e.g., "figure1.ps" not "/home/yourname/project/figure1.ps"). Combine all the files (DVI and figures) into a single TAR file. The resulting file should use .dar as the filename extension to allow proper handling after upload. To reduce the size of the upload, you can compress this file using gzip. In this case, use .dgz as the filename extension.


Acceptable Formats

FastLane supports TeX/LaTeX file formats with the following extensions:

EXTENSION File Type
.dvi DVI file only
  · No PostScript figures
.dvz DVI file only
  · No PostScript figures
  · Compressed with gzip (not pkzip!)
.dar DVI file and PostScript figures combined into a single TAR file
  · Uncompressed
.dgz DVI file and PostScript figures combined into a single TAR file
  · Compressed with gzip (not pkzip!)


TeX/LaTeX Archive Submissions

TeX files and archives may be transferred for conversion. However, even though the following file extensions define the conversion process, this is not recommended! FastLane uses the MikTeX (1.20e) compiler, and your TeX/LaTeX compiler, macros, style files, etc., may be different. You should upload the DVI file instead.

EXTENSION File Type
.tex TeX/LaTeX file only
  · No PostScript figures
.taz TeX/LaTeX file only
  · No PostScript figures
  · Compressed with gzip (not pkzip!)
.tar TeX/LaTeX file and PostScript figures combined into a single TAR file
  · Uncompressed
.tgz TeX/LaTeX file and PostScript figures combined into a single TAR file
  · Compressed with gzip (not pkzip!)


Generate the DVI File

Use your own TeX or LaTeX program to convert your .tex file to .dvi:

NOTE: The example above will create the myfile.dvi file from the myfile.tex file.


Create a Single Uncompressed Archive File (.dar)

If your files are not very large, it is not necessary to compress the resulting file. You can create a single compressed archive file by combining your .dvi and .ps files using the "tar" executable.

First, create your .dvi file as described in the "Generate DVI File" section above.

Next, combine the .dvi file and your figures into an uncompressed archive file using the "tar" executable with the following command:

NOTE 1: If you want the command to show you less output, remove the v from the command arguments. The last command argument must be -f and it must be followed immediately (after a space) by the output filename.

NOTE 2: In the above example, outputfilename.dar is the name given to the archive file.

NOTE 3: You can list as many space-separated filenames as necessary.

Then transfer the outputfilename.dar file to FastLane.


Create a Single Compressed Archive File (.dgz)

If your files are very large, you can create a single compressed archive file by combining your .dvi and .ps files using the "tar" executable.

First, create your .dvi file as described in "Generate DVI File" section above.

Next, combine the .dvi file and your figures into a compressed archive file using the "tar" executable with the following command:

NOTE 1: If you want the command to show you less output, remove the v from the command arguments. The last command argument must be -f and it must be followed immediately (after a space) by the output filename.

NOTE 2: In the above example, outputfilename.dgz is the name given to the archive file.

NOTE 3: You can list as many space-separated filenames as necessary.

NOTE 4: Older versions of tar that do not support the "z" argument in gzip output (such as Solaris tar) should be called with the following command:

These command lines should work for almost any UNIX system with the "tar" executable and "gzip" installed. Then transfer the outputfilename.dgz file to FastLane.


National Science Foundation
4201 Wilson Boulevard
Arlington, Virginia 22230, USA
Tel: 703-292-5111, FIRS: 800-877-8339
TDD: 703-292-5090

If you have trouble accessing any FastLane page, please
contact FastLane User Support at 1-800-673-6188.