scsh-conservatory
/
sunet
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Adjust section about installing SSAX to package proposal 

Minor reformatting / typos removed
This commit is contained in:
interp 2004-05-13 21:27:26 +00:00
parent b568965f6e
commit 9d67969c09
1 changed files with 46 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
doc/latex/surflethowto.tex
View File

@ -61,50 +61,69 @@ The following sections will show pieces of \surflet code you might
want to try out. Therefore you need the SUnet webserver running with want to try out. Therefore you need the SUnet webserver running with
the ability to serve \surflets. This section tells you how to do it. the ability to serve \surflets. This section tells you how to do it.
\begin{enumerate} \paragraph{Obtaining necessary packages} You need Oleg's SSAX package
\item You need Oleg's SSAX package (for scsh), to be able to use (for scsh), to be able to use surflets:
surflets:
\begin{itemize} \begin{itemize}
\item Download Oleg's SSAX package from \item Download Oleg's SSAX package from
\url{http://prdownloads.sf.net/ssax/ssax-sr5rs-plt200-4.9.tar.gz?download}. \url{http://prdownloads.sf.net/ssax/ssax-sr5rs-plt200-4.9.tar.gz?download}.
\item Uncompress and untar it to any directory. This will create a \item Download the SSAX package kit from
directory called \name{SSAX}, to which I will refer to as \url{http://lamp.epfl.ch/~schinz/scsh_packages}.
\typew{\$SSAX}.
\item Unfortunately, this SSAX distribution (plt200-4.9) has a typo in \item Uncompress and untar both tarballs in the same directory.
the package definition for scsh. Apply the patch that comes with This will create a directory called \name{SSAX}, to which I will
the \surflets distribution to get rid of this typo: refer to as \typew{\$SSAX}. The package kit will add a file
\begin{itemize} \name{pkg-def.scm} to the \name{SSAX} directory.
\item \typew{cd \$SSAX}
\item \typew{patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch} \item Install SSAX as a scsh package by issuing the command
\end{itemize} \typew{scsh-install-pkg --prefix /path/to/your/package/root} in the
\typew{\$SSAX} directory. If you don't yet have the packaging
utility of Michel Schinz, you can obtain it from
\url{http://lamp.epfl.ch/~schinz/scsh_packages}.
If you don't want to install SSAX with the packaging utility, you
can adjust the scripts to directly load the SSAX package definitions
from \type{\$SSAX/lib/packages.scm}. Note that the original file
has a typo which you can correct with
\begin{alltt}
cd \$SSAX
patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch
\end{alltt}
% \item Unfortunately, this SSAX distribution (plt200-4.9) has a typo in
% the package definition for scsh. Apply the patch that comes with
% the \surflets distribution to get rid of this typo:
% \begin{itemize}
% \item \typew{cd \$SSAX}
% \item \typew{patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch}
% \end{itemize}
\end{itemize} \end{itemize}
\item You can start the SUnet webserver along with the \paragraph{Starting the SUrflet server}
\surflet-handler now. The \surflets distribution comes with a script that You can start the SUnet webserver along with the
\surflet-handler now. The SUnet distribution comes with a script that
does this for you: does this for you:
\begin{itemize} \begin{alltt}
\item \typew{cd \$sunet} \$ /path/to/your/package/root/sunet/web-server/start-surflet-server
\item \typew{SSAX=\$SSAX ./start-surflet-server} \end{alltt}
\end{itemize}
Please be patient, scsh has to load a lot of libraries. If the Please be patient, scsh has to load a lot of libraries. If the
loading succeeds you will see something like this: loading succeeds you will see something like this:
\begin{alltt} \begin{alltt}
[andreas@hgt sunet]\$ SSAX=/home/andreas/sw/SSAX ./start-surflet-server [andreas@hgt web-server]\$ ./start-surflet-server
Loading... Loading...
reading options: () reading options: ()
Going to run SUrflet server with: Going to run SUrflet server with:
htdocs-dir: /home/andreas/sw/sunet/web-server/root/htdocs htdocs-dir: /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/htdocs
surflet-dir: /home/andreas/sw/sunet/web-server/root/surflets surflet-dir: /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/surflets
images-dir: /home/andreas/sw/sunet/web-server/root/img images-dir: /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/img
port: 8008 port: 8008
log-file-name: /home/andreas/sw/sunet/web-server/httpd.log log-file-name: /tmp/httpd.log
a maximum of 5 simultaneous requests, syslogging activated, a maximum of 5 simultaneous requests, syslogging activated,
and home-dir-handler (public_html) activated. and home-dir-handler (public_html) activated.
@ -135,12 +154,10 @@ Error: 98
\end{alltt} \end{alltt}
In this case, pass another port number to the script, \eg 8000: In this case, pass another port number to the script, \eg 8000:
\codex{ssax=\$SSAX ./start-surflet-server -p 8000} \codex{start-surflet-server -p 8000}
The \typew{--help} option will show you more parameters that you can The \typew{--help} option will show you more parameters that you can
adjust, but you won't need them for this howto. adjust, but you won't need them for this howto.
\end{enumerate}
\section{How to send web pages} \section{How to send web pages}
@ -1386,7 +1403,7 @@ escaping, \eg for the ampersand (\&).
\section{Outlook} \section{Outlook}
More to come soon about\surflets containing of different parts and More to come soon about \surflets consisting of different parts and
individual SXML. individual SXML.