expoweb/folk
2024-12-16 12:50:31 +00:00
..
i
l
to-do
author.htm
folk-0.csv
folk-1.csv
folk-2.csv
folk.csv
index.html
mosaic.htm
mosaic.jpg
README.txt

Convert the folk.csv to fold/index.htm like this:
$ cd :expoweb:/folk
$ python ../scripts/make-folklist.py <folk.csv >index.htm

This does some basic validation: it checks that the mugshot
images and blurb HTML files exist.

*** See current outstanding re-design proposal at /handbook/troggle/namesredesign.html ***

Troggle *also* reads the mugshot and blurb about each person.
It reads it direct from folk.csv
It does this when troggle is run with 
python3 databaseReset.py people

but only do that when testing folk import, it leaves the database in a bad state. 
You always need to finish with
python3 databaseReset.py reset
which re-imports everything

Troggle generates its own blurb about each person, including past expeditions and trips
taken from the logbooks (and from parsing svx files ?)
A link to this troggle page has been added to folk/index.htm 
by making it happen in make-folklist.py

Troggle scans the blurb and looks for everything between <body> and <hr
to find the text of the blurb
(see :troggle:/parsers/people.py)

All the blurb files have to be .htm - .html is not recognised by people.py
and trying to fix this breaks something else (weirdly, not fully investigated).

There seems to be a problem with importing blurbs with more than one image file, even those the code
in people.py only looks for the first image file but then fails to use it.

There are 19 people for which the troggle name parsing and this folklist parsing
are different. Reconciling these (find easily using a link checker scanner on the
folk/.index.htm file) is a job that needs to be done. Every name in the generated
index.htm now has a hyperlink which goes to the troggle page about that person. Except 
for those 19 people.

PENDING
this is planned to be split:
folk-1.csv will be for old cavers who will not come again, so this file need never be touched.
folk-2.csv will be for recent cavers and the current expo, this needs editing every year

The year headings of folk-1 and folk-2 need to be accurate , but they do not need to be
the same columns. So folk-2 can start in a much later year.

folk-0 will be for awkward buggers whose attendance spans decades. This needs updating whenever
one of these lags attends:
AERW, Becka, Mark Dougherty, Philip Sargent, Chris Densham, Mike Richardson

Currently (July 2023) the software ignores folk-0, -1, -2 and you will need to use the old folk.csv for 
the 2023 expo. But we hope to have this fixed next year...