VOICE Home Page: http://www.os2voice.org

[Newsletter Index] [Previous Page] [Next Page] [Features Index]

T_EXnical stuff for OS/2
First steps

By: Stefan Schwarzer <s.schwarzer@ndh.net>

What are TeX and LaTeX?

A more detailed answer is that both programs are typesetting systems, not word processors like StarWriter, to mention an example. In a word processor, you usually determine the appearance of a piece of text by selecting menu entries (or buttons) like "12 point, bold". This is called visual markup.

In LaTeX, you use logical markup, that is, instead of determining the appearance of the text directly, you assign it a function; perhaps you tell LaTeX that the string you just entered is the headline of a new chapter. Also, in contrast to word processors, you write your documents in a text editor of your choice, e. g. OS/2's Enhanced Programmer's Editor (EPM). The markup is mixed in the text by means of formatting instructions. Then, the text file is processed by a translation program. The output is a DVI file (from "device independent"), which then is converted to the final file format, e. g. PostScript or PDF, by use of a driver program. (Though this might sound complicated, it isn't anymore if you have done it a few times.)

If you are now curious how LaTeX code might look like, here is some.

A small example

If you want to write a short text, you may type in your editor

\documentclass{article}         % write an article (or other short text)
                                % a percent sign introduces a comment

\begin{document}                % begin with the document
\tableofcontents                % put a table of the contents here
                                % articles normally don't have a table
                                % of contents but we put one here for
                                % illustration

\section{A \LaTeX{} example}    % start a new section

\subsection{A very short subsection}
Some text goes here \dots       % three literal dots would be too close together
                                % plain text doesn't need special formatting

\subsection{A somewhat longer subsection}
Now we type a bit more text to show how \LaTeX{} formats paragraphs.
Irrespective of how many consecutive spaces     you type, they
come out as a single space. A line break is handled like a
space character, too.

As a special case, two consecutive line breaks tell \LaTeX{} to
start a new paragraph. Note that the line breaks in the editor
are not the same as those done by the typesetting system.

This is an unordered list:
\begin{itemize}
    \item  You don't have to think of vertical space above and below
        the list.
    \item  The indentation is also handled for you.
\end{itemize}
Here the text continues. Since we wrote it directly---without
an empty line---under the list commands, we didn't begin a new
paragraph.

\end{document}

Nice, isn't it? All the numbering and formatting has been done for you.

More advantages of LaTeX

• Page layout
  LaTeX does a very good job not only at line breaks but also at page breaks. Figures and table can "float" through the text if you want. That is, LaTeX will normally put the pictures etc. on the top or bottom of the page but is able to fill the gaps also with text that you wrote below the floating items.
  

• Mathematical formulas
  LaTeX is especially known for its ability to typeset mathematics. For example,

  A test formula:
  \begin{equation}
      \int \limits _0 ^\infty \frac{\sin bx}{x^s} =
      \frac{\pi b^{s-1}}{2 \Gamma(s) \sin s\pi/2}
      \quad , \quad 0 < s < 2
      \label{Eq:integral}   % see next item
  \end{equation}
      

  will give
  
  
  

  The label on the right is set automatically. More formulas will get ascending numbers.
  

• Handling of labels and references
  You may use as many labels as you want. An example of a label is given above; you could reference it with \ref{Eq:integral} to let the number of the formula, 1, appear at the place of the reference command.
  

• Helper applications
  LaTeX comes with several programs that are very useful, especially for scientific documents. One is BibTeX, a program to handle references that are used in your document. To do this, BibTeX accesses a literature database you supply and inserts appropriate text in the place of the reference in your text, and puts a formatted list of all literature you used at the end of the document. You can use the same database for multiple documents and choose the layout of the reference list on a per-document basis.
  

  Another program is makeindex. As you may guess, it is used to generate indices with keywords and their corresponding page numbers.
  

  Conversion from DVI to PostScript format is easily done with dvips, which is also delivered with LaTeX.
  

• Stability and reliability
  LaTeX and its supporting programs are thoroughly tested and very stable. Additionally, LaTeX only reads your file but never writes to it, so it can't modify (and thus damage) it.
  

  In contrast to almost all word processors, you see every single command in your document, so you won't be surprised by effects of "invisible" commands.
  

LaTeX distributions for OS/2

• "Classical" emTeX
  Probably the most used free LaTeX distribution is emTeX. The "em" in its name comes from its maintainer, Eberhard Mattes (who is known even more for his port of the Gnu C compiler, emx). Unfortunately, emTeX is a bit outdated now.
  

• emTeX/TDS
  This is the emTeX port, repackaged with additional LaTeX packages and organized in the TeX directory structure (to which LaTeX distributions for most operating systems comply). This distribution, maintained by Walter Schmidt, is also freely available. He also has written an extension (called TeX front end, TFE) for OS/2's EPM editor, so you can typeset and view your documents from the editor.
  

• OS/2TeX
  OS/2TeX is a shareware distribution, made by Jürgen Kleinböhl and sold for 70 DEM (about $35). It goes beyond the classical emTeX distribution by an editor (with syntax highlighting) which also provides menu access to LaTeX's translation and to the DVI preview.
  

• VTeX/2
  This is a more recent distribution which origins from the company MicroPress Inc. (also see the VTeX/2 page). The distribution is also free (though it's not allowed to bundle it with commercial products). VTeX/2 is special in the regard that it translates directly from LaTeX source code to Adobe's PDF file format. The generated files can also use links to jump to another place in the document or access URLs on the internet!
  

Installing emTeX/TDS

The file readme.eng which you fill find there, is the determining source for installation instructions. Though, I'll summarize it in short, assuming you install emTeX/TDS from scratch:

1. Install GSView and Ghostscript (see the March issue of the V.O.I.C.E. newsletter for this).
   
2. Create a temporary directory.
   
3. Put there the files from the emTeX/TDS directory on CTAN, namely readme.eng, tdsinst.cmd, config.zip, and texmf.zip .
   
4. Get the files bibtex4b.zip, dvid16h1.zip, dvid16h2.zip, makeindx.zip, mf4b.zip, mfjob12d.zip, mfware.zip, tex4b.zip, and texware.zip from the original emTeX directory. Place them also in the above mentioned directory.
   
5. Change to the directory where you placed the installation script  tdsinst.cmd, start it, and follow its instructions.
   
6. Copy the fix file config.ps into the directory \texmf\dvips\base\ of your emTeX/TDS installation, overwriting the old file. (This is an official bugfix.)
   
7. Reboot OS/2!
   
8. Open a command window and enter  makelatex  at the prompt in any directory.
   
9. Issue  makemf  next.
   
10. Read \texmf\doc\emtextds\manual.eng which can be found in your emTeX/TDS installation partition.
    

Hopefully, all went well. If not, please read and follow the file readme.eng in the emTeX/TDS CTAN directory.

After the installation, sit back, and drink a cup of coffee or tea :-) . Then, let's typeset and view the introductory example from above.

Using emTeX/TDS

Translating a LaTeX file

Next, you have to enter the LaTeX source code from above in your favorite editor. Create a file example.tex in your working directory and copy the LaTeX source from your browser window to the editor. Don't forget to save the file.

Change to the command line and type

[C:\WORKDIR\]latex example

This is emTeX (htex386), Version 3.14159 [4b] (no format preloaded)
**&latex example
(example.tex
LaTeX2e <1999/12/01> patch level 1
(e:/texmf/tex/latex/base/article.cls
Document Class: article 1999/09/10 v1.4a Standard LaTeX document class
(e:/texmf/tex/latex/base/size10.clo))
No file example.aux.
No file example.toc.
(e:/texmf/tex/latex/base/omscmr.fd) [1] (example.aux) )
Output written on example.dvi (1 page, 1616 bytes).
Transcript written on example.log.

DVI preview

[C:\WORKDIR\]start vp example

That looks fine, - but, where is the table of contents? The answer is that LaTeX generates the table of contents while it translates the document and includes the missing stuff in the next run.

So type again (you can use the arrow-up key)

[C:\WORKDIR\]latex example

No file example.aux.
No file example.toc.

This is the viewer main window you get.

Creating PostScript documents

[C:\WORKDIR\]dvips -P cmfonts example

This is dvips 5.83 Copyright 1998 Radical Eye Software (www.radicaleye.com)
dvips: *** HP LaserJet/600dpi ***
' TeX output 2000.04.17:2113' -> example.ps
<texc.pro><texps.pro>. <cmsy10.pfb><cmr7.pfb><cmbx12.pfb><cmr10.pfb>
<cmbx7.pfb><cmbx10.pfb>[1]

Start GSView to look at the PostScript file by clicking the GSView icon on your desktop and opening example.ps in your working directory. Alternatively, you may open your working folder and double-click on example.ps. (Similar to the DVI previewer, the reloading of the file upon changes can be automated if "Auto Redisplay" under the "Options" menu is enabled.) The file looks like

To print the file, select "File", then "Print ..." from the menu, and choose an appropriate printer driver (see the GSView and Ghostscript documentation for this). If you want to generate a PDF file, you may use the following settings:

After clicking on "Ok", you will be prompted for a filename to write the data to.

Working more effectively

1. Start GSView and your editor, and open an OS/2 command window.
   
2. Change to your working directory.
   
3. Edit your text and save it.
   
4. Change to the command window and type once

       latex example & dvips -P cmfonts example
       

   For further invocations you only need the arrow-up key. It may be necessary to repeat the command to update the table of contents or references in the text.
   
5. Load the result in GSView; if you have "Auto Redisplay" from the "Options" menu enabled, you also have to do this only once.
   

Conclusion

• many pages
  
• many pictures and/or tables
  
• complex and/or many mathematical formulas
  
• more than a few cross references
  
• bibliography sections whose styles changes from text to text (e. g. for different journals)
  

What comes next?

Therefore, I would like to present an article on VTeX/2 in the next issue of the V.O.I.C.E. newsletter.

For comments and wishes regarding articles on LaTeX and OS/2 please send a mail to Stefan Schwarzer.

Appendix: Some resources

There are several resources on the internet and in printed form available. (LateX2e is the official name of the latest LaTeX version.) Online resources are

• Homepage of the TeX Users group
  
• Homepage of DANTE, its German counterpart
  
• TeX and LaTeX frequently asked questions (FAQ) by the UK TeX Users Group (with search function)
  
• The not so short Introduction to LaTeX2e by Tobias Oetiker and others (tutorial; PDF file. This is a great example of a LaTeX document with links!)
  
• A simplified introduction to LaTeX by Harvey J. Greenberg (another nice tutorial)
  
• Hypertext Help with LaTeX (reference)
  
• LaTeX help 1.6 (reference; this is one large file, practical for download)
  
• Using Imported Graphics in LaTeX2e by Keith Reckdahl (PostScript file, also available as PDF version)
  

• LaTeX: A Document Preparation System by Leslie Lamport. Addison Wesley, ISBN 0-201-52983-1 (a very good start)
  
• The LaTeX Companion by M. Goossens, F. Mittelbach, and A. Samarin. Addison Wesley, ISBN 0-201-54199-8 (describes more sophisticated topics, not a good book to learn LaTeX from the beginnings)
  

© 2000, Stefan Schwarzer