Theo Todman's Web Page - Notes Pages
Website - Outstanding Developments (2014 - June)
(Text as at 04/07/2014 22:46:34)
(For other versions of this Note, see the tables at the end)
Rationale for this Document
- My website has evolved over time, and some parts are more active than others. Some haven’t been looked at (by me) for years.
- I have known of various problems for some time, and they have been queuing for development awaiting my time / enthusiasm.
- My focus has always been content before form. However, it’s form that catches the eye. So, the site needs a makeover.
- I’ve also used rather primitive HTML techniques – whatever’s simplest.
- I have started to document my website and the site-generator. The results are currently in a password-protected area. The functional documentation is very rudimentary, but the technical documentation – in the form of the actual code with hyperlinks between routines, and links to the tables and queries used – is wonderful (even if I say so myself) – something Microsoft should have supplied.
… Technical Documentation
- Undertake a trawl through the code for all functions within the generator – making improvements for efficiency and function.
- Supply rudimentary functional documentation as a spin-off from the above.
- Undertake a trawl through all (categories of) web-page, making aesthetic improvements, and correcting content.
- Standardise to HTML5.
- Ensure FN referencing within Notes and referencing between Abstracts and Notes works for archived Notes.
- Add more content to the photos pages.
- Improve error-recovery where encoding fails for Notes links. Mainly where one of my bespoke tags (ie. plusplus or plusN2) doesn’t match with its corresponding anti-tag (ie. plusplus or Nplus).
- Review the effectiveness of the categorised reading lists for both Papers and Books.
- Enable reproduction of archived “Printed Notes”.
- Standardise on “Write-ups” for Paper Abstracts – so, change the routines and database elements that enable the display of Paper Abstracts and Book-Paper Abstracts to accommodate this.
- Solve the problem of the size limitation for Notes by allowing their concatenation.
- Consequently, remove all large “Comments” that have been utilised to expand Paper (and Book?) abstracts.
- Enhance my backup routines to allow pruning of the backup disk itself, and easier location of items to restore.
- Web Spider
- Use the Spider to “prune” redundant pages.
- Analyse the results of the data collection exercise and design a plan of campaign to fix broken links and prevent recurrence,
- Complete investigation into broken “External Links”. See if I can get JSpider to work (or utilise some of its code) to check the links.
- Correct the code so the discovered problems don’t recur, and
- Fix the historical data (no simple task to automate).
- Delete “orphan pages” that are never linked to.
- Fix bugs in multi-level footnoting in Printable Notes – the referencing is going wrong.
- Investigate the use of RTF in memo fields, so that I can get round the 64k character limit.
Further Priority Items
- Review effectiveness of hyperlinking method in the light of PhD and Philosophy of Religion experience.
- Investigate Note_Links: needs versioning, and section of calling Note. Currently, the section called is often incorrect.
- Add easily-visible "quality markers" to Notes.
- Add “Date Created” to Note-Links (for audit purposes; I’m still not convinced that links disappear when they should).
- Determine why very long printable notes (eg. Level 3+ for Note 1703) are being truncated.
- Very long pages (eg. Concatenated Notes and Book Paper Abstracts) fail to render correctly in Firefox (mostly OK in other browsers). Investigate whether it’s possible to subdivide them.
- Check (in use) that the optional "don't print" feature for specific footnotes doesn't print other footnotes further down the chain. Probably OK.
- Add "Specific", "Contextual" & "General" Notes as an optional footer to all Notes. I think this is important – part of the difficulty in understanding some philosophers is knowing what their background assumptions are, as this influences what they take to be “obvious” or “a given”.
- Create automatic key-word referencing (ie. to Notes in the Notes-Group "Personal Identity").
- Improve flexibility of password-protected areas (ie. multiple areas, with different log-ons).
- Allow the option to concatenate Notes in the Printed version (ie. linearly embed them essay-style), rather than treating the hyperlinks as footnotes – but still keep the hyperlink & cross-referencing in place. The difficulty here is the need for linking passages to make the text run smoothly.
- Fix "American" date formats in Electronic Resources page + add scrolling titles.
- Improve flexibility of reading lists attached to printable version of Notes (different sort orders, priority items only, etc).
Items Completed in 2Q14
- Created multiple secure areas on my website, so that Documentation is no longer hiding under my Supervision Notes.
- Created the facility for Author Narratives.
- Added extra linkages between pages (eg. on Author).
- Wrote routines to import old (but missing) archived Notes into the database so they can be (and have been) re-exported in the current format.
- Used a clone of my Spider routines to create a backup and restore system.
Items Completed in 1Q14
- Created a “Website Regeneration Dashboard” to show when the various elements of my website have been refreshed, and how long the routines took to run. Links to this appear in the footer to each webpage.
- Improved the regeneration routines for the various classes of webpage, and got them to record statistics in support of the above.
- Repaired / updated my Website site-map.
- Made a lot of improvements to my Site generators, in particular the pesky bug that stopped the links to archived Notes working correctly.
Items Completed in 3Q13
- Enhancements to "Books & Papers Collection Categorised" Pages
- "Single Image" development for Notes
- Allowed "Authors Works Lists" to be linked-to from Notes
- Created Archived Notes Re-Export facility
- Converted Tables to CSS3 standard
- Re-engineering Monthly Reporting on Change of Year
- Re-engineered Time-Recording, so that actuals are held against Papers (and Books) in a separate table, rather than as columns by year in the Papers / Books tables themselves. Retained the grand totals only.
- Simplified / Re-engineered Notes processing
- Sorted conflicts between Subject, Topic & Sub-Topic IDs
- Used CSS in all manually-crafted and automatically-generated pages
- Improved linkages between Book/Paper Lists and Summaries or Abstracts
Items Completed in June 2013
- Some pages render oddly in Chrome (and maybe other browsers) – investigated4.
- Reduced the size of photos (to make the pages quicker to load).
- Improved the linkage between Papers and Books.
- Improved error-recovery where encoding fails for links to Books, Papers and Authors. That is, where one of my bespoke tags (eg. +B5) doesn’t match with its corresponding anti-tag (eg. B+).
- Wrote the Code Documenter.
- Created a code & query archive facility as part of the above.
- Created “Consolidated Bridge Results” webpages.
- Developed "Books by Location" Pages
- Improved "Concatenated Notes" production
- Improved "This Month's Summary" Reporting
- Improved Quarterly Reporting
- Merged Philosophy & Bridge Databases
- Replaced macros with code.
- De-bugged the Spider.
Items Completed prior to June 2013
See separate document6 (which requires updating).
In-Page FootnotesFootnote 2: Naturally, I can’t say precisely what I mean, by using a plus-sign, as it causes the process to fail!
Footnote 4: Fixed – it was very long blank-free URLs in the Source column. I now call my “WebRef” function to convert these to hyperlinks.
Footnote 5: Naturally, I can now say precisely what I mean, by using a plus-sign, as it no longer causes the process to fail!
Live Version of this Archived Note
Table of the 3 Earlier Versions of this Note
Table of the 8 Later Versions of this Note
Summary of Notes Links from this Page
To access information, click on one of the links in the table above (if any).
Summary of Note Links to this Page
To access information, click on one of the links in the table above (if any).
Text Colour Conventions
- Blue: Text by me; © Theo Todman, 2018