1 | Note: when running the localhost:8080/gsdl3/library, only the mgppdemo and
|
---|
2 | chinese demo collections can do anything useful.
|
---|
3 |
|
---|
4 | *******************************************************
|
---|
5 | There are 3 main parts to the system: sites, interfaces, library executables.
|
---|
6 |
|
---|
7 | Sites contain collections. Interfaces contain images and xslts.
|
---|
8 |
|
---|
9 | There are 2 sites in this prototype example.
|
---|
10 |
|
---|
11 | sites/localsite is a standalone site, like used by a local library. It has
|
---|
12 | no connections to any other sites.
|
---|
13 |
|
---|
14 | sites/site1 is a site that specifies a SOAP connection to another site: localsite
|
---|
15 |
|
---|
16 | to run site1, and talk to localsite via SOAP, you need to have apache tomcat installed, running, and serving site2. (see INSTALL)
|
---|
17 |
|
---|
18 | You can add other sites by putting a directory in the sites directory, and
|
---|
19 | configuring it appropriately. TODO MakeSite program
|
---|
20 |
|
---|
21 |
|
---|
22 | There is one interface - default. you can add other interfaces if you like, in
|
---|
23 | the interfaces directory.
|
---|
24 |
|
---|
25 | The interface and site to use for a particular servlet is determined by the
|
---|
26 | init-params in the web.xml file (web/WEB-INF/web.xml)
|
---|
27 |
|
---|
28 | XSL Files: when an xslt file is to be used, eg home.xsl, it is looked for in
|
---|
29 | several places: in sites/current site/transform, interfaces/current interface/transform, and finally interfaces/default/transform
|
---|
30 |
|
---|
31 | so you can change the interface by adding new xslt files to these three places.
|
---|
32 |
|
---|
33 | ******************************************************
|
---|
34 | Servlet:
|
---|
35 |
|
---|
36 | need to run setup.bash to set CLASSPATH etc
|
---|
37 |
|
---|
38 | Can run the web interface by starting tomcat (see INSTALL) and going to
|
---|
39 | localhost:8080/gsdl3/library
|
---|
40 |
|
---|
41 | only mgpp collections can be searched - use mgppdemo, not demo.
|
---|
42 |
|
---|
43 | to change the interface language, you can add &l=fr to the url. However, there are no alternative langs at the moment.
|
---|
44 |
|
---|
45 | *******************************************************
|
---|
46 | Command line libraries
|
---|
47 |
|
---|
48 | need to run setup.bash to set CLASSPATH etc
|
---|
49 |
|
---|
50 | there is a sample executable class: Library1
|
---|
51 |
|
---|
52 | it can be run by "java org.greenstone.gsdl3.Library1 <sitehome>"
|
---|
53 |
|
---|
54 | sitehome is the base dir for the site you are running:
|
---|
55 | for the local library example site, its .../gsdl3/sites/localsite
|
---|
56 | for the distributed soap example site, its .../gsdl3/sites/site1
|
---|
57 |
|
---|
58 | Library1 - just takes straight XML queries and returns the results. It talks
|
---|
59 | directly to the message router
|
---|
60 |
|
---|
61 | see the manual for sample messages.
|
---|
62 |
|
---|
63 | this program is not very useful - except for debugging - when using the servlet
|
---|
64 | or Library2, can print out the messages - then cut and paste these for
|
---|
65 | input to Library1
|
---|
66 |
|
---|
67 |
|
---|
68 | Library2:
|
---|
69 |
|
---|
70 | java org.greenstone.gsdl3.Library2 <sites home> <site name> <interfaces home> <interface name>
|
---|
71 |
|
---|
72 | takes xml request of 'cgi' params, and returns html (input must be all on one line)
|
---|
73 |
|
---|
74 | Collections:
|
---|
75 |
|
---|
76 | Can use the new java Queryer to test mgpp collections:
|
---|
77 |
|
---|
78 | java org.greenstone.mgpp.Queryer <basedir> <indexdir> <textdir>
|
---|
79 |
|
---|
80 | eg
|
---|
81 | java org.greenstone.mgpp.Queryer sites/localsite/collect/mgppdemo/index tt/mgppdemo text/mgppdemo
|
---|
82 |
|
---|
83 | you can use any mgpp collection built with gsdl2 - you need to add a
|
---|
84 | buildcfg.xml file to the index directory - look at the one for mgppdemo to see
|
---|
85 | what it should look like.
|
---|
86 |
|
---|
87 |
|
---|
88 |
|
---|
89 |
|
---|
90 |
|
---|
91 |
|
---|
92 |
|
---|