Просмотр исходного кода

update-ish (broken links)

some links were broken, and some files needed editing.
Seb 4 дней назад
Родитель
Сommit
a7fe7cfab4
10 измененных файлов с 172 добавлено и 36 удалено
  1. 129 0
      CHANGELOG.md
  2. 6 14
      Makefile
  3. 4 4
      README.md
  4. 12 0
      docs/Changelog
  5. 3 2
      docs/Makefile
  6. 1 0
      docs/gen-example-config.py
  7. 2 2
      docs/pisg-doc.html
  8. 12 12
      docs/pisg-doc.xml
  9. 2 2
      pisg.cfg
  10. 1 0
      pisg.cfg.example

+ 129 - 0
CHANGELOG.md

@@ -0,0 +1,129 @@
+# Changelog
+
+What changed in each release of pisg, newest first. This file is the short version; the
+complete history back to 2001 is in [`docs/Changelog`](docs/Changelog), and the long
+release notes for 1.0a are in [`docs/RELEASE-NOTES-1.0.md`](docs/RELEASE-NOTES-1.0.md).
+
+Website: <https://pisg.github.io/> · Help: `#pisg` on Undernet (`irc.undernet.org`) ·
+Bugs: <https://github.com/PISG/pisg/issues>
+
+---
+
+## 1.0a — 2026-09-21
+
+The "Modern Look" release. The `a` is for alpha: everything below works, but it has not
+had a long run in the wild yet.
+
+Nothing you have set up has to change: the same parsers, the same statistics, the same
+`pisg.cfg`. The default colour scheme is still `default`. The new sections are on by
+default — see *Upgrading* below if you want the old page exactly.
+
+### Added
+
+- **Guided setup**: `perl setup.pl` finds logs already on the computer (eggdrop, ZNC,
+  irssi, WeeChat, HexChat, mIRC, AdiIRC), asks a few questions, writes `pisg.cfg`, makes
+  the first page, offers to run pisg on a schedule and lists free places to host the pages.
+  It never overwrites an existing `pisg.cfg`. `--dry-run` shows what it would do.
+- **Four modern colour schemes** — `modern`, `midnight`, `amoled`, `terminal` — generated
+  from one stylesheet by `layout/build-themes.py`. `modern` follows the reader's
+  light/dark setting. The eight classic schemes are unchanged.
+- **Seven new sections**, all on by default:
+
+  | Section | Option |
+  | --- | --- |
+  | Channel overview | `ShowOverview` |
+  | Who talks to whom (interactive map) | `ShowRelations`, `RelationNicks`, `RelationMinWeight` |
+  | Closest pairs | `ShowRelations` |
+  | Social roles | `ShowRelations` |
+  | Time personalities | `ShowTimePersonalities` |
+  | Who carries the channel | `ShowConcentration` |
+  | Signature words | `ShowSignatureWords` |
+
+- **Section navigation** (`ShowNavBar`): a menu down the left on wide screens, a slim bar
+  on phones. Works without JavaScript.
+- **Landing page**: `site/index.html`, one static file, reads the `channels.json` pisg
+  writes next to its pages (`ChannelIndex`) and compares every channel. `HomeLink` adds an
+  "All channels" button to each stats page.
+- **`BadUrls`**: keep URLs out of the URL statistics, with `*` and `?` wildcards.
+- **Several channels in one run**: a channel that cannot be read is skipped with
+  `Skipped channel #name: reason` and the others are still made.
+- **`pisg.cfg.example`** lists every option with what it does; `docs/pisg-doc.html` is the
+  whole manual as one page. `docs/gen-example-config.py` and `docs/xml2html.py` rebuild them.
+- **Optional tools** in `scripts/`:
+  - `eggdrop-pisg.tcl` — people set their own sex, picture and link and merge their nicks
+    from IRC (`!pisginfo`, `!pisgmerge`, `!pisgshow`, `!pisgdel` …). Identified by services
+    account; never overwrites a `<user>` line you wrote. Tests: `eggdrop-pisg-test.tcl`.
+  - `pisg-autoalias.py` — merges nicks seen with the same authenticated host
+    (`*.users.undernet.org`). Your own `<user>` lines always win.
+  - `adiirc2eggdrop.py` — converts AdiIRC client logs to eggdrop or ZNC format so old
+    history can join the stats. Never overwrites a file.
+  - `znc-setup.sh` — lets pisg read a ZNC account's log folders; prints its plan first.
+- English and French texts for everything new; other languages fall back to English.
+
+### Changed
+
+- **The project's home is `#pisg` on Undernet** (`irc.undernet.org`), no longer freenode.
+  Bugs and patches go to GitHub issues; the SourceForge list and tracker are read-only.
+- Pages are responsive from 360 px phones to wide screens and use full UTF-8 with
+  `<set Charset="utf-8">`.
+- `eggdrop-pisg.tcl`: `!pisgstats` is open to everyone and no longer runs pisg inside the
+  bot; the old timer is off by default.
+- The version string is `1.0a` (pages say *Stats generated by pisg v1.0a*).
+
+### Removed
+
+- The `canada` colour scheme, which existed only during development, is not distributed.
+
+### Fixed
+
+- A page is written to a temporary file and moved into place only when complete — an error
+  can no longer leave a half-written page.
+- pisg exits with status 1 on failure (it used to exit 0).
+- A section that fails is skipped with a warning instead of stopping pisg.
+- An error in one channel no longer leaks its nick aliases into the next.
+- Long quotes are cut on a character boundary, so UTF-8 is no longer split in half.
+- "Most used words" no longer lists punctuation or ASCII art.
+- Tables share one left edge; column titles and "3 days ago" stay on one line.
+
+### Upgrading
+
+1. Replace the program files. Your `pisg.cfg` keeps working.
+2. For the old page exactly, set `ShowOverview`, `ShowRelations`, `ShowTimePersonalities`,
+   `ShowConcentration`, `ShowSignatureWords` and `ShowNavBar` to `0`.
+3. For the new look: `<set ColorScheme="modern">` (or `midnight`, `amoled`, `terminal`).
+4. If a script or cron job treated any exit status as success, check it: failures now exit 1.
+5. For the landing page, copy `site/index.html` next to your pages, run pisg once so
+   `channels.json` exists, and add `<set HomeLink="index.html">`.
+
+Requirements for pisg itself are unchanged (Perl). The optional tools need Python 3,
+Tcl 8.6 with an eggdrop, and `JSON::PP` (core Perl) for `ChannelIndex`.
+
+### Website
+
+<https://pisg.github.io/> was rebuilt for this release: the manual at `/docs/`, these notes
+at `/changelog/`, a full example stats page and landing page at `/demo/`, and a theme
+creator at `/themes/` that builds a stylesheet from a palette — including the eight
+classic schemes converted to 1.0a palettes — and previews it on a complete page.
+
+---
+
+## 0.80-preview2 — 2016-02-21
+
+- Removed the need for separate `.png` files: the bar graphics are embedded in the page.
+- Replaced SourceForge links with GitHub Pages.
+- Greatly improved cache performance.
+
+## 0.80-preview — 2016-02
+
+- Simple checksums now used for validating the cache.
+- Rounded corners and flatter graphics.
+
+## 0.73 — 2012-01-18
+
+Last release of the SourceForge era. Earlier releases, back to 2001: [`docs/Changelog`](docs/Changelog).
+
+---
+
+pisg was started in 2001 by Morten "mbrix" Brix Pedersen
+(<https://sourceforge.net/projects/pisg/>) and is free software under the GNU GPL,
+version 2 or later.

+ 6 - 14
Makefile

@@ -18,14 +18,17 @@ TARFILE = pisg-$(VERSION).tar.gz
 ZIPFILE = pisg-$(VERSION).zip
 
 FILES = pisg \
-	 COPYING \
-	 README \
+	 setup.pl \
+	 LICENSE.md \
+	 README.md \
+	 CHANGELOG.md \
 	 pisg.cfg \
 	 pisg.cfg.example \
 	 lang.txt
 
 DOCS = docs/FORMATS \
 	 docs/Changelog \
+	 docs/RELEASE-NOTES-1.0.md \
 	 docs/CREDITS \
 	 docs/pisg-doc.html \
 	 docs/pisg-doc.txt \
@@ -35,20 +38,12 @@ DOCS = docs/FORMATS \
 
 DEVDOCS = docs/dev/API
 
-GFX = gfx/green-h.png \
-	 gfx/green-v.png \
-	 gfx/blue-h.png \
-	 gfx/blue-v.png \
-	 gfx/yellow-h.png \
-	 gfx/yellow-v.png \
-	 gfx/red-h.png \
-	 gfx/red-v.png \
-
 SCRIPTS = scripts/crontab \
 	   scripts/dropegg.pl \
 	   scripts/egg2mirc.awk \
 	   scripts/eggdrop-pisg.tcl \
 	   scripts/eggdrop-pisg-test.tcl \
+	   scripts/pisg-addchan.tcl \
 	   scripts/pisg-autoalias.py \
 	   scripts/pisg-autoalias-test.py \
 	   scripts/adiirc2eggdrop.py scripts/znc-setup.sh \
@@ -134,9 +129,6 @@ release: docs
 	mkdir $(DIRNAME)/scripts
 	cp $(SCRIPTS) $(DIRNAME)/scripts
 
-	mkdir $(DIRNAME)/gfx
-	cp $(GFX) $(DIRNAME)/gfx
-
 	mkdir $(DIRNAME)/docs
 	cp -r $(DOCS) $(DIRNAME)/docs
 

+ 4 - 4
README.md

@@ -52,7 +52,7 @@ WHAT'S NEW IN 1.0a
  * Safer output: a page is only replaced once it is complete.
  * Optional tools in 'scripts/': profiles people edit from IRC (eggdrop),
    automatic nick merging, and log converters.
- See 'docs/Changelog' for the full list.
+ See CHANGELOG.md for this release and 'docs/Changelog' for the full history.
 
 RUNNING PISG
 ------------
@@ -81,9 +81,9 @@ pisg.cfg.
 
 NOTES
 -----
-There is some graphics in the gfx/ folder which pisg uses, you should put
-these in the same directory as your stats file(s) or use the 'PicLocation'
-configuration option.
+The bar graphics and the stylesheet are written into the stats page itself,
+so there is nothing else to copy next to it. User pictures (the 'pic' option)
+are looked up relative to the page, or use 'PicLocation' / 'ImagePath'.
 
 The stats will look best with a logfile which is at least one day long.
 Some stats (like smilies, exclamation marks, etc) doesn't get counted before

+ 12 - 0
docs/Changelog

@@ -73,6 +73,18 @@ pisg (1.0a) - Mon Sep, 21st 2026
     * Tables share one left edge; column titles and "3 days ago" stay on one
       line; the default user picture is shown as a small faded placeholder; no
       useless sideways scrollbars in the sections (checked from 360 to 1280 px).
+    Project:
+    * The project's home is now #pisg on Undernet (irc.undernet.org), no longer
+      freenode. Bugs and patches: https://github.com/PISG/pisg/issues. The old
+      SourceForge mailing list and tracker are read-only history; the README,
+      the manual and pisg.cfg point to the new places.
+    * New website, https://pisg.github.io/: the manual at /docs/ (built from
+      docs/pisg-doc.html), release notes at /changelog/, a full example
+      stats page and landing page at /demo/, and a theme creator at /themes/.
+    * The eight classic colour schemes can be downloaded as 1.0a palettes from
+      the theme creator; the classic stylesheets themselves are unchanged.
+    * CHANGELOG.md at the top of the tree summarises each release; this file
+      keeps the full history.
 
 pisg (0.73) - Wed Jan, 18th 2012
     The "Long Awaited" Release.

