more documn updates

This commit is contained in:
Philip Sargent 2023-01-27 01:11:17 +00:00
parent 89b3603db5
commit 04b7b1d549
2 changed files with 9 additions and 4 deletions

View File

@ -13,13 +13,18 @@
<ul>
<li><a href="#why">Why</a>
<li><a href="#prop1">Proposal #1</a>
</ul>
<h2>Update - January 2023</h2>
<p>This has now been done. All logbooks use the same format now and we have only one parser.
<h2 id="why">HTML formats - Why we need changes</h2>
<p>There is an advnatgae in using a "separator format" rather than a "encapsulated entry format". When parsing the logbook.html file, everthing will be in one of the entries if we use a separator (e.g. &lt;hr&gt; as opposed to a &lt;article&gt; ... &lt;/article&gt; encapsulation). Stuff between encapsulations is probably meant to be in an adjacent entry. So we are continuing to use the &lt;hr&gt; separator format style.
<hr />
<h2 id="why">HTML formats - Why we needed changes</h2>
<h4>Maintenance workload</h4>
<p>We have 4 different markdown and HTML formats for logbooks of different vintages. This means 4x as much maintenance as we need.
<p>We <s>have</s> had 4 different markdown and HTML formats for logbooks of different vintages. This means 4x as much maintenance as we need.
<code><pre>LOGBOOK_PARSER_SETTINGS = {
"2010": ("logbook.html", "Parseloghtmltxt"),

View File

@ -165,7 +165,7 @@ complete copy, but if universal internet access is coming anyway, any such work
<ul>
<li>New systems for <a href="namesredesign.html">handling people's names properly</a>
<li>New systems for <a href="menudesign.html">website menus</a>
<li>New <a href="lbredesign.html">logbook coding system</a> - not at all urgent
<li><s>New <a href="lbredesign.html">logbook coding system</a> </s>
<li><s>Short-term note on "logon" <a href="trogregistr.html">django-registration</a></s>
</ul>
<p>Open architectural issues being worked on: