source: main/trunk/greenstone3/resources/web/servlets.xml.svn@ 37750

Last change on this file since 37750 was 37750, checked in by anupama, 11 months ago

Opening xml comments added in for valid XML.

File size: 10.4 KB
Line 
1<servlet>
2 <!-- !!!! -->
3 <!-- This file was automatically generated from $GSDL3SRCHOME/resources/web/servlet.xml.in -->
4 <!-- !!!! -->
5
6 <servlet-name>library</servlet-name>
7 <description>The standard gsdl3 library program</description>
8 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
9 <!-- this is the servlet url path - needs to match what you have specified in servlet-mapping below -->
10 <init-param>
11 <param-name>library_name</param-name>
12 <param-value>library</param-value>
13 </init-param>
14
15 <!--
16 Production versions of Greenstone will typically need to set 'init-param' valus below if
17 the DL operates through a Reverse Proxy server, such as Apache2, which publically presents
18 externally over 'https' but internally routes things through to an http running instance
19 of tomcat providing Greenstone3.
20
21 For example, to have a Greenstone3 appear as:
22 https://mydomain.org/my-greenstone3/library
23
24 In your Apache2 configuration file include:
25
26 ProxyPass /my-greenstone3 http://localhost:8383/greenstone3
27 ProxyPassReverse /my-greenstone3 http://localhost:8383/greenstone3
28 <Location /my-greenstone3>
29 ProxyPassReverseCookiePath /greenstone3 /my-greenstone3
30 </Location>
31
32 The <Location> tags future proof things for the case where you run more than one
33 Greenstone3 on the same server. This can just be the ProxyPassReverseCookiePath
34 entry, if there is only one GS3 server running.
35
36 In the params below we break things down into constituent parts to make some of the
37 XSL template rules easier to write.
38 -->
39
40 <!--
41 Leave the following commented out if you are using http://localhost:8383/greenstone3/
42 as this is construted automatically from build.properties for use as the HTML <base> tag
43 -->
44 <!-- **** TODO: consider changing this to be built up from servlet_domain, servlet_opt_port, servlet_context / -->
45 <!--
46 <init-param>
47 <param-name>servlet_url_prefix</param-name>
48 <param-value>//mydomain.org//my-greenstone3/</param-value>
49 </init-param>
50 -->
51
52 <init-param>
53 <param-name>site_name</param-name>
54 <param-value>localsite</param-value>
55 </init-param>
56 <init-param>
57 <param-name>interface_name</param-name>
58 <param-value>default</param-value>
59 </init-param>
60 <init-param>
61 <param-name>receptionist_class</param-name>
62 <param-value>DefaultReceptionist</param-value>
63 </init-param>
64 <init-param>
65 <param-name>default_lang</param-name>
66 <param-value>en</param-value>
67 </init-param>
68 <init-param>
69 <!-- Does this servlet provide a favourites option? true/false-->
70 <param-name>favouritebasket</param-name>
71 <param-value>true</param-value>
72 </init-param>
73 <init-param>
74 <!-- Does this servlet provide a documentbasket option? true/false.
75Note, this currently doesn't work properly -->
76 <param-name>documentbasket</param-name>
77 <param-value>false</param-value>
78 </init-param>
79
80 <!--
81 The cookie consent manager is a component of the default interface that alerts the end user
82 to Greenstone's cookie usage. It also allows them to consent to non-essential cookies.
83 It can be customised by editing the 'cookieconsent-init.js' file in the default interface's 'js' folder.
84 To disable the manager for all interfaces that support it, remove or comment out this entire parameter.
85 -->
86 <init-param>
87 <param-name>cookie_consent</param-name>
88 <param-value>comment_this_entire_param_to_disable</param-value>
89 </init-param>
90 <!-- if you want to use a non standard greenstone cookie path (by default it will use greenstone.context in build.properties), then set the value of it here. If you are mapping to an address without this part (eg my-site.org/library) then cookie path will be / -->
91 <!--
92 <init-param>
93 <param-name>cookie_path</param-name>
94 <param-value>/greenstone3</param-value>
95 </init-param>
96 -->
97
98 <!-- ***** -->
99 <!-- Google related keys and id credentials -->
100 <!-- ***** -->
101
102 <!--
103 <init-param>
104 <param-name>google_tracking_id</param-name>
105 <param-value>UA-?????.....?????</param-value>
106 </init-param>
107 -->
108
109 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
110 <!-- More details at: https://developers.google.com/identity/sign-in/web/sign-in -->
111 <!--
112 <init-param>
113 <param-name>googlesignin_client_id</param-name>
114 <param-value>@googlesigninclientid@</param-value>
115 </init-param>
116 -->
117
118 <!-- For details on how to set up a Google API key to use with Google Maps, see:
119 https://developers.google.com/maps/documentation/javascript/get-api-key
120 -->
121 <!-- TLDR:
122 1. On the Credentials page, create an API key (copy the displayed value)
123 2. Then restrict it to your website
124 3. Further restrict calls to just Google Maps API
125 4. Give the key a name you will remember
126 5. Press Save
127 6. Paste the key into the <param-value> below
128 -->
129 <!--
130 <init-param>
131 <param-name>googlemaps_api_key</param-name>
132 <param-value>?????.....?????</param-value>
133 </init-param>
134 -->
135</servlet>
136
137<!-- the /* in the url-pattern below is necessary for the restful URLs to work.
138 e.g. greenstone3/library/collection/lucene-jdbm-demo/page/about
139-->
140<servlet-mapping>
141 <servlet-name>library</servlet-name>
142 <url-pattern>/library/*</url-pattern>
143</servlet-mapping>
144
145<servlet>
146 <servlet-name>halftone-library</servlet-name>
147 <description>A library servlet using the standard content, but with the halftone interface.</description>
148 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
149 <init-param>
150 <param-name>library_name</param-name>
151 <param-value>halftone-library</param-value>
152 </init-param>
153 <init-param>
154 <param-name>site_name</param-name>
155 <param-value>localsite</param-value>
156 </init-param>
157 <init-param>
158 <param-name>interface_name</param-name>
159 <param-value>halftone</param-value>
160 </init-param>
161 <init-param>
162 <param-name>receptionist_class</param-name>
163 <param-value>DefaultReceptionist</param-value>
164 </init-param>
165 <init-param>
166 <param-name>default_lang</param-name>
167 <param-value>en</param-value>
168 </init-param>
169
170 <!-- For Google Analytics -->
171 <!--
172 <init-param>
173 <param-name>google_tracking_id</param-name>
174 <param-value>UA-?????.....?????</param-value>
175 </init-param>
176 -->
177
178 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
179 <!--
180 <init-param>
181 <param-name>googlesignin_client_id</param-name>
182 <param-value>?????.....?????.apps.googleusercontent.com</param-value>
183 </init-param>
184 -->
185</servlet>
186
187<servlet-mapping>
188 <servlet-name>halftone-library</servlet-name>
189 <url-pattern>/halftone-library/*</url-pattern>
190</servlet-mapping>
191
192<!--<servlet>
193 <servlet-name>gs2-library</servlet-name>
194 <description>Greenstone 2 lookalike library program: uses localsite with the gs2 interface</description>
195 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
196 <init-param>
197 <param-name>library_name</param-name>
198 <param-value>gs2-library</param-value>
199 </init-param>
200 <init-param>
201 <param-name>site_name</param-name>
202 <param-value>localsite</param-value>
203 </init-param>
204 <init-param>
205 <param-name>interface_name</param-name>
206 <param-value>gs2</param-value>
207 </init-param>
208 <init-param>
209 <param-name>default_lang</param-name>
210 <param-value>en</param-value>
211 </init-param>
212 <init-param>
213 <param-name>session_expiration</param-name>
214 <param-value>1800</param-value>
215 </init-param>
216 <init-param>
217 <param-name>params_class</param-name>
218 <param-value>GS2Params</param-value>
219 </init-param>
220</servlet>
221
222<servlet-mapping>
223 <servlet-name>gs2-library</servlet-name>
224 <url-pattern>/gs2-library/*</url-pattern>
225</servlet-mapping>
226-->
227
228<!--<servlet>
229 <servlet-name>nzdl-library</servlet-name>
230 <description>gsdl3 library program</description>
231 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
232 <init-param>
233 <param-name>library_name</param-name>
234 <param-value>nzdl</param-value>
235 </init-param>
236 <init-param>
237 <param-name>site_name</param-name>
238 <param-value>nzdl</param-value>
239 </init-param>
240 <init-param>
241 <param-name>interface_name</param-name>
242 <param-value>nzdl</param-value>
243 </init-param>
244 <init-param>
245 <param-name>default_lang</param-name>
246 <param-value>en</param-value>
247 </init-param>
248 <init-param>
249 <param-name>params_class</param-name>
250 <param-value>NZDLParams</param-value>
251 </init-param>
252 <init-param>
253 <param-name>session_expiration</param-name>
254 <param-value>600</param-value>
255 </init-param>
256</servlet>
257
258<servlet-mapping>
259 <servlet-name>nzdl-library</servlet-name>
260 <url-pattern>/nzdl/*</url-pattern>
261</servlet-mapping>
262
263-->
264
265<!--<servlet>
266 <servlet-name>gateway</servlet-name>
267 <description>gsdl3 library based on gateway site and basic interface. It uses SOAP to talk to localsite</description>
268 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
269 <init-param>
270 <param-name>library_name</param-name>
271 <param-value>gateway</param-value>
272 </init-param>
273 <init-param>
274 <param-name>site_name</param-name>
275 <param-value>gateway</param-value>
276 </init-param>
277 <init-param>
278 <param-name>interface_name</param-name>
279 <param-value>basic</param-value>
280 </init-param>
281 <init-param>
282 <param-name>default_lang</param-name>
283 <param-value>en</param-value>
284 </init-param>
285</servlet>
286
287<servlet-mapping>
288 <servlet-name>gateway</servlet-name>
289 <url-pattern>/gateway/*</url-pattern>
290</servlet-mapping>
291-->
292
293<!--<servlet>
294 <servlet-name>basic-library</servlet-name>
295 <description>basic gsdl3 library program: uses localsite and the basic interface</description>
296 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
297 <init-param>
298 <param-name>library_name</param-name>
299 <param-value>basic-library</param-value>
300 </init-param>
301 <init-param>
302 <param-name>site_name</param-name>
303 <param-value>localsite</param-value>
304 </init-param>
305 <init-param>
306 <param-name>interface_name</param-name>
307 <param-value>basic</param-value>
308 </init-param>
309 <init-param>
310 <param-name>default_lang</param-name>
311 <param-value>en</param-value>
312 </init-param>
313 <init-param>
314 <param-name>allow_client_side_xslt</param-name>
315 <param-value>true</param-value>
316 </init-param>
317</servlet>
318
319<servlet-mapping>
320 <servlet-name>basic-library</servlet-name>
321 <url-pattern>/basic-library/*</url-pattern>
322</servlet-mapping>
323-->
Note: See TracBrowser for help on using the repository browser.