.TH irssistats 1 23-Nov-2002 "version 0.43" irssistats

.SH NAME
irssistats - A tool to generate HTML IRC stats based on irssi logs.

.SH SYNOPSIS
cat /path/to/file.log | \fBirssistats\fP \fI\\#channel\fP \fImaintainer\fP \fIlanguage\fP \fItheme\fP \fI[nickfile]\fP > /path/to/webdir/index.html

.SH DESCRIPTION
\fBirssistats\fP is a tool that make HTML stats from \fIirssi\fP logfiles.
.PP
It works like a filter (it reads data in input and produces the HTML page on the output).
.PP
The statistics generated display many useful and funny informations about the channel.

.SH USING IT
First you need to copy the images needed for the HTML page :
.PP
.B cp /usr/share/irssistats/pix/* /path/to/webdir/
.PP
Now you can generate the statistics for your channel :
.PP
.B cat /path/to/file.log | irssistats \\\\#channel maintainer language theme [nickfile] > /path/to/webdir/index.html
.PP
The logfiles for \fIirssi\fP are usually located in "~/irclogs/network/channel.log"

.SH COMMAND LINE OPTIONS
All the options (except the nickfile) are mandatory and have to be set at the good place on the command line.
.PP
If you make any mistake on the command line, \fBirssistats\fP will remind you the usage.
.PP
Launching \fBirssistats\fP without any parameters is a good way to show the available options.
.PP
.TP 8
.B \\\\#channel
Specifies the name of the channel you are parsing. Don't forget to escape the '#' character in the channel name.
.TP 8
.B maintainer
Nickname of the person generating the statistics (you !).
.TP 8
.B language
Language you want to use to display the statistics (example : "en" for english).
.TP 8
.B theme
Theme (colors) to use for the statistics (example : "default" for the default theme).
.TP 8
.B nickfile
This is the only optional argument. Specifies an alias file for nicks. See Below.

.SH NICKFILE
Since version 0.4 of \fBirssistats\fP, you can use a nickfile to specify nicks to join.
.PP
Each line of the nickfile contains the final nick and a regular expression.
.PP
Examples :
.TP 8
.B royale ^[Rr]oyale
join nicks starting with "Royale" or "royale" to the final nick "royale"
.TP 8
.B royale ^antoine$
also join the nick "antoine" to the final nick "royale"
.TP 8
.B djakette [Dd]ja
join any nick that contains "Dja" or "dja" to final nick "djakette"
.TP 8
.B <NULL> ^bot\\\\|royale$
remove "bot|royale" from statistics
.PP
The nickfile must not contain any comments.
.PP
The <NULL> final nick will remove matching nicks from all statistics, except from "Some URLs" and "Some topics"...
.PP
You can also take a look at the "sample.nickfile.txt" in this package (in "/usr/share/doc/irssistats/").

.SH SEE ALSO
irssi(1)

.SH INFORMATIONS
You can find informations and updates of \fBirssistats\fP at \fIhttp://royale.zerezo.com/programmation/irssistats/\fP.
.PP
Report bugs to \fIroyale@zerezo.com\fP.

.SH AUTHOR
Antoine Jacquet <\fIroyale@zerezo.com\fP>