You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@stanbol.apache.org by Anuj Kumar <an...@gmail.com> on 2012/06/24 08:25:35 UTC

Blog on Enhancement Engine

Hello Everyone,

We at FORMCEPT [1] have documented few simple steps to create an
enhancement engine- http://formcept.com/blog/stanbol/
The blog represents our understanding of the platform and we believe that
it will be useful for the community as well.

Please take a look at it and provide your feedback. We will continue to
document our experiences with Stanbol in subsequent blogs.

Thanks,
Anuj

[1] FORMCEPT - Your Analysis Platform, http://www.formcept.com

Re: Blog on Enhancement Engine

Posted by seralf <se...@gmail.com>.
HI, this is a really good job!

thanks :-)

Alfredo Serafini

2012/6/24 Anuj Kumar <an...@gmail.com>

> Hello Everyone,
>
> We at FORMCEPT [1] have documented few simple steps to create an
> enhancement engine- http://formcept.com/blog/stanbol/
> The blog represents our understanding of the platform and we believe that
> it will be useful for the community as well.
>
> Please take a look at it and provide your feedback. We will continue to
> document our experiences with Stanbol in subsequent blogs.
>
> Thanks,
> Anuj
>
> [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
>

Re: Blog on Enhancement Engine

Posted by harish suvarna <hs...@gmail.com>.
Thanks Rupert and Anuj.
I will start using this template.

thanks
-harish

On Sun, Jun 24, 2012 at 10:15 AM, Anuj Kumar <an...@gmail.com> wrote:

> Thanks Alfredo and Rupert.
>
> Harish,
>
> As Rupert mentioned, you can create a separate project. Maven can take care
> of the dependencies. I have uploaded the sample project to GitHub-
> https://github.com/formcept/formcept-enhancer
>
> Happy Forking!
>
> Regards,
> Anuj
>
> On Sun, Jun 24, 2012 at 7:07 PM, harish suvarna <hs...@gmail.com>
> wrote:
>
> > Anuj,
> > Excellent blog. Thanks.
> > To help pure beginners like me, is it possible to add more information
> like
> > a) where the new enhancement engine code stays in apace stanbol source
> > directory?
> > b) where the maven files reside?
> >
> > So that beginner like me would take this as a template.
> >
> > -harish
> >
> > On Sun, Jun 24, 2012 at 6:21 AM, Anuj Kumar <an...@gmail.com> wrote:
> >
> > > Thanks Fabian.
> > > Regarding the documentation, sure, will do that.
> > >
> > > Regards,
> > > Anuj
> > >
> > > On Sun, Jun 24, 2012 at 6:11 PM, Fabian Christ <
> > > christ.fabian@googlemail.com
> > > > wrote:
> > >
> > > > Hi Anuj,
> > > >
> > > > great blog post for people to get started. Cool!
> > > >
> > > > If you have ideas or patches to improve our documentation on the
> > > > website, do not hesitate to create Jira issues or even send patches.
> > > > We know, that we have to improve our sites and help is always welcome
> > > > ;)
> > > >
> > > > Best,
> > > >  - Fabian
> > > >
> > > > 2012/6/24 Anuj Kumar <an...@gmail.com>:
> > > > > Hello Everyone,
> > > > >
> > > > > We at FORMCEPT [1] have documented few simple steps to create an
> > > > > enhancement engine- http://formcept.com/blog/stanbol/
> > > > > The blog represents our understanding of the platform and we
> believe
> > > that
> > > > > it will be useful for the community as well.
> > > > >
> > > > > Please take a look at it and provide your feedback. We will
> continue
> > to
> > > > > document our experiences with Stanbol in subsequent blogs.
> > > > >
> > > > > Thanks,
> > > > > Anuj
> > > > >
> > > > > [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
> > > >
> > > >
> > > >
> > > > --
> > > > Fabian
> > > > http://twitter.com/fctwitt
> > > >
> > >
> >
>

Re: Blog on Enhancement Engine

Posted by Anuj Kumar <an...@gmail.com>.
Thanks Alfredo and Rupert.

Harish,

As Rupert mentioned, you can create a separate project. Maven can take care
of the dependencies. I have uploaded the sample project to GitHub-
https://github.com/formcept/formcept-enhancer

Happy Forking!

Regards,
Anuj

On Sun, Jun 24, 2012 at 7:07 PM, harish suvarna <hs...@gmail.com> wrote:

> Anuj,
> Excellent blog. Thanks.
> To help pure beginners like me, is it possible to add more information like
> a) where the new enhancement engine code stays in apace stanbol source
> directory?
> b) where the maven files reside?
>
> So that beginner like me would take this as a template.
>
> -harish
>
> On Sun, Jun 24, 2012 at 6:21 AM, Anuj Kumar <an...@gmail.com> wrote:
>
> > Thanks Fabian.
> > Regarding the documentation, sure, will do that.
> >
> > Regards,
> > Anuj
> >
> > On Sun, Jun 24, 2012 at 6:11 PM, Fabian Christ <
> > christ.fabian@googlemail.com
> > > wrote:
> >
> > > Hi Anuj,
> > >
> > > great blog post for people to get started. Cool!
> > >
> > > If you have ideas or patches to improve our documentation on the
> > > website, do not hesitate to create Jira issues or even send patches.
> > > We know, that we have to improve our sites and help is always welcome
> > > ;)
> > >
> > > Best,
> > >  - Fabian
> > >
> > > 2012/6/24 Anuj Kumar <an...@gmail.com>:
> > > > Hello Everyone,
> > > >
> > > > We at FORMCEPT [1] have documented few simple steps to create an
> > > > enhancement engine- http://formcept.com/blog/stanbol/
> > > > The blog represents our understanding of the platform and we believe
> > that
> > > > it will be useful for the community as well.
> > > >
> > > > Please take a look at it and provide your feedback. We will continue
> to
> > > > document our experiences with Stanbol in subsequent blogs.
> > > >
> > > > Thanks,
> > > > Anuj
> > > >
> > > > [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
> > >
> > >
> > >
> > > --
> > > Fabian
> > > http://twitter.com/fctwitt
> > >
> >
>

Re: Blog on Enhancement Engine

Posted by Rupert Westenthaler <ru...@gmail.com>.
Hi

First a big thanks to Anuj. This is really a great blog post!


On Sun, Jun 24, 2012 at 3:37 PM, harish suvarna <hs...@gmail.com> wrote:
> Anuj,
> Excellent blog. Thanks.
> To help pure beginners like me, is it possible to add more information like
> a) where the new enhancement engine code stays in apace stanbol source
> directory?

