4
0

README 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. Perl IRC Statistics Generator (pisg) is a Perl script which takes IRC
  2. logfiles and turns them into nice looking stats, which can be amusing to
  3. show for the users of your channel.
  4. The supported logfile formats is explained in the FORMATS file included with
  5. this distribution in the 'docs' directory.
  6. SETTING UP PISG
  7. ---------------
  8. Full documentation for pisg is located in 'docs/pisg-doc.txt' and
  9. 'docs/html/index.html' for a HTML version.
  10. Quick usage instructions below:
  11. It's quite simple to set up pisg. You have 2 choices:
  12. * Set settings from commandline (try pisg --help)
  13. * Configure pisg from the pisg.cfg file (more flexible and configurable)
  14. If you look in the example pisg.cfg, you will see a small working sample
  15. where you can insert your own data.
  16. The commandline version has the disadvantage that you can only set up one
  17. channel to be run.
  18. RUNNING PISG
  19. ------------
  20. If you have setup everything inside the config file, then you just need to
  21. run it. If you're on a Linux/BSD/Unix system, this should do the work:
  22. $ ./pisg
  23. Running pisg like this will just use the settings in pisg.cfg.
  24. If you want to specify things on commandline instead of in the config file,
  25. you could do:
  26. $ ./pisg -ch \#channel -l logfile.log -f mIRC -o index.html
  27. The syntax and options is explained when doing:
  28. $ ./pisg --help
  29. Setting settings on commandline, will override the relevant settings in
  30. pisg.cfg.
  31. NOTES
  32. -----
  33. There is some graphics in the gfx/ folder which pisg uses, you should put
  34. these in the same directory as your stats file(s) or use the 'PicLocation'
  35. configuration option.
  36. The stats will look best with a logfile which is at least one day long.
  37. Some stats (like smilies, exclamation marks, etc) doesn't get counted before
  38. a special amount of time.
  39. pisg supports multiple languages so the texts on the stats page will
  40. be in your own language; look in lang.txt to see the supported languages.
  41. The language can be changed from within the pisg.cfg file.
  42. If you have any corrections to the language file, or you want to add a new
  43. translation, then send it to the mailing list.
  44. CONTACT INFORMATION
  45. -------------------
  46. If you have any issues with pisg, such as problems with installing or
  47. running pisg, then send an e-mail to the pisg mailing list:
  48. http://lists.sourceforge.net/mailman/listinfo/pisg-general
  49. You can report bugs or add feature requests here:
  50. http://sourceforge.net/tracker/?group_id=31862
  51. The pisg homepage is located at http://pisg.sourceforge.net/.
  52. Have fun :)
  53. - The pisg project