Annotation of texttool-architecture/soft-cgi.tex, revision 1.18
1.1 casties 1: \subsubsection{rec.cgi (register text)}
2: \label{sec:rec.cgi}
3:
1.4 bcfuchs 4: \paragraph
1.7 bcfuchs 5: On the ECHO server, the registration of new texts is implemented by
1.5 bcfuchs 6: means of a cgi script, reg.cgi
7: (archimedes/web/cgi-bin/toc/admin/reg.cgi ). reg.cgi retrieves a
8: metadata file in MPIWG archive metadata format from the entered uri
9: (currently only local paths are supported ) and constructs from this
10: file a toc.cgi object file (see below) , which it writes to toc.cgi's
11: data section. [corpus???] It should be stressed that this is a
12: registration procedure developed for a particular implementation of
13: toc.cgi and not a part of the core application.
1.4 bcfuchs 14:
15: \paragraph
16: reg.cgi takes two parameters, path and show. Path should give the
17: local path to the metadata file for the text that is being
18: registered. If ``show'' is set to 1, reg.cgi will return for
19: inspection the toc.cgi object file that it has built out of the
20: submitted metadata file.
1.5 bcfuchs 21:
22: \paragraph{input metadata file}
23:
24: The input metadata file must have the following form
25:
1.17 casties 26: \begin{verbatim}
1.5 bcfuchs 27: <resource>
28: ...
29: <meta>
30: <meta>
31: <bib type=''Book''>
32:
33: <title>Mainzer Untergerichtsordnung (von 1534)</title>
34: <author>anon</author>
35: <year>1580</year>
36: <texttool><display>yes</display>
1.17 casties 37: <image>pageimgtif</image>
38: <text>/mpiwg/online/experimental/echo_DRQEdit_test/anon_Mainz_1580/fulltextDW/mainzugo02_utf8.xml</text>
39: <pagebreak>pb</pagebreak><presentation>01-presentation/info.xml</presentation></texttool></meta>
1.5 bcfuchs 40:
41: </meta>
1.17 casties 42: \end{verbatim}
1.4 bcfuchs 43:
1.7 bcfuchs 44: \paragraph{archimedes object registration}
1.1 casties 45:
46: \subsubsection{toc.cgi (display text)}
47: \label{sec:toc.cgi}
48:
1.2 bcfuchs 49: \paragraph{plan of this section }
50:
1.17 casties 51: \begin{enumerate}
1.9 bcfuchs 52: \item An overview of toc.cgi architecture
1.2 bcfuchs 53: \item A walk-through of typical cgi queries for toc.cgi
54: \item An index of cgi parameters and values with short descriptions of function
1.16 bcfuchs 55: \item The TOC Perl modules
1.17 casties 56: \end{enumerate}
1.2 bcfuchs 57:
1.9 bcfuchs 58: \paragraph{Overview of toc.cgi architecture}
59:
60: \subparagraph{}
1.6 bcfuchs 61: toc.cgi is a perl script for displaying collections of xml texts and
62: linking them to related resources such as page-images, morphological
63: analysis, commentaries, dictionaries, etc. It implements generic methods
64: for resource-linking provided by a series of perl modules which are in
1.9 bcfuchs 65: turn based mainly on generic open-source tools for xml manipulation and networking
1.6 bcfuchs 66: written in C.
1.9 bcfuchs 67:
68: \subparagraph{toc.cgi collections--Network transparency}
69: Each of the collections in toc.cgi is a ``virtual'' collection, that
70: is, a collection of links or uri's to resources that reside somewhere on an accessible
71: network, local or remote.
72:
73: \subparagraph{toc.cgi collections--remote resources}
74:
75: What is at the other end of the link is of no concern to toc.cgi, as
76: long as the resource referenced by the link meets minimal toc.cgi
77: requirements--how the resource is actually implemented and exposed is
78: a matter for the resource provider. The link may, for instance, point
79: directly to an xml text or it may point to a container which exposes a
80: particular xml view of an underlying resource that is perhaps not in
81: xml format at all.
82:
83:
84: \subparagraph{resource registry}
85:
86:
87:
1.6 bcfuchs 88:
1.2 bcfuchs 89: \paragraph{cgi parameters -- standard queries}
90:
1.17 casties 91: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=corpus }
1.3 bcfuchs 92: \newline
93: \newline
1.2 bcfuchs 94: get a listing of corpora
95:
96:
1.17 casties 97: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpusmanifest }
1.3 bcfuchs 98: \newline
99: \newline
1.2 bcfuchs 100: get an xml listing of corpora
101:
1.17 casties 102: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi }
1.3 bcfuchs 103: \newline
104: \newline
1.2 bcfuchs 105: get a listing of works in default corpus
106:
1.17 casties 107: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?corpus=1 }
1.3 bcfuchs 108: \newline
109: \newline
1.2 bcfuchs 110: get a listing of works in corpus 1 [default corpus = 0]
111:
1.17 casties 112: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist }
1.3 bcfuchs 113: \newline
114: \newline
1.2 bcfuchs 115: get an xml listing of works in default corpus
116:
1.17 casties 117: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?step=xmlcorpuslist;corpus=1 }
1.3 bcfuchs 118: \newline
119: \newline
1.2 bcfuchs 120: get an xml listing of works in corpus 1
121:
1.17 casties 122: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=baifl_renav_006_la_1537;step=thumb }
1.3 bcfuchs 123: \newline
124: \newline
1.2 bcfuchs 125: get a work from default corpus with thumbnail navbar displayed left
126:
127:
1.17 casties 128: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=thumb;ftype=thumbright }
1.3 bcfuchs 129: \newline
130: \newline
1.2 bcfuchs 131: get a work from default corpus with thumbnail navbar displayed right
132:
1.17 casties 133: \url{ http://archimedes.mpiwg-berlin.mpg.de/cgi-bin/toc/toc.cgi?dir=jorda_ponde_050_la_1533;step=textonly;corpus=;page=22 }
1.3 bcfuchs 134: \newline
135: \newline
1.2 bcfuchs 136: get a page of text from a work from default corpus
137:
138:
1.16 bcfuchs 139: \paragraph{TOC Perl Modules}
140: \subparagraph{general}The documentation for the Toc Perl Modules is
141: located in the modules themselves in POD format. The POD is the
142: definitive documentation for the modules.
1.2 bcfuchs 143:
1.16 bcfuchs 144: The modules are available to archimedes staff from cvs on the archimedes server at
145: 141.14.236.86:/perseus/cvsroot in the module
146: /perseus/cvsroot/mpitexts/perl/perllib. To get them, log on to the
147: archimedes server and use the commandline command:
1.17 casties 148: \begin{verbatim}
1.16 bcfuchs 149: cvs -d /perseus/cvsroot co /perseus/cvsroot/mpitexts/perl/perllib
1.17 casties 150: \end{verbatim}
1.16 bcfuchs 151:
152: or from a remote location
153:
1.17 casties 154: \begin{verbatim}
1.16 bcfuchs 155: bash; export CVS_RSH=ssh; cvs -d :ext:myusername@141.14.236.86:/perseus/cvsroot co /perseus/cvsroot/mpitexts/perl/perllib
1.17 casties 156: \end{verbatim}
1.1 casties 157:
1.18 ! bcfuchs 158: \input{soft-search}
1.1 casties 159:
160: \subsubsection{Morphology}
161: \label{sec:morphology}
162:
163:
164: \subsubsection{Dictionary server}
165: \label{sec:dictionary-server}
166:
1.7 bcfuchs 167:
168: \subsubsection{helper programs}
169:
170: \paragraph{addarch.pl ARCHIMEDES}
171:
172: Automatically registers new texts as toc.cgi objects when they appear in
1.8 bcfuchs 173: cvs. Automatically updates relevant morphological indices (slow!) each
174: time a cvs update occurs. This program is called by a hook in the cvs
175: ``loginfo'' configuration file.
1.7 bcfuchs 176:
177:
1.8 bcfuchs 178: \paragraph{makelemma.pl ARCHIMEDES}
1.7 bcfuchs 179:
180: Updates lemmatization indices.
181: Parameters:
182: No parameter--update all lemmatization indices
183: [latin | ital | greek | en | nl | de]-- update this language
184:
1.8 bcfuchs 185: \paragraph{makefast.pl ARCHIMEDES}
1.7 bcfuchs 186:
187: Updates the toc.cgi morphology indices
188: Parameters
189: No parameter--update all lemmatization indices
190: [latin | ital | greek | en | nl | de]-- update this language
1.1 casties 191:
1.14 bcfuchs 192: \subsubsection{summary of differences btwn the archimedes toc.cgi
193: implementation and the echo toc.cgi impelementation (toc.x.cgi)}
194:
195: \paragraph{missing in archimedes}
1.17 casties 196: \begin{enumerate}
1.14 bcfuchs 197:
198: \item html templates (coded but phased out of cvs branch)
1.17 casties 199: \end{enumerate}
1.14 bcfuchs 200:
201: \paragraph{missing in echo}
1.17 casties 202: \begin{enumerate}
1.14 bcfuchs 203:
204: \item word-coloring?
205: \item remote text method may work differently
206:
207:
208:
1.17 casties 209: \end{enumerate}
1.15 bcfuchs 210: \paragraph{differences}
1.17 casties 211: \begin{enumerate}
1.15 bcfuchs 212: \item structure of info.xml
213: \item resource-discovery algorithm for info.xml
1.17 casties 214: \end{enumerate}
1.14 bcfuchs 215:
216:
217:
1.1 casties 218: %%% Local Variables:
219: %%% mode: latex
220: %%% TeX-master: "texttools"
221: %%% End:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>