<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "document-v12.dtd">
<document>
    <header>
        <title>Themes</title>
    </header>
    <body>
        <section>
            <title>blojsom theme architecture</title>
            <p>
                A big phrase for such a small thing
                <icon src="happy.gif" alt="happy"/>. Themes are simply alternate templates and style
                sheets that tell blojsom how to render a different presentation. Creating new themes is quick, easy and fun.
            </p>
        </section>
        <section>
            <title>Installing blojsom themes</title>
            <p>
                Starting with blojsom 1.7, blojsom ships with an alternate theme called
                <strong>SecondWave</strong>. For those who care, the name is
                a pun on the fact that it's the 2nd template for blojsom. SecondWave is a
                Velocity-only template.
            </p>
            <p>
                Here is a
                <link href="takingout_secondwave.png">screenshot</link> of SecondWave in action
            </p>
            <p>
                To install the template simply follow these steps:
            </p>
            <ol>
                <li>Copy the all SecondWave files (secondwave*.vm) from
                    <code>$BLOJSOM_INSTALL_DIR</code>/themes/secondwave to your individual
                    <code>/WEB-INF/(user-id)/templates</code> directory on your server.
                </li>
                <li>Copy the
                    <code>blojsom-secondwave.css</code> stylesheet from
                    <code>$BLOJSOM_INSTALL_DIR</code>/themes/secondwave to your to webapp root
                    context directory on your sever.
                </li>
            </ol>
            <note> This is not
                <em>/WEB-INF</em> but the same directory in which
                <em>/WEB-INF</em> lives
            </note>
            <p>
                All that is left to do is tell blojsom to use the new template.
            </p>
        </section>
        <section>
            <title>Configuring the active theme</title>
            <p>
                All you need to do to enable your template is to edit your individual
                <code>/WEB-INF/(user-id)flavor.properties</code>
                and edit the value for the html flavor
            </p>
            <p>
                As an example, for SecondWave the line should read:
                <code>html=secondwave.vm, text/html;chartset=UTF-8</code>
            </p>
            <p>
                That's it, your blog has a brand new look!
            </p>
        </section>
    </body>
</document>