You can put them wherever you want. You need just to make sure you add
the required dependencies to the pom.xml of your module. Maven will
take care of getting the required dependencies (from maven central -
if you program against the released 0.9.0-incubating version; or from
your local repository if you want to implement against the trunk. In
the later case you need to checkout and "mvn clean install" the
Stanbol source first.

In addition I would also to recommend to add the following to your
pom.xml file (as described in step-0 in the blog)

    <plugins>
        <!-- other popguns -->
        <plugin>
            <groupId>org.apache.sling</groupId>
            <artifactId>maven-sling-plugin</artifactId>
            <version>2.0.6</version>
        </plugin>
    </plugins>


    <profiles>
    <!-- other popguns -->
      <profile>
        <id>installBundle</id>
        <activation>
          <activeByDefault>false</activeByDefault>
        </activation>
        <build>
          <plugins>
            <plugin>
              <groupId>org.apache.sling</groupId>
              <artifactId>maven-sling-plugin</artifactId>
              <executions>
                <execution>
                  <id>install-bundle</id>
                  <goals>
                    <goal>install</goal>
                  </goals>
                </execution>
              </executions>
            </plugin>
          </plugins>
        </build>
      </profile>

In Stanbol this definition can be found in the parent POM
({stnbol-trunk}/parent/pom.xml)

This is very helpful as it allows to deploy your Enhancement Engine to
a running Stanbol instance by using

    mvn clean install -P installBundle \
        -Dsling.url=http://localhost:8080/system/console

So with doing that you can test changes to your Engine without
restarting Stanbol.

If you have started the Stanbol instance with the following parameters

    java -jar -Xmx1g --XX:MaxPermSize=256M -Xdebug \
        -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n
        org.apache.stanbol.launchers.full-*-incubating-SNAPSHOT.jar

than you can also connect the remote Java debugger to the your running
instance and easily continue debugging the current version of the
Enhancement Engine your are working on.


> b) where the maven files reside?
>

The maven file need to be in the root folder of your project. A
typical maven directory structure looks like

The pom file

    pom.xml

The root directory for your Java code

    src/main/java/

The root directory for your resources (e.g. properties files)

    src/main/resources/

The unit tests of your module

    src/test/java/

The resources used by unit tests

    src/test/resources/


hope this helps
Rupert


