README for pisg.cfg - the configuration file for pisg ------------------ This file is used for: - Setting user options (for user aliases, pics, ignores and links) - Setting up channel(s) to be parsed. - Setting pisg config options (for general things with pisg) - Word options (for adding words that are meant to be 'foul(bad) language') USER OPTIONS ------------------ User options are set with a simple SGML like syntax in the form: Remember, the nick is always required. For example to add aliases to a nick, then you could do this: This will add all Joe^'s to 'Joe' in the stats. Another thing you can do is to add a picture to a user: You can also set a user's sex: Also you can add links to URLs and e-mails: or The last thing you can do is to ignore nicks (for example bots): You don't have to do all this in many lines, you could just as easily do: (Here the aliases is a space seperated list of nicks, that also works! But * as a wildcard is smarter, but also slower). CHANNELS SETUP ------------------ For each of your channels which you want to parse through, you make something like this: format = "mIRC" maintainer = "NameOfMaintainer" Any options in the section will be forced, even over commandline options... any options before can be overridden from command line There is a lot of options which you can set between the and tags, these are listed in the next section. PISG OPTIONS ------------------ If you have multiple channels, then you can set some defaults for them, for example you can do. And you won't have to worry about setting the format for every channel. You can also combine settings into one line such as: All the different options are listed below. Other examples: There is many options which can be set, here's a list of them all (not casesensitive): * The most useful ones * channel The name of your channel. E.g. '#mychannel' logfile The exact filename of the logfile. E.g. 'mylog.log' format The logfile format. See FORMATS file for supported formats network Network the channels is using. E.g. 'Undernet' outputfile Outputted stats goes to this HTML file. Default 'index.html' maintainer The maintainer or bot which makes the logfile. lang Language to use (see lang.txt) EN | DE | DK | FR | ES | PL | PT | NO | NL | SE | EE | IT HU | SI | FI pagehead Some 'page header' file which you want to include in top of the output file. imagepath If your user pictures is located in a special direcotry, set the path here. E.g. 'userpics/' default_pic If no picture defined for a user, use this default picture, good for example to display 'No picture available'. logdir If you specify a path to a directory here, then pisg will run through the files in that directory, parse all logfiles in it and create 1 HTML file from it. Useful with eggdrops. timeoffset A time offset on the stats page - if your country has a different timezone than the machine where the stats are being generated, then for example set '+1' to add one hour to the stats. show_activetimes 1 or 0, this enables/disables the 'Most Active Tiems' section, default is enabled. show_bignumbers 1 or 0, enable/disable 'Big Numbers' and 'Other interesting numbers', default is enabled. show_wpl 1 or 0, this enables pisg to show 'words per line' for each person in 'most active nicks' show_cpl Same as above, this is just 'characters per line' show_words 1 or 0, this will enable/disable both of the 2 above options. show_time 1 or 0, this will enable/disable the showing of the fancy timebars indicating when a nick was active. show_linetime 1 or 0, the same as above, except this will show the bar next to the number of lines like in mIRCStats show_randquote 1 or 0, this wil enable or disable the random quote displayed in the "active nick list" show_legend 1 or 0, this will add a legend of the different time- bars. show_kickline 1 or 0, this will add an example-kickline to the "Most kicked"-stats show_actionline 1 or 0, this will add an example-actionline to the "Most actions"-stats show_shoutline 1 or 0, this will add an example-shoutline to the "Most shouting people"-stats show_violentlines 1 or 0, this will add an example-attack to the "Most aggressive" and "Most attacked"-stats show_muw 1 or 0, this will enable or disable the "most used words" list show_mrn 1 or 0, this will enable or disable the "most referenced nicks" list show_mru 1 or 0, this will enable or disable the "most referenced urls" list show_voices 1 or 0, this will enable or disable the voice statistics (those who got voice and those who voiced). Disabled by default. ignorewords A space seperated list of words to ignore in 'most referenced words' foul Space seperated list of words considered to be 'foul' language, look in the bottom for a better explanation. regexp_alises 1 or 0, enabling this will make aliases in tags regex-able. Default '0'. silent 1 or 0. Enabling this will suppress all standard output from pisg. Error messages will still be sent to STDOUT. charset Charset to use for stats page, default is 'iso-8859-1'. * Colors / layout for your stats page * bgcolor Background color of the page bgpic Background picture of the page text Normal text color hbgcolor Background color in headlines hcolor Text color in headline hicell Background color in highlighted cells hicell2 Background color in highlighted cells tdcolor Color of text in tables tdtop Top color in some tables. link Color of links in tables vlink Color of visited links in tables hlink Color of hovered links in tables bg_link Color of links on background bg_vlink Color of visited links on background bg_hlink Color of hovered links on background headline Border color of headlines rankc Colors of 'ranks' (1,2,3,4) and active times hi_rankc Highlighted ranks pic_height Hardcode user picture sizes on stats page. This is when user has a pic, and you want to make it smaller. pic_width pic_v_0 Below settings are the filenames of the images to be pic_v_6 shown on the page on timebars, the names should be pic_v_12 self-explainable. pic_v_18 pic_h_0 pic_h_6 pic_h_12 pic_h_18 * Small things, useful for some people * logtype The type of logs kept for your channel. Currently only "Logfile" is supported. langfile Filename of language file. Default 'lang.txt' minquote Minimal value of letters for a random quote maxquote Maximum value of letters for a random quote wordlength The minimum number of chars an interesting word may be (in 'most referenced words') activenicks Number of nicks to show in the 'top 25' activenicks2 Nicks to show in 'these didnt make it...' topichistory How many topics to show in 'latest topics' nicktracking Track nickchanges and create aliases [1 or 0, enabled by default] WORD OPTIONS ------------------ pisg has the feature of making stats of people using "foul words" or bad language, like fuck, shit, etc. but this is something people would like to configure to their own language and slang. So this option configures which words which are considered to be "foul": Or in German: pisg also recognizes that people may attack others in a variety of ways. The words that pisg considers to be attacks may be set with the "violent" option: Have fun configuring pisg! :) LINKS ------------------ It's possible to ignore links in the 'most referenced URLs' section: