Ken Neighbors, Ph.D.
Software Development Services

https://nsds.com/

FREE SOFTWARE

You can browse my download area. I also have Debian packages (the names of the Debian packages are listed in parentheses after the headings).

Software I Wrote

Apache-AxKit-Language-FOP [download|cvs]
(axkit-language-fop)

This module uses Apache FOP to generate PDF by processing XSL-FO files. It can either call the command line tool "fop", or for better performance, it can use the XML-ApacheFOP package (which uses the Java.pm Perl package and JavaServer software).

• README
• Apache::AxKit::Language::FOP

It seems like everyone has their own version of this module since AxKit does not include it, and, like everyone else, mine is also based on Language/PassiveTex.pm. Other than the performance boost from using XML::ApacheFOP, some additional features of my module are:

• It cleans up its temporary directory after delivering the PDF document.
• It allows use of an external FOP configuration file.
• It caches the output for content generated dynamically with XSP. Alternatively, you could use my XSPCaching module for caching the output, but it is more difficult to set up.
• It checks the timestamps of a fo:external-graphic to see if it is later than the cached output, in which case the output is regenerated.
• It resolves fo:external-graphic relative to the source directory or baseDir.
• It clears FOP's image cache when it gets too full or when it has an old version of a fo:external-graphic.

Apache-AxKit-Language-XSPCaching [download|cvs]
(axkit-language-xspcaching)

This module allows the existing AxKit caching mechanism to function for XSP-generated content. You cannot simply install this module and have caching to work for your XSP, you must handle the dependencies and extra cache parameters as described in the document.

• README
• Apache::AxKit::Language::XSPCaching

Apache-AxKit-CacheCleaner [download|cvs]
(axkit-cachecleaner)

This module searches AxKit's cache directory and deletes files whose last access time is older than a specific maximum age. For example, you could run it nightly in a cron job and instruct it to delete files older than one month. Alternatively, you can configure it to run periodically during Apache's cleanup phase.

• README
• Apache::AxKit::CacheCleaner

Apache-AxKit-GzipInput [download|cvs]
(axkit-gzipinput)

This module allows gzipped input files to be read into AxKit for processing, for example .xml.gz, .xsl.gz, and .xsp.gz.

• README
• Apache::AxKit::GzConfigReader
• Apache::AxKit::Provider::GzFile

WWW-Yahoo-Credentials [download|cvs]

This module reads your Yahoo username, password, and security key from an XML file.

• README
• WWW::Yahoo::Credentials

WWW-Yahoo-Briefcase [download|cvs]

This module no longer works due to interface changes in Yahoo Briefcase.

This module provides access to your Yahoo Briefcase. You can upload and download files and perform other operations such as list, rename, move, copy, delete, and create new folders.

• README
• ybc
• WWW::Yahoo::Briefcase

Software I Patched or Extended

JavaServer (javaserver)

I created a Debian package for JavaServer. I wrote a wrapper and an init script to automatically start the JavaServer with an appropriate CLASSPATH that can be configured automatically by other packages (such as XML-ApacheFOP).

Note that there is a bug in the current distribution so I patched the source to work around the bug. You can download my patched version.

• Documentation for Debian
• Wrapper Documentation
• Wrapper Script (/usr/sbin/javaserver)
• Debian Init Script (/etc/init.d/javaserver)
• Debian Cron Script (/etc/cron.weekly/javaserver)
• Debian Configuration File (/etc/default/javaserver)
• log4j Configuration File (/etc/javaserver/log4j.conf)

FOP (fop, fop-doc)

I added the background borders patch and some patches of my own to fix the hyperlink location and another to help with the layout of multi-column spans.

• Fix PDF backgrounds extending too far and overlapping adjacent areas. [patch]
• Fix PDF hyperlink location for a display-align of center or after. [patch]
• Use font size for "heuristic safety factor" when balancing span area. [patch]
• Improve man page header in Debian package. [patch]

AxKit (axkit, axkit-examples, axkit-language-htmldoc, axkit-language-query)

I applied the following patches to the official Debian package:

• Suppress the spurious warning message "parser match_cb: ..." in Language/LibXSLT.pm so that it does not fill up the Apache error log. [patch]
• Reduce memory size of AxKit::Stash when using axkit_cache_extra. [patch]
• Allow custom AxCacheModule to override cache init in Apache::AxKit::Cache. [patch]

AWStats (awstats, awstats-plugin-geoip-allregions, awstats-apache2)

I applied the following patches to the Debian package:

• 0001-Add-patch-to-report-error-when-config-file-exists-bu.patch.txt
• 0002-Add-patch-to-fix-truncated-nested-included-config-fi.patch.txt
• 0003-Show-error-messages-from-cron-jobs-update.sh-and-bu.patch.txt
• 0004-Add-option-to-disable-nightly-generation-of-static-h.patch.txt
• 0005-Use-nice-to-lower-the-priority-of-the-AWStats-proc.patch.txt
• 0006-Do-not-use-implied-default-config-file-etc-awstats.patch.txt
• 0007-Improve-documentation-of-logfile-permissions-and-sug.patch.txt
• 0008-Cosmetic-improvements-to-cron-scripts-update.sh-and.patch.txt

Files changed/added:

• /usr/share/docs/awstats/README.Debian
• /etc/default/awstats
• /usr/share/awstats/tools/update.sh
• /usr/share/awstats/tools/buildstatic.sh
• /usr/share/docs/awstats/examples/awstats.default.conf
• /usr/lib/cgi-bin/awstats.pl

I also created an additional plugin called geoip_allregions based on geoip_region_maxmind and geoip_city_maxmind. It generates worldwide region information in a Regions table and in the Hosts table using the freely available MaxMind city database (according to its documentation, geoip_region_maxmind only shows region information for US and Canada, and it requires the licensed MaxMind region database). See the README file for more information. The Debian package is called awstats-plugin-geoip-allregions.

Furthermore, I created an additional Debian package to automate the setup of awstats for Apache. This package, awstats-apache2, automatically changes the permissions of the Apache log files to world-readable so that awstats can process them, and it contains a CGI script for listing the available AWStats reports.

• Documentation for Debian
• awstats-reports CGI Script (/usr/lib/cgi-bin/awstats-reports)

The free software on this page is also provided as Debian packages for the "i386" architecture. You can browse my repository pool and the Packages files for main and contrib. If you have a different architecture, you can download the Debian source package as described below and create your own binary package.

In addition to the software packages listed above, I have also created Debian packages of the following:

	XML-ApacheFOP	(libxml-apachefop-perl)
	Java.pm	(libjava-perl)
	Apache-AxKit-Plugin-Session	(axkit-plugin-session)
	Crypt-GeneratePassword	(libcrypt-generatepassword-perl)
	apt-method-https	(apt-method-https)

To install a package using apt, first add the following lines to your /etc/apt/sources.list:

  # Ken Neighbors' site of freely-available Debian packages
  deb     http://nsds.com/debian/ sarge main contrib

Then you can install a package with apt-get, for example:

  # apt-get update
  # apt-get install axkit-language-fop

If you also want Debian source packages, add this line to your /etc/apt/sources.list:

  deb-src http://nsds.com/debian/ sarge main contrib

Then you can download and unpack a source package into the current directory with apt-get, for example:

  # apt-get update
  # apt-get source axkit-language-fop