Initial Filter

With this Filter for JSPWiki you can display initial letters by the use of gif's.

Example

This is an initial. Initials are special letters at the beginning of a text as known by books. HTML/CSS has a standard for initials, but it looks a little bit ugly right now, and you can't choose the font, so this filter is a big advantage for all wiki's that aims to look a little bit old fashioned like this wiki for role players.

is created by the following syntax:

T his is an initial. Initials are special letters at the beginning

of a text as known by books. HTML/CSS has a standard for initials, but

it looks a little bit ugly right now, and you can't choose the font,

so this filter is a big advantage for all wiki's that aims to look a

little bit old fashioned like this wiki for role players.

Installation

1. For each letter in the alphabet you need a single gif with the name of the letter like

<code>a.gif</code>

. Copy this to a directory named

<code>{JSPWiki}/initial</code>

. Now each # on your page would be replaced by the gif with the name #.gif. You can also make a second set of gifs for an other font. This second set must be named like

<code>a1.gif</code>

. Each # would be replaced by the gif with the name #1.gif. You can use this Datei:Gif-dateien!.zip as an example.

2. The following jar must be copied to

<code>{JSPWiki}/WEB-INF/lib</code>

:

SBaltesPlugins.jar

3. Your {JSPWiki}/WEB-INF/filters.xml may look like the following

<code>

   <?xml version="1.0"?>

   <pagefilters>

      <filter>

         <class>de.sbaltes.jspwiki.filters.InitialFilter</class>

         <param>

            <name>initial.font.path.1</name>

            <value>initial/</value>

         </param>

         <param>

            <name>initial.font.path.2</name>

            <value>initial/</value>

         </param>

      </filter>

   </pagefilters>

</code>

4. Have a look at your jspwiki.properties, maybe you must add the following line:

<code>

jspwiki.filterConfig = {JSPWiki}/WEB-INF/filters.xml

</code>

5. Be sure to have a JspWiki >= v2.1.115 installed

Source Code

The source code is part of the SBaltesPlugins.jar.

License

InitialFilter itself is under the LGPL.

InitialFilter a JspWiki Filter for visualising inital letters.

This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

Lesser General Public License for more details.

GNU LESSER GENERAL PUBLIC LICENSE Version 2.1

Dateien

Datei:Gif-dateien!.zip