--- texttool-architecture/soft-cgi.tex	2004/01/02 18:06:20	1.2
+++ texttool-architecture/soft-cgi.tex	2004/01/07 23:46:33	1.6
@@ -1,6 +1,46 @@
 \subsubsection{rec.cgi (register text)}
 \label{sec:rec.cgi}
 
+\paragraph
+On the ECHO server, hte registration of new texts is implemented by
+means of a cgi script, reg.cgi
+(archimedes/web/cgi-bin/toc/admin/reg.cgi ). reg.cgi retrieves a
+metadata file  in MPIWG archive metadata format from the entered uri
+(currently only local paths are supported ) and constructs from this
+file a toc.cgi object file (see below) , which it writes to toc.cgi's
+data section. [corpus???] It should be stressed that this is a
+registration procedure developed for a particular implementation of
+toc.cgi and not a part of the core application. 
+
+\paragraph
+reg.cgi takes two parameters, path and show.  Path should give the
+local path to the metadata file for the text that is being
+registered. If ``show'' is set to 1, reg.cgi will return for
+inspection the toc.cgi object file that it has built out of the
+submitted metadata file. 
+
+\paragraph{input metadata file}
+
+The input metadata file must have the following form
+
+\paragraph
+
+<resource>
+    ...
+    <meta>
+      <meta>
+                <bib type=''Book''>
+
+<title>Mainzer Untergerichtsordnung (von 1534)</title>
+<author>anon</author>
+<year>1580</year>
+        <texttool><display>yes</display>
+	<image>pageimgtif</image>
+	<text>/mpiwg/online/experimental/echo_DRQEdit_test/anon_Mainz_1580/fulltextDW/mainzugo02_utf8.xml</text>
+	<pagebreak>pb</pagebreak><presentation>01-presentation/info.xml</presentation></texttool></meta>
+
+    </meta>
+
 
 \subsubsection{toc.cgi (display text)}
 \label{sec:toc.cgi}
@@ -12,45 +52,62 @@
 \item An index of cgi parameters and values with short descriptions of function
 \end{enumeration}
 
-\paragraph{cgi parameters -- standard queries}
+\paragraph{}
+toc.cgi is a perl script for displaying collections of xml texts and 
+linking them to related resources such as page-images, morphological
+analysis, commentaries, dictionaries, etc. It implements generic methods
+for resource-linking provided by a series of perl modules which are in
+turn based mainly on generic tools for xml manipulation and networking
+written in C. 
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus
+\paragraph{cgi parameters -- standard queries}
 
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus }
+\newline
+\newline
 get a listing of corpora
 
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest }
+\newline
+\newline
 get an xml listing of corpora 
 
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi }
+\newline
+\newline
 get a listing of works in default corpus
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1 }
+\newline
+\newline
 get a listing of works in corpus 1 [default corpus = 0]
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist }
+\newline
+\newline
 get an xml listing of works in default corpus 
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1 }
+\newline
+\newline
 get an xml listing of works in corpus 1
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb }
+\newline
+\newline
 get a work from default corpus with thumbnail navbar displayed left
 
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright }
+\newline
+\newline
 get a work from default corpus with thumbnail navbar displayed right
 
-http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22
-
+\htmladdnormallink{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22 }{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22 }
+\newline
+\newline
 get a page of text from a work from default corpus