> So that beginner like me would take this as a template.
>
> -harish
>
> On Sun, Jun 24, 2012 at 6:21 AM, Anuj Kumar <an...@gmail.com> wrote:
>
>> Thanks Fabian.
>> Regarding the documentation, sure, will do that.
>>
>> Regards,
>> Anuj
>>
>> On Sun, Jun 24, 2012 at 6:11 PM, Fabian Christ <
>> christ.fabian@googlemail.com
>> > wrote:
>>
>> > Hi Anuj,
>> >
>> > great blog post for people to get started. Cool!
>> >
>> > If you have ideas or patches to improve our documentation on the
>> > website, do not hesitate to create Jira issues or even send patches.
>> > We know, that we have to improve our sites and help is always welcome
>> > ;)
>> >
>> > Best,
>> >  - Fabian
>> >
>> > 2012/6/24 Anuj Kumar <an...@gmail.com>:
>> > > Hello Everyone,
>> > >
>> > > We at FORMCEPT [1] have documented few simple steps to create an
>> > > enhancement engine- http://formcept.com/blog/stanbol/
>> > > The blog represents our understanding of the platform and we believe
>> that
>> > > it will be useful for the community as well.
>> > >
>> > > Please take a look at it and provide your feedback. We will continue to
>> > > document our experiences with Stanbol in subsequent blogs.
>> > >
>> > > Thanks,
>> > > Anuj
>> > >
>> > > [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
>> >
>> >
>> >
>> > --
>> > Fabian
>> > http://twitter.com/fctwitt
>> >
>>



-- 
| Rupert Westenthaler             rupert.westenthaler@gmail.com
| Bodenlehenstraße 11                             ++43-699-11108907
| A-5500 Bischofshofen

Re: Blog on Enhancement Engine

Posted by harish suvarna <hs...@gmail.com>.
Anuj,
Excellent blog. Thanks.
To help pure beginners like me, is it possible to add more information like
a) where the new enhancement engine code stays in apace stanbol source
directory?
b) where the maven files reside?

So that beginner like me would take this as a template.

-harish

On Sun, Jun 24, 2012 at 6:21 AM, Anuj Kumar <an...@gmail.com> wrote:

> Thanks Fabian.
> Regarding the documentation, sure, will do that.
>
> Regards,
> Anuj
>
> On Sun, Jun 24, 2012 at 6:11 PM, Fabian Christ <
> christ.fabian@googlemail.com
> > wrote:
>
> > Hi Anuj,
> >
> > great blog post for people to get started. Cool!
> >
> > If you have ideas or patches to improve our documentation on the
> > website, do not hesitate to create Jira issues or even send patches.
> > We know, that we have to improve our sites and help is always welcome
> > ;)
> >
> > Best,
> >  - Fabian
> >
> > 2012/6/24 Anuj Kumar <an...@gmail.com>:
> > > Hello Everyone,
> > >
> > > We at FORMCEPT [1] have documented few simple steps to create an
> > > enhancement engine- http://formcept.com/blog/stanbol/
> > > The blog represents our understanding of the platform and we believe
> that
> > > it will be useful for the community as well.
> > >
> > > Please take a look at it and provide your feedback. We will continue to
> > > document our experiences with Stanbol in subsequent blogs.
> > >
> > > Thanks,
> > > Anuj
> > >
> > > [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
> >
> >
> >
> > --
> > Fabian
> > http://twitter.com/fctwitt
> >
>

Re: Blog on Enhancement Engine

Posted by Anuj Kumar <an...@gmail.com>.
Thanks Fabian.
Regarding the documentation, sure, will do that.

Regards,
Anuj

On Sun, Jun 24, 2012 at 6:11 PM, Fabian Christ <christ.fabian@googlemail.com
> wrote:

> Hi Anuj,
>
> great blog post for people to get started. Cool!
>
> If you have ideas or patches to improve our documentation on the
> website, do not hesitate to create Jira issues or even send patches.
> We know, that we have to improve our sites and help is always welcome
> ;)
>
> Best,
>  - Fabian
>
> 2012/6/24 Anuj Kumar <an...@gmail.com>:
> > Hello Everyone,
> >
> > We at FORMCEPT [1] have documented few simple steps to create an
> > enhancement engine- http://formcept.com/blog/stanbol/
> > The blog represents our understanding of the platform and we believe that
> > it will be useful for the community as well.
> >
> > Please take a look at it and provide your feedback. We will continue to
> > document our experiences with Stanbol in subsequent blogs.
> >
> > Thanks,
> > Anuj
> >
> > [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com
>
>
>
> --
> Fabian
> http://twitter.com/fctwitt
>

Re: Blog on Enhancement Engine

Posted by Fabian Christ <ch...@googlemail.com>.
Hi Anuj,

great blog post for people to get started. Cool!

If you have ideas or patches to improve our documentation on the
website, do not hesitate to create Jira issues or even send patches.
We know, that we have to improve our sites and help is always welcome
;)

Best,
 - Fabian

2012/6/24 Anuj Kumar <an...@gmail.com>:
> Hello Everyone,
>
> We at FORMCEPT [1] have documented few simple steps to create an
> enhancement engine- http://formcept.com/blog/stanbol/
> The blog represents our understanding of the platform and we believe that
> it will be useful for the community as well.
>
> Please take a look at it and provide your feedback. We will continue to
> document our experiences with Stanbol in subsequent blogs.
>
> Thanks,
> Anuj
>
> [1] FORMCEPT - Your Analysis Platform, http://www.formcept.com



-- 
Fabian
http://twitter.com/fctwitt