Raul's latest html changes are now on the website. On Wed, Sep 22, 2021 at 10:15 AM chris burke <[email protected]> wrote:
> This looks good, thanks. > > The html help source is in repo https://github.com/jsoftware/docs_help . > > Originally we planned to continue the html help into j901, but then > decided to freeze it at j807. As a result there were some unused j901 > changes in the repo. > > I reverted the repo back to j807, and added your changes which can be seen > in the updated page at https://www.jsoftware.com/help/dictionary/dqco.htm > . After refreshing the browser, there will be a "caution" link at top right. > > You can experiment with this using the repo. When all the repo changes are > made, I will update the website. > > Note that updating the repo does not automatically update the website. > > On Tue, Sep 21, 2021 at 9:00 PM Raul Miller <[email protected]> wrote: > >> Ok... this might take a few iterations before we have something we can >> agree on. >> >> As a first draft, I visited >> https://www.jsoftware.com/help/dictionary/dqco.htm in chrome and used >> right click Save As... with Format: Webpage, Complete and saving it >> under the name dqco.htm on my machine. >> >> Then, I went into the resulting dqco_files folder and edited the copy >> of jdoc.css there, adding a line at the bottom: >> >> .caution {float: right} >> >> I also created a javascript file named caution.js in that folder with >> this content: >> >> let firstHR= document.getElementsByTagName('hr')[0]; >> let newAnchor= document.createElement('a'); >> let newHref= document.createAttribute('href'); >> newHref.value= 'https://code.jsoftware.com/wiki/Vocabulary/ObsoleteSyntax >> '; >> newAnchor.setAttributeNode(newHref); >> let newClass= document.createAttribute('class'); >> newClass.value= 'caution'; >> newAnchor.setAttributeNode(newClass); >> newAnchor.appendChild(document.createTextNode('caution')); >> document.body.insertBefore(newAnchor, firstHR); >> >> Finally, I added to the bottom of my local dqco.htm file as the >> second-to-last line: >> >> <script src="./dqco_files/caution.js" ></script> >> >> This gives me a caution link in the upper right hand corner of that >> page which links to the obsolete syntax page. >> >> Keep in mind that this is only a first draft and some of this would >> obviously have to change before it could be used for real. >> >> Key questions to consider: >> >> (1) Does this look suitable from a user perspective? >> >> (2) Does this procedure look close to plausible from an admin >> perspective? (Would it be preferable to add the corresponding html >> fragment before the first hr? Or is this separation of concerns closer >> to ideal?) >> >> (I was looking at doing this entirely in css, but adding links to html >> documents via css is considered an "exploit" -- javascript is >> considered "more secure" than css.) >> >> (3) How do we decide which pages should get this proposed update? >> >> Thanks, >> >> -- >> Raul >> > ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
