With this Filter for [JSPWiki|http://www.jspwiki.org] you can display initial letters by the use of gif's.



!Example



§§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.



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 {{{a.gif}}}. Copy this to a directory named {{{{JSPWiki}/initial}}}. 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 {{{a1.gif}}}. Each §#§ would be replaced by the gif with the name #1.gif. You can use this [set of gifs|gif-dateien!.zip] as an example.



2. The following jar must be copied to {{{{JSPWiki}/WEB-INF/lib}}}:



* [SBaltesPlugins.jar|SBaltesPlugins/SBaltesPlugins.jar]



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



{{{

<?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>

}}}\\



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



{{{

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

}}}



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.

Copyright (C) 2005 Sebastian Baltes



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|http://www.gnu.org/copyleft/lesser.txt]