Home Explore Help
Sign In
LBP
/
PISG
mirror of https://github.com/PISG/pisg.git
4
0
Fork 0
Files Issues 0 Wiki
Branch: master
Branches Tags
PISG
/
docs
/
pisg-doc.html

pisg-doc.html 125 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318 
  1. <!doctype html>
    2. 

  2. <html lang="en">
    3. 

  3. <head>
    4. 

  4. <meta charset="utf-8">
    5. 

  5. <meta name="viewport" content="width=device-width, initial-scale=1">
    6. 

  6. <title>pisg 1.0a documentation</title>
    7. 

  7. <style>
    8. 

  8. :root { --bg:#fff; --fg:#1d2329; --muted:#5b6672; --line:#d9dee3; --code:#f3f5f7; --link:#0b6b3a; }
    9. 

  9. @media (prefers-color-scheme: dark) {
    10. 

  10.   :root { --bg:#14181c; --fg:#e3e8ec; --muted:#98a4af; --line:#2a3138; --code:#1d2329; --link:#5fd08e; }
    11. 

  11. }
    12. 

  12. body { margin:0; background:var(--bg); color:var(--fg);
    13. 

  13.   font:16px/1.6 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif; }
    14. 

  14. main { max-width:60rem; margin:0 auto; padding:2rem 1rem 4rem; }
    15. 

  15. a { color:var(--link); }
    16. 

  16. h1 { margin-bottom:.2rem; } .sub { color:var(--muted); margin-top:0; }
    17. 

  17. h2 { margin-top:3rem; padding-bottom:.3rem; border-bottom:2px solid var(--line); }
    18. 

  18. h3 { margin-top:2rem; } h4 { margin:1rem 0 .2rem; color:var(--muted);
    19. 

  19.   text-transform:uppercase; font-size:.8rem; letter-spacing:.06em; }
    20. 

  20. .purpose { font-weight:400; font-size:.85rem; color:var(--muted); margin-left:.5rem; }
    21. 

  21. section.option { border-top:1px solid var(--line); padding-top:.5rem; }
    22. 

  22. pre { background:var(--code); border:1px solid var(--line); border-radius:6px;
    23. 

  23.   padding:.75rem 1rem; overflow-x:auto; font-size:.85rem; }
    24. 

  24. code { background:var(--code); padding:.1em .3em; border-radius:4px; font-size:.9em; }
    25. 

  25. nav { border:1px solid var(--line); border-radius:8px; padding:.5rem 1.2rem; margin:1.5rem 0; }
    26. 

  26. /* example config: code block with copy/download bar */
    27. 

  27. .codewrap { border:1px solid var(--line); border-radius:8px; overflow:hidden; margin:1rem 0; }
    28. 

  28. .codebar { display:flex; align-items:center; gap:.5rem; padding:.4rem .75rem; background:var(--code);
    29. 

  29.   border-bottom:1px solid var(--line); font-size:.85rem; color:var(--muted); }
    30. 

  30. .codebar span { flex:1; font-family:ui-monospace,Menlo,Consolas,monospace; }
    31. 

  31. .btn { font:inherit; font-size:.8rem; padding:.25rem .7rem; border:1px solid var(--line); border-radius:6px;
    32. 

  32.   background:var(--bg); color:var(--fg); cursor:pointer; text-decoration:none; }
    33. 

  33. .btn:hover { border-color:var(--link); color:var(--link); }
    34. 

  34. pre.cfg { margin:0; border:0; border-radius:0; max-height:36rem; overflow:auto; font-size:.8rem; line-height:1.45; }
    35. 

  35. nav .opts a { display:inline-block; margin:.1rem .6rem .1rem 0; font-size:.85rem; }
    36. 

  36. </style>
    37. 

  37. </head>
    38. 

  38. <body>
    39. 

  39. <main>
    40. 

  40. <h1>pisg 1.0a documentation</h1>
    41. 

  41. <p class="sub">How to install and configure pisg</p>
    42. 

  42. <nav aria-label="Contents"><ul><li><a href="#what-is-pisg">1. What is pisg?</a><ul><li><a href="#requirements">What are the requirements to run pisg?</a></li></ul></li><li><a href="#setting-up-pisg">2. Setting up pisg for the first time</a><ul><li><a href="#setting-up-a-channel">Setting up a channel</a></li><li><a href="#user-options">Specifying user options</a></li><li><a href="#global-options">Setting global options</a></li><li><a href="#ignoring-links">Ignoring links</a></li><li><a href="#including-config">Including common settings for various channels</a></li><li><a href="#using-css">Changing the layout of your stats page</a></li><li><a href="#running-pisg">Running pisg</a></li><li><a href="#mailing-list-and-bugs">Obtaining help and reporting bugs</a></li></ul></li><li><a href="#reference">3. General pisg options</a><div class="opts"><a href="#Channel">Channel</a> <a href="#Format">Format</a> <a href="#Network">Network</a> <a href="#OutputFile">OutputFile</a> <a href="#OutputTag">OutputTag</a> <a href="#Logfile">Logfile</a> <a href="#LogDir">LogDir</a> <a href="#NFiles">NFiles</a> <a href="#Maintainer">Maintainer</a> <a href="#ColorScheme">ColorScheme</a> <a href="#AltColorScheme">AltColorScheme</a> <a href="#Lang">Lang</a> <a href="#PageHead">PageHead</a> <a href="#PageFoot">PageFoot</a> <a href="#LogPrefix">LogPrefix</a> <a href="#LogSuffix">LogSuffix</a> <a href="#Silent">Silent</a> <a href="#CacheDir">CacheDir</a> <a href="#ChannelIndex">ChannelIndex</a> <a href="#HomeLink">HomeLink</a> <a href="#ShowNavBar">ShowNavBar</a></div></li><li><a href="#reference-stats">4. Options for various statistics features</a><div class="opts"><a href="#DailyActivity">DailyActivity</a> <a href="#ShowActiveTimes">ShowActiveTimes</a> <a href="#ShowActiveNicks">ShowActiveNicks</a> <a href="#ShowBigNumbers">ShowBigNumbers</a> <a href="#ShowTopics">ShowTopics</a> <a href="#ShowLines">ShowLines</a> <a href="#ShowWpl">ShowWpl</a> <a href="#ShowCpl">ShowCpl</a> <a href="#ShowWords">ShowWords</a> <a href="#ShowLastSeen">ShowLastSeen</a> <a href="#ShowTime">ShowTime</a> <a href="#ShowLineTime">ShowLineTime</a> <a href="#ShowWordTime">ShowWordTime</a> <a href="#ShowRandQuote">ShowRandQuote</a> <a href="#ShowLegend">ShowLegend</a> <a href="#ShowKickLine">ShowKickLine</a> <a href="#ShowActionLine">ShowActionLine</a> <a href="#ShowShoutLine">ShowShoutLine</a> <a href="#ShowFoulDecimals">ShowFoulDecimals</a> <a href="#ShowFoulLine">ShowFoulLine</a> <a href="#ShowViolentLines">ShowViolentLines</a> <a href="#ShowMuw">ShowMuw</a> <a href="#ShowMrn">ShowMrn</a> <a href="#ShowMru">ShowMru</a> <a href="#ShowCharts">ShowCharts</a> <a href="#ShowOps">ShowOps</a> <a href="#ShowVoices">ShowVoices</a> <a href="#ShowHalfops">ShowHalfops</a> <a href="#ShowMostNicks">ShowMostNicks</a> <a href="#ShowActiveGenders">ShowActiveGenders</a> <a href="#ShowSmileys">ShowSmileys</a> <a href="#ShowKarma">ShowKarma</a> <a href="#ShowMostActiveByHour">ShowMostActiveByHour</a> <a href="#ShowOnlyTop">ShowOnlyTop</a> <a href="#ShowMostActiveByHourGraph">ShowMostActiveByHourGraph</a> <a href="#ShowOverview">ShowOverview</a> <a href="#ShowRelations">ShowRelations</a> <a href="#RelationNicks">RelationNicks</a> <a href="#RelationMinWeight">RelationMinWeight</a> <a href="#ShowTimePersonalities">ShowTimePersonalities</a> <a href="#ShowConcentration">ShowConcentration</a> <a href="#ShowSignatureWords">ShowSignatureWords</a> <a href="#IgnoreWords">IgnoreWords</a> <a href="#NoIgnoredQuotes">NoIgnoredQuotes</a> <a href="#FoulWords">FoulWords</a> <a href="#ViolentWords">ViolentWords</a> <a href="#BadUrls">BadUrls</a> <a href="#MinQuote">MinQuote</a> <a href="#MaxQuote">MaxQuote</a> <a href="#WordLength">WordLength</a> <a href="#QuoteWidth">QuoteWidth</a> <a href="#BigNumbersThreshold">BigNumbersThreshold</a> <a href="#ActiveNicks">ActiveNicks</a> <a href="#ActiveNicks2">ActiveNicks2</a> <a href="#ActiveNicksByHour">ActiveNicksByHour</a> <a href="#MostNicksHistory">MostNicksHistory</a> <a href="#MostNicksVerbose">MostNicksVerbose</a> <a href="#TopicHistory">TopicHistory</a> <a href="#UrlHistory">UrlHistory</a> <a href="#ChartsHistory">ChartsHistory</a> <a href="#ChartsRegexp">ChartsRegexp</a> <a href="#WordHistory">WordHistory</a> <a href="#NickHistory">NickHistory</a> <a href="#SmileyHistory">SmileyHistory</a> <a href="#KarmaHistory">KarmaHistory</a> <a href="#NickTracking">NickTracking</a> <a href="#NickLimit">NickLimit</a> <a href="#SortByWords">SortByWords</a></div></li><li><a href="#reference-pictures">5. Picture options</a><ul><li><a href="#PicLocation">PicLocation</a></li><li><a href="#UserPics">UserPics</a></li><li><a href="#ImagePath">ImagePath</a></li><li><a href="#DefaultPic">DefaultPic</a></li><li><a href="#ImageGlobPath">ImageGlobPath</a></li><li><a href="#PicWidth">PicWidth</a></li><li><a href="#PicHeight">PicHeight</a></li></ul></li><li><a href="#reference-misc">6. Misc options</a><ul><li><a href="#Charset">Charset</a></li><li><a href="#LogCharset">LogCharset</a></li><li><a href="#LogCharsetFallback">LogCharsetFallback</a></li><li><a href="#TimeOffset">TimeOffset</a></li><li><a href="#RegexpAliases">RegexpAliases</a></li><li><a href="#LangFile">LangFile</a></li><li><a href="#CssDir">CssDir</a></li><li><a href="#HiCell">HiCell, HiCell2</a></li><li><a href="#LogType">LogType</a></li><li><a href="#StatsDump">StatsDump</a></li></ul></li><li><a href="#copyright">7. Copyright and License</a></li><li><a href="#example-config">8. Complete example configuration</a></li></ul></nav>
    43. 

  43. <section class="chapter" id="what-is-pisg"><h2>1. What is pisg?</h2>
    44. 

  44. <p>pisg is an IRC statistics generator. It takes IRC logfiles and turns
    45. 

  45.      them into nice looking stats.</p>
    46. 

  46. <p>In general, you would do something like this to get it running:
    47. 

  47. 

  48.     <ul>
    49. 

  49. <li><p>Enable logging in an IRC bot, or in your IRC client. The log will be
    50. 

  50.         outputted into a file.</p>
    51. 

  51. </li>
    52. 

  52. <li><p>You set up pisg, you define the channel name, and the path to the
    53. 

  53.         logfile you created.</p>
    54. 

  54. </li>
    55. 

  55. <li><p>You run pisg, pisg runs the log through and create statistics, it
    56. 

  56.         then creates an HTML page which you can upload to a webserver.</p>
    57. 

  57. </li>
    58. 

  58. </ul></p>
    59. 

  59. <section id="requirements"><h3>What are the requirements to run pisg?</h3>
    60. 

  60. <p><ul>
    61. 

  61. <li><p>An IRC client or bot where pisg supports the output logfile.</p>
    62. 

  62. </li>
    63. 

  63. <li><p>Any operating system which Perl runs on, this includes popular OSes
    64. 

  64.         such as Linux, FreeBSD, Windows and Mac. You will have a hard time
    65. 

  65.         finding an OS where Perl isn&#x27;t supported. For Windows this means
    66. 

  66.         that you need to download <a href="http://activestate.com/Products/ActivePerl/">ActivePerl</a>.</p>
    67. 

  67. </li>
    68. 

  68. <li><p><em>Optional</em> - a system to host the statistics page
    69. 

  69.        24 hours a day, 7 days a week.</p>
    70. 

  70. </li>
    71. 

  71. <li><p><em>Optional</em> - a system to log the channel, 24 hours
    72. 

  72.        a day, 7 days a week.</p>
    73. 

  73. </li>
    74. 

  74. </ul></p>
    75. 

  75. </section>
    76. 

  76. </section>
    77. 

  77. <section class="chapter" id="setting-up-pisg"><h2>2. Setting up pisg for the first time</h2>
    78. 

  78. <p>Most configuration happens through the <code>pisg.cfg</code>
    79. 

  79.    file, the file format is made to be easy to read, and easy to extend for
    80. 

  80.    further use. It uses an XML-like format, with elements and attributes.</p>
    81. 

  81. <section id="setting-up-a-channel"><h3>Setting up a channel</h3>
    82. 

  82. <p>An element called <a href="#Channel">Channel</a> is made for defining
    83. 

  83.    channels, a quick example of a channel is here:
    84. 

  84. 

  85.    <pre>&lt;channel=&quot;#channel&quot;&gt;
    86. 

  86.  Logfile = &quot;channel.log&quot;
    87. 

  87.  Format = &quot;mIRC&quot;
    88. 

  88.  Maintainer = &quot;John&quot;
    89. 

  89.  OutputFile = &quot;mychan.html&quot;
    90. 

  90. &lt;/channel&gt;</pre>
    91. 

  91. 

  92. 

  93.    The above will define a <a href="#Channel">Channel</a> called <code>#channel</code>, the
    94. 

  94.    logfile pisg will look for is called <code>channel.log</code> and
    95. 

  95.    the <a href="#Format">Format</a> of the logfile will be <code>mIRC</code>. The
    96. 

  96.    <a href="#Maintainer">Maintainer</a> (which will be stated on the output page) is
    97. 

  97.    <code>John</code>.</p>
    98. 

  98. <p>That is basically it! Now, there are a lot more options that you can use
    99. 

  99.    for your channels, for this please refer to the reference documentation.</p>
    100. 

  100. <p>Also be-aware of the fact that pisg uses various images to show the
    101. 

  101.    time-related bars. These images are placed in the
    102. 

  102.    <code>gfx/</code> folder and should be placed into the same
    103. 

  103.    directory as your outputted HTML file.</p>
    104. 

  104. </section>
    105. 

  105. <section id="user-options"><h3>Specifying user options</h3>
    106. 

  106. <p>User options are set with a simple XML-like syntax in the form:
    107. 

  107. 

  108.    <pre>&lt;user nick=&quot;NICK&quot; option=&quot;VALUE&quot;&gt;</pre>
    109. 

  109. 

  110. 

  111.     Remember, the nick is always required.
    112. 

  112. 

  113.     For example to add aliases to a nick, then you could do this:
    114. 

  114.     <pre>&lt;user nick=&quot;Joe&quot; alias=&quot;Joe^*&quot;&gt;</pre>
    115. 

  115. 

  116. 

  117.     The asterisk (*) means that it will match all nicks starting with &#x27;Joe^&#x27;. So
    118. 

  118.     it will add all Joe^&#x27;s to &#x27;Joe&#x27; in the stats.
    119. 

  119. 

  120.     Another thing you can do is to add a picture to a user:
    121. 

  121.     <pre>&lt;user nick=&quot;Ben&quot; pic=&quot;ben_holiday.jpg&quot;&gt;</pre>
    122. 

  122. 

  123. 

  124.     If you have a larger picture of the user as well, you can make the picture
    125. 

  125.     on the stats page link to it:
    126. 

  126.     <pre>&lt;user nick=&quot;Ben&quot; pic=&quot;ben_holiday.jpg&quot; bigpic=&quot;ben-big.jpg&quot;&gt;</pre>
    127. 

  127. 

  128. 

  129.     You can include * or ? to enable filename globbing to randomly choose one
    130. 

  130.     from several pictures: (see documentation for the
    131. 

  131.     <a href="#ImageGlobPath">ImageGlobPath</a> option)
    132. 

  132.     <pre>&lt;user nick=&quot;Ben&quot; pic=&quot;ben_*.jpg&quot;&gt;</pre>
    133. 

  133. 

  134. 

  135.     You can also set a user&#x27;s sex.
    136. 

  136.     The sex setting can be &quot;f&quot;emale, &quot;m&quot;ale, or &quot;b&quot;ot:
    137. 

  137.     <pre>&lt;user nick=&quot;Ben&quot; sex=&quot;m&quot;&gt;</pre>
    138. 

  138. 

  139. 

  140.     Also you can add links to URLs and e-mails:
    141. 

  141.     <pre>&lt;user nick=&quot;Christine&quot; link=&quot;http://www.christine.com&quot;&gt;</pre>
    142. 

  142. 

  143. 

  144.         or
    145. 

  145. 

  146.     <pre>&lt;user nick=&quot;Chris&quot; link=&quot;chris@host.com&quot;&gt;</pre>
    147. 

  147. 

  148. 

  149.     The last thing you can do is to ignore nicks (for example bots):
    150. 

  150.     <pre>&lt;user nick=&quot;nameofbot&quot; ignore=&quot;y&quot;&gt;</pre>
    151. 

  151. 

  152. 

  153.     You don&#x27;t have to do all this in many lines, you could just as easily do:
    154. 

  154.     <pre>&lt;user nick=&quot;Joe&quot; alias=&quot;Joe^away Joe^work&quot; pic=&quot;joe.jpg&quot; link=&quot;joe@joe.com&quot; sex=&quot;m&quot;&gt;</pre>
    155. 

  155. 

  156. 

  157.     (Here the aliases are a space separated list of nicks, that also works! But *
    158. 

  158.     as a wildcard is smarter, although it is slower).</p>
    159. 

  159. </section>
    160. 

  160. <section id="global-options"><h3>Setting global options</h3>
    161. 

  161. <p>Many times, it will be useful to set up global options, global options
    162. 

  162.      are set like this:
    163. 

  163. 

  164.      <pre>&lt;set option=&quot;VALUE&quot;&gt;</pre>
    165. 

  165. 

  166. 

  167.      Any global option will be overriden by anything defined within channel
    168. 

  168.      elements (see <a href="#setting-up-a-channel">Setting up a channel</a>)</p>
    169. 

  169. <p>For example, to change the background color of the stats page, you
    170. 

  170.      could do:
    171. 

  171. 

  172.      <pre>&lt;set bgcolor=&quot;black&quot;&gt;</pre>
    173. 

  173. 

  174. 

  175.      You can set many options in a single <code>set</code>:
    176. 

  176. 

  177.      <pre>&lt;set lang=&quot;DE&quot; timeoffset=&quot;+1&quot;&gt;</pre>
    178. 

  178. 

  179. 

  180.      The above will set the language on the statistics page to DE (Deutsch,
    181. 

  181.      German) and set the time offset to +1.
    182. 

  182. 

  183.      All options available are mentioned in the reference documentation.</p>
    184. 

  184. </section>
    185. 

  185. <section id="ignoring-links"><h3>Ignoring links</h3>
    186. 

  186. <p>It&#x27;s possible to ignore links in the &quot;Most referenced URLs&quot; section:
    187. 

  187. 

  188. 

  189.     <pre>&lt;link url=&quot;http://www.slashdot.org&quot; ignore=&quot;y&quot;&gt;</pre></p>
    190. 

  190. </section>
    191. 

  191. <section id="including-config"><h3>Including common settings for various channels</h3>
    192. 

  192. <p>If you have, for example, more than one channel, where the users are the
    193. 

  193.     same, or you don&#x27;t want to maintain more than one user file, you can use
    194. 

  194.     the &quot;include&quot; setting in the main config file:
    195. 

  195. 

  196.     <pre>&lt;include=&quot;/home/vetinari/pisg/users.cfg&quot;&gt;</pre>
    197. 

  197. 

  198. 

  199.     This will include the file /home/vetinari/pisg/users.cfg in the config
    200. 

  200.     at the place where the include statement is set.</p>
    201. 

  201. <p>Note, that you can NOT include a file from an included file!</p>
    202. 

  202. </section>
    203. 

  203. <section id="using-css"><h3>Changing the layout of your stats page</h3>
    204. 

  204. <p>The standard layout and colors in the outputted HTML page are made to be
    205. 

  205.     somewhat clean and neutral. But you have the chance to change the layout
    206. 

  206.     yourself.</p>
    207. 

  207. <p>There are a few predefined color schemes for you to use, use the
    208. 

  208.     <a href="#ColorScheme">ColorScheme</a> option when using them. The
    209. 

  209.     colorschemes distributed with pisg are: default (which is the default),
    210. 

  210.     darkgalaxy, darkred, justgrey, ocean, orange_grey, pisg, softgreen.</p>
    211. 

  211. <p>When changing it, you need a fair knowledge of CSS (Cascading Style
    212. 

  212.     Sheets). CSS is what most of the web uses today to define styles and
    213. 

  213.     layout on HTML pages.
    214. 

  214.     With the pisg distribution, look in the <code>layout</code>
    215. 

  215.     directory. In it resides <code>default.css</code> which is the
    216. 

  216.     file being included onto the HTML page. Open it in a text editor like
    217. 

  217.     vi or notepad. Then change it until you&#x27;re happy with it. Be aware that
    218. 

  218.     you might want to look at the <a href="#HiCell">HiCell and HiCell2</a>
    219. 

  219.     options through pisg.cfg for changing the last two colors.</p>
    220. 

  220. <p>If you have created a nice stylesheet which others can take advantage of,
    221. 

  221.     open a pull request at <a href="https://github.com/PISG/pisg">https://github.com/PISG/pisg</a>
    222. 

  222.     so that it can be distributed with the next version of pisg. The theme
    223. 

  223.     creator at <a href="https://pisg.github.io/themes/">https://pisg.github.io/themes/</a>
    224. 

  224.     builds a stylesheet from a palette and previews it on a full stats page.</p>
    225. 

  225. <p>If you want to embed the statistics into another page, use the &quot;none&quot; color scheme.
    226. 

  226.     Pisg will then omit the HTML header and write only the body part.</p>
    227. 

  227. </section>
    228. 

  228. <section id="running-pisg"><h3>Running pisg</h3>
    229. 

  229. <p>When everything is set up in the pisg configuration file (pisg.cfg),
    230. 

  230.     then you simply run pisg on the command-line.</p>
    231. 

  231. <p>Using Linux, BSD or another UNIX-like system:
    232. 

  232. 

  233.     <pre>user@host:~/pisg$ ./pisg</pre></p>
    234. 

  234. <p>Using Windows:
    235. 

  235.     <pre>c:\pisg&gt; perl pisg</pre></p>
    236. 

  236. <p>The program will run and parse the logfiles you specified in the
    237. 

  237.     configuration file.</p>
    238. 

  238. <p>If you are using Linux, BSD or another UNIX-like system and want run
    239. 

  239.     pisg automatically several times a day, then see the
    240. 

  240.     <code>crontab</code> file in the <code>scripts/</code>
    241. 

  241.     directory.</p>
    242. 

  242. <p>For Windows, see the <code>windows-upload-ftp.txt</code> file
    243. 

  243.     with the pisg distribution, this file is also placed in the
    244. 

  244.     <code>scripts/</code> directory.</p>
    245. 

  245. </section>
    246. 

  246. <section id="mailing-list-and-bugs"><h3>Obtaining help and reporting bugs</h3>
    247. 

  247. <p>If your problem could not be resolved through here, ask in #pisg on
    248. 

  248.     Undernet (irc.undernet.org). That is where the people who work on pisg are.</p>
    249. 

  249. <p>If you believe that you have found a bug, open an issue at
    250. 

  250.     <a href="https://github.com/PISG/pisg/issues">https://github.com/PISG/pisg/issues</a>.
    251. 

  251.     Say which pisg version you run and which log format, and paste the error.
    252. 

  252.     The old SourceForge mailing list and tracker are read-only history.</p>
    253. 

  253. </section>
    254. 

  254. </section>
    255. 

  255. <section class="chapter" id="reference"><h2>3. General pisg options</h2>
    256. 

  256. <section class="option" id="Channel"><h3>Channel <span class="purpose">define channel name</span></h3>
    257. 

  257. <pre>&lt;channel=&quot;#channel&quot;&gt;
    258. 

  258.  Logfile = &quot;channel.log&quot;
    259. 

  259.  Format = &quot;mIRC&quot;
    260. 

  260.  Maintainer = &quot;John&quot;
    261. 

  261. &lt;/channel&gt;</pre>
    262. 

  262. <h4>Description</h4>
    263. 

  263. <p><code>Channel</code> is used in two contexts, globally when using
    264. 

  264.     &lt;set&gt; and when defining new channels. It sets the name of the
    265. 

  265.     channel.</p>
    266. 

  266. <h4>Default</h4>
    267. 

  267. <p>Unset</p>
    268. 

  268. </section>
    269. 

  269. <section class="option" id="Format"><h3>Format <span class="purpose">the logfile format</span></h3>
    270. 

  270. <pre>&lt;channel=&quot;#channel&quot;&gt;
    271. 

  271.  Logfile = &quot;channel.log&quot;
    272. 

  272.  Format = &quot;eggdrop&quot;
    273. 

  273.  Maintainer = &quot;John&quot;
    274. 

  274. &lt;/channel&gt;
    275. 

  275. 

  276. &lt;set Format=&quot;mIRC&quot;&gt;</pre>
    277. 

  277. <h4>Description</h4>
    278. 

  278. <p><code>Format</code> is used to define the format of the logfile,
    279. 

  279.     pisg supports a various number of different logfiles, see the FORMATS
    280. 

  280.     file included with the pisg distribution. If your logfiles have the
    281. 

  281.     suffix .gz or .bz2, they will automatically be decompressed and read by
    282. 

  282.     pisg.
    283. 

  283.     See also <a href="#Maintainer">Maintainer</a>.</p>
    284. 

  284. <h4>Default</h4>
    285. 

  285. <p>Unset</p>
    286. 

  286. </section>
    287. 

  287. <section class="option" id="Network"><h3>Network <span class="purpose">the IRC network of the channel</span></h3>
    288. 

  288. <pre>&lt;channel=&quot;#channel&quot;&gt;
    289. 

  289.  Logfile = &quot;channel.log&quot;
    290. 

  290.  Format = &quot;eggdrop&quot;
    291. 

  291.  Network = &quot;Undernet&quot;
    292. 

  292. &lt;/channel&gt;
    293. 

  293. 

  294. &lt;set Network=&quot;Quakenet&quot;&gt;</pre>
    295. 

  295. <h4>Description</h4>
    296. 

  296. <p><code>Network</code> is used to set the network which the channel
    297. 

  297.     resides on, this name is displayed on the stats page.</p>
    298. 

  298. <h4>Default</h4>
    299. 

  299. <p>SomeIRCNetwork</p>
    300. 

  300. </section>
    301. 

  301. <section class="option" id="OutputFile"><h3>OutputFile <span class="purpose">name of the generated HTML page</span></h3>
    302. 

  302. <pre>&lt;channel=&quot;#channel&quot;&gt;
    303. 

  303.  Logfile = &quot;channel.log&quot;
    304. 

  304.  Format = &quot;eggdrop&quot;
    305. 

  305.  OutputFile = &quot;mychan.html&quot;
    306. 

  306. &lt;/channel&gt;
    307. 

  307. 

  308. &lt;set OutputFile=&quot;mychan.html&quot;&gt;</pre>
    309. 

  309. <h4>Description</h4>
    310. 

  310. <p><code>OutputFile</code> is used to define the name of the
    311. 

  311.     generated statistics page.</p>
    312. 

  312. <h4>Default</h4>
    313. 

  313. <p>index.html</p>
    314. 

  314. </section>
    315. 

  315. <section class="option" id="OutputTag"><h3>OutputTag <span class="purpose">tag to insert into OutputFile</span></h3>
    316. 

  316. <pre>&lt;channel=&quot;#channel&quot;&gt;
    317. 

  317.  LogDir = &quot;logs/&quot;
    318. 

  318.  Format = &quot;eggdrop&quot;
    319. 

  319.  OutputFile = &quot;mychan%t.html&quot;
    320. 

  320.  OutputTag = &quot;-week&quot;
    321. 

  321. &lt;/channel&gt;
    322. 

  322. 

  323. &lt;set OutputTag=&quot;-week&quot;&gt;</pre>
    324. 

  324. <h4>Description</h4>
    325. 

  325. <p><code>OutputTag</code> specifies a string that will replace
    326. 

  326.     occurrences of &quot;%t&quot; in <a href="#OutputFile">OutputFile</a>. This option is most
    327. 

  327.     useful when used as a command line switch (-t) to pisg in conjunction with
    328. 

  328.     <a href="#NFiles">NFiles</a> (-nf). Example:
    329. 

  329. 

  330.     <pre>$ pisg -co pisg.conf
    331. 

  331. $ pisg -co pisg.conf -nf 8 -t -week</pre>
    332. 

  332. 

  333. 

  334.     Leaving out the <code>OutputTag</code> settings from the above
    335. 

  335.     pisg.conf snippet, this writes both the full statistics (mychan.html) and
    336. 

  336.     statistics for the last week (mychan-week.html) using the same pisg config
    337. 

  337.     file. (Assuming that there are separate logfiles for each day.)</p>
    338. 

  338. <h4>Default</h4>
    339. 

  339. <p>unset</p>
    340. 

  340. </section>
    341. 

  341. <section class="option" id="Logfile"><h3>Logfile <span class="purpose">name of logfile to parse</span></h3>
    342. 

  342. <pre>&lt;channel=&quot;#channel&quot;&gt;
    343. 

  343.  Logfile=&quot;/home/foo/eggdrop/logs/mylog.txt&quot;
    344. 

  344.  Format = &quot;eggdrop&quot;
    345. 

  345. &lt;/channel&gt;
    346. 

  346. 

  347. &lt;set Logfile=&quot;foo.log&quot;&gt;</pre>
    348. 

  348. <h4>Description</h4>
    349. 

  349. <p>This defines the filename of the logfile to parse for the channel. If
    350. 

  350.     you want to parse a directory full of logfiles, you should use the
    351. 

  351.     <a href="#LogDir">LogDir</a> option instead. Providing this option multiple
    352. 

  352.     times will parse multiple files in the order the statements appear.
    353. 

  353.     Wildcards (* ? []) will be expanded.
    354. 

  354.     See also <a href="#LogDir">LogDir</a> and <a href="#NFiles">NFiles</a>.</p>
    355. 

  355. <h4>Default</h4>
    356. 

  356. <p>unset</p>
    357. 

  357. </section>
    358. 

  358. <section class="option" id="LogDir"><h3>LogDir <span class="purpose">parse a directory full of logs</span></h3>
    359. 

  359. <pre>&lt;channel=&quot;#channel&quot;&gt;
    360. 

  360.  LogDir=&quot;/home/foo/eggdrop/logs/&quot;
    361. 

  361.  Format = &quot;eggdrop&quot;
    362. 

  362. &lt;/channel&gt;
    363. 

  363. 

  364. &lt;set LogDir=&quot;dailylogs/&quot;&gt;</pre>
    365. 

  365. <h4>Description</h4>
    366. 

  366. <p>When <code>LogDir</code> is defined to valid path to a directory,
    367. 

  367.     then pisg will run through that directory, parse all logfiles in it and
    368. 

  368.     create one HTML page from it. Useful with for example eggdrop logs. Providing
    369. 

  369.     this option multiple times will parse all the files in multiple
    370. 

  370.     directories in the order the statements appear.
    371. 

  371.     See also <a href="#NFiles">NFiles</a>, <a href="#LogPrefix">LogPrefix</a>, and
    372. 

  372.     <a href="#LogSuffix">LogSuffix</a>.</p>
    373. 

  373. <h4>Default</h4>
    374. 

  374. <p>unset</p>
    375. 

  375. </section>
    376. 

  376. <section class="option" id="NFiles"><h3>NFiles <span class="purpose">parse only the last files in</span></h3>
    377. 

  377. <pre>&lt;channel=&quot;#channel&quot;&gt;
    378. 

  378.  LogDir=&quot;/home/foo/eggdrop/logs/&quot;
    379. 

  379.  NFiles=&quot;8&quot;
    380. 

  380.  Format=&quot;eggdrop&quot;
    381. 

  381. &lt;/channel&gt;
    382. 

  382. 

  383. &lt;set NFiles=&quot;8&quot;&gt;</pre>
    384. 

  384. <h4>Description</h4>
    385. 

  385. <p>When <code>NFiles</code> is set to a positive integer, pisg will
    386. 

  386.     process only the last that much logfiles from <a href="#Logfile">Logfile</a>
    387. 

  387.     and <a href="#LogDir">LogDir</a> options. Useful to create statistics that
    388. 

  388.     cover the last week or month (assuming there are separate logfile per
    389. 

  389.     day/week/etc.).</p>
    390. 

  390. <h4>Default</h4>
    391. 

  391. <p>0 (process all files)</p>
    392. 

  392. </section>
    393. 

  393. <section class="option" id="Maintainer"><h3>Maintainer <span class="purpose">name of the maintainer</span></h3>
    394. 

  394. <pre>&lt;channel=&quot;#channel&quot;&gt;
    395. 

  395.  Logfile = &quot;channel.log&quot;
    396. 

  396.  Format = &quot;mIRC&quot;
    397. 

  397.  Maintainer = &quot;Benny&quot;
    398. 

  398. &lt;/channel&gt;
    399. 

  399. 

  400. &lt;set Maintainer=&quot;Benny&quot;&gt;</pre>
    401. 

  401. <h4>Description</h4>
    402. 

  402. <p><code>Maintainer</code> is used to define the name of the
    403. 

  403.     maintainer of the statistics page, this can be either the person
    404. 

  404.     generating the stats or the bot/client doing the logging.
    405. 

  405.     The maintainer is displayed in the outputted stats page.
    406. 

  406.     This setting is also used by some log parsers where &quot;You&quot; is used
    407. 

  407.     instead of the nick in the log (e.g. &quot;You have been kicked&quot;).
    408. 

  408.     See also <a href="#Format">Format</a>, <a href="#NickTracking">NickTracking</a>.</p>
    409. 

  409. <h4>Default</h4>
    410. 

  410. <p>MAINTAINER</p>
    411. 

  411. </section>
    412. 

  412. <section class="option" id="ColorScheme"><h3>ColorScheme <span class="purpose">use a different color scheme for stats page</span></h3>
    413. 

  413. <pre>&lt;channel=&quot;#channel&quot;&gt;
    414. 

  414.  Logfile = &quot;channel.log&quot;
    415. 

  415.  ColorScheme = &quot;darkgalaxy&quot;
    416. 

  416.  Maintainer = &quot;John&quot;
    417. 

  417. &lt;/channel&gt;
    418. 

  418. 

  419. &lt;set ColorScheme=&quot;default&quot;&gt;</pre>
    420. 

  420. <h4>Description</h4>
    421. 

  421. <p><code>ColorScheme</code> is used to define the color scheme used
    422. 

  422.     for the statistics page. Actually it&#x27;s the CSS file being included.
    423. 

  423.     CSS files distributed with pisg are: darkgalaxy, darkred, default,
    424. 

  424.     justgrey, ocean, orange_grey, pisg, softgreen (omit the .css). The file
    425. 

  425.     will be included statically in the generated HTML page. If you give a file
    426. 

  426.     name or URL (i.e. a color scheme name with .css or a path), the file will
    427. 

  427.     be linked to instead. Using &quot;none&quot; will cause pisg to write only the body
    428. 

  428.     of the page; use this to include the statistics into a custom page. See
    429. 

  429.     also <a href="#CssDir">CssDir</a>, <a href="#AltColorScheme">AltColorScheme</a>,
    430. 

  430.     <a href="#HiCell">HiCell/HiCell2</a>.</p>
    431. 

  431. <h4>Default</h4>
    432. 

  432. <p>default</p>
    433. 

  433. </section>
    434. 

  434. <section class="option" id="AltColorScheme"><h3>AltColorScheme <span class="purpose">alternate stylesheets for stats page</span></h3>
    435. 

  435. <pre>&lt;channel=&quot;#channel&quot;&gt;
    436. 

  436.  Logfile = &quot;channel.log&quot;
    437. 

  437.  ColorScheme = &quot;darkgalaxy&quot;
    438. 

  438.  AltColorScheme = &quot;layout/ocean.css&quot;
    439. 

  439.  Maintainer = &quot;John&quot;
    440. 

  440. &lt;/channel&gt;
    441. 

  441. 

  442. &lt;set AltColorScheme=&quot;layout/darkgalaxy.css layout/justgrey.css&quot;&gt;</pre>
    443. 

  443. <h4>Description</h4>
    444. 

  444. <p><code>AltColorScheme</code> defines an alternate CSS file to
    445. 

  445.     be used for the statistics page. Multiple files can be given (space
    446. 

  446.     separated.) Note that this is not supported by all browsers.
    447. 

  447.     See also <a href="#ColorScheme">ColorScheme</a> and <a href="#CssDir">CssDir</a>.</p>
    448. 

  448. <h4>Default</h4>
    449. 

  449. <p>default</p>
    450. 

  450. </section>
    451. 

  451. <section class="option" id="Lang"><h3>Lang <span class="purpose">define the language / translation to use</span></h3>
    452. 

  452. <pre>&lt;channel=&quot;#channel&quot;&gt;
    453. 

  453.  Logfile = &quot;channel.log&quot;
    454. 

  454.  Format = &quot;mIRC&quot;
    455. 

  455.  Lang = &quot;DE&quot;
    456. 

  456.  OutputFile = &quot;mychan-%l.html&quot;
    457. 

  457. &lt;/channel&gt;
    458. 

  458. 

  459. &lt;set Lang=&quot;FR,SE&quot;&gt;</pre>
    460. 

  460. <h4>Description</h4>
    461. 

  461. <p><code>Lang</code> defines the language to use for the stats.
    462. 

  462.     Currently, lang.txt includes:
    463. 

  463.     EN    (English),
    464. 

  464.     BG    (Bulgarian),
    465. 

  465.     CA    (Catalan),
    466. 

  466.     CZ    (Czech),
    467. 

  467.     DA    (Danish),
    468. 

  468.     DE    (German),
    469. 

  469.     EE    (Estonian),
    470. 

  470.     ES    (Spanish),
    471. 

  471.     FI    (Finnish),
    472. 

  472.     FR    (French),
    473. 

  473.     GR    (Greek),
    474. 

  474.     HE    (Hebrew),
    475. 

  475.     HU    (Hungarian),
    476. 

  476.     IS    (Icelandic),
    477. 

  477.     IT    (Italian),
    478. 

  478.     NL    (Dutch),
    479. 

  479.     NL_BE (Flemish),
    480. 

  480.     NO    (Norwegian),
    481. 

  481.     PL    (Polish),
    482. 

  482.     PT    (Portuguese),
    483. 

  483.     PT_BR (Portuguese/Brazil),
    484. 

  484.     RO    (Romanian),
    485. 

  485.     RU    (Russian),
    486. 

  486.     SE    (Swedish),
    487. 

  487.     SI    (Slovenian),
    488. 

  488.     SK    (Slovak),
    489. 

  489.     SQ    (Albanian),
    490. 

  490.     TR    (Turkish),
    491. 

  491.     YU    (Serbian).
    492. 

  492.     Output in several languages can be generated at the same time, separate the
    493. 

  493.     languages by comma. The tag %l in the output file name will be replaced by
    494. 

  494.     the language name. See also <a href="#LangFile">LangFile</a>.</p>
    495. 

  495. <h4>Default</h4>
    496. 

  496. <p>EN (English)</p>
    497. 

  497. </section>
    498. 

  498. <section class="option" id="PageHead"><h3>PageHead <span class="purpose">define a file as page header</span></h3>
    499. 

  499. <pre>&lt;channel=&quot;#channel&quot;&gt;
    500. 

  500.  Logfile = &quot;channel.log&quot;
    501. 

  501.  Format = &quot;mIRC&quot;
    502. 

  502.  OutputFile = &quot;stats.html&quot;
    503. 

  503.  PageHead = &quot;myheader.txt&quot;
    504. 

  504. &lt;/channel&gt;
    505. 

  505. 

  506. &lt;set PageHead=&quot;someheader.txt&quot;&gt;</pre>
    507. 

  507. <h4>Description</h4>
    508. 

  508. <p><code>PageHead</code> is used to include a file in the stats page,
    509. 

  509.     for example an introduction text, a link to an image or a banner. The
    510. 

  510.     file can hold anything, it will be included raw in the stats page -
    511. 

  511.     so HTML should be preferred. The file will be included in the top of
    512. 

  512.     the page. This option is the opposite of <a href="#PageFoot">PageFoot</a>.</p>
    513. 

  513. <h4>Default</h4>
    514. 

  514. <p>none</p>
    515. 

  515. </section>
    516. 

  516. <section class="option" id="PageFoot"><h3>PageFoot <span class="purpose">define a file as page footer</span></h3>
    517. 

  517. <pre>&lt;channel=&quot;#channel&quot;&gt;
    518. 

  518.  Logfile = &quot;channel.log&quot;
    519. 

  519.  Format = &quot;mIRC&quot;
    520. 

  520.  outputfile = &quot;stats.html&quot;
    521. 

  521.  PageFoot = &quot;myfooter.txt&quot;
    522. 

  522. &lt;/channel&gt;
    523. 

  523. 

  524. &lt;set PageFoot=&quot;somefooter.txt&quot;&gt;</pre>
    525. 

  525. <h4>Description</h4>
    526. 

  526. <p><code>PageFoot</code> is used to include a file in the stats page,
    527. 

  527.     for example an introduction text, a link to an image or a banner. The
    528. 

  528.     file can hold anything, it will be included raw in the stats page -
    529. 

  529.     so HTML should be preferred. The file will be included in the bottom of
    530. 

  530.     the page. This option is the opposite of <a href="#PageHead">PageHead</a>.</p>
    531. 

  531. <h4>Default</h4>
    532. 

  532. <p>none</p>
    533. 

  533. </section>
    534. 

  534. <section class="option" id="LogPrefix"><h3>LogPrefix <span class="purpose">only parse logs LogPrefixed with a user defined string</span></h3>
    535. 

  535. <pre>&lt;channel=&quot;#channel&quot;&gt;
    536. 

  536.  LogDir=&quot;/home/foo/eggdrop/logs/&quot;
    537. 

  537.  Format = &quot;eggdrop&quot;
    538. 

  538.  LogPrefix = &quot;logjun&quot;
    539. 

  539. &lt;/channel&gt;
    540. 

  540. 

  541. &lt;set LogPrefix=&quot;logjanuary&quot;&gt;</pre>
    542. 

  542. <h4>Description</h4>
    543. 

  543. <p>When using the <a href="#LogDir">LogDir</a> option and you only want to use
    544. 

  544.     a slew of the files in it, you can have pisg choose only files which are
    545. 

  545.     prefixed with a special string.</p>
    546. 

  546. <h4>Default</h4>
    547. 

  547. <p>unset</p>
    548. 

  548. </section>
    549. 

  549. <section class="option" id="LogSuffix"><h3>LogSuffix <span class="purpose">Regexp to sort logfiles by format month||day||year</span></h3>
    550. 

  550. <pre>&lt;set LogSuffix=&quot;\.\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)&quot;&gt;</pre>
    551. 

  551. <h4>Description</h4>
    552. 

  552. <p><code>LogSuffix</code> is used to define the suffix of a logfile,
    553. 

  553.     it only works when <a href="#LogDir">LogDir</a> is defined. The example in
    554. 

  554.     the synopsis is for the eggdrop bots default format.</p>
    555. 

  555. <h4>Default</h4>
    556. 

  556. <p>Unset</p>
    557. 

  557. </section>
    558. 

  558. <section class="option" id="Silent"><h3>Silent <span class="purpose">make pisg silent, suppress messages</span></h3>
    559. 

  559. <pre>&lt;set Silent=&quot;1&quot;&gt;</pre>
    560. 

  560. <h4>Description</h4>
    561. 

  561. <p>This option is useful mainly from command line when invoking pisg with
    562. 

  562.     <code>--silent 1</code>. But it can also used in the configuration
    563. 

  563.     file. It will suppress all standard output from pisg. Error messages
    564. 

  564.     will still be sent.</p>
    565. 

  565. <h4>Default</h4>
    566. 

  566. <p>0 (disabled)</p>
    567. 

  567. </section>
    568. 

  568. <section class="option" id="CacheDir"><h3>CacheDir <span class="purpose">use a cache to speed up log parsing</span></h3>
    569. 

  569. <pre>&lt;set CacheDir=&quot;pisg_cache&quot;&gt;
    570. 

  570. &lt;set CacheDir=&quot;/path/to/pisg_cache&quot;&gt;</pre>
    571. 

  571. <h4>Description</h4>
    572. 

  572. <p>Setting this option makes pisg dump the results of log parsing into cache
    573. 

  573.     files. The next time pisg is run, it compares the timestamp of the log(s)
    574. 

  574.     with the timestamp stored in the cache file. When the log was not changed,
    575. 

  575.     the cached data is used. (This means that it does not work if you only
    576. 

  576.     have a single big logfile. Split the log at arbitrary points and use
    577. 

  577.     <a href="#LogDir">LogDir</a> or <a href="#Logfile">Logfile</a>=&quot;dir/*&quot;.)</p>
    578. 

  578. <p>Note that the cache files should be deleted when the pisg config file is
    579. 

  579.     changed since the cache data uses the old config settings.
    580. 

  580.     <a href="#NickTracking">NickTracking</a> does not work especially well with the
    581. 

  581.     cache when using different <a href="#NFiles">NFiles</a> settings.</p>
    582. 

  582. <h4>Default</h4>
    583. 

  583. <p>Unset</p>
    584. 

  584. </section>
    585. 

  585. <section class="option" id="ChannelIndex"><h3>ChannelIndex <span class="purpose">name of the channel list file for a landing page</span></h3>
    586. 

  586. <pre>&lt;set ChannelIndex=&quot;channels.json&quot;&gt;</pre>
    587. 

  587. <h4>Description</h4>
    588. 

  588. <p>Each time pisg writes a channel page, it also updates a small JSON file, next to
    589. 

  589.     that page, listing the channels found in the same directory: the channel name as
    590. 

  590.     written in the <a href="#Channel">Channel</a> setting, the page file name, the network, when
    591. 

  591.     it was updated, and the number of days, nicks and lines. A landing page can read this
    592. 

  592.     file to offer a drop-down list of channels (see <code>site/index.html</code>), so
    593. 

  593.     nothing has to scan or scrape the HTML pages. Each run only changes the entry of its
    594. 

  594.     own channel, and entries whose page no longer exists are removed. Set it to &quot;none&quot;
    595. 

  595.     to switch this off.</p>
    596. 

  596. <h4>Default</h4>
    597. 

  597. <p>channels.json</p>
    598. 

  598. </section>
    599. 

  599. <section class="option" id="HomeLink"><h3>HomeLink <span class="purpose">adds a button at the top of every stats page that leads back to your landing page</span></h3>
    600. 

  600. <pre>&lt;set HomeLink=&quot;index.html&quot;&gt;</pre>
    601. 

  601. <h4>Description</h4>
    602. 

  602. <p>Shows an &quot;All channels&quot; button above the title of each stats page (translated with the
    603. 

  603.     page language). Give the page it should lead to: a file name next to the stats page, such as
    604. 

  604.     <code>index.html</code> (the landing page in <code>site/</code>), or a full
    605. 

  605.     http(s) address. Leave it empty, or &quot;none&quot;, for no button. Only the newer colour schemes
    606. 

  606.     draw it as a button; a scheme set to &quot;none&quot; does not show it.</p>
    607. 

  607. <h4>Default</h4>
    608. 

  608. <p>empty (no button)</p>
    609. 

  609. </section>
    610. 

  610. <section class="option" id="ShowNavBar"><h3>ShowNavBar <span class="purpose">enable/disable the section bar at the top of the page</span></h3>
    611. 

  611. <pre>&lt;set ShowNavBar=&quot;1&quot;&gt;</pre>
    612. 

  612. <h4>Description</h4>
    613. 

  613. <p>Adds a slim bar at the top of the stats page that stays in view while scrolling. It shows which
    614. 

  614.     section is being read, and a &quot;Sections&quot; button opens a list of every section, laid out in columns so
    615. 

  615.     nothing has to be scrolled sideways, whatever the number of sections or the language. It also works
    616. 

  616.     without JavaScript. The bar is left out when <a href="#ColorScheme">ColorScheme</a> is &quot;none&quot;,
    617. 

  617.     since the page is then meant to be embedded in another one.</p>
    618. 

  618. <h4>Default</h4>
    619. 

  619. <p>1 (enabled)</p>
    620. 

  620. </section>
    621. 

  621. </section>
    622. 

  622. <section class="chapter" id="reference-stats"><h2>4. Options for various statistics features</h2>
    623. 

  623. <section class="option" id="DailyActivity"><h3>DailyActivity <span class="purpose">number of days to show in &quot;Daily Actitity&quot;</span></h3>
    624. 

  624. <pre>&lt;channel=&quot;#channel&quot;&gt;
    625. 

  625.  Logfile = &quot;channel.log&quot;
    626. 

  626.  Format = &quot;xchat&quot;
    627. 

  627.  DailyActivity = &quot;0&quot;
    628. 

  628. &lt;/channel&gt;
    629. 

  629. 

  630. &lt;set DailyActivity=&quot;31&quot;&gt;</pre>
    631. 

  631. <h4>Description</h4>
    632. 

  632. <p>This option sets the number of days to show in the &quot;Daily activity&quot;
    633. 

  633.     section. Pisg will generate a graph that shows the actitivy during
    634. 

  634.     this timeframe. Setting the option to 0 disables the section.</p>
    635. 

  635. <h4>Default</h4>
    636. 

  636. <p>0 (disabled)</p>
    637. 

  637. </section>
    638. 

  638. <section class="option" id="ShowActiveTimes"><h3>ShowActiveTimes <span class="purpose">enable/disable &quot;Most Active Times&quot;</span></h3>
    639. 

  639. <pre>&lt;channel=&quot;#channel&quot;&gt;
    640. 

  640.  Logfile = &quot;channel.log&quot;
    641. 

  641.  Format = &quot;xchat&quot;
    642. 

  642.  ShowActiveTimes = &quot;0&quot;
    643. 

  643. &lt;/channel&gt;
    644. 

  644. 

  645. &lt;set ShowActiveTimes=&quot;1&quot;&gt;</pre>
    646. 

  646. <h4>Description</h4>
    647. 

  647. <p>With this option you can disable the &quot;Most Active Times&quot; section on the
    648. 

  648.     stats page. It will simply disappear when specifying 0.</p>
    649. 

  649. <h4>Default</h4>
    650. 

  650. <p>1 (enabled)</p>
    651. 

  651. </section>
    652. 

  652. <section class="option" id="ShowActiveNicks"><h3>ShowActiveNicks <span class="purpose">enable/disable &quot;Most Active Nicks&quot;</span></h3>
    653. 

  653. <pre>&lt;channel=&quot;#channel&quot;&gt;
    654. 

  654.  Logfile = &quot;channel.log&quot;
    655. 

  655.  Format = &quot;xchat&quot;
    656. 

  656.  ShowActiveNicks = &quot;0&quot;
    657. 

  657. &lt;/channel&gt;
    658. 

  658. 

  659. &lt;set ShowActiveNicks=&quot;1&quot;&gt;</pre>
    660. 

  660. <h4>Description</h4>
    661. 

  661. <p>With this option you can disable the &quot;Most Active Nicks&quot; section on the
    662. 

  662.     stats page.</p>
    663. 

  663. <h4>Default</h4>
    664. 

  664. <p>1 (enabled)</p>
    665. 

  665. </section>
    666. 

  666. <section class="option" id="ShowBigNumbers"><h3>ShowBigNumbers <span class="purpose">enable/disable &quot;Big Numbers&quot; sections</span></h3>
    667. 

  667. <pre>&lt;channel=&quot;#channel&quot;&gt;
    668. 

  668.  Logfile = &quot;channel.log&quot;
    669. 

  669.  Format = &quot;xchat&quot;
    670. 

  670.  ShowBigNumbers = &quot;0&quot;
    671. 

  671. &lt;/channel&gt;
    672. 

  672. 

  673. &lt;set ShowBigNumbers=&quot;1&quot;&gt;</pre>
    674. 

  674. <h4>Description</h4>
    675. 

  675. <p>With this option you can disable the &quot;Big Numbers&quot; and &quot;Other
    676. 

  676.     Interesting numbers&quot; sections on the stats page. They will simply
    677. 

  677.     disappear when specifying 0.</p>
    678. 

  678. <h4>Default</h4>
    679. 

  679. <p>1 (enabled)</p>
    680. 

  680. </section>
    681. 

  681. <section class="option" id="ShowTopics"><h3>ShowTopics <span class="purpose">enable/disable &quot;Latest topics&quot; sections</span></h3>
    682. 

  682. <pre>&lt;channel=&quot;#channel&quot;&gt;
    683. 

  683.  Logfile = &quot;channel.log&quot;
    684. 

  684.  Format = &quot;xchat&quot;
    685. 

  685.  ShowTopics = &quot;0&quot;
    686. 

  686. &lt;/channel&gt;
    687. 

  687. 

  688. &lt;set ShowTopics=&quot;1&quot;&gt;</pre>
    689. 

  689. <h4>Description</h4>
    690. 

  690. <p>With this option you can disable the &quot;Latest topics&quot; section on the
    691. 

  691.     stats page. It will simply disappear when specifying 0.</p>
    692. 

  692. <h4>Default</h4>
    693. 

  693. <p>1 (enabled)</p>
    694. 

  694. </section>
    695. 

  695. <section class="option" id="ShowLines"><h3>ShowLines <span class="purpose">enable/disable &quot;number of lines&quot;</span></h3>
    696. 

  696. <pre>&lt;channel=&quot;#channel&quot;&gt;
    697. 

  697.  Logfile = &quot;channel.log&quot;
    698. 

  698.  Format = &quot;xchat&quot;
    699. 

  699.  ShowLines = &quot;0&quot;
    700. 

  700. &lt;/channel&gt;
    701. 

  701. 

  702. &lt;set ShowLines=&quot;1&quot;&gt;</pre>
    703. 

  703. <h4>Description</h4>
    704. 

  704. <p>The default behaviour is to add a column to the &quot;Most Active Nicks&quot;
    705. 

  705.     section displaying the number of lines a user wrote. With this option it
    706. 

  706.     can be disabled.</p>
    707. 

  707. <h4>Default</h4>
    708. 

  708. <p>1 (enabled)</p>
    709. 

  709. </section>
    710. 

  710. <section class="option" id="ShowWpl"><h3>ShowWpl <span class="purpose">enable/disable &quot;words per line&quot;</span></h3>
    711. 

  711. <pre>&lt;channel=&quot;#channel&quot;&gt;
    712. 

  712.  Logfile = &quot;channel.log&quot;
    713. 

  713.  Format = &quot;xchat&quot;
    714. 

  714.  ShowWpl = &quot;0&quot;
    715. 

  715. &lt;/channel&gt;
    716. 

  716. 

  717. &lt;set ShowWpl=&quot;1&quot;&gt;</pre>
    718. 

  718. <h4>Description</h4>
    719. 

  719. <p>With this option you can enable the &quot;words per line&quot; column in the
    720. 

  720.     &quot;Most Active Nicks&quot; section. It will add a column describing the average
    721. 

  721.     words per line for a person.</p>
    722. 

  722. <h4>Default</h4>
    723. 

  723. <p>0 (disabled)</p>
    724. 

  724. </section>
    725. 

  725. <section class="option" id="ShowCpl"><h3>ShowCpl <span class="purpose">enable/disable &quot;characters per line&quot;</span></h3>
    726. 

  726. <pre>&lt;channel=&quot;#channel&quot;&gt;
    727. 

  727.  Logfile = &quot;channel.log&quot;
    728. 

  728.  Format = &quot;xchat&quot;
    729. 

  729.  ShowCpl = &quot;0&quot;
    730. 

  730. &lt;/channel&gt;
    731. 

  731. 

  732. &lt;set ShowCpl=&quot;1&quot;&gt;</pre>
    733. 

  733. <h4>Description</h4>
    734. 

  734. <p>With this option you can enable the &quot;characters per line&quot; column in the
    735. 

  735.     &quot;Most Active Nicks&quot; section. It will add a column describing the average
    736. 

  736.     number of characters per line for a person.</p>
    737. 

  737. <h4>Default</h4>
    738. 

  738. <p>0 (disabled)</p>
    739. 

  739. </section>
    740. 

  740. <section class="option" id="ShowWords"><h3>ShowWords <span class="purpose">enable/disable &quot;number of words&quot;</span></h3>
    741. 

  741. <pre>&lt;channel=&quot;#channel&quot;&gt;
    742. 

  742.  Logfile = &quot;channel.log&quot;
    743. 

  743.  Format = &quot;xchat&quot;
    744. 

  744.  ShowWords = &quot;0&quot;
    745. 

  745. &lt;/channel&gt;
    746. 

  746. 

  747. &lt;set ShowWords=&quot;1&quot;&gt;</pre>
    748. 

  748. <h4>Description</h4>
    749. 

  749. <p>The <code>ShowWords</code> option adds a column to the &quot;Most
    750. 

  750.     Active Nicks&quot; list which list the total number of words a user has
    751. 

  751.     typed.</p>
    752. 

  752. <h4>Default</h4>
    753. 

  753. <p>0 (disabled)</p>
    754. 

  754. </section>
    755. 

  755. <section class="option" id="ShowLastSeen"><h3>ShowLastSeen <span class="purpose">show when a user was last seen on a channel</span></h3>
    756. 

  756. <pre>&lt;channel=&quot;#channel&quot;&gt;
    757. 

  757.  Logfile = &quot;channel.log&quot;
    758. 

  758.  Format = &quot;xchat&quot;
    759. 

  759.  ShowLastSeen = &quot;0&quot;
    760. 

  760. &lt;/channel&gt;
    761. 

  761. 

  762. &lt;set ShowLastSeen=&quot;1&quot;&gt;</pre>
    763. 

  763. <h4>Description</h4>
    764. 

  764. <p>With this option enabled, a column will be added to the &quot;Most Active
    765. 

  765.     Nicks&quot; section to display when a user was last seen. E.g. &quot;2 days ago&quot;.</p>
    766. 

  766. <h4>Default</h4>
    767. 

  767. <p>1 (enabled)</p>
    768. 

  768. </section>
    769. 

  769. <section class="option" id="ShowTime"><h3>ShowTime <span class="purpose">show when a nick was active</span></h3>
    770. 

  770. <pre>&lt;channel=&quot;#channel&quot;&gt;
    771. 

  771.  Logfile = &quot;channel.log&quot;
    772. 

  772.  Format = &quot;xchat&quot;
    773. 

  773.  ShowTime = &quot;0&quot;
    774. 

  774. &lt;/channel&gt;
    775. 

  775. 

  776. &lt;set ShowTime=&quot;1&quot;&gt;</pre>
    777. 

  777. <h4>Description</h4>
    778. 

  778. <p>The default behaviour is to add a column to the &quot;Most Active Nicks&quot;
    779. 

  779.     section displaying a fancy time bar to show when a user was active. With
    780. 

  780.     this option it can be disabled.</p>
    781. 

  781. <h4>Default</h4>
    782. 

  782. <p>1 (enabled)</p>
    783. 

  783. </section>
    784. 

  784. <section class="option" id="ShowLineTime"><h3>ShowLineTime <span class="purpose">mIRCStats like behaviour of time bar</span></h3>
    785. 

  785. <pre>&lt;channel=&quot;#channel&quot;&gt;
    786. 

  786.  Logfile = &quot;channel.log&quot;
    787. 

  787.  Format = &quot;bobot&quot;
    788. 

  788.  ShowLineTime = &quot;0&quot;
    789. 

  789. &lt;/channel&gt;
    790. 

  790. 

  791. &lt;set ShowLineTime=&quot;1&quot;&gt;</pre>
    792. 

  792. <h4>Description</h4>
    793. 

  793. <p>The default behaviour is to add a column to the &quot;Most Active Nicks&quot;
    794. 

  794.     section displaying a fancy time bar to show when a user was active.
    795. 

  795.     With this option it can be done the same way as mIRCStats does it; that
    796. 

  796.     is, by putting that time bar next to the number of lines, in the same
    797. 

  797.     column.</p>
    798. 

  798. <h4>Default</h4>
    799. 

  799. <p>0 (disabled)</p>
    800. 

  800. </section>
    801. 

  801. <section class="option" id="ShowWordTime"><h3>ShowWordTime <span class="purpose">ShowLineTime like behavior of words column</span></h3>
    802. 

  802. <pre>&lt;channel=&quot;#channel&quot;&gt;
    803. 

  803.  Logfile = &quot;channel.log&quot;
    804. 

  804.  Format = &quot;bobot&quot;
    805. 

  805.  ShowWordTime = &quot;0&quot;
    806. 

  806. &lt;/channel&gt;
    807. 

  807. 

  808. &lt;set ShowWordTime=&quot;1&quot;&gt;</pre>
    809. 

  809. <h4>Description</h4>
    810. 

  810. <p>The default behaviour is to add a column to the &quot;Most Active Nicks&quot;
    811. 

  811.     section displaying a fancy time bar to show when a user was active.
    812. 

  812.     With this option it can be done similarly to mIRCStats does it and like
    813. 

  813.     the ShowLineTime option, but using words instead of lines; that is, by
    814. 

  814.     putting that time bar next to the number of words, in the same column.</p>
    815. 

  815. <h4>Default</h4>
    816. 

  816. <p>0 (disabled)</p>
    817. 

  817. </section>
    818. 

  818. <section class="option" id="ShowRandQuote"><h3>ShowRandQuote <span class="purpose">enable or disable the random quotes</span></h3>
    819. 

  819. <pre>&lt;channel=&quot;#channel&quot;&gt;
    820. 

  820.  Logfile = &quot;channel.log&quot;
    821. 

  821.  Format = &quot;bobot&quot;
    822. 

  822.  ShowRandQuote = &quot;0&quot;
    823. 

  823. &lt;/channel&gt;
    824. 

  824. 

  825. &lt;set ShowRandQuote=&quot;1&quot;&gt;</pre>
    826. 

  826. <h4>Description</h4>
    827. 

  827. <p>The default behaviour is to add a column to the &quot;Most Active Nicks&quot;
    828. 

  828.     section displaying a users random quote. With this option it can be
    829. 

  829.     disabled.</p>
    830. 

  830. <h4>Default</h4>
    831. 

  831. <p>1 (enabled)</p>
    832. 

  832. </section>
    833. 

  833. <section class="option" id="ShowLegend"><h3>ShowLegend <span class="purpose">enable or disable the legend of the time bars</span></h3>
    834. 

  834. <pre>&lt;channel=&quot;#channel&quot;&gt;
    835. 

  835.  Logfile = &quot;channel.log&quot;
    836. 

  836.  Format = &quot;bobot&quot;
    837. 

  837.  ShowLegend = &quot;0&quot;
    838. 

  838. &lt;/channel&gt;
    839. 

  839. 

  840. &lt;set ShowLegend=&quot;1&quot;&gt;</pre>
    841. 

  841. <h4>Description</h4>
    842. 

  842. <p>By default, pisg shows a legend below the &quot;Most Active Times&quot; displaying
    843. 

  843.     what the different colors means. With this option it can be disabled.</p>
    844. 

  844. <h4>Default</h4>
    845. 

  845. <p>1 (enabled)</p>
    846. 

  846. </section>
    847. 

  847. <section class="option" id="ShowKickLine"><h3>ShowKickLine <span class="purpose">enable or disable the kick line</span></h3>
    848. 

  848. <pre>&lt;channel=&quot;#channel&quot;&gt;
    849. 

  849.  Logfile = &quot;channel.log&quot;
    850. 

  850.  Format = &quot;bobot&quot;
    851. 

  851.  ShowKickLine = &quot;0&quot;
    852. 

  852. &lt;/channel&gt;
    853. 

  853. 

  854. &lt;set ShowKickLine=&quot;1&quot;&gt;</pre>
    855. 

  855. <h4>Description</h4>
    856. 

  856. <p>By default, pisg shows an example kick line in the &quot;Most kicked&quot;-stats.
    857. 

  857.     With this option it can be disabled.</p>
    858. 

  858. <h4>Default</h4>
    859. 

  859. <p>1 (enabled)</p>
    860. 

  860. </section>
    861. 

  861. <section class="option" id="ShowActionLine"><h3>ShowActionLine <span class="purpose">enable or disable the action line</span></h3>
    862. 

  862. <pre>&lt;channel=&quot;#channel&quot;&gt;
    863. 

  863.  Logfile = &quot;channel.log&quot;
    864. 

  864.  Format = &quot;bobot&quot;
    865. 

  865.  ShowActionLine = &quot;0&quot;
    866. 

  866. &lt;/channel&gt;
    867. 

  867. 

  868. &lt;set ShowActionLine=&quot;1&quot;&gt;</pre>
    869. 

  869. <h4>Description</h4>
    870. 

  870. <p>By default, pisg shows an example action line in the &quot;Most actions&quot;-stats.
    871. 

  871.     With this option it can be disabled.</p>
    872. 

  872. <h4>Default</h4>
    873. 

  873. <p>1 (enabled)</p>
    874. 

  874. </section>
    875. 

  875. <section class="option" id="ShowShoutLine"><h3>ShowShoutLine <span class="purpose">enable or disable the shout line</span></h3>
    876. 

  876. <pre>&lt;channel=&quot;#channel&quot;&gt;
    877. 

  877.  Logfile = &quot;channel.log&quot;
    878. 

  878.  Format = &quot;bobot&quot;
    879. 

  879.  ShowShoutLine = &quot;0&quot;
    880. 

  880. &lt;/channel&gt;
    881. 

  881. 

  882. &lt;set ShowShoutLine=&quot;1&quot;&gt;</pre>
    883. 

  883. <h4>Description</h4>
    884. 

  884. <p>By default, pisg shows an example shout line in the &quot;Most shouting
    885. 

  885.     people&quot;-stats.  With this option it can be disabled.</p>
    886. 

  886. <h4>Default</h4>
    887. 

  887. <p>1 (enabled)</p>
    888. 

  888. </section>
    889. 

  889. <section class="option" id="ShowFoulDecimals"><h3>ShowFoulDecimals <span class="purpose">set how many decimals to show</span></h3>
    890. 

  890. <pre>&lt;channel=&quot;#channel&quot;&gt;
    891. 

  891.  Logfile = &quot;channel.log&quot;
    892. 

  892.  Format = &quot;bobot&quot;
    893. 

  893.  ShowFoulDecimals = &quot;2&quot;
    894. 

  894. &lt;/channel&gt;
    895. 

  895. 

  896. &lt;set ShowFoulDecimals=&quot;1&quot;&gt;</pre>
    897. 

  897. <h4>Description</h4>
    898. 

  898. <p>By default, pisg uses 1 decimal. With this option you could change 
    899. 

  899.     it to whatever you like. Negative is treated as the default value.</p>
    900. 

  900. <h4>Default</h4>
    901. 

  901. <p>1 decimal</p>
    902. 

  902. </section>
    903. 

  903. <section class="option" id="ShowFoulLine"><h3>ShowFoulLine <span class="purpose">enable or disable the foul line</span></h3>
    904. 

  904. <pre>&lt;channel=&quot;#channel&quot;&gt;
    905. 

  905.  Logfile = &quot;channel.log&quot;
    906. 

  906.  Format = &quot;bobot&quot;
    907. 

  907.  ShowFoulLine = &quot;0&quot;
    908. 

  908. &lt;/channel&gt;
    909. 

  909. 

  910. &lt;set ShowFoulLine=&quot;1&quot;&gt;</pre>
    911. 

  911. <h4>Description</h4>
    912. 

  912. <p>By default, pisg doesn&#x27;t show an example foul line in the &quot;Most
    913. 

  913.     fouls&quot;-stats.  With this option it can be enabled.</p>
    914. 

  914. <h4>Default</h4>
    915. 

  915. <p>0 (disabled)</p>
    916. 

  916. </section>
    917. 

  917. <section class="option" id="ShowViolentLines"><h3>ShowViolentLines <span class="purpose">enable or disable the violent lines</span></h3>
    918. 

  918. <pre>&lt;channel=&quot;#channel&quot;&gt;
    919. 

  919.  Logfile = &quot;channel.log&quot;
    920. 

  920.  Format = &quot;bobot&quot;
    921. 

  921.  ShowViolentLines = &quot;0&quot;
    922. 

  922. &lt;/channel&gt;
    923. 

  923. 

  924. &lt;set ShowViolentLines=&quot;1&quot;&gt;</pre>
    925. 

  925. <h4>Description</h4>
    926. 

  926. <p>By default, pisg shows example violent lines in the &quot;Most aggressive&quot;
    927. 

  927.     and &quot;Most attacked&quot;-stats.  With this option it can be disabled.</p>
    928. 

  928. <h4>Default</h4>
    929. 

  929. <p>1 (enabled)</p>
    930. 

  930. </section>
    931. 

  931. <section class="option" id="ShowMuw"><h3>ShowMuw <span class="purpose">enable or disable &quot;Most used words&quot;</span></h3>
    932. 

  932. <pre>&lt;channel=&quot;#channel&quot;&gt;
    933. 

  933.  Logfile = &quot;channel.log&quot;
    934. 

  934.  Format = &quot;xchat&quot;
    935. 

  935.  ShowMuw = &quot;0&quot;
    936. 

  936. &lt;/channel&gt;
    937. 

  937. 

  938. &lt;set ShowMuw=&quot;1&quot;&gt;</pre>
    939. 

  939. <h4>Description</h4>
    940. 

  940. <p>By default, pisg adds an &quot;Most used words&quot; section to the stats page.
    941. 

  941.     With this option you can disable it from being shown.
    942. 

  942.     See also <a href="#WordHistory">WordHistory</a>.</p>
    943. 

  943. <h4>Default</h4>
    944. 

  944. <p>1 (enabled)</p>
    945. 

  945. </section>
    946. 

  946. <section class="option" id="ShowMrn"><h3>ShowMrn <span class="purpose">enable or disable &quot;Most referenced nicks&quot;</span></h3>
    947. 

  947. <pre>&lt;channel=&quot;#channel&quot;&gt;
    948. 

  948.  Logfile = &quot;channel.log&quot;
    949. 

  949.  Format = &quot;xchat&quot;
    950. 

  950.  ShowMrn = &quot;0&quot;
    951. 

  951. &lt;/channel&gt;
    952. 

  952. 

  953. &lt;set ShowMrn=&quot;1&quot;&gt;</pre>
    954. 

  954. <h4>Description</h4>
    955. 

  955. <p>By default,  pisg adds an &quot;Most referenced nicks&quot; section to the stats
    956. 

  956.     page.  With this option you can disable it from being shown.
    957. 

  957.     See also <a href="#NickHistory">NickHistory</a>.</p>
    958. 

  958. <h4>Default</h4>
    959. 

  959. <p>1 (enabled)</p>
    960. 

  960. </section>
    961. 

  961. <section class="option" id="ShowMru"><h3>ShowMru <span class="purpose">enable or disable &quot;Most referenced URLs&quot;</span></h3>
    962. 

  962. <pre>&lt;channel=&quot;#channel&quot;&gt;
    963. 

  963.  Logfile = &quot;channel.log&quot;
    964. 

  964.  Format = &quot;xchat&quot;
    965. 

  965.  ShowMru = &quot;0&quot;
    966. 

  966. &lt;/channel&gt;
    967. 

  967. 

  968. &lt;set ShowMru=&quot;1&quot;&gt;</pre>
    969. 

  969. <h4>Description</h4>
    970. 

  970. <p>By default,  pisg adds an &quot;Most referenced URLs&quot; section to the stats
    971. 

  971.     page.  With this option you can disable it from being shown.
    972. 

  972.     See also <a href="#UrlHistory">UrlHistory</a>.</p>
    973. 

  973. <h4>Default</h4>
    974. 

  974. <p>1 (enabled)</p>
    975. 

  975. </section>
    976. 

  976. <section class="option" id="ShowCharts"><h3>ShowCharts <span class="purpose">enable or disable channel music charts</span></h3>
    977. 

  977. <pre>&lt;channel=&quot;#channel&quot;&gt;
    978. 

  978.  Logfile = &quot;channel.log&quot;
    979. 

  979.  Format = &quot;xchat&quot;
    980. 

  980.  ShowCharts = &quot;0&quot;
    981. 

  981. &lt;/channel&gt;
    982. 

  982. 

  983. &lt;set ShowCharts=&quot;1&quot;&gt;</pre>
    984. 

  984. <h4>Description</h4>
    985. 

  985. <p>With this option set, pisg creates a chart listing of the top songs played
    986. 

  986.     on the channel. See also <a href="#ChartsHistory">ChartsHistory</a> and
    987. 

  987.     <a href="#ChartsRegexp">ChartsRegexp</a>.</p>
    988. 

  988. <h4>Default</h4>
    989. 

  989. <p>0 (disabled)</p>
    990. 

  990. </section>
    991. 

  991. <section class="option" id="ShowOps"><h3>ShowOps <span class="purpose">enable or disable op statistics</span></h3>
    992. 

  992. <pre>&lt;channel=&quot;#channel&quot;&gt;
    993. 

  993.  Logfile = &quot;channel.log&quot;
    994. 

  994.  Format = &quot;xchat&quot;
    995. 

  995.  ShowOps = &quot;0&quot;
    996. 

  996. &lt;/channel&gt;
    997. 

  997. 

  998. &lt;set ShowOps=&quot;0&quot;&gt;</pre>
    999. 

  999. <h4>Description</h4>
    1000. 

  1000. <p>By default, pisg has op statistics in the &quot;Most interesting numbers&quot;
    1001. 

  1001.     section. Here you can disable the feature, it&#x27;s useful if you don&#x27;t feel
    1002. 

  1002.     that the information is of any value, or your log format doesn&#x27;t support
    1003. 

  1003.     ops/deops.</p>
    1004. 

  1004. <h4>Default</h4>
    1005. 

  1005. <p>1 (enabled)</p>
    1006. 

  1006. </section>
    1007. 

  1007. <section class="option" id="ShowVoices"><h3>ShowVoices <span class="purpose">enable or disable voice statistics</span></h3>
    1008. 

  1008. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1009. 

  1009.  Logfile = &quot;channel.log&quot;
    1010. 

  1010.  Format = &quot;xchat&quot;
    1011. 

  1011.  ShowVoices = &quot;0&quot;
    1012. 

  1012. &lt;/channel&gt;
    1013. 

  1013. 

  1014. &lt;set ShowVoices=&quot;1&quot;&gt;</pre>
    1015. 

  1015. <h4>Description</h4>
    1016. 

  1016. <p>By default, pisg doesn&#x27;t have voice statistics like it has op
    1017. 

  1017.     statistics. Enabling this option will add a section to the &quot;Most
    1018. 

  1018.     interesting numbers&quot; displaying who got most voices.</p>
    1019. 

  1019. <h4>Default</h4>
    1020. 

  1020. <p>0 (disabled)</p>
    1021. 

  1021. </section>
    1022. 

  1022. <section class="option" id="ShowHalfops"><h3>ShowHalfops <span class="purpose">enable or disable halfop statistics</span></h3>
    1023. 

  1023. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1024. 

  1024.  Logfile = &quot;channel.log&quot;
    1025. 

  1025.  Format = &quot;xchat&quot;
    1026. 

  1026.  ShowHalfops = &quot;0&quot;
    1027. 

  1027. &lt;/channel&gt;
    1028. 

  1028. 

  1029. &lt;set ShowHalfops=&quot;1&quot;&gt;</pre>
    1030. 

  1030. <h4>Description</h4>
    1031. 

  1031. <p>By default, pisg doesn&#x27;t have halfop statistics (+h on some servers)
    1032. 

  1032.     like it has op statistics. Enabling this option will add a section to
    1033. 

  1033.     the &quot;Most interesting numbers&quot; displaying who gave most half-ops.</p>
    1034. 

  1034. <h4>Default</h4>
    1035. 

  1035. <p>0 (disabled)</p>
    1036. 

  1036. </section>
    1037. 

  1037. <section class="option" id="ShowMostNicks"><h3>ShowMostNicks <span class="purpose">show who changed nick most often</span></h3>
    1038. 

  1038. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1039. 

  1039.  Logfile = &quot;channel.log&quot;
    1040. 

  1040.  Format = &quot;xchat&quot;
    1041. 

  1041.  ShowMostNicks = &quot;0&quot;
    1042. 

  1042. &lt;/channel&gt;
    1043. 

  1043. 

  1044. &lt;set ShowMostNicks=&quot;1&quot;&gt;</pre>
    1045. 

  1045. <h4>Description</h4>
    1046. 

  1046. <p>By enabling this option, pisg will add a section to the stats showing
    1047. 

  1047.     who had the most nicks, and what the nicks were. This option only works
    1048. 

  1048.     properly when <a href="#NickTracking">NickTracking</a> is enabled or
    1049. 

  1049.     <a href="#user-options">user aliases</a> have been defined.
    1050. 

  1050.     See also <a href="#MostNicksHistory">MostNicksHistory</a>,
    1051. 

  1051.     <a href="#MostNicksVerbose">MostNicksVerbose</a>, and
    1052. 

  1052.     <a href="#NickLimit">NickLimit</a>.</p>
    1053. 

  1053. <h4>Default</h4>
    1054. 

  1054. <p>0 (disabled)</p>
    1055. 

  1055. </section>
    1056. 

  1056. <section class="option" id="ShowActiveGenders"><h3>ShowActiveGenders <span class="purpose">show stats on which gender talked most</span></h3>
    1057. 

  1057. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1058. 

  1058.  Logfile = &quot;channel.log&quot;
    1059. 

  1059.  Format = &quot;xchat&quot;
    1060. 

  1060.  ShowActiveGenders = &quot;0&quot;
    1061. 

  1061. &lt;/channel&gt;
    1062. 

  1062. 

  1063. &lt;set ShowActiveGenders=&quot;1&quot;&gt;</pre>
    1064. 

  1064. <h4>Description</h4>
    1065. 

  1065. <p>Setting this option will make pisg create statistics on which gender
    1066. 

  1066.     (female/male/bot) talked most (see the &quot;sex&quot; option in <a href="#user-options">Specifying user options</a>). See also <a href="#NickLimit">NickLimit</a>.</p>
    1067. 

  1067. <h4>Default</h4>
    1068. 

  1068. <p>0 (disabled)</p>
    1069. 

  1069. </section>
    1070. 

  1070. <section class="option" id="ShowSmileys"><h3>ShowSmileys <span class="purpose">show most used smileys</span></h3>
    1071. 

  1071. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1072. 

  1072.  Logfile = &quot;channel.log&quot;
    1073. 

  1073.  Format = &quot;xchat&quot;
    1074. 

  1074.  ShowSmileys = &quot;0&quot;
    1075. 

  1075. &lt;/channel&gt;
    1076. 

  1076. 

  1077. &lt;set ShowSmileys=&quot;1&quot;&gt;</pre>
    1078. 

  1078. <h4>Description</h4>
    1079. 

  1079. <p>With this option, pisg will make a list of the most used smileys in the
    1080. 

  1080.     channel. See also <a href="#SmileyHistory">SmileyHistory</a>.</p>
    1081. 

  1081. <h4>Default</h4>
    1082. 

  1082. <p>0 (disabled)</p>
    1083. 

  1083. </section>
    1084. 

  1084. <section class="option" id="ShowKarma"><h3>ShowKarma <span class="purpose">show channel karma</span></h3>
    1085. 

  1085. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1086. 

  1086.  Logfile = &quot;channel.log&quot;
    1087. 

  1087.  Format = &quot;xchat&quot;
    1088. 

  1088.  ShowKarma = &quot;0&quot;
    1089. 

  1089. &lt;/channel&gt;
    1090. 

  1090. 

  1091. &lt;set ShowKarma=&quot;1&quot;&gt;</pre>
    1092. 

  1092. <h4>Description</h4>
    1093. 

  1093. <p>With this option, pisg will analyze the channel karma. Users can give other
    1094. 

  1094.     users (or things) good or bad karma by saying &quot;nickname++&quot; or &quot;nickname--&quot;;
    1095. 

  1095.     &quot;nickname==&quot; resets it to zero. Only the last karma is remembered per
    1096. 

  1096.     nick/nick combination, so there is at most +- 1 karma point.
    1097. 

  1097.     See also <a href="#KarmaHistory">KarmaHistory</a> and <a href="#NickLimit">NickLimit</a>.</p>
    1098. 

  1098. <h4>Default</h4>
    1099. 

  1099. <p>0 (disabled)</p>
    1100. 

  1100. </section>
    1101. 

  1101. <section class="option" id="ShowMostActiveByHour"><h3>ShowMostActiveByHour <span class="purpose">show most active nicks by hour</span></h3>
    1102. 

  1102. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1103. 

  1103.  Logfile = &quot;channel.log&quot;
    1104. 

  1104.  Format = &quot;xchat&quot;
    1105. 

  1105.  ShowMostActiveByHour = &quot;0&quot;
    1106. 

  1106. &lt;/channel&gt;
    1107. 

  1107. 

  1108. &lt;set ShowMostActiveByHour=&quot;1&quot;&gt;</pre>
    1109. 

  1109. <h4>Description</h4>
    1110. 

  1110. <p>By enabling this option, pisg will add a section to the stats showing
    1111. 

  1111.     &quot;Most Active Nicks By Hour&quot; - also look at the
    1112. 

  1112.     <a href="#ShowMostActiveByHourGraph">ShowMostActiveByHourGraph</a> and
    1113. 

  1113.     <a href="#ActiveNicksByHour">ActiveNicksByHour</a> settings.</p>
    1114. 

  1114. <h4>Default</h4>
    1115. 

  1115. <p>0 (disabled)</p>
    1116. 

  1116. </section>
    1117. 

  1117. <section class="option" id="ShowOnlyTop"><h3>ShowOnlyTop <span class="purpose">only count stats for top talkers, ignore less-active users</span></h3>
    1118. 

  1118. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1119. 

  1119.  Logfile = &quot;channel.log&quot;
    1120. 

  1120.  Format = &quot;xchat&quot;
    1121. 

  1121.  ShowOnlyTop = &quot;1&quot;
    1122. 

  1122. &lt;/channel&gt;
    1123. 

  1123. 

  1124. &lt;set ShowOnlyTop=&quot;1&quot;&gt;</pre>
    1125. 

  1125. <h4>Description</h4>
    1126. 

  1126. <p>By enabling this option, stats in the &quot;Big Numbers&quot; and &quot;Interesting
    1127. 

  1127.     Numbers&quot; section will only be counted for users who were the most
    1128. 

  1128.     active. E.g. users who appear in the &quot;Most Active Nicks&quot; section, as
    1129. 

  1129.     respected by the <a href="#ActiveNicks">ActiveNicks</a> and 
    1130. 

  1130.     <a href="#ActiveNicks2">ActiveNicks2</a> options. See also
    1131. 

  1131.     <a href="#BigNumbersThreshold">BigNumbersThreshold</a>.</p>
    1132. 

  1132. <h4>Default</h4>
    1133. 

  1133. <p>0 (disabled)</p>
    1134. 

  1134. </section>
    1135. 

  1135. <section class="option" id="ShowMostActiveByHourGraph"><h3>ShowMostActiveByHourGraph <span class="purpose">show graphs in most active nicks by hour</span></h3>
    1136. 

  1136. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1137. 

  1137.  Logfile = &quot;channel.log&quot;
    1138. 

  1138.  Format = &quot;xchat&quot;
    1139. 

  1139.  ShowMostActiveByHourGraph = &quot;0&quot;
    1140. 

  1140. &lt;/channel&gt;
    1141. 

  1141. 

  1142. &lt;set ShowMostActiveByHour=&quot;1&quot;&gt;
    1143. 

  1143. &lt;set ShowMostActiveByHourGraph=&quot;1&quot;&gt;</pre>
    1144. 

  1144. <h4>Description</h4>
    1145. 

  1145. <p>By enabling this option and the <a href="#ShowMostActiveByHour">ShowMostActiveByHour</a>
    1146. 

  1146.     option, pisg will show graphs in the &quot;Most Active Nicks By Hour&quot;
    1147. 

  1147.     section.</p>
    1148. 

  1148. <h4>Default</h4>
    1149. 

  1149. <p>1 (enabled)</p>
    1150. 

  1150. </section>
    1151. 

  1151. <section class="option" id="ShowOverview"><h3>ShowOverview <span class="purpose">enable/disable the channel overview</span></h3>
    1152. 

  1152. <pre>&lt;set ShowOverview=&quot;1&quot;&gt;</pre>
    1153. 

  1153. <h4>Description</h4>
    1154. 

  1154. <p>Shows a row of key numbers at the top of the page: lines, words, nicks, days covered, lines
    1155. 

  1155.     per day, the busiest and quietest hour, questions, links shared, the top talker and the
    1156. 

  1156.     number of joins and kicks.</p>
    1157. 

  1157. <h4>Default</h4>
    1158. 

  1158. <p>1 (enabled)</p>
    1159. 

  1159. </section>
    1160. 

  1160. <section class="option" id="ShowRelations"><h3>ShowRelations <span class="purpose">enable/disable the relation map and its tables</span></h3>
    1161. 

  1161. <pre>&lt;set ShowRelations=&quot;1&quot;&gt;</pre>
    1162. 

  1162. <h4>Description</h4>
    1163. 

  1163. <p>Shows who talks to whom: an interactive map (click a nick or a line for details), a table of
    1164. 

  1164.     the closest pairs, and the &quot;social roles&quot; (who is talked to the most, the best listener, ...).
    1165. 

  1165.     Two people are connected when one starts a line with the other&#x27;s nick (&quot;Bob: hi&quot;), mentions
    1166. 

  1166.     them, or answers right after them. A line addressed to someone counts three times as much as
    1167. 

  1167.     a mention or a quick reply. Nicks that are joined by <a href="#NickTracking">NickTracking</a> or a user alias
    1168. 

  1168.     count as one person. Bots are left out: mark a bot with &lt;user nick=&quot;Bot&quot; sex=&quot;b&quot;&gt; to keep it in the
    1169. 

  1169.     other statistics but off the map, or with ignore=&quot;y&quot; to remove it altogether. Nicks that are also
    1170. 

  1170.     ordinary words (and the channel name) are not counted as mentions.
    1171. 

  1171.     See also <a href="#RelationNicks">RelationNicks</a> and <a href="#RelationMinWeight">RelationMinWeight</a>.</p>
    1172. 

  1172. <h4>Default</h4>
    1173. 

  1173. <p>1 (enabled)</p>
    1174. 

  1174. </section>
    1175. 

  1175. <section class="option" id="RelationNicks"><h3>RelationNicks <span class="purpose">number of nicks on the relation map</span></h3>
    1176. 

  1176. <pre>&lt;set RelationNicks=&quot;30&quot;&gt;</pre>
    1177. 

  1177. <h4>Description</h4>
    1178. 

  1178. <p>The map shows this many of the most active people (bots excluded). More than about 40 makes
    1179. 

  1179.     the picture crowded.</p>
    1180. 

  1180. <h4>Default</h4>
    1181. 

  1181. <p>30</p>
    1182. 

  1182. </section>
    1183. 

  1183. <section class="option" id="RelationMinWeight"><h3>RelationMinWeight <span class="purpose">minimum connection strength shown as a line on the relation map</span></h3>
    1184. 

  1184. <pre>&lt;set RelationMinWeight=&quot;3&quot;&gt;</pre>
    1185. 

  1185. <h4>Description</h4>
    1186. 

  1186. <p>Connections weaker than this are not drawn, which keeps the map readable. A line addressed to
    1187. 

  1187.     someone is worth 3, a mention 1 and a quick reply 1. Raise it for a busy channel, lower it for a quiet one.</p>
    1188. 

  1188. <h4>Default</h4>
    1189. 

  1189. <p>3</p>
    1190. 

  1190. </section>
    1191. 

  1191. <section class="option" id="ShowTimePersonalities"><h3>ShowTimePersonalities <span class="purpose">enable/disable the time personalities section</span></h3>
    1192. 

  1192. <pre>&lt;set ShowTimePersonalities=&quot;1&quot;&gt;</pre>
    1193. 

  1193. <h4>Description</h4>
    1194. 

  1194. <p>Shows who chats mostly at night (0-5h), in the morning (6-11h), in the afternoon (12-17h) and
    1195. 

  1195.     in the evening (18-23h), for the people with enough lines. The hours follow <a href="#TimeOffset">TimeOffset</a>.</p>
    1196. 

  1196. <h4>Default</h4>
    1197. 

  1197. <p>1 (enabled)</p>
    1198. 

  1198. </section>
    1199. 

  1199. <section class="option" id="ShowConcentration"><h3>ShowConcentration <span class="purpose">enable/disable the &quot;who carries the channel&quot; section</span></h3>
    1200. 

  1200. <pre>&lt;set ShowConcentration=&quot;1&quot;&gt;</pre>
    1201. 

  1201. <h4>Description</h4>
    1202. 

  1202. <p>Shows how much of the channel the busiest people write: the share of all lines written by the
    1203. 

  1203.     top 1, 3, 5, 10 and 20 nicks, and how many nicks wrote half of everything.</p>
    1204. 

  1204. <h4>Default</h4>
    1205. 

  1205. <p>1 (enabled)</p>
    1206. 

  1206. </section>
    1207. 

  1207. <section class="option" id="ShowSignatureWords"><h3>ShowSignatureWords <span class="purpose">enable/disable the signature words section</span></h3>
    1208. 

  1208. <pre>&lt;set ShowSignatureWords=&quot;1&quot;&gt;</pre>
    1209. 

  1209. <h4>Description</h4>
    1210. 

  1210. <p>Shows, for each of the regular talkers, the word they use a lot and that hardly anyone else uses.
    1211. 

  1211.     Short words, nicks and links are ignored (see <a href="#WordLength">WordLength</a> and <a href="#IgnoreWords">IgnoreWords</a>).</p>
    1212. 

  1212. <h4>Default</h4>
    1213. 

  1213. <p>1 (enabled)</p>
    1214. 

  1214. </section>
    1215. 

  1215. <section class="option" id="IgnoreWords"><h3>IgnoreWords <span class="purpose">ignore specified words</span></h3>
    1216. 

  1216. <pre>&lt;set IgnoreWords=&quot;there about&quot;&gt;</pre>
    1217. 

  1217. <h4>Description</h4>
    1218. 

  1218. <p>Sometimes words in the &quot;most used words&quot; appears which you don&#x27;t want to
    1219. 

  1219.     see, with this option you can ignore these words. It also applies to the
    1220. 

  1220.     &quot;most referenced nicks&quot; section. It&#x27;s a space separated list of words.
    1221. 

  1221.     You can use * like in nick aliases.
    1222. 

  1222.     Can not be used in a channel-only context.</p>
    1223. 

  1223. <h4>Default</h4>
    1224. 

  1224. <p>unset</p>
    1225. 

  1225. </section>
    1226. 

  1226. <section class="option" id="NoIgnoredQuotes"><h3>NoIgnoredQuotes <span class="purpose">Control random quote output</span></h3>
    1227. 

  1227. <pre>&lt;set NoIgnoredQuotes=&quot;1&quot;&gt;</pre>
    1228. 

  1228. <h4>Description</h4>
    1229. 

  1229. <p>When set to &quot;1&quot;, pisg will not output quotes containing ignored words.
    1230. 

  1230.      Pisg will output a blank line after trying 20 random quotes if all 20 random quotes were ignored.</p>
    1231. 

  1231. <h4>Default</h4>
    1232. 

  1232. <p>0</p>
    1233. 

  1233. </section>
    1234. 

  1234. <section class="option" id="FoulWords"><h3>FoulWords <span class="purpose">specify words considered to be bad/FoulWords language</span></h3>
    1235. 

  1235. <pre>&lt;set FoulWords=&quot;ass fuck bitch&quot;&gt;</pre>
    1236. 

  1236. <h4>Description</h4>
    1237. 

  1237. <p>There is a section in the &quot;Most interesting numbers&quot; which tells who had
    1238. 

  1238.     a &quot;dirty mouth&quot; - here you can define which words are considered being
    1239. 

  1239.     bad/foul. It is a space separated list of words.
    1240. 

  1240.     You can use * like in nick aliases.
    1241. 

  1241.     Can not be used in a channel-only context.</p>
    1242. 

  1242. <h4>Default</h4>
    1243. 

  1243. <p>ass fuck bitch shit scheisse kacke arsch ficker ficken schlampe</p>
    1244. 

  1244. </section>
    1245. 

  1245. <section class="option" id="ViolentWords"><h3>ViolentWords <span class="purpose">specify words considered to be aggressive/violent</span></h3>
    1246. 

  1246. <pre>&lt;set ViolentWords=&quot;slaps beats kick&quot;&gt;</pre>
    1247. 

  1247. <h4>Description</h4>
    1248. 

  1248. <p>There is a section in the &quot;Most interesting numbers&quot; which tells who is
    1249. 

  1249.     most &quot;aggressive&quot; - here you can define which words are considered being
    1250. 

  1250.     &quot;violent&quot;. It is a space separated list of words. You can use * like in
    1251. 

  1251.     nick aliases. Can not be used in a channel-only context.</p>
    1252. 

  1252. <h4>Default</h4>
    1253. 

  1253. <p>slaps beats smacks</p>
    1254. 

  1254. </section>
    1255. 

  1255. <section class="option" id="BadUrls"><h3>BadUrls <span class="purpose">words that keep a URL out of the URL statistics</span></h3>
    1256. 

  1256. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1257. 

  1257.  Logfile = &quot;channel.log&quot;
    1258. 

  1258.  Format = &quot;xchat&quot;
    1259. 

  1259.  BadUrls = &quot;imagetwist imgur.com postimg.cc/*&quot;
    1260. 

  1260. &lt;/channel&gt;
    1261. 

  1261. 

  1262. &lt;set BadUrls=&quot;imagetwist imgur.com postimg.cc/*&quot;&gt;</pre>
    1263. 

  1263. <h4>Description</h4>
    1264. 

  1264. <p>BadUrls is a list of words, separated by spaces, much like <a href="#FoulWords">FoulWords</a>.
    1265. 

  1265.     A URL that contains any of the words is not counted, so it never shows up in
    1266. 

  1266.     &quot;Most referenced URLs&quot; (see <a href="#ShowMru">ShowMru</a>). Use it to keep spam and
    1267. 

  1267.     unwanted image hosts out of the statistics.
    1268. 

  1268.     A word matches anywhere in the URL, whatever the case, so &quot;imgur.com&quot; also
    1269. 

  1269.     removes &quot;https://i.imgur.com/abc.png&quot;. Two wildcards are understood: * stands for
    1270. 

  1270.     any run of characters and ? for exactly one character. So &quot;postimg.cc/*&quot; removes
    1271. 

  1271.     every link to postimg.cc (including &quot;i.postimg.cc/x.png&quot;) but not
    1272. 

  1272.     &quot;example.org/postimg.cc&quot;, where nothing follows the name, and &quot;*.example.org/*&quot;
    1273. 

  1273.     removes links on any subdomain of example.org but not on example.org itself.
    1274. 

  1274.     Apart from the wildcards the words are plain text, not regular expressions, so
    1275. 

  1275.     characters such as . + ( ) [ ] | mean exactly themselves. A lone * would remove every
    1276. 

  1276.     URL. To hide a single exact address instead, use the
    1277. 

  1277.     <a href="#ignoring-links">link ignore</a> setting.</p>
    1278. 

  1278. <h4>Default</h4>
    1279. 

  1279. <p>unset (no URLs are removed)</p>
    1280. 

  1280. </section>
    1281. 

  1281. <section class="option" id="MinQuote"><h3>MinQuote <span class="purpose">minimum numbers of letters for a random quote</span></h3>
    1282. 

  1282. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1283. 

  1283.  Logfile = &quot;channel.log&quot;
    1284. 

  1284.  Format = &quot;xchat&quot;
    1285. 

  1285.  MinQuote = &quot;10&quot;
    1286. 

  1286. &lt;/channel&gt;
    1287. 

  1287. 

  1288. &lt;set MinQuote=&quot;5&quot;&gt;</pre>
    1289. 

  1289. <h4>Description</h4>
    1290. 

  1290. <p>The random quotes displayed in the &quot;Most Active Nicks&quot; section will be
    1291. 

  1291.     picked from a length range. With this option you can change the minimum
    1292. 

  1292.     number of letters required for a random quote. Also see the
    1293. 

  1293.     <a href="#MaxQuote">MaxQuote</a> option. Note that pisg will still choose a
    1294. 

  1294.     short quote if it cannot find a longer one.</p>
    1295. 

  1295. <h4>Default</h4>
    1296. 

  1296. <p>25</p>
    1297. 

  1297. </section>
    1298. 

  1298. <section class="option" id="MaxQuote"><h3>MaxQuote <span class="purpose">maximum numbers of letters for a random quote</span></h3>
    1299. 

  1299. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1300. 

  1300.  Logfile = &quot;channel.log&quot;
    1301. 

  1301.  Format = &quot;xchat&quot;
    1302. 

  1302.  MaxQuote = &quot;70&quot;
    1303. 

  1303. &lt;/channel&gt;
    1304. 

  1304. 

  1305. &lt;set MaxQuote=&quot;100&quot;&gt;</pre>
    1306. 

  1306. <h4>Description</h4>
    1307. 

  1307. <p>The random quotes displayed in the &quot;Most Active Nicks&quot; section will be
    1308. 

  1308.     picked from a length range. With this option you can change the maximum
    1309. 

  1309.     number of letters required for a random quote. Also see the
    1310. 

  1310.     <a href="#MinQuote">MinQuote</a> option.</p>
    1311. 

  1311. <h4>Default</h4>
    1312. 

  1312. <p>65</p>
    1313. 

  1313. </section>
    1314. 

  1314. <section class="option" id="WordLength"><h3>WordLength <span class="purpose">minimum number of characters in an interesting word</span></h3>
    1315. 

  1315. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1316. 

  1316.  Logfile = &quot;channel.log&quot;
    1317. 

  1317.  Format = &quot;xchat&quot;
    1318. 

  1318.  WordLength = &quot;10&quot;
    1319. 

  1319. &lt;/channel&gt;
    1320. 

  1320. 

  1321. &lt;set WordLength=&quot;2&quot;&gt;</pre>
    1322. 

  1322. <h4>Description</h4>
    1323. 

  1323. <p>The &quot;Most Used Words&quot; section on the stats page display the most used
    1324. 

  1324.     words. The default is that a word only appears if it is longer than 5
    1325. 

  1325.     characters. With this option you can change that minimum.</p>
    1326. 

  1326. <h4>Default</h4>
    1327. 

  1327. <p>5</p>
    1328. 

  1328. </section>
    1329. 

  1329. <section class="option" id="QuoteWidth"><h3>QuoteWidth <span class="purpose">maximum allowed length of a &quot;word&quot; with no spaces</span></h3>
    1330. 

  1330. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1331. 

  1331.  Logfile = &quot;channel.log&quot;
    1332. 

  1332.  Format = &quot;xchat&quot;
    1333. 

  1333.  QuoteWidth = &quot;48&quot;
    1334. 

  1334. &lt;/channel&gt;
    1335. 

  1335. 

  1336. &lt;set QuoteWidth=&quot;48&quot;&gt;</pre>
    1337. 

  1337. <h4>Description</h4>
    1338. 

  1338. <p>Pisg will automatically insert a space in words that have a length
    1339. 

  1339.     over the amount QuoteWidth is set to.  When used in breaking up
    1340. 

  1340.     URLs it will insert a space in the displayed URL, but not in the
    1341. 

  1341.     actual URL referenced by the HREF.</p>
    1342. 

  1342. <h4>Default</h4>
    1343. 

  1343. <p>80</p>
    1344. 

  1344. </section>
    1345. 

  1345. <section class="option" id="BigNumbersThreshold"><h3>BigNumbersThreshold <span class="purpose">Minimum number of lines per user for some &quot;Big Numbers&quot; statistics</span></h3>
    1346. 

  1346. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1347. 

  1347.  Logfile = &quot;channel.log&quot;
    1348. 

  1348.  Format = &quot;xchat&quot;
    1349. 

  1349.  BigNumbersThreshold = &quot;10&quot;
    1350. 

  1350. &lt;/channel&gt;
    1351. 

  1351. 

  1352. &lt;set BigNumbersThreshold=&quot;sqrt&quot;&gt;</pre>
    1353. 

  1353. <h4>Description</h4>
    1354. 

  1354. <p>Pisg will ignore users with less than this setting lines in the &quot;questions
    1355. 

  1355.     asked&quot;, &quot;shouts loudest&quot;, &quot;CAPSLOCK&quot;, &quot;longest line&quot;, &quot;most sad&quot;, and &quot;most
    1356. 

  1356.     happy&quot; sections. If the setting is &quot;sqrt&quot; (the default), it will be
    1357. 

  1357.     dynamically replaced with the square root of the number of lines of the
    1358. 

  1358.     most active nick. See also <a href="#ShowOnlyTop">ShowOnlyTop</a>.</p>
    1359. 

  1359. <h4>Default</h4>
    1360. 

  1360. <p>sqrt</p>
    1361. 

  1361. </section>
    1362. 

  1362. <section class="option" id="ActiveNicks"><h3>ActiveNicks <span class="purpose">nicks to show in &quot;Most Active Nicks&quot;</span></h3>
    1363. 

  1363. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1364. 

  1364.  Logfile = &quot;channel.log&quot;
    1365. 

  1365.  Format = &quot;mIRC&quot;
    1366. 

  1366.  ActiveNicks = &quot;50&quot;
    1367. 

  1367. &lt;/channel&gt;
    1368. 

  1368. 

  1369. &lt;set ActiveNicks=&quot;10&quot;&gt;</pre>
    1370. 

  1370. <h4>Description</h4>
    1371. 

  1371. <p>With this option you can define how many nicks you want to appear in the
    1372. 

  1372.     &quot;Most Active Nicks&quot; section on the stats page.</p>
    1373. 

  1373. <h4>Default</h4>
    1374. 

  1374. <p>25</p>
    1375. 

  1375. </section>
    1376. 

  1376. <section class="option" id="ActiveNicks2"><h3>ActiveNicks2 <span class="purpose">nicks to show in &quot;These didn&#x27;t make it..&quot;</span></h3>
    1377. 

  1377. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1378. 

  1378.  Logfile = &quot;channel.log&quot;
    1379. 

  1379.  Format = &quot;mIRC&quot;
    1380. 

  1380.  ActiveNicks2 = &quot;25&quot;
    1381. 

  1381. &lt;/channel&gt;
    1382. 

  1382. 

  1383. &lt;set ActiveNicks2=&quot;10&quot;&gt;</pre>
    1384. 

  1384. <h4>Description</h4>
    1385. 

  1385. <p>With this option you can define how many nicks you want to appear in the
    1386. 

  1386.     &quot;These didn&#x27;t make it&quot; section on the stats page.</p>
    1387. 

  1387. <h4>Default</h4>
    1388. 

  1388. <p>30</p>
    1389. 

  1389. </section>
    1390. 

  1390. <section class="option" id="ActiveNicksByHour"><h3>ActiveNicksByHour <span class="purpose">number of nicks to show in &quot;Most Active Nicks By Hour&quot;</span></h3>
    1391. 

  1391. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1392. 

  1392.  Logfile = &quot;channel.log&quot;
    1393. 

  1393.  Format = &quot;mIRC&quot;
    1394. 

  1394.  ActiveNicksByHour = &quot;25&quot;
    1395. 

  1395. &lt;/channel&gt;
    1396. 

  1396. 

  1397. &lt;set ActiveNicksByHour=&quot;10&quot;&gt;</pre>
    1398. 

  1398. <h4>Description</h4>
    1399. 

  1399. <p>With this option you can define how many nicks you want to appear in the
    1400. 

  1400.     &quot;Most Active Nicks By Hour&quot; section on the stats page.</p>
    1401. 

  1401. <h4>Default</h4>
    1402. 

  1402. <p>10</p>
    1403. 

  1403. </section>
    1404. 

  1404. <section class="option" id="MostNicksHistory"><h3>MostNicksHistory <span class="purpose">maximum number of nicks to show in &quot;users with most nicknames&quot;</span></h3>
    1405. 

  1405. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1406. 

  1406.  Logfile = &quot;channel.log&quot;
    1407. 

  1407.  Format = &quot;mIRC&quot;
    1408. 

  1408.  MostNicksHistory = &quot;2&quot;
    1409. 

  1409. &lt;/channel&gt;
    1410. 

  1410. 

  1411. &lt;set MostNicksHistory=&quot;10&quot;&gt;</pre>
    1412. 

  1412. <h4>Description</h4>
    1413. 

  1413. <p>With this option you can define how many nicks you want to appear in
    1414. 

  1414.     the &quot;Users with most nicknames&quot; section. See also
    1415. 

  1415.     <a href="#ShowMostNicks">ShowMostNicks</a> and <a href="#MostNicksVerbose">MostNicksVerbose</a>.</p>
    1416. 

  1416. <h4>Default</h4>
    1417. 

  1417. <p>5</p>
    1418. 

  1418. </section>
    1419. 

  1419. <section class="option" id="MostNicksVerbose"><h3>MostNicksVerbose <span class="purpose">show nicks used in &quot;most nicks&quot;</span></h3>
    1420. 

  1420. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1421. 

  1421.  Logfile = &quot;channel.log&quot;
    1422. 

  1422.  Format = &quot;mIRC&quot;
    1423. 

  1423.  MostNicksVerbose = &quot;0&quot;
    1424. 

  1424. &lt;/channel&gt;
    1425. 

  1425. 

  1426. &lt;set MostNicksVerbose=&quot;1&quot;&gt;</pre>
    1427. 

  1427. <h4>Description</h4>
    1428. 

  1428. <p>By disabling this option you can stop pisg from displaying all the nicks
    1429. 

  1429.     a user has had in the &quot;Most used nicks&quot; section.
    1430. 

  1430.     See also <a href="#ShowMostNicks">ShowMostNicks</a>,
    1431. 

  1431.     <a href="#MostNicksHistory">MostNicksHistory</a>, and <a href="#NickLimit">NickLimit</a>.</p>
    1432. 

  1432. <h4>Default</h4>
    1433. 

  1433. <p>1 (enabled)</p>
    1434. 

  1434. </section>
    1435. 

  1435. <section class="option" id="TopicHistory"><h3>TopicHistory <span class="purpose">maximum number of topics to show</span></h3>
    1436. 

  1436. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1437. 

  1437.  Logfile = &quot;channel.log&quot;
    1438. 

  1438.  Format = &quot;mIRC&quot;
    1439. 

  1439.  TopicHistory = &quot;2&quot;
    1440. 

  1440. &lt;/channel&gt;
    1441. 

  1441. 

  1442. &lt;set TopicHistory=&quot;10&quot;&gt;</pre>
    1443. 

  1443. <h4>Description</h4>
    1444. 

  1444. <p>With this option you can define how many topics you want to appear in
    1445. 

  1445.     the &quot;Latest topics&quot; section.</p>
    1446. 

  1446. <h4>Default</h4>
    1447. 

  1447. <p>3</p>
    1448. 

  1448. </section>
    1449. 

  1449. <section class="option" id="UrlHistory"><h3>UrlHistory <span class="purpose">maximum number of URLs to show</span></h3>
    1450. 

  1450. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1451. 

  1451.  Logfile = &quot;channel.log&quot;
    1452. 

  1452.  Format = &quot;mIRC&quot;
    1453. 

  1453.  UrlHistory = &quot;2&quot;
    1454. 

  1454. &lt;/channel&gt;
    1455. 

  1455. 

  1456. &lt;set UrlHistory=&quot;10&quot;&gt;</pre>
    1457. 

  1457. <h4>Description</h4>
    1458. 

  1458. <p>With this option you can define how many URLs you want to appear in
    1459. 

  1459.     the &quot;Most referenced URLs&quot; section. See also <a href="#ShowMru">ShowMru</a>.</p>
    1460. 

  1460. <h4>Default</h4>
    1461. 

  1461. <p>5</p>
    1462. 

  1462. </section>
    1463. 

  1463. <section class="option" id="ChartsHistory"><h3>ChartsHistory <span class="purpose">number of songs to show</span></h3>
    1464. 

  1464. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1465. 

  1465.  Logfile = &quot;channel.log&quot;
    1466. 

  1466.  Format = &quot;mIRC&quot;
    1467. 

  1467.  ChartsHistory = &quot;10&quot;
    1468. 

  1468. &lt;/channel&gt;
    1469. 

  1469. 

  1470. &lt;set ChartsHistory=&quot;5&quot;&gt;</pre>
    1471. 

  1471. <h4>Description</h4>
    1472. 

  1472. <p>This option sets the number of songs that will be show in the channel music
    1473. 

  1473.     charts. See also <a href="#ShowCharts">ShowCharts</a> and
    1474. 

  1474.     <a href="#ChartsRegexp">ChartsRegexp</a>.</p>
    1475. 

  1475. <h4>Default</h4>
    1476. 

  1476. <p>5 (the Top Five)</p>
    1477. 

  1477. </section>
    1478. 

  1478. <section class="option" id="ChartsRegexp"><h3>ChartsRegexp <span class="purpose">how to recognize songs played</span></h3>
    1479. 

  1479. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1480. 

  1480.  Logfile = &quot;channel.log&quot;
    1481. 

  1481.  Format = &quot;mIRC&quot;
    1482. 

  1482.  ChartsRegexp = &quot;(?:is )?(?:np:|(?:now )?playing:? |listening to:? )(?:MPEG stream from)?\s*(.*)&quot;
    1483. 

  1483. &lt;/channel&gt;</pre>
    1484. 

  1484. <h4>Description</h4>
    1485. 

  1485. <p>This option is a perl regexp that is used to recognize songs played. Please
    1486. 

  1486.     open an issue at https://github.com/PISG/pisg/issues if you have a better default. The regexp MUST
    1487. 

  1487.     contain a single () pair to extract the song name. See also the perlre(1)
    1488. 

  1488.     manpage, <a href="#ShowCharts">ShowCharts</a> and <a href="#ChartsHistory">ChartsHistory</a>.</p>
    1489. 

  1489. <h4>Default</h4>
    1490. 

  1490. <p>&quot;(?:np:|(?:now )?playing:? (?:MPEG stream from)?)\s*(.*)&quot;</p>
    1491. 

  1491. </section>
    1492. 

  1492. <section class="option" id="WordHistory"><h3>WordHistory <span class="purpose">maximum number of words to show</span></h3>
    1493. 

  1493. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1494. 

  1494.  Logfile = &quot;channel.log&quot;
    1495. 

  1495.  Format = &quot;mIRC&quot;
    1496. 

  1496.  WordHistory = &quot;5&quot;
    1497. 

  1497. &lt;/channel&gt;
    1498. 

  1498. 

  1499. &lt;set WordHistory=&quot;15&quot;&gt;</pre>
    1500. 

  1500. <h4>Description</h4>
    1501. 

  1501. <p>With this option you can define how many words you want to appear in
    1502. 

  1502.     the &quot;Most used words&quot; section. See also <a href="#ShowMuw">ShowMuw</a>.</p>
    1503. 

  1503. <h4>Default</h4>
    1504. 

  1504. <p>10</p>
    1505. 

  1505. </section>
    1506. 

  1506. <section class="option" id="NickHistory"><h3>NickHistory <span class="purpose">maximum number of nicks to show in &quot;Most referenced nicks&quot;</span></h3>
    1507. 

  1507. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1508. 

  1508.  logfile = &quot;channel.log&quot;
    1509. 

  1509.  format = &quot;mIRC&quot;
    1510. 

  1510.  NickHistory = &quot;3&quot;
    1511. 

  1511. &lt;/channel&gt;
    1512. 

  1512. 

  1513. &lt;set NickHistory=&quot;15&quot;&gt;</pre>
    1514. 

  1514. <h4>Description</h4>
    1515. 

  1515. <p>With this option you can define how many nicks you want to appear in
    1516. 

  1516.     the &quot;Most referenced nicks&quot; section. See also <a href="#ShowMrn">ShowMrn</a>.</p>
    1517. 

  1517. <h4>Default</h4>
    1518. 

  1518. <p>5</p>
    1519. 

  1519. </section>
    1520. 

  1520. <section class="option" id="SmileyHistory"><h3>SmileyHistory <span class="purpose">maximum number of smileys to show in smiley stats</span></h3>
    1521. 

  1521. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1522. 

  1522.  logfile = &quot;channel.log&quot;
    1523. 

  1523.  format = &quot;mIRC&quot;
    1524. 

  1524.  SmileyHistory = &quot;3&quot;
    1525. 

  1525. &lt;/channel&gt;
    1526. 

  1526. 

  1527. &lt;set SmileyHistory=&quot;15&quot;&gt;</pre>
    1528. 

  1528. <h4>Description</h4>
    1529. 

  1529. <p>At most this many smileys will appear in smiley stats.
    1530. 

  1530.     See also <a href="#ShowSmileys">ShowSmileys</a>.</p>
    1531. 

  1531. <h4>Default</h4>
    1532. 

  1532. <p>10</p>
    1533. 

  1533. </section>
    1534. 

  1534. <section class="option" id="KarmaHistory"><h3>KarmaHistory <span class="purpose">maximum number of nicks to show in &quot;Karma&quot;</span></h3>
    1535. 

  1535. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1536. 

  1536.  logfile = &quot;channel.log&quot;
    1537. 

  1537.  format = &quot;mIRC&quot;
    1538. 

  1538.  KarmaHistory = &quot;3&quot;
    1539. 

  1539. &lt;/channel&gt;
    1540. 

  1540. 

  1541. &lt;set KarmaHistory=&quot;15&quot;&gt;</pre>
    1542. 

  1542. <h4>Description</h4>
    1543. 

  1543. <p>At most this many nicks will appear in the good and bad karma stats.
    1544. 

  1544.     See also <a href="#ShowKarma">ShowKarma</a> and <a href="#NickLimit">NickLimit</a>.</p>
    1545. 

  1545. <h4>Default</h4>
    1546. 

  1546. <p>5</p>
    1547. 

  1547. </section>
    1548. 

  1548. <section class="option" id="NickTracking"><h3>NickTracking <span class="purpose">track nick changes and create aliases</span></h3>
    1549. 

  1549. <pre>&lt;set NickTracking=&quot;1&quot;&gt;</pre>
    1550. 

  1550. <h4>Description</h4>
    1551. 

  1551. <p>Enabling this option will track nick changes as well as it can. It will
    1552. 

  1552.     then automatically create aliases for these nicks. Useful for
    1553. 

  1553.     <a href="#ShowMostNicks">ShowMostNicks</a> and other stats.
    1554. 

  1554.     Nick tracking does not work for log formats that do not use the nickname
    1555. 

  1555.     for the person running the logger, but only show &quot;You&quot; there.
    1556. 

  1556.     See <a href="#Maintainer">Maintainer</a>.</p>
    1557. 

  1557. <h4>Default</h4>
    1558. 

  1558. <p>0 (disabled)</p>
    1559. 

  1559. </section>
    1560. 

  1560. <section class="option" id="NickLimit"><h3>NickLimit <span class="purpose">maximum number of nicks in lists</span></h3>
    1561. 

  1561. <pre>&lt;set NickLimit=&quot;0&quot;&gt;</pre>
    1562. 

  1562. <h4>Description</h4>
    1563. 

  1563. <p>This option trims lists of nicks to a maximum length, replacing the rest
    1564. 

  1564.     with &quot;...&quot;. Setting to 0 disables trimming. Affected are the used nicks in
    1565. 

  1565.     the &quot;Users with most nicknames&quot; section, nicks in &quot;Most active genders&quot;,
    1566. 

  1566.     and nicks in the &quot;Good/bad karma by&quot; columns. See
    1567. 

  1567.     <a href="#ShowMostNicks">ShowMostNicks</a>, <a href="#ShowKarma">ShowKarma</a>, and
    1568. 

  1568.     <a href="#ShowActiveGenders">ShowActiveGenders</a>.</p>
    1569. 

  1569. <h4>Default</h4>
    1570. 

  1570. <p>10</p>
    1571. 

  1571. </section>
    1572. 

  1572. <section class="option" id="SortByWords"><h3>SortByWords <span class="purpose">sort &quot;most active nicks&quot; by words</span></h3>
    1573. 

  1573. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1574. 

  1574.  logfile = &quot;channel.log&quot;
    1575. 

  1575.  format = &quot;xchat&quot;
    1576. 

  1576.  SortByWords = &quot;0&quot;
    1577. 

  1577. &lt;/channel&gt;
    1578. 

  1578. 

  1579. &lt;set SortByWords=&quot;1&quot;&gt;</pre>
    1580. 

  1580. <h4>Description</h4>
    1581. 

  1581. <p>The default for the &quot;Most Active Nicks&quot; section - is to sort users by
    1582. 

  1582.     lines. Enabling this will sort it by words instead.</p>
    1583. 

  1583. <h4>Default</h4>
    1584. 

  1584. <p>0 (disabled)</p>
    1585. 

  1585. </section>
    1586. 

  1586. </section>
    1587. 

  1587. <section class="chapter" id="reference-pictures"><h2>5. Picture options</h2>
    1588. 

  1588. <section class="option" id="PicLocation"><h3>PicLocation <span class="purpose">path to images on stats page</span></h3>
    1589. 

  1589. <pre>&lt;set PicLocation=&quot;gfx/&quot;&gt;</pre>
    1590. 

  1590. <h4>Description</h4>
    1591. 

  1591. <p>The location to the pictures used on the stats page - not the user
    1592. 

  1592.     pictures but the different bars in &quot;Most Active Times&quot;.</p>
    1593. 

  1593. <h4>Default</h4>
    1594. 

  1594. <p>Current directory</p>
    1595. 

  1595. </section>
    1596. 

  1596. <section class="option" id="UserPics"><h3>UserPics <span class="purpose">number of user pictures per row</span></h3>
    1597. 

  1597. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1598. 

  1598.  Logfile = &quot;channel.log&quot;
    1599. 

  1599.  UserPics = &quot;no&quot;
    1600. 

  1600. &lt;/channel&gt;
    1601. 

  1601. 

  1602. &lt;set UserPics=&quot;3&quot;&gt;</pre>
    1603. 

  1603. <h4>Description</h4>
    1604. 

  1604. <p><code>UserPics</code> allows you to configure the number of user
    1605. 

  1605.     pictures per row. Per default, one picture will be shown. Since pictures
    1606. 

  1606.     are usually higher than one line of text, this lets the table grow. With
    1607. 

  1607.     settings greater than 1, several pictures will be placed next to each
    1608. 

  1608.     other. A good setting would be <code>UserPics</code>=3 and pictures
    1609. 

  1609.     of size 60x60. Set <code>UserPics</code> to no or 0 to disable user
    1610. 

  1610.     pictures. The latter is useful if you share a user config file between
    1611. 

  1611.     channels and want to disable user pictures for some channels.</p>
    1612. 

  1612. <h4>Default</h4>
    1613. 

  1613. <p>yes (1)</p>
    1614. 

  1614. </section>
    1615. 

  1615. <section class="option" id="ImagePath"><h3>ImagePath <span class="purpose">path to user pictures (HTML page)</span></h3>
    1616. 

  1616. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1617. 

  1617.  Logfile = &quot;channel.log&quot;
    1618. 

  1618.  Format = &quot;mIRC&quot;
    1619. 

  1619.  ImagePath = &quot;userpics/&quot;
    1620. 

  1620. &lt;/channel&gt;
    1621. 

  1621. 

  1622. &lt;set ImagePath=&quot;users/&quot;&gt;</pre>
    1623. 

  1623. <h4>Description</h4>
    1624. 

  1624. <p><code>ImagePath</code> defines the path to where user
    1625. 

  1625.     pictures are located, relative to the HTML page generated. The default is
    1626. 

  1626.     that user pictures is located in the same directory as the HTML page.</p>
    1627. 

  1627. <h4>Default</h4>
    1628. 

  1628. <p>current directory</p>
    1629. 

  1629. </section>
    1630. 

  1630. <section class="option" id="DefaultPic"><h3>DefaultPic <span class="purpose">use a default user picture</span></h3>
    1631. 

  1631. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1632. 

  1632.  Logfile = &quot;channel.log&quot;
    1633. 

  1633.  Format = &quot;mIRC&quot;
    1634. 

  1634.  DefaultPic = &quot;not_available.jpg&quot;
    1635. 

  1635. &lt;/channel&gt;
    1636. 

  1636. 

  1637. &lt;set DefaultPic=&quot;unknown.gif&quot;&gt;</pre>
    1638. 

  1638. <h4>Description</h4>
    1639. 

  1639. <p><code>DefaultPic</code> defines a picture to be displayed for all
    1640. 

  1640.     users which have no other picture defined in the <code>user</code>
    1641. 

  1641.     element. This is good for showing &quot;No picture available&quot; or something.
    1642. 

  1642.     May contain globbing patterns, see <a href="#ImageGlobPath">ImageGlobPath</a> below.</p>
    1643. 

  1643. <h4>Default</h4>
    1644. 

  1644. <p>unset</p>
    1645. 

  1645. </section>
    1646. 

  1646. <section class="option" id="ImageGlobPath"><h3>ImageGlobPath <span class="purpose">path to user pictures (output generation)</span></h3>
    1647. 

  1647. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1648. 

  1648.  Logfile = &quot;channel.log&quot;
    1649. 

  1649.  Format = &quot;mIRC&quot;
    1650. 

  1650.  ImageGlobPath = &quot;users/&quot;
    1651. 

  1651. &lt;/channel&gt;
    1652. 

  1652. 

  1653. &lt;set ImageGlobPath=&quot;/var/www/pisg/&quot;&gt;
    1654. 

  1654. &lt;set DefaultPic=&quot;default-??.gif&quot;&gt;</pre>
    1655. 

  1655. <h4>Description</h4>
    1656. 

  1656. <p><code>ImageGlobPath</code> defines the path to the directory where
    1657. 

  1657.     user pictures are located, relative to the current directory. This setting
    1658. 

  1658.     is used to choose random pictures if ? or * (globbing characters) are used
    1659. 

  1659.     in the picture name. ? matches a single character, * matches a (possibly
    1660. 

  1660.     empty) string. The default is the <a href="#ImagePath">ImagePath</a> setting.
    1661. 

  1661.     (NB: This setting will be different from <a href="#ImagePath">ImagePath</a> if
    1662. 

  1662.     the latter is not relative to the current directory, e.g. if you are
    1663. 

  1663.     writing the HTML file outside of the current directory.)</p>
    1664. 

  1664. <h4>Default</h4>
    1665. 

  1665. <p>current <a href="#ImagePath">ImagePath</a> setting</p>
    1666. 

  1666. </section>
    1667. 

  1667. <section class="option" id="PicWidth"><h3>PicWidth <span class="purpose">define a standard width for user pictures</span></h3>
    1668. 

  1668. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1669. 

  1669.  Logfile = &quot;channel.log&quot;
    1670. 

  1670.  Format = &quot;mIRC&quot;
    1671. 

  1671.  PicWidth = &quot;500&quot;
    1672. 

  1672. &lt;/channel&gt;
    1673. 

  1673. 

  1674. &lt;set PicWidth=&quot;500&quot;&gt;</pre>
    1675. 

  1675. <h4>Description</h4>
    1676. 

  1676. <p><code>PicWidth</code> defines the standard width for user
    1677. 

  1677.     pictures. Setting the &#x27;width&#x27; attribute of image-elements on the
    1678. 

  1678.     outputted stats page. See also <a href="#PicHeight">PicHeight</a>.</p>
    1679. 

  1679. <h4>Default</h4>
    1680. 

  1680. <p>unset</p>
    1681. 

  1681. </section>
    1682. 

  1682. <section class="option" id="PicHeight"><h3>PicHeight <span class="purpose">define a standard height for user pictures</span></h3>
    1683. 

  1683. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1684. 

  1684.  Logfile = &quot;channel.log&quot;
    1685. 

  1685.  Format = &quot;mIRC&quot;
    1686. 

  1686.  PicHeight = &quot;500&quot;
    1687. 

  1687. &lt;/channel&gt;
    1688. 

  1688. 

  1689. &lt;set PicHeight=&quot;500&quot;&gt;</pre>
    1690. 

  1690. <h4>Description</h4>
    1691. 

  1691. <p><code>PicHeight</code> defines the standard height for user
    1692. 

  1692.     pictures. Setting the &#x27;height&#x27; attribute of image-elements on the
    1693. 

  1693.     outputted stats page. See also <a href="#PicWidth">PicWidth</a>.</p>
    1694. 

  1694. <h4>Default</h4>
    1695. 

  1695. <p>unset</p>
    1696. 

  1696. </section>
    1697. 

  1697. </section>
    1698. 

  1698. <section class="chapter" id="reference-misc"><h2>6. Misc options</h2>
    1699. 

  1699. <section class="option" id="Charset"><h3>Charset <span class="purpose">character set to use for stats page</span></h3>
    1700. 

  1700. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1701. 

  1701.  Logfile = &quot;channel.log&quot;
    1702. 

  1702.  Format = &quot;xchat&quot;
    1703. 

  1703.  Charset = &quot;utf-8&quot;
    1704. 

  1704. &lt;/channel&gt;
    1705. 

  1705. 

  1706. &lt;set Charset=&quot;iso-8859-15&quot;&gt;</pre>
    1707. 

  1707. <h4>Description</h4>
    1708. 

  1708. <p>The pisg stats page defines a character set in a meta tag, this can be
    1709. 

  1709.     used if your country is using a different one than the default. Pisg
    1710. 

  1710.     will also use this setting to convert the language templates from
    1711. 

  1711.     <a href="#LangFile">LangFile</a> if the language defines a source charset.
    1712. 

  1712.     Note: you also have to tell your webserver to transmit the charset to
    1713. 

  1713.     the browser. With Apache, use &quot;AddDefaultCharset off&quot; in the server
    1714. 

  1714.     config.</p>
    1715. 

  1715. <h4>Default</h4>
    1716. 

  1716. <p>iso-8859-1</p>
    1717. 

  1717. </section>
    1718. 

  1718. <section class="option" id="LogCharset"><h3>LogCharset <span class="purpose">character set for logfiles</span></h3>
    1719. 

  1719. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1720. 

  1720.  Logfile = &quot;channel.log&quot;
    1721. 

  1721.  Format = &quot;xchat&quot;
    1722. 

  1722.  Charset = &quot;iso-8859-1&quot;
    1723. 

  1723.  LogCharset = &quot;utf-8&quot;
    1724. 

  1724. &lt;/channel&gt;
    1725. 

  1725. 

  1726. &lt;set Charset=&quot;iso-8859-15&quot;&gt;
    1727. 

  1727. &lt;set LogCharset=&quot;iso-8859-15&quot;&gt;</pre>
    1728. 

  1728. <h4>Description</h4>
    1729. 

  1729. <p>If <code>LogCharset</code> is set and different from
    1730. 

  1730.     <a href="#Charset">Charset</a>, pisg will convert the charset using
    1731. 

  1731.     Text::Iconv. Using this option slows down log processing.</p>
    1732. 

  1732. <h4>Default</h4>
    1733. 

  1733. <p>empty (no conversion)</p>
    1734. 

  1734. </section>
    1735. 

  1735. <section class="option" id="LogCharsetFallback"><h3>LogCharsetFallback <span class="purpose">fallback character set for logfiles</span></h3>
    1736. 

  1736. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1737. 

  1737.  Logfile = &quot;channel.log&quot;
    1738. 

  1738.  Format = &quot;xchat&quot;
    1739. 

  1739.  Charset = &quot;utf-8&quot;
    1740. 

  1740.  LogCharset = &quot;utf-8&quot;
    1741. 

  1741.  LogCharsetFallback = &quot;iso-8859-1&quot;
    1742. 

  1742. &lt;/channel&gt;
    1743. 

  1743. 

  1744. &lt;set Charset=&quot;utf-8&quot;&gt;
    1745. 

  1745. &lt;set LogCharset=&quot;utf-8&quot;&gt;
    1746. 

  1746. &lt;set LogCharsetFallback=&quot;iso-8859-15&quot;&gt;</pre>
    1747. 

  1747. <h4>Description</h4>
    1748. 

  1748. <p><code>LogCharsetFallback</code> defines a fallback charset for
    1749. 

  1749.     the <a href="#LogCharset">LogCharset</a> conversion. This is useful if you
    1750. 

  1750.     have mixed unicode/iso-8859-* logs. Pisg will first try the conversion
    1751. 

  1751.     from <a href="#LogCharset">LogCharset</a>. If that fails,
    1752. 

  1752.     <code>LogCharsetFallback</code> is used. Note that this only works
    1753. 

  1753.     for charsets where certain byte sequences are illegal, like UTF-8. (In
    1754. 

  1754.     short: <code>LogCharset</code> = utf-8,
    1755. 

  1755.     <code>LogCharsetFallback</code> = iso-8859-15 works, the other way
    1756. 

  1756.     round does not.)</p>
    1757. 

  1757. <h4>Default</h4>
    1758. 

  1758. <p>empty (no fallback conversion)</p>
    1759. 

  1759. </section>
    1760. 

  1760. <section class="option" id="TimeOffset"><h3>TimeOffset <span class="purpose">use a different time zone than the local machine</span></h3>
    1761. 

  1761. <pre>&lt;channel=&quot;#channel&quot;&gt;
    1762. 

  1762.  Logfile = &quot;channel.log&quot;
    1763. 

  1763.  Format = &quot;mIRC&quot;
    1764. 

  1764.  Maintainer = &quot;John&quot;
    1765. 

  1765.  TimeOffset = &quot;+5&quot;
    1766. 

  1766. &lt;/channel&gt;
    1767. 

  1767. 

  1768. &lt;set TimeOffset=&quot;+2&quot;&gt;</pre>
    1769. 

  1769. <h4>Description</h4>
    1770. 

  1770. <p>By default, pisg uses the time of the local machine to display the time
    1771. 

  1771.     of the generated stats. Sometimes when you have a shell on an external
    1772. 

  1772.     box, and it&#x27;s in another country, you want to use another time. This is
    1773. 

  1773.     accomplished by the <code>TimeOffset</code> command.</p>
    1774. 

  1774. <h4>Default</h4>
    1775. 

  1775. <p>+0</p>
    1776. 

  1776. </section>
    1777. 

  1777. <section class="option" id="RegexpAliases"><h3>RegexpAliases <span class="purpose">use regular expressions in user aliases</span></h3>
    1778. 

  1778. <pre>&lt;user nick=&quot;Joe&quot; alias=&quot;Joe\d+&quot;&gt;
    1779. 

  1779. 

  1780. &lt;set RegexpAliases=&quot;1&quot;&gt;</pre>
    1781. 

  1781. <h4>Description</h4>
    1782. 

  1782. <p>Enabling this option will make all aliases in &lt;user&gt; lines be
    1783. 

  1783.     parsed as regular expressions; this setting also applies to the
    1784. 

  1784.     <a href="#IgnoreWords">IgnoreWords</a>, <a href="#FoulWords">FoulWords</a>, and
    1785. 

  1785.     <a href="#ViolentWords">ViolentWords</a> settings.</p>
    1786. 

  1786. <h4>Default</h4>
    1787. 

  1787. <p>0 (disabled)</p>
    1788. 

  1788. </section>
    1789. 

  1789. <section class="option" id="LangFile"><h3>LangFile <span class="purpose">filename of language file</span></h3>
    1790. 

  1790. <pre>&lt;set LangFile=&quot;mylang.txt&quot;&gt;</pre>
    1791. 

  1791. <h4>Description</h4>
    1792. 

  1792. <p>With this option you have an alternative way to define the name and/or
    1793. 

  1793.     path to the language file. Usually you don&#x27;t have to touch this option.</p>
    1794. 

  1794. <h4>Default</h4>
    1795. 

  1795. <p>lang.txt</p>
    1796. 

  1796. </section>
    1797. 

  1797. <section class="option" id="CssDir"><h3>CssDir <span class="purpose">path to directory with CSS files</span></h3>
    1798. 

  1798. <pre>&lt;set CssDir=&quot;/usr/share/pisg/layout/&quot;&gt;</pre>
    1799. 

  1799. <h4>Description</h4>
    1800. 

  1800. <p><code>CssDir</code> is used to define the paths to the CSS files
    1801. 

  1801.     (the <a href="#ColorScheme">ColorScheme</a>s). Usually you don&#x27;t
    1802. 

  1802.     need to change this. This setting is only used when statically including
    1803. 

  1803.     the CSS file.</p>
    1804. 

  1804. <h4>Default</h4>
    1805. 

  1805. <p>layout/ (in current directory)</p>
    1806. 

  1806. </section>
    1807. 

  1807. <section class="option" id="HiCell"><h3>HiCell, HiCell2 <span class="purpose">colors for color gradient in most active nicks section</span></h3>
    1808. 

  1808. <pre>&lt;set HiCell=&quot;#BABADD&quot; HiCell2=&quot;#CCCCCC&quot;&gt;
    1809. 

  1809. &lt;set HiCell=&quot;&quot;&gt;</pre>
    1810. 

  1810. <h4>Description</h4>
    1811. 

  1811. <p><code>HiCell</code> and <code>HiCell2</code> define the colors
    1812. 

  1812.     to be used for the color gradient in the most active nicks section. They should
    1813. 

  1813.     match your <a href="#ColorScheme">ColorScheme</a>. When setting
    1814. 

  1814.     <code>HiCell</code> the empty string (&quot;&quot;), pisg will not generate a color
    1815. 

  1815.     gradient; you might want to use this with <a href="#ColorScheme">ColorScheme</a>=&quot;none&quot;
    1816. 

  1816.     or <a href="#AltColorScheme">AltColorScheme</a>.</p>
    1817. 

  1817. <h4>Default</h4>
    1818. 

  1818. <p>#BABADD, #CCCCCC</p>
    1819. 

  1819. </section>
    1820. 

  1820. <section class="option" id="LogType"><h3>LogType <span class="purpose">type of log (not the format of the log)</span></h3>
    1821. 

  1821. <pre>&lt;set LogType=&quot;Logfile&quot;&gt;</pre>
    1822. 

  1822. <h4>Description</h4>
    1823. 

  1823. <p>The type of logs kept for your channel. Currently only &quot;Logfile&quot; is
    1824. 

  1824.     supported, so you don&#x27;t need to change this option.</p>
    1825. 

  1825. <h4>Default</h4>
    1826. 

  1826. <p>Logfile</p>
    1827. 

  1827. </section>
    1828. 

  1828. <section class="option" id="StatsDump"><h3>StatsDump <span class="purpose">dump raw statistics into file</span></h3>
    1829. 

  1829. <pre>&lt;set StatsDump=&quot;statsdump&quot;&gt;</pre>
    1830. 

  1830. <h4>Description</h4>
    1831. 

  1831. <p>This option is intended for debugging pisg, but might be useful to process
    1832. 

  1832.     the parsed logs with another program. The file contains the %stats and
    1833. 

  1833.     %lines hashes in perl&#x27;s Data::Dumper format.</p>
    1834. 

  1834. <h4>Default</h4>
    1835. 

  1835. <p>Unset</p>
    1836. 

  1836. </section>
    1837. 

  1837. </section>
    1838. 

  1838. <section class="chapter" id="copyright"><h2>7. Copyright and License</h2>
    1839. 

  1839. <p>pisg - Perl IRC Statistics Generator</p>
    1840. 

  1840. <p>Copyright (C) 2001-2012  The pisg project</p>
    1841. 

  1841. <p>This program is free software; you can redistribute it and/or modify
    1842. 

  1842.     it under the terms of the GNU General Public License as published by
    1843. 

  1843.     the Free Software Foundation; either version 2 of the License, or
    1844. 

  1844.     (at your option) any later version.</p>
    1845. 

  1845. <p>This program is distributed in the hope that it will be useful,
    1846. 

  1846.     but WITHOUT ANY WARRANTY; without even the implied warranty of
    1847. 

  1847.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    1848. 

  1848.     GNU General Public License for more details.</p>
    1849. 

  1849. <p>You should have received a copy of the GNU General Public License
    1850. 

  1850.     along with this program; if not, write to the Free Software
    1851. 

  1851.     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA</p>
    1852. 

  1852. </section>
    1853. 

  1853. <section class="chapter" id="example-config">
    1854. 

  1854. <h2>8. Complete example configuration</h2>
    1855. 

  1855. <p>A ready-to-use <code>pisg.cfg</code> for a channel called <code>#example</code>. It lists every
    1856. 

  1856. option pisg understands, with what it does, so you can copy it and change only the lines marked
    1857. 

  1857. <code>EDIT</code>: the log file, its format, the network name, the output file and your name.
    1858. 

  1858. Options are at pisg's own defaults unless the comment says <em>recommended</em>.</p>
    1859. 

  1859. <ol>
    1860. 

  1860. <li>Copy the file below (or download it) and save it as <code>pisg.cfg</code> next to <code>pisg</code>.</li>
    1861. 

  1861. <li>Change the <code>EDIT</code> values in the <code>&lt;channel&gt;</code> block.</li>
    1862. 

  1862. <li>Run <code>./pisg</code>.</li>
    1863. 

  1863. </ol>
    1864. 

  1864. <div class="codewrap">
    1865. 

  1865. <div class="codebar"><span>pisg.cfg</span>
    1866. 

  1866. <a class="btn" href="data:text/plain;charset=utf-8,%23%20pisg.cfg.example%20-%20a%20complete%20configuration%20for%20pisg%2C%20ready%20to%20copy.%0A%23%0A%23%20%20%201.%20Copy%20this%20file%20to%20pisg.cfg%0A%23%20%20%202.%20Change%20the%20values%20marked%20%20EDIT%20%20%28log%20path%2C%20format%2C%20network%2C%20output%20file%2C%20name%29%0A%23%20%20%203.%20Run%20./pisg%0A%23%0A%23%20Every%20option%20pisg%20understands%20is%20listed%20below%20with%20its%20meaning.%20Options%20are%20set%20to%0A%23%20pisg%27s%20own%20default%20unless%20the%20comment%20says%20%22recommended%22.%20Lines%20starting%20with%20%23%20are%0A%23%20comments%3B%20an%20option%20shown%20commented%20out%20is%20off/unset%20-%20remove%20the%20%23%20to%20use%20it.%0A%23%0A%23%20Syntax%20reminders%3A%0A%23%20%20%20%3Cset%20Name%3D%22value%22%3E%20%20%20%20%20%20a%20global%20option%2C%20applies%20to%20every%20channel%0A%23%20%20%20%3Cchannel%3D%22%23name%22%3E%20...%20%3C/channel%3E%20%20%20settings%20for%20one%20channel%20%28they%20override%20%3Cset%3E%29%0A%23%20%20%20%3Cuser%20nick%3D%22...%22%20...%3E%20%20%20per-user%20settings%0A%23%20Each%20%3Cset%3E%20must%20be%20on%20one%20line%2C%20and%20every%20value%20must%20be%20in%20quotes.%0A%0A%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20%20GLOBAL%20OPTIONS%20-%20apply%20to%20every%20channel%20below%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%0A%23%20----%20General%20options%20-------------------------------------------------------%0A%0A%23%20use%20a%20different%20color%20scheme%20for%20stats%20page%20-%20recommended%3A%20modern%2C%20light/dark%20theme%3B%0A%23%20try%20midnight%2C%20amoled%2C%20terminal%2C%20or%20default%0A%3Cset%20ColorScheme%3D%22modern%22%3E%0A%0A%23%20alternate%20stylesheets%20for%20stats%20page%20-%20extra%20stylesheets%20the%20visitor%20can%20switch%20to%0A%23%3Cset%20AltColorScheme%3D%22midnight.css%20amoled.css%22%3E%0A%0A%23%20define%20the%20language%20/%20translation%20to%20use%0A%3Cset%20Lang%3D%22EN%22%3E%0A%0A%23%20define%20a%20file%20as%20page%20header%20-%20HTML%20file%20inserted%20above%20the%20statistics%0A%23%3Cset%20PageHead%3D%22header.html%22%3E%0A%0A%23%20define%20a%20file%20as%20page%20footer%20-%20HTML%20file%20inserted%20below%20the%20statistics%0A%23%3Cset%20PageFoot%3D%22footer.html%22%3E%0A%0A%23%20make%20pisg%20silent%2C%20suppress%20messages%0A%3Cset%20Silent%3D%220%22%3E%0A%0A%23%20use%20a%20cache%20to%20speed%20up%20log%20parsing%20-%20cache%20parsed%20logs%20here%20to%20speed%20up%20runs%20%28delete%0A%23%20it%20when%20you%20change%20settings%29%0A%23%3Cset%20CacheDir%3D%22cache/%22%3E%0A%0A%23%20name%20of%20the%20channel%20list%20file%20for%20a%20landing%20page%0A%3Cset%20ChannelIndex%3D%22channels.json%22%3E%0A%0A%23%20adds%20a%20button%20at%20the%20top%20of%20every%20stats%20page%20that%20leads%20back%20to%20your%20landing%20page%0A%3Cset%20HomeLink%3D%22%22%3E%0A%0A%23%20enable/disable%20the%20section%20bar%20at%20the%20top%20of%20the%20page%0A%3Cset%20ShowNavBar%3D%221%22%3E%0A%0A%23%20----%20Options%20for%20various%20statistics%20features%20-------------------------------%0A%0A%23%20number%20of%20days%20to%20show%20in%20%22Daily%20Actitity%22%20-%20recommended%3A%20show%20the%20last%2014%20days%20as%20a%0A%23%20bar%20chart%0A%3Cset%20DailyActivity%3D%2214%22%3E%0A%0A%23%20enable/disable%20%22Most%20Active%20Times%22%0A%3Cset%20ShowActiveTimes%3D%221%22%3E%0A%0A%23%20enable/disable%20%22Most%20Active%20Nicks%22%0A%3Cset%20ShowActiveNicks%3D%221%22%3E%0A%0A%23%20enable/disable%20%22Big%20Numbers%22%20sections%0A%3Cset%20ShowBigNumbers%3D%221%22%3E%0A%0A%23%20enable/disable%20%22Latest%20topics%22%20sections%0A%3Cset%20ShowTopics%3D%221%22%3E%0A%0A%23%20enable/disable%20%22number%20of%20lines%22%0A%3Cset%20ShowLines%3D%221%22%3E%0A%0A%23%20enable/disable%20%22words%20per%20line%22%20-%20recommended%3A%20also%20show%20words%20per%20line%0A%3Cset%20ShowWpl%3D%221%22%3E%0A%0A%23%20enable/disable%20%22characters%20per%20line%22%20-%20recommended%3A%20also%20show%20characters%20per%20line%0A%3Cset%20ShowCpl%3D%221%22%3E%0A%0A%23%20enable/disable%20%22number%20of%20words%22%20-%20recommended%3A%20also%20show%20total%20words%0A%3Cset%20ShowWords%3D%221%22%3E%0A%0A%23%20show%20when%20a%20user%20was%20last%20seen%20on%20a%20channel%0A%3Cset%20ShowLastSeen%3D%221%22%3E%0A%0A%23%20show%20when%20a%20nick%20was%20active%0A%3Cset%20ShowTime%3D%221%22%3E%0A%0A%23%20mIRCStats%20like%20behaviour%20of%20time%20bar%0A%3Cset%20ShowLineTime%3D%220%22%3E%0A%0A%23%20ShowLineTime%20like%20behavior%20of%20words%20column%0A%3Cset%20ShowWordTime%3D%220%22%3E%0A%0A%23%20enable%20or%20disable%20the%20random%20quotes%0A%3Cset%20ShowRandQuote%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20the%20legend%20of%20the%20time%20bars%0A%3Cset%20ShowLegend%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20the%20kick%20line%0A%3Cset%20ShowKickLine%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20the%20action%20line%0A%3Cset%20ShowActionLine%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20the%20shout%20line%0A%3Cset%20ShowShoutLine%3D%221%22%3E%0A%0A%23%20set%20how%20many%20decimals%20to%20show%0A%3Cset%20ShowFoulDecimals%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20the%20foul%20line%0A%3Cset%20ShowFoulLine%3D%220%22%3E%0A%0A%23%20enable%20or%20disable%20the%20violent%20lines%0A%3Cset%20ShowViolentLines%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20%22Most%20used%20words%22%0A%3Cset%20ShowMuw%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20%22Most%20referenced%20nicks%22%0A%3Cset%20ShowMrn%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20%22Most%20referenced%20URLs%22%0A%3Cset%20ShowMru%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20channel%20music%20charts%0A%3Cset%20ShowCharts%3D%220%22%3E%0A%0A%23%20enable%20or%20disable%20op%20statistics%0A%3Cset%20ShowOps%3D%221%22%3E%0A%0A%23%20enable%20or%20disable%20voice%20statistics%0A%3Cset%20ShowVoices%3D%220%22%3E%0A%0A%23%20enable%20or%20disable%20halfop%20statistics%0A%3Cset%20ShowHalfops%3D%220%22%3E%0A%0A%23%20show%20who%20changed%20nick%20most%20often%20-%20recommended%3A%20show%20who%20changed%20nick%20most%20often%0A%3Cset%20ShowMostNicks%3D%221%22%3E%0A%0A%23%20show%20stats%20on%20which%20gender%20talked%20most%0A%3Cset%20ShowActiveGenders%3D%220%22%3E%0A%0A%23%20show%20most%20used%20smileys%20-%20recommended%3A%20show%20the%20most%20used%20smileys%0A%3Cset%20ShowSmileys%3D%221%22%3E%0A%0A%23%20show%20channel%20karma%20-%20recommended%3A%20show%20karma%20%28nick%2B%2B%20/%20nick--%29%0A%3Cset%20ShowKarma%3D%221%22%3E%0A%0A%23%20show%20most%20active%20nicks%20by%20hour%20-%20recommended%3A%20show%20the%20most%20active%20nicks%20by%20time%20of%0A%23%20day%0A%3Cset%20ShowMostActiveByHour%3D%221%22%3E%0A%0A%23%20only%20count%20stats%20for%20top%20talkers%2C%20ignore%20less-active%20users%0A%3Cset%20ShowOnlyTop%3D%220%22%3E%0A%0A%23%20show%20graphs%20in%20most%20active%20nicks%20by%20hour%0A%3Cset%20ShowMostActiveByHourGraph%3D%221%22%3E%0A%0A%23%20enable/disable%20the%20channel%20overview%0A%3Cset%20ShowOverview%3D%221%22%3E%0A%0A%23%20enable/disable%20the%20relation%20map%20and%20its%20tables%0A%3Cset%20ShowRelations%3D%221%22%3E%0A%0A%23%20number%20of%20nicks%20on%20the%20relation%20map%0A%3Cset%20RelationNicks%3D%2230%22%3E%0A%0A%23%20minimum%20connection%20strength%20shown%20as%20a%20line%20on%20the%20relation%20map%0A%3Cset%20RelationMinWeight%3D%223%22%3E%0A%0A%23%20enable/disable%20the%20time%20personalities%20section%0A%3Cset%20ShowTimePersonalities%3D%221%22%3E%0A%0A%23%20enable/disable%20the%20%22who%20carries%20the%20channel%22%20section%0A%3Cset%20ShowConcentration%3D%221%22%3E%0A%0A%23%20enable/disable%20the%20signature%20words%20section%0A%3Cset%20ShowSignatureWords%3D%221%22%3E%0A%0A%23%20ignore%20specified%20words%20-%20words%20to%20leave%20out%20of%20the%20word%20statistics%0A%23%3Cset%20IgnoreWords%3D%22badword%20otherword%22%3E%0A%0A%23%20Control%20random%20quote%20output%0A%3Cset%20NoIgnoredQuotes%3D%220%22%3E%0A%0A%23%20specify%20words%20considered%20to%20be%20bad/FoulWords%20language%0A%3Cset%20FoulWords%3D%22ass%20fuck%20bitch%20shit%20scheisse%20schei%C3%9Fe%20kacke%20arsch%20ficker%20ficken%20schlampe%22%3E%0A%0A%23%20specify%20words%20considered%20to%20be%20aggressive/violent%0A%3Cset%20ViolentWords%3D%22slaps%20beats%20smacks%22%3E%0A%0A%23%20words%20that%20keep%20a%20URL%20out%20of%20the%20URL%20statistics%20-%20matched%20anywhere%20in%20a%20URL%2C%20any%20case%3B%0A%23%20%2A%20%3D%20any%20characters%2C%20%3F%20%3D%20one%3B%20for%20spam%20and%20unwanted%20image%20hosts%0A%23%3Cset%20BadUrls%3D%22imagetwist%20imgur.com%20postimg.cc/%2A%22%3E%0A%0A%23%20minimum%20numbers%20of%20letters%20for%20a%20random%20quote%0A%3Cset%20MinQuote%3D%2225%22%3E%0A%0A%23%20maximum%20numbers%20of%20letters%20for%20a%20random%20quote%0A%3Cset%20MaxQuote%3D%2265%22%3E%0A%0A%23%20minimum%20number%20of%20characters%20in%20an%20interesting%20word%0A%3Cset%20WordLength%3D%225%22%3E%0A%0A%23%20maximum%20allowed%20length%20of%20a%20%22word%22%20with%20no%20spaces%0A%3Cset%20QuoteWidth%3D%2280%22%3E%0A%0A%23%20Minimum%20number%20of%20lines%20per%20user%20for%20some%20%22Big%20Numbers%22%20statistics%0A%3Cset%20BigNumbersThreshold%3D%22sqrt%22%3E%0A%0A%23%20nicks%20to%20show%20in%20%22Most%20Active%20Nicks%22%0A%3Cset%20ActiveNicks%3D%2225%22%3E%0A%0A%23%20nicks%20to%20show%20in%20%22These%20didn%27t%20make%20it..%22%0A%3Cset%20ActiveNicks2%3D%2230%22%3E%0A%0A%23%20number%20of%20nicks%20to%20show%20in%20%22Most%20Active%20Nicks%20By%20Hour%22%0A%3Cset%20ActiveNicksByHour%3D%2210%22%3E%0A%0A%23%20maximum%20number%20of%20nicks%20to%20show%20in%20%22users%20with%20most%20nicknames%22%0A%3Cset%20MostNicksHistory%3D%225%22%3E%0A%0A%23%20show%20nicks%20used%20in%20%22most%20nicks%22%0A%3Cset%20MostNicksVerbose%3D%221%22%3E%0A%0A%23%20maximum%20number%20of%20topics%20to%20show%20-%20recommended%3A%20show%20the%20last%205%20topics%0A%3Cset%20TopicHistory%3D%225%22%3E%0A%0A%23%20maximum%20number%20of%20URLs%20to%20show%0A%3Cset%20UrlHistory%3D%225%22%3E%0A%0A%23%20number%20of%20songs%20to%20show%0A%3Cset%20ChartsHistory%3D%225%22%3E%0A%0A%23%20how%20to%20recognize%20songs%20played%0A%3Cset%20ChartsRegexp%3D%22%28%3F%3Ais%20%29%3F%28%3F%3Anp%3A%7C%28%3F%3Anow%20%29%3Fplaying%3A%3F%20%7Clistening%20to%3A%3F%20%29%28%3F%3AMPEG%20stream%20from%29%3F%5Cs%2A%28.%2A%29%22%3E%0A%0A%23%20maximum%20number%20of%20words%20to%20show%0A%3Cset%20WordHistory%3D%2210%22%3E%0A%0A%23%20maximum%20number%20of%20nicks%20to%20show%20in%20%22Most%20referenced%20nicks%22%0A%3Cset%20NickHistory%3D%225%22%3E%0A%0A%23%20maximum%20number%20of%20smileys%20to%20show%20in%20smiley%20stats%0A%3Cset%20SmileyHistory%3D%2210%22%3E%0A%0A%23%20maximum%20number%20of%20nicks%20to%20show%20in%20%22Karma%22%0A%3Cset%20KarmaHistory%3D%225%22%3E%0A%0A%23%20track%20nick%20changes%20and%20create%20aliases%20-%20recommended%3A%20follow%20nick%20changes%20so%20Alice%2C%0A%23%20Alice_%20and%20Alice-%20count%20as%20one%20person%0A%3Cset%20NickTracking%3D%221%22%3E%0A%0A%23%20maximum%20number%20of%20nicks%20in%20lists%0A%3Cset%20NickLimit%3D%2210%22%3E%0A%0A%23%20sort%20%22most%20active%20nicks%22%20by%20words%0A%3Cset%20SortByWords%3D%220%22%3E%0A%0A%23%20----%20Picture%20options%20-------------------------------------------------------%0A%0A%23%20path%20to%20images%20on%20stats%20page%0A%3Cset%20PicLocation%3D%22.%22%3E%0A%0A%23%20number%20of%20user%20pictures%20per%20row%0A%3Cset%20UserPics%3D%221%22%3E%0A%0A%23%20path%20to%20user%20pictures%20%28HTML%20page%29%20-%20folder%20of%20user%20pictures%2C%20as%20seen%20by%20the%20web%20page%0A%23%3Cset%20ImagePath%3D%22images/%22%3E%0A%0A%23%20use%20a%20default%20user%20picture%20-%20picture%20shown%20for%20users%20who%20have%20none%0A%23%3Cset%20DefaultPic%3D%22images/nobody.png%22%3E%0A%0A%23%20path%20to%20user%20pictures%20%28output%20generation%29%20-%20folder%20of%20user%20pictures%2C%20as%20seen%20by%20pisg%0A%23%20%28for%20pic%3D%22x_%2A.jpg%22%20globs%29%0A%23%3Cset%20ImageGlobPath%3D%22/var/www/pisg/images/%22%3E%0A%0A%23%20define%20a%20standard%20width%20for%20user%20pictures%20-%20show%20every%20user%20picture%20this%20wide%2C%20in%0A%23%20pixels%0A%23%3Cset%20PicWidth%3D%2255%22%3E%0A%0A%23%20define%20a%20standard%20height%20for%20user%20pictures%20-%20show%20every%20user%20picture%20this%20tall%2C%20in%0A%23%20pixels%0A%23%3Cset%20PicHeight%3D%2255%22%3E%0A%0A%23%20----%20Misc%20options%20----------------------------------------------------------%0A%0A%23%20character%20set%20to%20use%20for%20stats%20page%20-%20recommended%3A%20UTF-8%20shows%20accents%2C%20emoji%20and%20non-%0A%23%20Latin%20scripts%20correctly%0A%3Cset%20Charset%3D%22utf-8%22%3E%0A%0A%23%20character%20set%20for%20logfiles%20-%20convert%20logs%20from%20this%20charset%20%28needs%20the%20Text%3A%3AIconv%0A%23%20perl%20module%29%0A%23%3Cset%20LogCharset%3D%22iso-8859-1%22%3E%0A%0A%23%20fallback%20character%20set%20for%20logfiles%20-%20used%20for%20lines%20that%20are%20not%20valid%20in%20LogCharset%0A%23%20%28needs%20Text%3A%3AIconv%29%0A%23%3Cset%20LogCharsetFallback%3D%22iso-8859-1%22%3E%0A%0A%23%20use%20a%20different%20time%20zone%20than%20the%20local%20machine%0A%3Cset%20TimeOffset%3D%22%2B0%22%3E%0A%0A%23%20use%20regular%20expressions%20in%20user%20aliases%0A%3Cset%20RegexpAliases%3D%220%22%3E%0A%0A%23%20filename%20of%20language%20file%0A%3Cset%20LangFile%3D%22lang.txt%22%3E%0A%0A%23%20path%20to%20directory%20with%20CSS%20files%0A%3Cset%20CssDir%3D%22layout/%22%3E%0A%0A%23%20colors%20for%20color%20gradient%20in%20most%20active%20nicks%20section%0A%3Cset%20HiCell%3D%22%23BABADD%22%3E%0A%3Cset%20HiCell2%3D%22%23CCCCCC%22%3E%0A%0A%23%20colors%20for%20color%20gradient%20in%20most%20active%20nicks%20section%0A%3Cset%20HiCell2%3D%22%23CCCCCC%22%3E%0A%0A%23%20dump%20raw%20statistics%20into%20file%20-%20debugging%3A%20dump%20the%20raw%20statistics%20to%20this%20file%0A%23%3Cset%20StatsDump%3D%22stats.dump%22%3E%0A%0A%23%20----%20Advanced%20%28not%20in%20the%20original%20documentation%29%20-------------------------%0A%0A%23%20nicks%20of%20bots%2C%20for%20log%20formats%20that%20cannot%20tell%20bots%20from%20people%20%28DCpp%29%0A%23%3Cset%20BotNicks%3D%22bot1%20bot2%22%3E%0A%0A%23%20width%20in%20pixels%20of%20the%20statistics%20tables%0A%3Cset%20TableWidth%3D%22574%22%3E%0A%0A%23%20image%20id%20of%20the%20horizontal%20bar%20for%20hours%200-5%0A%3Cset%20Pic_H_0%3D%22blue-h%22%3E%0A%0A%23%20image%20id%20of%20the%20horizontal%20bar%20for%20hours%206-11%0A%3Cset%20Pic_H_6%3D%22green-h%22%3E%0A%0A%23%20image%20id%20of%20the%20horizontal%20bar%20for%20hours%2012-17%0A%3Cset%20Pic_H_12%3D%22yellow-h%22%3E%0A%0A%23%20image%20id%20of%20the%20horizontal%20bar%20for%20hours%2018-23%0A%3Cset%20Pic_H_18%3D%22red-h%22%3E%0A%0A%23%20image%20id%20of%20the%20vertical%20bar%20for%20hours%200-5%0A%3Cset%20Pic_V_0%3D%22blue-v%22%3E%0A%0A%23%20image%20id%20of%20the%20vertical%20bar%20for%20hours%206-11%0A%3Cset%20Pic_V_6%3D%22green-v%22%3E%0A%0A%23%20image%20id%20of%20the%20vertical%20bar%20for%20hours%2012-17%0A%3Cset%20Pic_V_12%3D%22yellow-v%22%3E%0A%0A%23%20image%20id%20of%20the%20vertical%20bar%20for%20hours%2018-23%0A%3Cset%20Pic_V_18%3D%22red-v%22%3E%0A%0A%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20%20YOUR%20CHANNEL%20-%20copy%20this%20block%20for%20each%20extra%20channel%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%0A%3Cchannel%3D%22%23example%22%3E%0A%20%20%23%20Logfile%3A%20the%20log%20to%20read%3B%20you%20can%20list%20several%20Logfile%20lines%20%20EDIT%0A%20%20Logfile%3D%22/path/to/example.log%22%0A%0A%20%20%23%20LogDir%3A%20use%20INSTEAD%20of%20Logfile%20to%20read%20a%20whole%20folder%20of%20dated%20logs%0A%20%20%23LogDir%3D%22/path/to/logs/%22%0A%0A%20%20%23%20LogPrefix%3A%20with%20LogDir%3A%20only%20read%20files%20starting%20with%20this%0A%20%20%23LogPrefix%3D%22example.log.%22%0A%0A%20%20%23%20LogSuffix%3A%20with%20LogDir%3A%20date%20format%20at%20the%20end%20of%20the%20file%20names%2C%20so%20they%20sort%20by%0A%20%20%23%20date%0A%20%20%23LogSuffix%3D%22.%25d%25b%25Y%22%0A%0A%20%20%23%20NFiles%3A%20with%20LogDir%3A%20only%20parse%20the%20newest%20N%20files%20%280%20%3D%20all%29%0A%20%20%23NFiles%3D%2230%22%0A%0A%20%20%23%20Format%3A%20your%20log%20format%3A%20eggdrop%2C%20mIRC%2C%20xchat%2C%20irssi%2C%20...%20%28see%20docs/FORMATS%29%20%20EDIT%0A%20%20Format%3D%22eggdrop%22%0A%0A%20%20%23%20Network%3A%20the%20IRC%20network%2C%20shown%20on%20the%20page%20%20EDIT%0A%20%20Network%3D%22ExampleNet%22%0A%0A%20%20%23%20OutputFile%3A%20the%20page%20pisg%20writes%20%20EDIT%0A%20%20OutputFile%3D%22/var/www/html/example.html%22%0A%0A%20%20%23%20OutputTag%3A%20replaces%20%25t%20in%20OutputFile%3B%20used%20with%20the%20-nf%20/%20-t%20command%20line%20options%0A%20%20%23OutputTag%3D%22-week%22%0A%0A%20%20%23%20Maintainer%3A%20who%20is%20named%20as%20maintainer%20on%20the%20page%20%20EDIT%0A%20%20Maintainer%3D%22Your%20Name%22%0A%0A%20%20%23%20LogType%3A%20only%20%22Logfile%22%20exists%2C%20leave%20it%0A%20%20LogType%3D%22Logfile%22%0A%0A%20%20%23%20Any%20global%20option%20can%20be%20overridden%20for%20this%20channel%20only%2C%20for%20example%3A%0A%20%20%23Lang%3D%22FR%22%0A%20%20%23ColorScheme%3D%22midnight%22%0A%3C/channel%3E%0A%0A%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20%20USERS%20-%20link%20nicks%20together%2C%20add%20pictures%2C%20mark%20bots%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20nick%20%20%20%20the%20name%20shown%20in%20the%20stats%20%28required%29%0A%23%20alias%20%20%20other%20nicks%20of%20the%20same%20person%2C%20space%20separated%3B%20%2A%20matches%20anything%0A%23%20%20%20%20%20%20%20%20%20%28Joe%2A%20also%20counts%20Joe_%2C%20Joe%5Eaway%20...%29.%20NickTracking%3D%221%22%20also%20finds%20many%0A%23%20pic%20%20%20%20%20picture%20shown%20next%20to%20the%20user%20%20%20%20%20%20bigpic%20%20larger%20picture%20it%20links%20to%0A%23%20link%20%20%20%20a%20web%20address%20or%20e-mail%20address%20%20%20%20%20%20sex%20%20%20%20%20m%2C%20f%20or%20b%20%28bot%29%0A%23%20ignore%20%20y%20%3D%20leave%20this%20nick%20out%20of%20the%20stats%20altogether%20%28for%20bots%29%0A%0A%3Cuser%20nick%3D%22Alice%22%20alias%3D%22Alice_%20Alice-%2A%20AliceAway%22%20pic%3D%22alice.png%22%20link%3D%22https%3A//example.com/alice%22%20sex%3D%22f%22%3E%0A%3Cuser%20nick%3D%22Bob%22%20alias%3D%22Bob_%20Bobby%22%20pic%3D%22bob.png%22%20bigpic%3D%22bob-big.png%22%20link%3D%22bob%40example.com%22%20sex%3D%22m%22%3E%0A%3Cuser%20nick%3D%22ChanBot%22%20sex%3D%22b%22%20ignore%3D%22y%22%3E%0A%3Cuser%20nick%3D%22Seb%22%20alias%3D%22Seb-%20Seb_%22%20pic%3D%22https%3A//r2.fivemanage.com/X8I0LGoLdHY2Wx9DdTrvx/Pics/me.png%22%20sex%3D%22m%22%20link%3D%22https%3A//dooubletap.github.io/%22%3E%0A%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20%20LINKS%20-%20keep%20addresses%20out%20of%20%22Most%20referenced%20URLs%22%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%3Clink%20url%3D%22https%3A//example.com/spam%22%20ignore%3D%22y%22%3E%0A%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20%20INCLUDE%20-%20share%20users%20between%20channels%20or%20config%20files%0A%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%23%0A%23%20Put%20your%20%3Cuser%3E%20lines%20in%20users.cfg%20and%20load%20them%20here%20%28an%20included%20file%20cannot%0A%23%20include%20another%20file%29%3A%0A%23%3Cinclude%3D%22users.cfg%22%3E%0A" download="pisg.cfg">Download</a>
    1867. 

  1867. <button class="btn copy" type="button" data-target="cfg-example">Copy</button></div>
    1868. 

  1868. <pre id="cfg-example" class="cfg"># pisg.cfg.example - a complete configuration for pisg, ready to copy.
    1869. 

  1869. #
    1870. 

  1870. #   1. Copy this file to pisg.cfg
    1871. 

  1871. #   2. Change the values marked  EDIT  (log path, format, network, output file, name)
    1872. 

  1872. #   3. Run ./pisg
    1873. 

  1873. #
    1874. 

  1874. # Every option pisg understands is listed below with its meaning. Options are set to
    1875. 

  1875. # pisg&#x27;s own default unless the comment says &quot;recommended&quot;. Lines starting with # are
    1876. 

  1876. # comments; an option shown commented out is off/unset - remove the # to use it.
    1877. 

  1877. #
    1878. 

  1878. # Syntax reminders:
    1879. 

  1879. #   &lt;set Name=&quot;value&quot;&gt;      a global option, applies to every channel
    1880. 

  1880. #   &lt;channel=&quot;#name&quot;&gt; ... &lt;/channel&gt;   settings for one channel (they override &lt;set&gt;)
    1881. 

  1881. #   &lt;user nick=&quot;...&quot; ...&gt;   per-user settings
    1882. 

  1882. # Each &lt;set&gt; must be on one line, and every value must be in quotes.
    1883. 

  1883. 

  1884. 

  1885. ##############################################################################
    1886. 

  1886. #  GLOBAL OPTIONS - apply to every channel below
    1887. 

  1887. ##############################################################################
    1888. 

  1888. 

  1889. # ---- General options -------------------------------------------------------
    1890. 

  1890. 

  1891. # use a different color scheme for stats page - recommended: modern, light/dark theme;
    1892. 

  1892. # try midnight, amoled, terminal, or default
    1893. 

  1893. &lt;set ColorScheme=&quot;modern&quot;&gt;
    1894. 

  1894. 

  1895. # alternate stylesheets for stats page - extra stylesheets the visitor can switch to
    1896. 

  1896. #&lt;set AltColorScheme=&quot;midnight.css amoled.css&quot;&gt;
    1897. 

  1897. 

  1898. # define the language / translation to use
    1899. 

  1899. &lt;set Lang=&quot;EN&quot;&gt;
    1900. 

  1900. 

  1901. # define a file as page header - HTML file inserted above the statistics
    1902. 

  1902. #&lt;set PageHead=&quot;header.html&quot;&gt;
    1903. 

  1903. 

  1904. # define a file as page footer - HTML file inserted below the statistics
    1905. 

  1905. #&lt;set PageFoot=&quot;footer.html&quot;&gt;
    1906. 

  1906. 

  1907. # make pisg silent, suppress messages
    1908. 

  1908. &lt;set Silent=&quot;0&quot;&gt;
    1909. 

  1909. 

  1910. # use a cache to speed up log parsing - cache parsed logs here to speed up runs (delete
    1911. 

  1911. # it when you change settings)
    1912. 

  1912. #&lt;set CacheDir=&quot;cache/&quot;&gt;
    1913. 

  1913. 

  1914. # name of the channel list file for a landing page
    1915. 

  1915. &lt;set ChannelIndex=&quot;channels.json&quot;&gt;
    1916. 

  1916. 

  1917. # adds a button at the top of every stats page that leads back to your landing page
    1918. 

  1918. &lt;set HomeLink=&quot;&quot;&gt;
    1919. 

  1919. 

  1920. # enable/disable the section bar at the top of the page
    1921. 

  1921. &lt;set ShowNavBar=&quot;1&quot;&gt;
    1922. 

  1922. 

  1923. # ---- Options for various statistics features -------------------------------
    1924. 

  1924. 

  1925. # number of days to show in &quot;Daily Actitity&quot; - recommended: show the last 14 days as a
    1926. 

  1926. # bar chart
    1927. 

  1927. &lt;set DailyActivity=&quot;14&quot;&gt;
    1928. 

  1928. 

  1929. # enable/disable &quot;Most Active Times&quot;
    1930. 

  1930. &lt;set ShowActiveTimes=&quot;1&quot;&gt;
    1931. 

  1931. 

  1932. # enable/disable &quot;Most Active Nicks&quot;
    1933. 

  1933. &lt;set ShowActiveNicks=&quot;1&quot;&gt;
    1934. 

  1934. 

  1935. # enable/disable &quot;Big Numbers&quot; sections
    1936. 

  1936. &lt;set ShowBigNumbers=&quot;1&quot;&gt;
    1937. 

  1937. 

  1938. # enable/disable &quot;Latest topics&quot; sections
    1939. 

  1939. &lt;set ShowTopics=&quot;1&quot;&gt;
    1940. 

  1940. 

  1941. # enable/disable &quot;number of lines&quot;
    1942. 

  1942. &lt;set ShowLines=&quot;1&quot;&gt;
    1943. 

  1943. 

  1944. # enable/disable &quot;words per line&quot; - recommended: also show words per line
    1945. 

  1945. &lt;set ShowWpl=&quot;1&quot;&gt;
    1946. 

  1946. 

  1947. # enable/disable &quot;characters per line&quot; - recommended: also show characters per line
    1948. 

  1948. &lt;set ShowCpl=&quot;1&quot;&gt;
    1949. 

  1949. 

  1950. # enable/disable &quot;number of words&quot; - recommended: also show total words
    1951. 

  1951. &lt;set ShowWords=&quot;1&quot;&gt;
    1952. 

  1952. 

  1953. # show when a user was last seen on a channel
    1954. 

  1954. &lt;set ShowLastSeen=&quot;1&quot;&gt;
    1955. 

  1955. 

  1956. # show when a nick was active
    1957. 

  1957. &lt;set ShowTime=&quot;1&quot;&gt;
    1958. 

  1958. 

  1959. # mIRCStats like behaviour of time bar
    1960. 

  1960. &lt;set ShowLineTime=&quot;0&quot;&gt;
    1961. 

  1961. 

  1962. # ShowLineTime like behavior of words column
    1963. 

  1963. &lt;set ShowWordTime=&quot;0&quot;&gt;
    1964. 

  1964. 

  1965. # enable or disable the random quotes
    1966. 

  1966. &lt;set ShowRandQuote=&quot;1&quot;&gt;
    1967. 

  1967. 

  1968. # enable or disable the legend of the time bars
    1969. 

  1969. &lt;set ShowLegend=&quot;1&quot;&gt;
    1970. 

  1970. 

  1971. # enable or disable the kick line
    1972. 

  1972. &lt;set ShowKickLine=&quot;1&quot;&gt;
    1973. 

  1973. 

  1974. # enable or disable the action line
    1975. 

  1975. &lt;set ShowActionLine=&quot;1&quot;&gt;
    1976. 

  1976. 

  1977. # enable or disable the shout line
    1978. 

  1978. &lt;set ShowShoutLine=&quot;1&quot;&gt;
    1979. 

  1979. 

  1980. # set how many decimals to show
    1981. 

  1981. &lt;set ShowFoulDecimals=&quot;1&quot;&gt;
    1982. 

  1982. 

  1983. # enable or disable the foul line
    1984. 

  1984. &lt;set ShowFoulLine=&quot;0&quot;&gt;
    1985. 

  1985. 

  1986. # enable or disable the violent lines
    1987. 

  1987. &lt;set ShowViolentLines=&quot;1&quot;&gt;
    1988. 

  1988. 

  1989. # enable or disable &quot;Most used words&quot;
    1990. 

  1990. &lt;set ShowMuw=&quot;1&quot;&gt;
    1991. 

  1991. 

  1992. # enable or disable &quot;Most referenced nicks&quot;
    1993. 

  1993. &lt;set ShowMrn=&quot;1&quot;&gt;
    1994. 

  1994. 

  1995. # enable or disable &quot;Most referenced URLs&quot;
    1996. 

  1996. &lt;set ShowMru=&quot;1&quot;&gt;
    1997. 

  1997. 

  1998. # enable or disable channel music charts
    1999. 

  1999. &lt;set ShowCharts=&quot;0&quot;&gt;
    2000. 

  2000. 

  2001. # enable or disable op statistics
    2002. 

  2002. &lt;set ShowOps=&quot;1&quot;&gt;
    2003. 

  2003. 

  2004. # enable or disable voice statistics
    2005. 

  2005. &lt;set ShowVoices=&quot;0&quot;&gt;
    2006. 

  2006. 

  2007. # enable or disable halfop statistics
    2008. 

  2008. &lt;set ShowHalfops=&quot;0&quot;&gt;
    2009. 

  2009. 

  2010. # show who changed nick most often - recommended: show who changed nick most often
    2011. 

  2011. &lt;set ShowMostNicks=&quot;1&quot;&gt;
    2012. 

  2012. 

  2013. # show stats on which gender talked most
    2014. 

  2014. &lt;set ShowActiveGenders=&quot;0&quot;&gt;
    2015. 

  2015. 

  2016. # show most used smileys - recommended: show the most used smileys
    2017. 

  2017. &lt;set ShowSmileys=&quot;1&quot;&gt;
    2018. 

  2018. 

  2019. # show channel karma - recommended: show karma (nick++ / nick--)
    2020. 

  2020. &lt;set ShowKarma=&quot;1&quot;&gt;
    2021. 

  2021. 

  2022. # show most active nicks by hour - recommended: show the most active nicks by time of
    2023. 

  2023. # day
    2024. 

  2024. &lt;set ShowMostActiveByHour=&quot;1&quot;&gt;
    2025. 

  2025. 

  2026. # only count stats for top talkers, ignore less-active users
    2027. 

  2027. &lt;set ShowOnlyTop=&quot;0&quot;&gt;
    2028. 

  2028. 

  2029. # show graphs in most active nicks by hour
    2030. 

  2030. &lt;set ShowMostActiveByHourGraph=&quot;1&quot;&gt;
    2031. 

  2031. 

  2032. # enable/disable the channel overview
    2033. 

  2033. &lt;set ShowOverview=&quot;1&quot;&gt;
    2034. 

  2034. 

  2035. # enable/disable the relation map and its tables
    2036. 

  2036. &lt;set ShowRelations=&quot;1&quot;&gt;
    2037. 

  2037. 

  2038. # number of nicks on the relation map
    2039. 

  2039. &lt;set RelationNicks=&quot;30&quot;&gt;
    2040. 

  2040. 

  2041. # minimum connection strength shown as a line on the relation map
    2042. 

  2042. &lt;set RelationMinWeight=&quot;3&quot;&gt;
    2043. 

  2043. 

  2044. # enable/disable the time personalities section
    2045. 

  2045. &lt;set ShowTimePersonalities=&quot;1&quot;&gt;
    2046. 

  2046. 

  2047. # enable/disable the &quot;who carries the channel&quot; section
    2048. 

  2048. &lt;set ShowConcentration=&quot;1&quot;&gt;
    2049. 

  2049. 

  2050. # enable/disable the signature words section
    2051. 

  2051. &lt;set ShowSignatureWords=&quot;1&quot;&gt;
    2052. 

  2052. 

  2053. # ignore specified words - words to leave out of the word statistics
    2054. 

  2054. #&lt;set IgnoreWords=&quot;badword otherword&quot;&gt;
    2055. 

  2055. 

  2056. # Control random quote output
    2057. 

  2057. &lt;set NoIgnoredQuotes=&quot;0&quot;&gt;
    2058. 

  2058. 

  2059. # specify words considered to be bad/FoulWords language
    2060. 

  2060. &lt;set FoulWords=&quot;ass fuck bitch shit scheisse scheiße kacke arsch ficker ficken schlampe&quot;&gt;
    2061. 

  2061. 

  2062. # specify words considered to be aggressive/violent
    2063. 

  2063. &lt;set ViolentWords=&quot;slaps beats smacks&quot;&gt;
    2064. 

  2064. 

  2065. # words that keep a URL out of the URL statistics - matched anywhere in a URL, any case;
    2066. 

  2066. # * = any characters, ? = one; for spam and unwanted image hosts
    2067. 

  2067. #&lt;set BadUrls=&quot;imagetwist imgur.com postimg.cc/*&quot;&gt;
    2068. 

  2068. 

  2069. # minimum numbers of letters for a random quote
    2070. 

  2070. &lt;set MinQuote=&quot;25&quot;&gt;
    2071. 

  2071. 

  2072. # maximum numbers of letters for a random quote
    2073. 

  2073. &lt;set MaxQuote=&quot;65&quot;&gt;
    2074. 

  2074. 

  2075. # minimum number of characters in an interesting word
    2076. 

  2076. &lt;set WordLength=&quot;5&quot;&gt;
    2077. 

  2077. 

  2078. # maximum allowed length of a &quot;word&quot; with no spaces
    2079. 

  2079. &lt;set QuoteWidth=&quot;80&quot;&gt;
    2080. 

  2080. 

  2081. # Minimum number of lines per user for some &quot;Big Numbers&quot; statistics
    2082. 

  2082. &lt;set BigNumbersThreshold=&quot;sqrt&quot;&gt;
    2083. 

  2083. 

  2084. # nicks to show in &quot;Most Active Nicks&quot;
    2085. 

  2085. &lt;set ActiveNicks=&quot;25&quot;&gt;
    2086. 

  2086. 

  2087. # nicks to show in &quot;These didn&#x27;t make it..&quot;
    2088. 

  2088. &lt;set ActiveNicks2=&quot;30&quot;&gt;
    2089. 

  2089. 

  2090. # number of nicks to show in &quot;Most Active Nicks By Hour&quot;
    2091. 

  2091. &lt;set ActiveNicksByHour=&quot;10&quot;&gt;
    2092. 

  2092. 

  2093. # maximum number of nicks to show in &quot;users with most nicknames&quot;
    2094. 

  2094. &lt;set MostNicksHistory=&quot;5&quot;&gt;
    2095. 

  2095. 

  2096. # show nicks used in &quot;most nicks&quot;
    2097. 

  2097. &lt;set MostNicksVerbose=&quot;1&quot;&gt;
    2098. 

  2098. 

  2099. # maximum number of topics to show - recommended: show the last 5 topics
    2100. 

  2100. &lt;set TopicHistory=&quot;5&quot;&gt;
    2101. 

  2101. 

  2102. # maximum number of URLs to show
    2103. 

  2103. &lt;set UrlHistory=&quot;5&quot;&gt;
    2104. 

  2104. 

  2105. # number of songs to show
    2106. 

  2106. &lt;set ChartsHistory=&quot;5&quot;&gt;
    2107. 

  2107. 

  2108. # how to recognize songs played
    2109. 

  2109. &lt;set ChartsRegexp=&quot;(?:is )?(?:np:|(?:now )?playing:? |listening to:? )(?:MPEG stream from)?\s*(.*)&quot;&gt;
    2110. 

  2110. 

  2111. # maximum number of words to show
    2112. 

  2112. &lt;set WordHistory=&quot;10&quot;&gt;
    2113. 

  2113. 

  2114. # maximum number of nicks to show in &quot;Most referenced nicks&quot;
    2115. 

  2115. &lt;set NickHistory=&quot;5&quot;&gt;
    2116. 

  2116. 

  2117. # maximum number of smileys to show in smiley stats
    2118. 

  2118. &lt;set SmileyHistory=&quot;10&quot;&gt;
    2119. 

  2119. 

  2120. # maximum number of nicks to show in &quot;Karma&quot;
    2121. 

  2121. &lt;set KarmaHistory=&quot;5&quot;&gt;
    2122. 

  2122. 

  2123. # track nick changes and create aliases - recommended: follow nick changes so Alice,
    2124. 

  2124. # Alice_ and Alice- count as one person
    2125. 

  2125. &lt;set NickTracking=&quot;1&quot;&gt;
    2126. 

  2126. 

  2127. # maximum number of nicks in lists
    2128. 

  2128. &lt;set NickLimit=&quot;10&quot;&gt;
    2129. 

  2129. 

  2130. # sort &quot;most active nicks&quot; by words
    2131. 

  2131. &lt;set SortByWords=&quot;0&quot;&gt;
    2132. 

  2132. 

  2133. # ---- Picture options -------------------------------------------------------
    2134. 

  2134. 

  2135. # path to images on stats page
    2136. 

  2136. &lt;set PicLocation=&quot;.&quot;&gt;
    2137. 

  2137. 

  2138. # number of user pictures per row
    2139. 

  2139. &lt;set UserPics=&quot;1&quot;&gt;
    2140. 

  2140. 

  2141. # path to user pictures (HTML page) - folder of user pictures, as seen by the web page
    2142. 

  2142. #&lt;set ImagePath=&quot;images/&quot;&gt;
    2143. 

  2143. 

  2144. # use a default user picture - picture shown for users who have none
    2145. 

  2145. #&lt;set DefaultPic=&quot;images/nobody.png&quot;&gt;
    2146. 

  2146. 

  2147. # path to user pictures (output generation) - folder of user pictures, as seen by pisg
    2148. 

  2148. # (for pic=&quot;x_*.jpg&quot; globs)
    2149. 

  2149. #&lt;set ImageGlobPath=&quot;/var/www/pisg/images/&quot;&gt;
    2150. 

  2150. 

  2151. # define a standard width for user pictures - show every user picture this wide, in
    2152. 

  2152. # pixels
    2153. 

  2153. #&lt;set PicWidth=&quot;55&quot;&gt;
    2154. 

  2154. 

  2155. # define a standard height for user pictures - show every user picture this tall, in
    2156. 

  2156. # pixels
    2157. 

  2157. #&lt;set PicHeight=&quot;55&quot;&gt;
    2158. 

  2158. 

  2159. # ---- Misc options ----------------------------------------------------------
    2160. 

  2160. 

  2161. # character set to use for stats page - recommended: UTF-8 shows accents, emoji and non-
    2162. 

  2162. # Latin scripts correctly
    2163. 

  2163. &lt;set Charset=&quot;utf-8&quot;&gt;
    2164. 

  2164. 

  2165. # character set for logfiles - convert logs from this charset (needs the Text::Iconv
    2166. 

  2166. # perl module)
    2167. 

  2167. #&lt;set LogCharset=&quot;iso-8859-1&quot;&gt;
    2168. 

  2168. 

  2169. # fallback character set for logfiles - used for lines that are not valid in LogCharset
    2170. 

  2170. # (needs Text::Iconv)
    2171. 

  2171. #&lt;set LogCharsetFallback=&quot;iso-8859-1&quot;&gt;
    2172. 

  2172. 

  2173. # use a different time zone than the local machine
    2174. 

  2174. &lt;set TimeOffset=&quot;+0&quot;&gt;
    2175. 

  2175. 

  2176. # use regular expressions in user aliases
    2177. 

  2177. &lt;set RegexpAliases=&quot;0&quot;&gt;
    2178. 

  2178. 

  2179. # filename of language file
    2180. 

  2180. &lt;set LangFile=&quot;lang.txt&quot;&gt;
    2181. 

  2181. 

  2182. # path to directory with CSS files
    2183. 

  2183. &lt;set CssDir=&quot;layout/&quot;&gt;
    2184. 

  2184. 

  2185. # colors for color gradient in most active nicks section
    2186. 

  2186. &lt;set HiCell=&quot;#BABADD&quot;&gt;
    2187. 

  2187. &lt;set HiCell2=&quot;#CCCCCC&quot;&gt;
    2188. 

  2188. 

  2189. # colors for color gradient in most active nicks section
    2190. 

  2190. &lt;set HiCell2=&quot;#CCCCCC&quot;&gt;
    2191. 

  2191. 

  2192. # dump raw statistics into file - debugging: dump the raw statistics to this file
    2193. 

  2193. #&lt;set StatsDump=&quot;stats.dump&quot;&gt;
    2194. 

  2194. 

  2195. # ---- Advanced (not in the original documentation) -------------------------
    2196. 

  2196. 

  2197. # nicks of bots, for log formats that cannot tell bots from people (DCpp)
    2198. 

  2198. #&lt;set BotNicks=&quot;bot1 bot2&quot;&gt;
    2199. 

  2199. 

  2200. # width in pixels of the statistics tables
    2201. 

  2201. &lt;set TableWidth=&quot;574&quot;&gt;
    2202. 

  2202. 

  2203. # image id of the horizontal bar for hours 0-5
    2204. 

  2204. &lt;set Pic_H_0=&quot;blue-h&quot;&gt;
    2205. 

  2205. 

  2206. # image id of the horizontal bar for hours 6-11
    2207. 

  2207. &lt;set Pic_H_6=&quot;green-h&quot;&gt;
    2208. 

  2208. 

  2209. # image id of the horizontal bar for hours 12-17
    2210. 

  2210. &lt;set Pic_H_12=&quot;yellow-h&quot;&gt;
    2211. 

  2211. 

  2212. # image id of the horizontal bar for hours 18-23
    2213. 

  2213. &lt;set Pic_H_18=&quot;red-h&quot;&gt;
    2214. 

  2214. 

  2215. # image id of the vertical bar for hours 0-5
    2216. 

  2216. &lt;set Pic_V_0=&quot;blue-v&quot;&gt;
    2217. 

  2217. 

  2218. # image id of the vertical bar for hours 6-11
    2219. 

  2219. &lt;set Pic_V_6=&quot;green-v&quot;&gt;
    2220. 

  2220. 

  2221. # image id of the vertical bar for hours 12-17
    2222. 

  2222. &lt;set Pic_V_12=&quot;yellow-v&quot;&gt;
    2223. 

  2223. 

  2224. # image id of the vertical bar for hours 18-23
    2225. 

  2225. &lt;set Pic_V_18=&quot;red-v&quot;&gt;
    2226. 

  2226. 

  2227. 

  2228. ##############################################################################
    2229. 

  2229. #  YOUR CHANNEL - copy this block for each extra channel
    2230. 

  2230. ##############################################################################
    2231. 

  2231. 

  2232. &lt;channel=&quot;#example&quot;&gt;
    2233. 

  2233.   # Logfile: the log to read; you can list several Logfile lines  EDIT
    2234. 

  2234.   Logfile=&quot;/path/to/example.log&quot;
    2235. 

  2235. 

  2236.   # LogDir: use INSTEAD of Logfile to read a whole folder of dated logs
    2237. 

  2237.   #LogDir=&quot;/path/to/logs/&quot;
    2238. 

  2238. 

  2239.   # LogPrefix: with LogDir: only read files starting with this
    2240. 

  2240.   #LogPrefix=&quot;example.log.&quot;
    2241. 

  2241. 

  2242.   # LogSuffix: with LogDir: date format at the end of the file names, so they sort by
    2243. 

  2243.   # date
    2244. 

  2244.   #LogSuffix=&quot;.%d%b%Y&quot;
    2245. 

  2245. 

  2246.   # NFiles: with LogDir: only parse the newest N files (0 = all)
    2247. 

  2247.   #NFiles=&quot;30&quot;
    2248. 

  2248. 

  2249.   # Format: your log format: eggdrop, mIRC, xchat, irssi, ... (see docs/FORMATS)  EDIT
    2250. 

  2250.   Format=&quot;eggdrop&quot;
    2251. 

  2251. 

  2252.   # Network: the IRC network, shown on the page  EDIT
    2253. 

  2253.   Network=&quot;ExampleNet&quot;
    2254. 

  2254. 

  2255.   # OutputFile: the page pisg writes  EDIT
    2256. 

  2256.   OutputFile=&quot;/var/www/html/example.html&quot;
    2257. 

  2257. 

  2258.   # OutputTag: replaces %t in OutputFile; used with the -nf / -t command line options
    2259. 

  2259.   #OutputTag=&quot;-week&quot;
    2260. 

  2260. 

  2261.   # Maintainer: who is named as maintainer on the page  EDIT
    2262. 

  2262.   Maintainer=&quot;Your Name&quot;
    2263. 

  2263. 

  2264.   # LogType: only &quot;Logfile&quot; exists, leave it
    2265. 

  2265.   LogType=&quot;Logfile&quot;
    2266. 

  2266. 

  2267.   # Any global option can be overridden for this channel only, for example:
    2268. 

  2268.   #Lang=&quot;FR&quot;
    2269. 

  2269.   #ColorScheme=&quot;midnight&quot;
    2270. 

  2270. &lt;/channel&gt;
    2271. 

  2271. 

  2272. 

  2273. ##############################################################################
    2274. 

  2274. #  USERS - link nicks together, add pictures, mark bots
    2275. 

  2275. ##############################################################################
    2276. 

  2276. # nick    the name shown in the stats (required)
    2277. 

  2277. # alias   other nicks of the same person, space separated; * matches anything
    2278. 

  2278. #         (Joe* also counts Joe_, Joe^away ...). NickTracking=&quot;1&quot; also finds many
    2279. 

  2279. # pic     picture shown next to the user      bigpic  larger picture it links to
    2280. 

  2280. # link    a web address or e-mail address      sex     m, f or b (bot)
    2281. 

  2281. # ignore  y = leave this nick out of the stats altogether (for bots)
    2282. 

  2282. 

  2283. &lt;user nick=&quot;Alice&quot; alias=&quot;Alice_ Alice-* AliceAway&quot; pic=&quot;alice.png&quot; link=&quot;https://example.com/alice&quot; sex=&quot;f&quot;&gt;
    2284. 

  2284. &lt;user nick=&quot;Bob&quot; alias=&quot;Bob_ Bobby&quot; pic=&quot;bob.png&quot; bigpic=&quot;bob-big.png&quot; link=&quot;bob@example.com&quot; sex=&quot;m&quot;&gt;
    2285. 

  2285. &lt;user nick=&quot;ChanBot&quot; sex=&quot;b&quot; ignore=&quot;y&quot;&gt;
    2286. 

  2286. &lt;user nick=&quot;Seb&quot; alias=&quot;Seb- Seb_&quot; pic=&quot;https://r2.fivemanage.com/X8I0LGoLdHY2Wx9DdTrvx/Pics/me.png&quot; sex=&quot;m&quot; link=&quot;https://dooubletap.github.io/&quot;&gt;
    2287. 

  2287. 

  2288. ##############################################################################
    2289. 

  2289. #  LINKS - keep addresses out of &quot;Most referenced URLs&quot;
    2290. 

  2290. ##############################################################################
    2291. 

  2291. &lt;link url=&quot;https://example.com/spam&quot; ignore=&quot;y&quot;&gt;
    2292. 

  2292. 

  2293. ##############################################################################
    2294. 

  2294. #  INCLUDE - share users between channels or config files
    2295. 

  2295. ##############################################################################
    2296. 

  2296. # Put your &lt;user&gt; lines in users.cfg and load them here (an included file cannot
    2297. 

  2297. # include another file):
    2298. 

  2298. #&lt;include=&quot;users.cfg&quot;&gt;
    2299. 

  2299. </pre>
    2300. 

  2300. </div>
    2301. 

  2301. </section>
    2302. 

  2302. </main>
    2303. 

  2303. <script>
    2304. 

  2304. document.querySelectorAll('.copy').forEach(function (b) {
    2305. 

  2305.   b.addEventListener('click', function () {
    2306. 

  2306.     var pre = document.getElementById(b.dataset.target), text = pre.textContent;
    2307. 

  2307.     function done(ok) { var old = b.textContent; b.textContent = ok ? 'Copied!' : 'Press Ctrl+C';
    2308. 

  2308.       setTimeout(function () { b.textContent = old; }, 1800); }
    2309. 

  2309.     function fallback() { var r = document.createRange(); r.selectNodeContents(pre);
    2310. 

  2310.       var s = window.getSelection(); s.removeAllRanges(); s.addRange(r);
    2311. 

  2311.       var ok = false; try { ok = document.execCommand('copy'); } catch (e) {} done(ok); }
    2312. 

  2312.     if (navigator.clipboard && window.isSecureContext) { navigator.clipboard.writeText(text).then(function () { done(true); }, fallback); }
    2313. 

  2313.     else { fallback(); }
    2314. 

  2314.   });
    2315. 

  2315. });
    2316. 

  2316. </script>
    2317. 

  2317. </body>
    2318. 

  2318. </html>
    2319.