Notes on Martin's use of JS - online edit of handbook/computing/hbmanual1.html

This commit is contained in:
Philip Sargent 2024-12-28 16:12:01 +00:00 committed by Philip Sargent
parent c6c1fdb22b
commit 31be79ac80

View File

@ -61,10 +61,15 @@ This covers all files and names, not just just the handbook pages. Other parts o
<li>We are using <a href="https://www.w3schools.com/html/html5_intro.asp">HTML5</a> and
<a href="https://developer.mozilla.org/en-US/docs/Web/CSS">CSS3</a> but a great many pages still use obsolescent tags such as &lt;font&gt;. These are being removed whenever a page is edited.
<li>All the pages use a single CSS stylesheet <a href="/css/main2.css">/css/main2.css</a>.
<li>We do not use any javascript framework: just HTML and CSS. You may come across historic references to jquery but this is not used.
<li>When editing webpages, use <a href="https://www.freeformatter.com/html-entities.html">HTML entities</a> for characters with umlauts, e.g. <var>&amp;ouml;</var> for &ouml;.
<li><em>Only</em> use a <a href="https://en.wikipedia.org/wiki/UTF-8#Encoding_process">UTF-8 encoding</a> if there is no HTML entity available, e.g. biohazard: <span style='font-size:30px;'>&#9763;</span> which is written as <var> &amp;#9763;</var>
<li><em>Only</em> use a <a href="https://en.wikipedia.org/wiki/UTF-8#Encoding_process">UTF-8 encoding</a> if there is no HTML entity available instead, e.g. biohazard: <span style='font-size:30px;'>&#9763;</span> which is written as <var> &amp;#9763;</var>
</ul>
<h4>Javascript</h4>
<ul>
<li>We do not use any javascript framework: just HTML and CSS.
<li>You may come across historic references to jquery <strike>but this is not used</strike> and this is used sparingly, e.g. to provide editing buttons on some fo the data entry forms. (We use the Django-provided copy of jquery which is embedded in the /admin/ part of Django.)
<li>We use CaveView (Javascript) and may be using CodeMirror and/or TinyMCE for editing HTML online.</ul>
<h4>Automated formatting</h4>
<ul>
<li>When any .html page is loaded by troggle it replaces all the <em> &lt;head&gt;...&lt;/head&gt; </em> material with the expo standard header. So don't put anything in the header of any page you edit as it will be ignored. This is also where troggle inserts the <a href="/css/main2.css">/css/main2.css</a> standard stylesheet.