How to Add a Software Page

Procedure

~info/www/software/XXXXXX

1. This step is only necessary if you have changed your umask in your login script. If you have not, ignore it.

   Make sure your umask is set to 022 such that all the files generated are readable to everybody:

   umask 022
   

2. Create a file XXXXXX.tex that contains a LaTeX (not TeX) description of your software without preamble i.e. only what you would write in LaTeX between

   \begin{document} ... \end{document}
   

   Important: you may use sectioning commands, description, enumerate, itemize, center and verbatim environments, font changing commands and simple $ $ math mode (super and subscripts only); you must not use any skips (\vskip, ...) or \maketitle.

   In order to include an encapsulated PostScript (.eps) picture, you may use the following form:

   \begin{gif}{myfigure}
   \psfig{file=myfigure.eps}
   \end{gif}
   

   where you provide the file myfigure.eps within the directory.

   More information on HyperLaTeX and its differences from LaTeXyou may find on the WWW page

   http://www/systems/software/hyperlatex/hyperlatex.html
   

3. Copy ~info/www/software/template.hyp as XXXXXX.hyp into this directory and edit this file by changing TITLE, AUTHOR, MAINTAINER and FILE (XXXXXX).
4. Run

   hyp.pl XXXXXX.hyp
   

   This will create a file XXXXXX-main.tex.
5. Copy ~info/www/software/index into your directory.
6. Run

   hyperlatex XXXXXX-main.tex
   

   This will create the HTML file index.html.
7. This step is only necessary if you have included encapsulated PostScript figures. Otherwise ignore it.

   Run

   hyperlatex -gif XXXXXX.tex
   

   This will create for each figure.eps included in your document as described above a corresponding graphics figure.gif.

   Alternatively, you may create figure.gif by your favorite graphics software (also a PostScript to GIF converter ps2gif is available on the SGIs).

8. Run

   wndex
   

   This will create a file index.cache.
9. Run now

   netscape
   

   and try the URL

   http://www.risc.uni-linz.ac.at:81/software/XXXXXX
   

   You should now see the description of your software package.