How to Add a Software Page

RISC-Linz logo

Procedure

Assume you want to add the description of your software package XXXXXX in directory
~info/www/software/XXXXXX
For this purpose you may use HyperLaTeX as follows:
  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.
If you modify your description, just repeat the last four steps of above sequence (provided that the umask condition holds).
Maintained by: The System Administration
Last Modification: December 11, 1996

[Previous] [Up] [Next] [RISC-Linz] [University] [Search]