2. Creating a tutorial

Let us assume that the name of your tutorial should be mytut. You need to prepare two files: mytut.tex which is used to generate the HTML version of the tutorial and mytutbodydy.tex which contains your actual tutorial text.


2.1 mytut.tex

The file should look exactly like:

 1+       \documentclass[a4paper]{article}
 2+       \usepackage{html}
 3
 4        \parindent 0pt
 5        \parskip 0.5\baselineskip
 6
 7+       \begin{document}
 8
 9+       12
13+       14+       \input xhtml
15+       16
17+       \setcounter{sectionno}{3}
18+       \input mytutbody
19+       \frameclose
20
21+       \end{document}

It is necessary that the lines marked with + appear in this file. Any style you might want to use has to be added before \usepackage{html}.

The number in given in line \setcounter{sectionno}{3} is number of calls of \xchapter and \xsection in the file mytutbody.


2.2 mytutbody.tex

This file contains your actual tutorial text. It looks like:

          \xchapter{How to make a tutorial}{tuthow}{}
          ...
          \xsection{Creating a tutorial}{tutprep}{}
          ...
          \xsubsection{\tt mytut.tex}{tutmytut}{}
          ...
          \xsubsection{\tt mytutbody.tex}{tutmytutbody}{}
          ...
          \xsubsection{Generating HTML files}{tutgen}{}
          ...
          \xsection{New LaTeX commands}{tutcmd}{Commands}
          ...
          \xsubsection{xchapter}{mytutxchapter}
          ...
          \xsubsection{xsection}{mytutxsection}{}
          ...
          \xsubsection{xsubsection}{mytutxsubsection}{}
          ...
          \xsubsection{xsection}{mytutxsection}{}
          ...
          \xsubsection{xsubsection}{mytutxsubsection}{}
          ...
          \xsubsection{xlink}{mytutxlink}{}
          ...
          \xsubsection{tlink}{mytuttlink}{}
          ...
          \xsubsection{nlink}{mytutnlink}{}
          ...

It is important to replace the \chapter, \section and \subsection commands of LaTeX by the the commands \xchapter, \xsection and \xsubsection.

If we do not do this then the contents file for HTML will not be generated correctly. The second parameter is a name of a label which will be used in HTML to jump from the table of contents to the appropriate position in the HTML body files.


2.3 Generating HTML files

After creating these files and ensuring that the files compile under LaTeX you can call in the shell

         maketut mytut "How to make my own tutorial in XploRe ?"

Assumed that the files xlatex.tex, xhtml.tex and xmanual.tex as well as html.sty are available, the shell script maketut will generate a set of HTML files. The second parameter given is the title which will appear on top of each HTML page.

After this is finished you need to copy all files with the extension *.gif in your tutorial directory, as well as the following HTML files:

          mytuttoc*.html
          mytutnode*.html
          mytutframe*.html

Make also sure that you copy the files xpl_bg.gif, xpl_logo.gif, xpl_2.gif, xpl_3.gif, md_cube.gif, xstyle1.css and xstyle2.css from /home/xplore/source/tutorials/_styles.

The entry point to our tutorial will be

mytutstart.html



Method and Data Technologies   MD*TECH Method and Data Technologies
  http://www.mdtech.de  mdtech@mdtech.de