expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2025-12-07 14:24:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

enlarged text on troggle folk data importing - online edit of handbook/computing/folkupdate.html

Browse Source
This commit is contained in:
Philip Sargent
2025-10-22 17:04:26 +01:00
committed by Expo on server
parent 4d141b63bd
commit 180eae16ac
1 changed files with 27 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
handbook/computing/folkupdate.html
View File

@@ -65,14 +65,39 @@ package.
<p>In the folk.csv file there are two fields for mugshot and bio (blurb): the mugshot is typically either "i/john-mugshot.jpg" "i/2025/john-mugshot.jpg" and the blurb field is "l/john-bio.html" [changed in 2025]. If it is an HTML file, then that file can contain links to several photos as well as containing biographical details: roles in organising expos, CUCC committee positions etc. <p>There is an example template for this biog file in folk/l/_template.html which shows you how to use the HTML idioms for figures and captions in the context of a troggle page. This bio is viewed by clicking on the person's name in the folk page, but is also copied and displayed as part of the troggle page on the person which includes the list of survex files and logbook entries they appear in.
<h4>Readme</h4>
<p>The script and CSV file also have a <a href="/folk/README.txt">README.txt</a> file in the folk folder which contains more
detailed coding notes re interactions with other troggle code.
detailed coding notes re interactions with other troggle code, but is somewhat out of date!.
<h3>Troggle folk data importing</h3>
<p>
Troggle reads the mugshot and blurb about each person.
It reads it direct from folk.csv which has fields of URL links to those files.
It does this when troggle is run with
<code>python databaseReset.py people</code>
[NOTE: the code in the troggle import parser <var>parsers/people.py</var> contains a <em>duplicate</em> of the <var> make-folklist.py</var> and these two different files need to be kept in sync.]
<p>
Troggle generates its own blurb about each person, including past expeditions and trips
taken from the logbooks and from parsing svx files. So the troggle blurb is more informative than the static blurb linked from the index.html file produced by the script.
A link to this troggle page has been added to folk/index.htm
by making it happen in make-folklist.py
<p>
Troggle scans the blurb and looks for everything between &lt;body&gt; and &lt;hr&gt;
to find the text of the blurb
(see <var>parsers/people.py</var>)
<h3>Issues:</h3>
<p style="margin:20px">
<ul>
<li>The 2025 code and csv format update which allows both mugshots and blurbfiles to exist independently is not properly populated yet in the folk.csv file.
</ul>
<h4>History</h4>
<p>This bizarre Folk update process is a relic of the pre-troggle "<a href="../website-history.html">script and spreadsheet</a>"
phase of the Expo website.
Another relic is <a href="../troggle/scriptsqms.html">the complex QM process</a>.
All these will eventually be merged into troggle - we hope. At the moment (July 2024), it is not run by a database reset and must be done manually.
All these will eventually be merged into troggle - we hope. At the moment (Oct. 2025), the folk script is not run by a database reset and must be done manually.
<hr /></body>
</html>