jamun/README at master · artunit/jamun · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
README – Created: March 2011
Last Revised: May 2011

There must be a config.properties file, the outline is here:

    https://github.com/artunit/jamun/blob/master/config/config.properties.sample

Fill in the values, copy this to config.properties and place it in the "config" directory
identified below.

* tomcat installation

If you are using tomcat, the location of the config file should be

    {tomcat-base}/work/Catalina/config

copy the dist/gulab.war file to webapps, and then access the application at:

    http://localhost:8080/gulab/jamun

or whatever host/port tomcat uses. This is the simplest option.

* maven and jetty installation

This combination is more involved and requires a few jar files that need to be installed manually:

* jamun-1.0-0.jar (https://github.com/artunit/artunit-mvn-repo/blob/master/snapshots/org/conifer/jamun/1.0-0/jamun-1.0-0.jar)
* commons-httpclient-3.0.jar (http://archive.apache.org/dist/httpcomponents/commons-httpclient/3.0/binary/)
* jtidy-r938.jar (http://sourceforge.net/projects/jtidy/files/JTidy/r938/jtidy-r938.zip/download)
* lucene-core and lucene-highlighter (http://www.apache.org/dyn/closer.cgi/lucene/java/)

Download these and install them directly into your local maven repository, for example:

    mvn install:install-file -DgroupId=org.conifer -DartifactId=jamun -Dversion=1.0-0 -Dpackaging=jar -Dfile=gbook-1.0-0.jar

    mvn install:install-file -DgroupId=commons-httpclient -DartifactId=commons-httpclient -Dversion=3.0.1 -Dpackaging=jar -Dfile=commons-httpclient-3.0.jar

    mvn install:install-file -DgroupId=jtidy -DartifactId=jtidy -Dversion=r938 -Dpackaging=jar -Dfile=jtidy-r938.jar

    mvn install:install-file -DgroupId=lucene -DartifactId=lucene-core -Dversion=2007-05-20_00-04-53 -Dpackaging=jar -Dfile=lucene-core-2007-05-20_00-04-53.jar

    mvn install:install-file -DgroupId=lucene -DartifactId=lucene-highlighter -Dversion=2007-05-20_00-04-53 -Dpackaging=jar -Dfile=lucene-highlighter-2007-05-20_00-04-53.jar

The application is set up as a cocoon block, and maven can supply the application environment:

    mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org

    Select option 3 and supply some package options:

    Choose archetype:
    1: http://cocoon.apache.org -> cocoon-22-archetype-block-plain (Creates an empty Cocoon block; useful if you want to add another block to a Cocoon application)
    2: http://cocoon.apache.org -> cocoon-22-archetype-block (Creates a Cocoon block containing some small samples)
    3: http://cocoon.apache.org -> cocoon-22-archetype-webapp (Creates a web application configured to host Cocoon blocks. Just add the block dependencies)
    Choose a number:  (1/2/3): 3
    Define value for groupId: : org.conifer
    Define value for artifactId: : gulab
    Define value for version:  1.0-SNAPSHOT: : 1.0.0
    Define value for package:  org.conifer: :

The application's pom.xml file needs to be given the following dependencies:

    <dependency>
        <groupId>org.conifer</groupId>
        <artifactId>jamun</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cocoon</groupId>
        <artifactId>cocoon-core</artifactId>
        <version>2.2.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cocoon</groupId>
        <artifactId>cocoon-servlet-service-components</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cocoon</groupId>
        <artifactId>cocoon-template-impl</artifactId>
        <version>1.1.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cocoon</groupId>
        <artifactId>cocoon-flowscript-impl</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.4</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>commons-httpclient</groupId>
        <artifactId>commons-httpclient</artifactId>
        <version>3.0.1</version>
    </dependency>
    <dependency>
        <groupId>jtidy</groupId>
        <artifactId>jtidy</artifactId>
        <version>r938</version>
    </dependency>
    <dependency>
        <groupId>lucene</groupId>
        <artifactId>lucene-core</artifactId>
        <version>2007-05-20_00-04-53</version>
    </dependency>
    <dependency>
        <groupId>lucene</groupId>
        <artifactId>lucene-highlighter</artifactId>
        <version>2007-05-20_00-04-53</version>
    </dependency>
    <dependency>
        <groupId>org.ko.ourontario</groupId>
        <artifactId>cocoon-transformers-ko</artifactId>
        <version>1.1.0-SNAPSHOT</version>
    </dependency>

Create a directory called config in "gulab" and copy config.properties there. Jetty
will launch the environment:

    mvn package jetty:run

The application is available on  the default jetty port:

    http://localhost:8888/jamun/

Please address any questions to:

art rhyno <http://projectconifer.ca>