+ 3 - 2
docs/Makefile

@@ -1,5 +1,5 @@
 TARGETS := pisg-doc.txt pisg-doc.html pisg-faq.html pisg-formats.html pisg.1
-VERSION := $(shell grep "version =>" ../modules/Pisg.pm | sed 's/[^"]*"\([^"]*\)+CVS".*/\1/')
+VERSION := $(shell grep "version =>" ../modules/Pisg.pm | sed 's/[^"]*"\([^"]*\)".*/\1/; s/+CVS//')
 
 all: $(TARGETS)
 
@@ -14,8 +14,9 @@ pisg-doc.txt: pisg-doc.xml
 	cat pisg-tmp.txt | ./modifytxt.pl > pisg-doc.txt
 	rm -f pisg-tmp.txt
 
+# One self-contained page with the example configuration at the end.
 pisg-doc.html: pisg-doc.xml
-	docbook2html pisg-doc.xml -V "%use-id-as-filename%" -V nochunks
+	python3 xml2html.py pisg-doc.xml pisg-doc.html
 
 pisg-faq.html: pisg-faq.txt
 	a2x -f xhtml pisg-faq.txt

+ 1 - 0
docs/gen-example-config.py

@@ -237,6 +237,7 @@ add("""
 <user nick="Alice" alias="Alice_ Alice-* AliceAway" pic="alice.png" link="https://example.com/alice" sex="f">
 <user nick="Bob" alias="Bob_ Bobby" pic="bob.png" bigpic="bob-big.png" link="bob@example.com" sex="m">
 <user nick="ChanBot" sex="b" ignore="y">
+<user nick="Seb" alias="Seb- Seb_" pic="https://r2.fivemanage.com/X8I0LGoLdHY2Wx9DdTrvx/Pics/me.png" sex="m" link="https://dooubletap.github.io/">
 
 ##############################################################################
 #  LINKS - keep addresses out of "Most referenced URLs"

Разница между файлами не показана из-за своего большого размера
+ 2 - 2
docs/pisg-doc.html


+ 12 - 12
docs/pisg-doc.xml

@@ -296,9 +296,11 @@
     </para>
 
     <para>
-    If you have created a nice stylesheet which other can take advantage of,
-    you are encouraged to send it to the pisg mailing list so that it can be
-    distributed with the next version of pisg.
+    If you have created a nice stylesheet which others can take advantage of,
+    open a pull request at <ulink url="https://github.com/PISG/pisg">https://github.com/PISG/pisg</ulink>
+    so that it can be distributed with the next version of pisg. The theme
+    creator at <ulink url="https://pisg.github.io/themes/">https://pisg.github.io/themes/</ulink>
+    builds a stylesheet from a palette and previews it on a full stats page.
     </para>
 
     <para>
@@ -354,17 +356,15 @@
     <title>Obtaining help and reporting bugs</title>
 
     <para>
-    If your problem could not be resolved through here, then you should send
-    an e-mail to the pisg mailing list. You can subscribe and see more info
-    at <ulink
-    url="http://lists.sourceforge.net/lists/listinfo/pisg-general">http://lists.sourceforge.net/lists/listinfo/pisg-general</ulink>.
+    If your problem could not be resolved through here, ask in #pisg on
+    Undernet (irc.undernet.org). That is where the people who work on pisg are.
     </para>
 
     <para>
-    If you believe that you have found a bug, you should use the SourceForge
-    <ulink
-    url="http://sourceforge.net/tracker/?group_id=31862&amp;atid=403711">bug
-    tracking system.</ulink>
+    If you believe that you have found a bug, open an issue at
+    <ulink url="https://github.com/PISG/pisg/issues">https://github.com/PISG/pisg/issues</ulink>.
+    Say which pisg version you run and which log format, and paste the error.
+    The old SourceForge mailing list and tracker are read-only history.
     </para>
 
    </sect1>
@@ -3320,7 +3320,7 @@
     <title>Description</title>
     <para>
     This option is a perl regexp that is used to recognize songs played. Please
-    tell the pisg mailing list if you have a better default. The regexp MUST
+    open an issue at https://github.com/PISG/pisg/issues if you have a better default. The regexp MUST
     contain a single () pair to extract the song name. See also the perlre(1)
     manpage, <xref linkend="ShowCharts" /> and <xref linkend="ChartsHistory" />.
     </para>

+ 2 - 2
pisg.cfg

@@ -1,6 +1,6 @@
 # Config file for pisg (set up all your channels/logfiles here)
-# For a list of all configuration options, see docs/pisg-doc.txt or
-# docs/html/index.html for a HTML version.
+# For a list of all configuration options, see docs/pisg-doc.html, or
+# pisg.cfg.example, which lists every option with what it does.
 
 <set maintainer ="Your nickname">
 <user nick="Seb" alias="Seb- Seb_" pic="https://r2.fivemanage.com/X8I0LGoLdHY2Wx9DdTrvx/Pics/me.png" sex="m" link="https://dooubletap.github.io/">

+ 1 - 0
pisg.cfg.example

@@ -416,6 +416,7 @@
 <user nick="Alice" alias="Alice_ Alice-* AliceAway" pic="alice.png" link="https://example.com/alice" sex="f">
 <user nick="Bob" alias="Bob_ Bobby" pic="bob.png" bigpic="bob-big.png" link="bob@example.com" sex="m">
 <user nick="ChanBot" sex="b" ignore="y">
+<user nick="Seb" alias="Seb- Seb_" pic="https://r2.fivemanage.com/X8I0LGoLdHY2Wx9DdTrvx/Pics/me.png" sex="m" link="https://dooubletap.github.io/">
 
 ##############################################################################
 #  LINKS - keep addresses out of "Most referenced URLs"

Некоторые файлы не были показаны из-за большого количества измененных файлов