Difference between revisions of "Pisg:Options générales"

From Base de connaissances eggdrops & TCL
Jump to: navigation, search
(OutputTag)
 
(7 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
[[Catégorie:Utilitaires]]
 +
Ces options permettent d'effectuer les réglages initiaux pour un canal.
 +
<noinclude>
 +
{{Translation}}
 
==Channel==
 
==Channel==
*'''Name''' : Channel -- define channel name
+
Channel is used in two contexts, globally when using <set> and when defining new channels. It sets the name of the channel.
*'''Synopsis''':
 
 
<source lang=xml><channel="#channel">
 
<source lang=xml><channel="#channel">
 
   Logfile = "channel.log"
 
   Logfile = "channel.log"
Line 7: Line 10:
 
   Maintainer = "John"
 
   Maintainer = "John"
 
</channel></source>
 
</channel></source>
*'''Description''' : Channel is used in two contexts, globally when using <set> and when defining new channels. It sets the name of the channel.
+
'''Default''':Unset
*'''Default''':Unset
 
 
==Format==
 
==Format==
*'''Name''': Format -- the logfile format
+
Format is used to define the format of the logfile, pisg supports a various number of different logfiles, see the FORMATS file included with the pisg distribution. If your logfiles have the suffix .gz or .bz2, they will automatically be decompressed and read by pisg. See also Maintainer.
*'''Synopsis''':
 
 
<source lang=xml><channel="#channel">
 
<source lang=xml><channel="#channel">
 
   Logfile = "channel.log"
 
   Logfile = "channel.log"
Line 18: Line 19:
 
</channel>
 
</channel>
 
<set Format="mIRC"></source>
 
<set Format="mIRC"></source>
*'''Description''' : Format is used to define the format of the logfile, pisg supports a various number of different logfiles, see the FORMATS file included with the pisg distribution. If your logfiles have the suffix .gz or .bz2, they will automatically be decompressed and read by pisg. See also Maintainer.
+
'''Default''': Unset
*'''Default''': Unset
 
 
==Network==
 
==Network==
*'''Name''': Network -- the IRC network of the channel
+
Network is used to set the network which the channel resides on, this name is displayed on the stats page.
*'''Synopsis''':
 
 
<source lang=xml><channel="#channel">
 
<source lang=xml><channel="#channel">
 
   Logfile = "channel.log"
 
   Logfile = "channel.log"
Line 29: Line 28:
 
</channel>
 
</channel>
 
<set Network="Quakenet"></source>
 
<set Network="Quakenet"></source>
*'''Description''': Network is used to set the network which the channel resides on, this name is displayed on the stats page.
+
'''Default''': SomeIRCNetwork
*'''Default''': SomeIRCNetwork
+
==OutputFile==
=OutputFile=
+
OutputFile is used to define the name of the generated statistics page.
*'''Name''': OutputFile -- name of the generated HTML page
 
*'''Synopsis''':
 
 
<source lang=xml><channel="#channel">
 
<source lang=xml><channel="#channel">
 
   Logfile = "channel.log"
 
   Logfile = "channel.log"
Line 40: Line 37:
 
</channel>
 
</channel>
 
<set OutputFile="mychan.html"></source>
 
<set OutputFile="mychan.html"></source>
*'''Description''': OutputFile is used to define the name of the generated statistics page.
+
'''Default''': index.html
*'''Default''': index.html
 
 
 
 
==OutputTag==
 
==OutputTag==
Name
+
OutputTag specifies a string that will replace occurrences of "%t" in OutputFile. This option is most useful when used as a command line switch (-t) to pisg in conjunction with NFiles (-nf). Example:<br />
OutputTag -- tag to insert into OutputFile
+
{{code|$ pisg -co pisg.conf}}<br />
Synopsis
+
{{code|$ pisg -co pisg.conf -nf 8 -t -week}}<br />
 
 
     
 
        <channel="#channel">
 
        LogDir = "logs/"
 
        Format = "eggdrop"
 
        OutputFile = "mychan%t.html"
 
        OutputTag = "-week"
 
        </channel>
 
 
 
        <set OutputTag="-week">
 
     
 
   
 
 
 
Description
 
 
 
OutputTag specifies a string that will replace occurrences of "%t" in OutputFile. This option is most useful when used as a command line switch (-t) to pisg in conjunction with NFiles (-nf). Example:
 
 
 
     
 
      $ pisg -co pisg.conf
 
      $ pisg -co pisg.conf -nf 8 -t -week
 
     
 
   
 
 
 
 
Leaving out the OutputTag settings from the above pisg.conf snippet, this writes both the full statistics (mychan.html) and statistics for the last week (mychan-week.html) using the same pisg config file. (Assuming that there are separate logfiles for each day.)
 
Leaving out the OutputTag settings from the above pisg.conf snippet, this writes both the full statistics (mychan.html) and statistics for the last week (mychan-week.html) using the same pisg config file. (Assuming that there are separate logfiles for each day.)
Default
+
<source lang=xml><channel="#channel">
 
+
  LogDir = "logs/"
unset
+
  Format = "eggdrop"
Logfile
+
  OutputFile = "mychan%t.html"
Name
+
  OutputTag = "-week"
Logfile -- name of logfile to parse
+
</channel>
Synopsis
+
<set OutputTag="-week"></source>
 
+
'''Default''': unset
     
+
==Logfile==
        <channel="#channel">
+
This defines the filename of the logfile to parse for the channel. If you want to parse a directory full of logfiles, you should use the LogDir option instead. Providing this option multiple times will parse multiple files in the order the statements appear. Wildcards (* ? <nowiki>[]</nowiki>) will be expanded. See also LogDir and NFiles.
        Logfile="/home/foo/eggdrop/logs/mylog.txt"
+
<source lang=xml><channel="#channel">
        Format = "eggdrop"
+
  Logfile="/home/foo/eggdrop/logs/mylog.txt"
        </channel>
+
  Format = "eggdrop"
 
+
</channel>
        <set Logfile="foo.log">
+
<set Logfile="foo.log"></source>
     
+
'''Default''': unset
   
+
==LogDir==
 
 
Description
 
 
 
This defines the filename of the logfile to parse for the channel. If you want to parse a directory full of logfiles, you should use the LogDir option instead. Providing this option multiple times will parse multiple files in the order the statements appear. Wildcards (* ? []) will be expanded. See also LogDir and NFiles.
 
Default
 
 
 
unset
 
LogDir
 
Name
 
LogDir -- parse a directory full of logs
 
Synopsis
 
 
 
     
 
        <channel="#channel">
 
        LogDir="/home/foo/eggdrop/logs/"
 
        Format = "eggdrop"
 
        </channel>
 
 
 
        <set LogDir="dailylogs/">
 
     
 
   
 
 
 
Description
 
 
 
 
When LogDir is defined to valid path to a directory, then pisg will run through that directory, parse all logfiles in it and create one HTML page from it. Useful with for example eggdrop logs. Providing this option multiple times will parse all the files in multiple directories in the order the statements appear. See also NFiles, LogPrefix, and LogSuffix.
 
When LogDir is defined to valid path to a directory, then pisg will run through that directory, parse all logfiles in it and create one HTML page from it. Useful with for example eggdrop logs. Providing this option multiple times will parse all the files in multiple directories in the order the statements appear. See also NFiles, LogPrefix, and LogSuffix.
Default
+
<source lang=xml><channel="#channel">
 
+
  LogDir="/home/foo/eggdrop/logs/"
unset
+
  Format = "eggdrop"
NFiles
+
</channel>
Name
+
<set LogDir="dailylogs/"></source>
NFiles -- parse only the last files in LogDir
+
'''Default''': unset
Synopsis
+
==NFiles==
 
 
     
 
        <channel="#channel">
 
        LogDir="/home/foo/eggdrop/logs/"
 
        NFiles="8"
 
        Format="eggdrop"
 
        </channel>
 
 
 
        <set NFiles="8">
 
     
 
   
 
 
 
Description
 
 
 
 
When NFiles is set to a positive integer, pisg will process only the last that much logfiles from Logfile and LogDir options. Useful to create statistics that cover the last week or month (assuming there are separate logfile per day/week/etc.).
 
When NFiles is set to a positive integer, pisg will process only the last that much logfiles from Logfile and LogDir options. Useful to create statistics that cover the last week or month (assuming there are separate logfile per day/week/etc.).
Default
+
<source lang=xml><channel="#channel">
 
+
  LogDir="/home/foo/eggdrop/logs/"
0 (process all files)
+
  NFiles="8"
Maintainer
+
  Format="eggdrop"
Name
+
</channel>
Maintainer -- name of the maintainer
+
<set NFiles="8"></source>
Synopsis
+
'''Default''': 0 (process all files)
 
+
==Maintainer==
     
 
        <channel="#channel">
 
        Logfile = "channel.log"
 
        Format = "mIRC"
 
        Maintainer = "Benny"
 
        </channel>
 
 
 
        <set Maintainer="Benny">
 
     
 
   
 
 
 
Description
 
 
 
 
Maintainer is used to define the name of the maintainer of the statistics page, this can be either the person generating the stats or the bot/client doing the logging. The maintainer is displayed in the outputted stats page. This setting is also used by some log parsers where "You" is used instead of the nick in the log (e.g. "You have been kicked"). See also Format, NickTracking.
 
Maintainer is used to define the name of the maintainer of the statistics page, this can be either the person generating the stats or the bot/client doing the logging. The maintainer is displayed in the outputted stats page. This setting is also used by some log parsers where "You" is used instead of the nick in the log (e.g. "You have been kicked"). See also Format, NickTracking.
Default
+
<source lang=xml><channel="#channel">
 
+
  Logfile = "channel.log"
MAINTAINER
+
  Format = "mIRC"
ColorScheme
+
  Maintainer = "Benny"
 +
</channel>
 +
<set Maintainer="Benny"></source>
 +
'''Default''': MAINTAINER
 +
==ColorScheme==
 
Name
 
Name
ColorScheme -- use a different color scheme for stats page
 
Synopsis
 
 
     
 
        <channel="#channel">
 
        Logfile = "channel.log"
 
        ColorScheme = "darkgalaxy"
 
        Maintainer = "John"
 
        </channel>
 
 
        <set ColorScheme="default">
 
     
 
   
 
 
Description
 
 
 
ColorScheme is used to define the color scheme used for the statistics page. Actually it's the CSS file being included. CSS files distributed with pisg are: darkgalaxy, darkred, default, justgrey, ocean, orange_grey, pisg, softgreen (omit the .css). The file will be included statically in the generated HTML page. If you give a file name or URL (i.e. a color scheme name with .css or a path), the file will be linked to instead. Using "none" will cause pisg to write only the body of the page; use this to include the statistics into a custom page. See also CssDir, AltColorScheme, HiCell/HiCell2.
 
ColorScheme is used to define the color scheme used for the statistics page. Actually it's the CSS file being included. CSS files distributed with pisg are: darkgalaxy, darkred, default, justgrey, ocean, orange_grey, pisg, softgreen (omit the .css). The file will be included statically in the generated HTML page. If you give a file name or URL (i.e. a color scheme name with .css or a path), the file will be linked to instead. Using "none" will cause pisg to write only the body of the page; use this to include the statistics into a custom page. See also CssDir, AltColorScheme, HiCell/HiCell2.
Default
+
<source lang=xml><channel="#channel">
 
+
  Logfile = "channel.log"
default
+
  ColorScheme = "darkgalaxy"
AltColorScheme
+
  Maintainer = "John"
Name
+
</channel>
AltColorScheme -- alternate stylesheets for stats page
+
<set ColorScheme="default"></source>
Synopsis
+
'''Default''': default
 
+
==AltColorScheme==
     
 
        <channel="#channel">
 
        Logfile = "channel.log"
 
        ColorScheme = "darkgalaxy"
 
        AltColorScheme = "layout/ocean.css"
 
        Maintainer = "John"
 
        </channel>
 
 
 
        <set AltColorScheme="layout/darkgalaxy.css layout/justgrey.css">
 
     
 
   
 
 
 
Description
 
 
 
 
AltColorScheme defines an alternate CSS file to be used for the statistics page. Multiple files can be given (space separated.) Note that this is not supported by all browsers. See also ColorScheme and CssDir.
 
AltColorScheme defines an alternate CSS file to be used for the statistics page. Multiple files can be given (space separated.) Note that this is not supported by all browsers. See also ColorScheme and CssDir.
Default
+
<source lang=xml><channel="#channel">
 
+
  Logfile = "channel.log"
default
+
  ColorScheme = "darkgalaxy"
Lang
+
  AltColorScheme = "layout/ocean.css"
 +
  Maintainer = "John"
 +
</channel>
 +
<set AltColorScheme="layout/darkgalaxy.css layout/justgrey.css"></source>
 +
'''Default''': default
 +
==Lang==
 
Name
 
Name
Lang -- define the language / translation to use
 
Synopsis
 
 
     
 
        <channel="#channel">
 
        Logfile = "channel.log"
 
        Format = "mIRC"
 
        Lang = "DE"
 
        OutputFile = "mychan-%l.html"
 
        </channel>
 
 
        <set Lang="FR,SE">
 
     
 
   
 
 
Description
 
 
 
Lang defines the language to use for the stats. Currently, lang.txt includes: EN (English), BG (Bulgarian), CA (Catalan), CZ (Czech), DA (Danish), DE (German), EE (Estonian), ES (Spanish), FI (Finnish), FR (French), GR (Greek), HE (Hebrew), HU (Hungarian), IS (Icelandic), IT (Italian), NL (Dutch), NL_BE (Flemish), NO (Norwegian), PL (Polish), PT (Portuguese), PT_BR (Portuguese/Brazil), RO (Romanian), RU (Russian), SE (Swedish), SI (Slovenian), SK (Slovak), SQ (Albanian), TR (Turkish), YU (Serbian). Output in several languages can be generated at the same time, separate the languages by comma. The tag %l in the output file name will be replaced by the language name. See also LangFile.
 
Lang defines the language to use for the stats. Currently, lang.txt includes: EN (English), BG (Bulgarian), CA (Catalan), CZ (Czech), DA (Danish), DE (German), EE (Estonian), ES (Spanish), FI (Finnish), FR (French), GR (Greek), HE (Hebrew), HU (Hungarian), IS (Icelandic), IT (Italian), NL (Dutch), NL_BE (Flemish), NO (Norwegian), PL (Polish), PT (Portuguese), PT_BR (Portuguese/Brazil), RO (Romanian), RU (Russian), SE (Swedish), SI (Slovenian), SK (Slovak), SQ (Albanian), TR (Turkish), YU (Serbian). Output in several languages can be generated at the same time, separate the languages by comma. The tag %l in the output file name will be replaced by the language name. See also LangFile.
Default
+
<source lang=xml><channel="#channel">
 
+
  Logfile = "channel.log"
EN (English)
+
  Format = "mIRC"
PageHead
+
  Lang = "DE"
Name
+
  OutputFile = "mychan-%l.html"
PageHead -- define a file as page header
+
</channel>
Synopsis
+
<set Lang="FR,SE"></source>
 
+
'''Default''': EN (English)
     
+
==PageHead==
        <channel="#channel">
 
        Logfile = "channel.log"
 
        Format = "mIRC"
 
        OutputFile = "stats.html"
 
        PageHead = "myheader.txt"
 
        </channel>
 
 
 
        <set PageHead="someheader.txt">
 
     
 
   
 
 
 
Description
 
 
 
 
PageHead is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the top of the page. This option is the opposite of PageFoot.
 
PageHead is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the top of the page. This option is the opposite of PageFoot.
Default
+
<source lang=xml><channel="#channel">
 
+
  Logfile = "channel.log"
none
+
  Format = "mIRC"
PageFoot
+
  OutputFile = "stats.html"
Name
+
  PageHead = "myheader.txt"
PageFoot -- define a file as page footer
+
</channel>
Synopsis
+
<set PageHead="someheader.txt"></source>
 
+
'''Default''': none
     
+
==PageFoot==
        <channel="#channel">
+
PageFoot is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the bottom of the page. This option is the opposite of PageHead.    
        Logfile = "channel.log"
+
<source lang=xml><channel="#channel">
        Format = "mIRC"
+
  Logfile = "channel.log"
        outputfile = "stats.html"
+
  Format = "mIRC"
        PageFoot = "myfooter.txt"
+
  outputfile = "stats.html"
        </channel>
+
  PageFoot = "myfooter.txt"
 
+
</channel>
        <set PageFoot="somefooter.txt">
+
<set PageFoot="somefooter.txt"></source>
     
+
'''Default''': none
   
 
 
 
Description
 
 
 
PageFoot is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the bottom of the page. This option is the opposite of PageHead.
 
Default
 
 
 
none
 
LogPrefix
 
Name
 
LogPrefix -- only parse logs LogPrefixed with a user defined string
 
Synopsis
 
 
 
     
 
        <channel="#channel">
 
        LogDir="/home/foo/eggdrop/logs/"
 
        Format = "eggdrop"
 
        LogPrefix = "logjun"
 
        </channel>
 
 
 
        <set LogPrefix="logjanuary">
 
     
 
   
 
 
 
Description
 
  
 +
==LogPrefix==
 
When using the LogDir option and you only want to use a slew of the files in it, you can have pisg choose only files which are prefixed with a special string.
 
When using the LogDir option and you only want to use a slew of the files in it, you can have pisg choose only files which are prefixed with a special string.
Default
+
<source lang=xml><channel="#channel">
 
+
  LogDir="/home/foo/eggdrop/logs/"
unset
+
  Format = "eggdrop"
LogSuffix
+
  LogPrefix = "logjun"
Name
+
</channel>
LogSuffix -- Regexp to sort logfiles by format month||day||year
+
<set LogPrefix="logjanuary"></source>
Synopsis
+
'''Default''': unset
 
+
==LogSuffix==
     
+
LogSuffix is used to define the suffix of a logfile, it only works when LogDir is defined. The example in the synopsis is for the eggdrop bots default format. Regexp to sort logfiles by format month||day||year
        <set LogSuffix="\.\d\d([A-Za-z]+)\d\d\d\d||\.(\d\d)[A-Za-z]+\d\d\d\d||\.\d\d[A-Za-z]+(\d\d\d\d)">
+
<source lang=xml><set LogSuffix="\.\d\d([A-Za-z]+)\d\d\d\d||\.(\d\d)[A-Za-z]+\d\d\d\d||\.\d\d[A-Za-z]+(\d\d\d\d)"></source>
     
+
'''Default''': Unset
   
+
==Silent==
 
 
Description
 
 
 
LogSuffix is used to define the suffix of a logfile, it only works when LogDir is defined. The example in the synopsis is for the eggdrop bots default format.
 
Default
 
 
 
Unset
 
Silent
 
Name
 
Silent -- make pisg silent, suppress messages
 
Synopsis
 
 
 
     
 
        <set Silent="1">
 
     
 
   
 
 
 
Description
 
 
 
 
This option is useful mainly from command line when invoking pisg with --silent 1. But it can also used in the configuration file. It will suppress all standard output from pisg. Error messages will still be sent.
 
This option is useful mainly from command line when invoking pisg with --silent 1. But it can also used in the configuration file. It will suppress all standard output from pisg. Error messages will still be sent.
Default
+
<source lang=xml><set Silent="1"></source>
 
+
'''Default''': 0 (disabled)
0 (disabled)
+
==CacheDir==
CacheDir
 
Name
 
CacheDir -- use a cache to speed up log parsing
 
Synopsis
 
 
 
     
 
        <set CacheDir="pisg_cache">
 
        <set CacheDir="/path/to/pisg_cache">
 
     
 
   
 
 
 
Description
 
 
 
 
Setting this option makes pisg dump the results of log parsing into cache files. The next time pisg is run, it compares the timestamp of the log(s) with the timestamp stored in the cache file. When the log was not changed, the cached data is used. (This means that it does not work if you only have a single big logfile. Split the log at arbitrary points and use LogDir or Logfile="dir/*".)
 
Setting this option makes pisg dump the results of log parsing into cache files. The next time pisg is run, it compares the timestamp of the log(s) with the timestamp stored in the cache file. When the log was not changed, the cached data is used. (This means that it does not work if you only have a single big logfile. Split the log at arbitrary points and use LogDir or Logfile="dir/*".)
  
 
Note that the cache files should be deleted when the pisg config file is changed since the cache data uses the old config settings. NickTracking does not work especially well with the cache when using different NFiles settings.
 
Note that the cache files should be deleted when the pisg config file is changed since the cache data uses the old config settings. NickTracking does not work especially well with the cache when using different NFiles settings.
Default
+
<source lang=xml><set CacheDir="pisg_cache">
 
+
<set CacheDir="/path/to/pisg_cache"></source>
Unset
+
'''Default''': Unset
 +
</noinclude>

Latest revision as of 18:50, 8 December 2007

Ces options permettent d'effectuer les réglages initiaux pour un canal.

Eye.png Cet article est en cours de traduction, n'hésitez pas à aider

Channel

Channel is used in two contexts, globally when using <set> and when defining new channels. It sets the name of the channel.

<channel="#channel">
   Logfile = "channel.log"
   Format = "mIRC"
   Maintainer = "John"
</channel>

Default:Unset

Format

Format is used to define the format of the logfile, pisg supports a various number of different logfiles, see the FORMATS file included with the pisg distribution. If your logfiles have the suffix .gz or .bz2, they will automatically be decompressed and read by pisg. See also Maintainer.

<channel="#channel">
   Logfile = "channel.log"
   Format = "eggdrop"
   Maintainer = "John"
</channel>
<set Format="mIRC">

Default: Unset

Network

Network is used to set the network which the channel resides on, this name is displayed on the stats page.

<channel="#channel">
   Logfile = "channel.log"
   Format = "eggdrop"
   Network = "Undernet"
</channel>
<set Network="Quakenet">

Default: SomeIRCNetwork

OutputFile

OutputFile is used to define the name of the generated statistics page.

<channel="#channel">
   Logfile = "channel.log"
   Format = "eggdrop"
   OutputFile = "mychan.html"
</channel>
<set OutputFile="mychan.html">

Default: index.html

OutputTag

OutputTag specifies a string that will replace occurrences of "%t" in OutputFile. This option is most useful when used as a command line switch (-t) to pisg in conjunction with NFiles (-nf). Example:
$ pisg -co pisg.conf
$ pisg -co pisg.conf -nf 8 -t -week
Leaving out the OutputTag settings from the above pisg.conf snippet, this writes both the full statistics (mychan.html) and statistics for the last week (mychan-week.html) using the same pisg config file. (Assuming that there are separate logfiles for each day.)

<channel="#channel">
   LogDir = "logs/"
   Format = "eggdrop"
   OutputFile = "mychan%t.html"
   OutputTag = "-week"
</channel>
<set OutputTag="-week">

Default: unset

Logfile

This defines the filename of the logfile to parse for the channel. If you want to parse a directory full of logfiles, you should use the LogDir option instead. Providing this option multiple times will parse multiple files in the order the statements appear. Wildcards (* ? []) will be expanded. See also LogDir and NFiles.

<channel="#channel">
   Logfile="/home/foo/eggdrop/logs/mylog.txt"
   Format = "eggdrop"
</channel>
<set Logfile="foo.log">

Default: unset

LogDir

When LogDir is defined to valid path to a directory, then pisg will run through that directory, parse all logfiles in it and create one HTML page from it. Useful with for example eggdrop logs. Providing this option multiple times will parse all the files in multiple directories in the order the statements appear. See also NFiles, LogPrefix, and LogSuffix.

<channel="#channel">
   LogDir="/home/foo/eggdrop/logs/"
   Format = "eggdrop"
</channel>
<set LogDir="dailylogs/">

Default: unset

NFiles

When NFiles is set to a positive integer, pisg will process only the last that much logfiles from Logfile and LogDir options. Useful to create statistics that cover the last week or month (assuming there are separate logfile per day/week/etc.).

<channel="#channel">
   LogDir="/home/foo/eggdrop/logs/"
   NFiles="8"
   Format="eggdrop"
</channel>
<set NFiles="8">

Default: 0 (process all files)

Maintainer

Maintainer is used to define the name of the maintainer of the statistics page, this can be either the person generating the stats or the bot/client doing the logging. The maintainer is displayed in the outputted stats page. This setting is also used by some log parsers where "You" is used instead of the nick in the log (e.g. "You have been kicked"). See also Format, NickTracking.

<channel="#channel">
   Logfile = "channel.log"
   Format = "mIRC"
   Maintainer = "Benny"
</channel>
<set Maintainer="Benny">

Default: MAINTAINER

ColorScheme

Name ColorScheme is used to define the color scheme used for the statistics page. Actually it's the CSS file being included. CSS files distributed with pisg are: darkgalaxy, darkred, default, justgrey, ocean, orange_grey, pisg, softgreen (omit the .css). The file will be included statically in the generated HTML page. If you give a file name or URL (i.e. a color scheme name with .css or a path), the file will be linked to instead. Using "none" will cause pisg to write only the body of the page; use this to include the statistics into a custom page. See also CssDir, AltColorScheme, HiCell/HiCell2.

<channel="#channel">
   Logfile = "channel.log"
   ColorScheme = "darkgalaxy"
   Maintainer = "John"
</channel>
<set ColorScheme="default">

Default: default

AltColorScheme

AltColorScheme defines an alternate CSS file to be used for the statistics page. Multiple files can be given (space separated.) Note that this is not supported by all browsers. See also ColorScheme and CssDir.

<channel="#channel">
   Logfile = "channel.log"
   ColorScheme = "darkgalaxy"
   AltColorScheme = "layout/ocean.css"
   Maintainer = "John"
</channel>
<set AltColorScheme="layout/darkgalaxy.css layout/justgrey.css">

Default: default

Lang

Name Lang defines the language to use for the stats. Currently, lang.txt includes: EN (English), BG (Bulgarian), CA (Catalan), CZ (Czech), DA (Danish), DE (German), EE (Estonian), ES (Spanish), FI (Finnish), FR (French), GR (Greek), HE (Hebrew), HU (Hungarian), IS (Icelandic), IT (Italian), NL (Dutch), NL_BE (Flemish), NO (Norwegian), PL (Polish), PT (Portuguese), PT_BR (Portuguese/Brazil), RO (Romanian), RU (Russian), SE (Swedish), SI (Slovenian), SK (Slovak), SQ (Albanian), TR (Turkish), YU (Serbian). Output in several languages can be generated at the same time, separate the languages by comma. The tag %l in the output file name will be replaced by the language name. See also LangFile.

<channel="#channel">
   Logfile = "channel.log"
   Format = "mIRC"
   Lang = "DE"
   OutputFile = "mychan-%l.html"
</channel>
<set Lang="FR,SE">

Default: EN (English)

PageHead

PageHead is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the top of the page. This option is the opposite of PageFoot.

<channel="#channel">
   Logfile = "channel.log"
   Format = "mIRC"
   OutputFile = "stats.html"
   PageHead = "myheader.txt"
</channel>
<set PageHead="someheader.txt">

Default: none

PageFoot

PageFoot is used to include a file in the stats page, for example an introduction text, a link to an image or a banner. The file can hold anything, it will be included raw in the stats page - so HTML should be preferred. The file will be included in the bottom of the page. This option is the opposite of PageHead.

<channel="#channel">
   Logfile = "channel.log"
   Format = "mIRC"
   outputfile = "stats.html"
   PageFoot = "myfooter.txt"
</channel>
<set PageFoot="somefooter.txt">

Default: none

LogPrefix

When using the LogDir option and you only want to use a slew of the files in it, you can have pisg choose only files which are prefixed with a special string.

<channel="#channel">
   LogDir="/home/foo/eggdrop/logs/"
   Format = "eggdrop"
   LogPrefix = "logjun"
</channel>
<set LogPrefix="logjanuary">

Default: unset

LogSuffix

LogSuffix is used to define the suffix of a logfile, it only works when LogDir is defined. The example in the synopsis is for the eggdrop bots default format. Regexp to sort logfiles by format month||day||year

<set LogSuffix="\.\d\d([A-Za-z]+)\d\d\d\d||\.(\d\d)[A-Za-z]+\d\d\d\d||\.\d\d[A-Za-z]+(\d\d\d\d)">

Default: Unset

Silent

This option is useful mainly from command line when invoking pisg with --silent 1. But it can also used in the configuration file. It will suppress all standard output from pisg. Error messages will still be sent.

<set Silent="1">

Default: 0 (disabled)

CacheDir

Setting this option makes pisg dump the results of log parsing into cache files. The next time pisg is run, it compares the timestamp of the log(s) with the timestamp stored in the cache file. When the log was not changed, the cached data is used. (This means that it does not work if you only have a single big logfile. Split the log at arbitrary points and use LogDir or Logfile="dir/*".)

Note that the cache files should be deleted when the pisg config file is changed since the cache data uses the old config settings. NickTracking does not work especially well with the cache when using different NFiles settings.

<set CacheDir="pisg_cache">
<set CacheDir="/path/to/pisg_cache">

Default: Unset