royale.zerezo.com Git - irssistats/blob - irssistats.sgml

   1 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
   2   <!-- Fill in your name for FIRSTNAME and SURNAME. -->
   3   <!ENTITY dhfirstname "<firstname>JACQUET</firstname>">
   4   <!ENTITY dhsurname   "<surname>ANTOINE</surname>">
   5   <!-- Please adjust the date whenever revising the manpage. -->
   6   <!ENTITY dhdate      "<date>april 4, 2004</date>">
   7   <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
   8        allowed: see man(7), man(1). -->
   9   <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  10   <!ENTITY dhemail     "<email>royale@zerezo.com</email>">
  11   <!ENTITY dhusername  "Antoine Jacquet">
  12   <!ENTITY dhucpackage "<refentrytitle>IRSSISTATS</refentrytitle>">
  13   <!ENTITY dhpackage   "irssistats">
  14
  15   <!ENTITY debian      "<productname>Debian</productname>">
  16   <!ENTITY gnu         "<acronym>GNU</acronym>">
  17   <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
  18 ]>
  19
  20 <refentry>
  21
  22   <refentryinfo>
  23     <address>
  24       &dhemail;
  25     </address>
  26     <author>
  27       &dhfirstname;
  28       &dhsurname;
  29     </author>
  30     <copyright>
  31       <year>2004</year>
  32       <holder>&dhusername;</holder>
  33     </copyright>
  34     &dhdate;
  35   </refentryinfo>
  36
  37   <refmeta>
  38     &dhucpackage;
  39     &dhsection;
  40   </refmeta>
  41
  42   <refnamediv>
  43     <refname>&dhpackage;</refname>
  44     <refpurpose>A tool to generate HTML IRC stats based on irssi logs.</refpurpose>
  45   </refnamediv>
  46
  47   <refsynopsisdiv>
  48     <cmdsynopsis>
  49       <command>&dhpackage;</command>
  50       <arg><option><replaceable>/path/to/file.conf</replaceable></option></arg>
  51     </cmdsynopsis>
  52   </refsynopsisdiv>
  53
  54   <refsect1>
  55     <title>DESCRIPTION</title>
  56     <para><command>irssistats</command> is a tool that make HTML stats from <command>irssi</command> logfiles.</para>
  57     <para>The statistics generated display many useful and funny informations about the channel.</para>
  58   </refsect1>
  59
  60   <refsect1>
  61     <title>USING IT</title>
  62     <para>First you need to copy the files needed for the HTML page :</para>
  63     <para><command>cp /usr/share/irssistats/data/* /path/to/webdir/</command></para>
  64     <para>Then you must edit a configuration file : "/etc/irssistats.conf", "~/.irssistats", or another file given as a parameter.</para>
  65     <para>Now you can generate the statistics for your channel :</para>
  66     <para><command>irssistats <option><replaceable>[/path/to/file.conf]</replaceable></option></command></para>
  67     <para>The logfiles for <command>irssi</command> are usually located in "~/irclogs/network/channel.log"</para>
  68   </refsect1>
  69
  70
  71   <refsect1>
  72     <title>CONFIGURATION FILE</title>
  73     <para>Please look at the sample configuration file in "/usr/share/docs/irssistats/sample.configfile" for an example.</para>
  74     <para>The path to the configuration file can be given on the command line : <command>irssistats</command> <replaceable>/path/to/irssistats.conf</replaceable></para>
  75     <para>If no configuration file is given, irssistats looks for files ~/.irssistats.conf or then /etc/irssistats.conf</para>
  76     <para>Lines starting by ; # -- or // are ignored (comments).</para>
  77     <para>This file is read sequencially, so it acts like a script.</para>
  78     <para>Each option keyword is case sensitive, and you must put separators around the ':' character.</para>
  79     <para>Blank lines must not contain any spaces !</para>
  80     <para>Each option keeps its value until erased by another value.</para>
  81     <para>IMPORTANT : the order of options to parse a channel must allways be "input" THEN "nickfile" THEN "output".</para>
  82
  83     <para>Available options are :</para>
  84
  85     <variablelist>
  86
  87       <varlistentry>
  88         <term>debug</term>
  89         <listitem>
  90           <para>Allows you to display debugging informations.</para>
  91           <para>Values : normal / verbose / none</para>
  92           <para>Default : normal</para>
  93         </listitem>
  94       </varlistentry>
  95
  96       <varlistentry>
  97         <term>channel</term>
  98         <listitem><para>Specifies the name of the channel you are parsing.</para></listitem>
  99       </varlistentry>
 100
 101       <varlistentry>
 102         <term>maintainer</term>
 103         <listitem><para>Nickname of the person generating the statistics (you !).</para></listitem>
 104       </varlistentry>
 105
 106       <varlistentry>
 107         <term>language</term>
 108         <listitem>
 109           <para>Language you want to use to display the statistics</para>
 110           <para>Values : fr en de du es it fi ru</para>
 111           <para>Default : en</para>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry>
 116         <term>theme</term>
 117         <listitem>
 118           <para>Theme (colors) to use for the statistics, separated by comas</para>
 119           <para>In fact this is the name of the CSS file to include.</para>
 120           <para>This option has no effect if you use a custom header : you'll have to include the CSS yourself.</para>
 121           <para>The first theme is the primary stylesheet, and the others are alternate themes</para>
 122         </listitem>
 123       </varlistentry>
 124
 125       <varlistentry>
 126         <term>top_words</term>
 127         <listitem>
 128           <para>Allows you to disable top words list which is using a lot of memory</para>
 129           <para>Default : yes</para>
 130         </listitem>
 131       </varlistentry>
 132
 133       <varlistentry>
 134         <term>ranking</term>
 135         <listitem>
 136           <para>Specifies which ranking method to use</para>
 137           <para>Values : lines / words / letters</para>
 138           <para>Default : lines</para>
 139         </listitem>
 140       </varlistentry>
 141
 142       <varlistentry>
 143         <term>quarter</term>
 144         <listitem>
 145           <para>Display quarters in top hours (smoother graphs)</para>
 146           <para>Default : no</para>
 147         </listitem>
 148       </varlistentry>
 149
 150       <varlistentry>
 151         <term>refresh_time</term>
 152         <listitem>
 153           <para>Specifies the refresh time in seconds (0 to disable)</para>
 154           <para>This option has no effect if you use a custom header : you'll have to include the refresh code yourself.</para>
 155           <para>Default : 3600</para>
 156         </listitem>
 157       </varlistentry>
 158
 159       <varlistentry>
 160         <term>w3c_link</term>
 161         <listitem>
 162           <para>Set this to "no" if you don't want the W3C logo.</para>
 163           <para>Default : yes</para>
 164         </listitem>
 165       </varlistentry>
 166
 167       <varlistentry>
 168         <term>header</term>
 169         <listitem><para>Use your custom header file (HTML code between &lt;!DOCTYPE... and &lt;body&gt; included)</para></listitem>
 170       </varlistentry>
 171
 172       <varlistentry>
 173         <term>footer</term>
 174         <listitem><para>Use your custom footer file (HTML code between &lt;/body&gt; and &lt;/html&gt; included)</para>
 175         </listitem>
 176       </varlistentry>
 177
 178       <varlistentry>
 179         <term>input</term>
 180         <listitem>
 181           <para>This allow you to parse a file.</para>
 182           <para>Note that irssistats will really parse the file as soon as it reads this option.</para>
 183         </listitem>
 184       </varlistentry>
 185
 186       <varlistentry>
 187         <term>nickfile</term>
 188         <listitem>
 189           <para>This allow you to group nick using a nickfile.</para>
 190           <para>Note that irssistats will really merge the nicks as soon as it reads this option.</para>
 191         </listitem>
 192       </varlistentry>
 193
 194       <varlistentry>
 195         <term>output</term>
 196         <listitem>
 197           <para>This allow you to generate the HTML file.</para>
 198           <para>Note that irssistats will really generate the HTML file as soon as it reads this option.</para>
 199         </listitem>
 200       </varlistentry>
 201
 202     </variablelist>
 203
 204   </refsect1>
 205
 206
 207   <refsect1>
 208     <title>NICKFILE</title>
 209     <para>Since version 0.4 of <command>irssistats</command>, you can use a nickfile to specify nicks to join.</para>
 210     <para>Each line of the nickfile contains the final nick and a regular expression.</para>
 211     <para>Examples :</para>
 212     <variablelist>
 213       <varlistentry>
 214         <term>royale &circ;[Rr]oyale</term>
 215         <listitem><para>join nicks starting with "Royale" or "royale" to the final nick "royale"</para></listitem>
 216       </varlistentry>
 217       <varlistentry>
 218         <term>royale &circ;antoine$</term>
 219         <listitem><para>also join the nick "antoine" to the final nick "royale"</para></listitem>
 220       </varlistentry>
 221       <varlistentry>
 222         <term>djakette [Dd]ja</term>
 223         <listitem><para>join any nick that contains "Dja" or "dja" to final nick "djakette"</para></listitem>
 224       </varlistentry>
 225       <varlistentry>
 226         <term>&lt;NULL&gt; &circ;bot\|royale$</term>
 227         <listitem><para>remove "bot|royale" from statistics</para></listitem>
 228       </varlistentry>
 229     </variablelist>
 230     <para>The nickfile must not contain any comments.</para>
 231     <para>The &lt;NULL&gt; final nick will remove matching nicks from all statistics, except from "Some URLs" and "Some topics"...</para>
 232     <para>You can also take a look at the "sample.nickfile" in this package (in "/usr/share/doc/irssistats/").</para>
 233   </refsect1>
 234
 235
 236   <refsect1>
 237     <title>SEE ALSO</title>
 238     <para><command>irssi</command> (1).</para>
 239   </refsect1>
 240
 241   <refsect1>
 242     <title>INFORMATIONS</title>
 243     <para>You can find informations and updates of <command>irssistats</command> at <ulink url="http://royale.zerezo.com/irssistats/">http://royale.zerezo.com/irssistats/</ulink>.</para>
 244     <para>Report bugs to &dhemail;.</para>
 245   </refsect1>
 246
 247   <refsect1>
 248     <title>AUTHOR</title>
 249     <para>Antoine Jacquet &dhemail;</para>
 250   </refsect1>
 251
 252 </refentry>
 253
 254 <!-- Keep this comment at the end of the file
 255 Local variables:
 256 mode: sgml
 257 sgml-omittag:t
 258 sgml-shorttag:t
 259 sgml-minimize-attributes:nil
 260 sgml-always-quote-attributes:t
 261 sgml-indent-step:2
 262 sgml-indent-data:t
 263 sgml-parent-document:nil
 264 sgml-default-dtd-file:nil
 265 sgml-exposed-tags:nil
 266 sgml-local-catalogs:nil
 267 sgml-local-ecat-files:nil
 268 End:
 269 -->
 270
 271