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.
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.
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.
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
![]() |
MD*TECH Method and Data Technologies |
http://www.mdtech.de mdtech@mdtech.de |