StringTemplate Renderer for JPublish, a Component this time ;)

Sat, 01 Sep 2007 20:28:44 GMT

Hi there,

For those of you maintaining JPublish sites developed with Velocity or FreeMarker, using the newly added StringTemplate renderer is not an easy option, especially if those sites are in production. So what can you do if you want to use ST?

Don't worry, you can render StringTemplate syntax in Velocity/FreeMarker driven pages by using the StringTemplate component that I just added to the JPublish component family.

Using it is very simple.

Build the ST Component from SVN and load it in jpublish.xml:

<component-manager>
    <components>
        <component id="JPST" classname="ca.flop.jpublish.components.JPSTComponent">
            <stringtemplate-groups>
                <group name="default" relative-root-dir="/st_content" refresh-interval="15"
                       lexer="org.antlr.stringtemplate.language.DefaultTemplateLexer"/>
                <group name="menus" relative-root-dir="/st_menus"/>
            </stringtemplate-groups>
        </component>
    </components>
</component-manager>

and then use the ST component wherever ST is required, for example in a Velocity page:
$components.JPST.renderPath("menus:main_menu"), the contents of the main_menu.st file will be immediately rendered in-line.

I will add more details in the JPublish Wiki, meanwhile you can find the code and a demo web application in our SVN.

Have fun!
-florin

Wiki syntax -Textile- available now in JPublish

Sun, 20 May 2007 20:03:19 GMT

In my recent blog entry I was contemplating adding Wiki support to JPublish. It is available now :)

I decided to add Textile support through JTextile. This is possible now very easy due to the improved support of the new JPublish Component API which I plan to improve even more. RADEOX implementation will follow.

I can say that I am already addicted to this new feature, especially that you can create your pages with smart editors, such as: TextMate, who already understands the Textile syntax and the bundle supplied with TextMate is very valuable.

Let's see how easy is to use the Textile support in JPublish.

1. download and build our latest JPublish version from our new SVN repository.
2. if you want to go straight to the demo app, check the folder components/jptextile from your JPublish folder and build the jptextile web application (ant dist), deploy the distribution into your preferred Servlet container and start playing with Textile, skip the rest.
3. in your jpublish.xml configuration file from an existing application, add the following:

    <component-manager>
        <components>
            <component id="jpTextile" classname="ca.flop.jpublish.wiki.JPTextileComponent">
                <repository name="fs_repository"/>
            </component>
        </components>
    </component-manager>

4. use Textile syntax in any page you need, through this simple component support: $components.jpTextile.renderText("h1. Hi!"), if you want to transform a string containing Textile sytax, or include and transform an external file containing a larger text: $components.jpTextile.renderPath("text.textile") , where the "text.textile" is a text file from your JPublish repository you mentioned in the jpublish.xml file; fs_repository, respectively.

I hope you'll find this support handy, and if yes, please send us your feedback to our user-group list.

Cheers,
-florin

Spikes Of Nothingness - component tag

StringTemplate Renderer for JPublish, a Component this time ;)

Wiki syntax -Textile- available now in JPublish