Theo Todman's Web Page - Notes Pages
Website Generator Documentation - Database Objects
(Text as at 13/01/2015 19:07:41)
(For earlier versions of this Note, see the table at the end)
Most of the papers in this website are made up of hyperlinked Notes, which are small sections of text which themselves link to other Notes, and so on. Such documents are supposed to be viewed on-line, but I recognise that not everyone likes to read in this way. In particular, while this is a good way of chasing up details of an argument, it can be difficult to see the overall picture. It is also difficult to scribble in the margins of a web-page. So, printable versions will be required until technology for marginal annotation improves (but note that you can copy and paste my printable versions into MS Word and annotate those if you want to save trees).
There are several parameters (explained below) that are accounted for in the file-name of the printed Note:-
There are, in general, hyperlinks to an appropriate selection of printable Notes that satisfy these options.
- The depth of scan.
- Whether the Printed Note is archived.
- Whether all inter-Note references are indicated.
- Whether Private Notes are printed.
- Whether Reading Lists are included.
Within the printable note itself, there are no “inter-Note” hyperlinks, though the links to external websites and to Book and Paper summaries within the reading lists work.
A straight print of a frames-based page only prints the first page, which is why most professional sites have printable versions of their pages to allow printing of the full document, and without the other frames interfering. My printable pages do this, of course, but the main difficulty is to print the footnotes (pages hyperlinked to within the site: I don't make any attempt to print the results of linking to external sites).
Printing all the footnotes associated with the main Note precisely once in a sensible sequence is a particular challenge. This is firstly because (intentionally or otherwise) a referential loop may occur. Secondly, we don't want to print the same note more than once if it is referred to on multiple occasions (which is part of the point of having separable notes in the first place). Finally, we don't necessarily want to print Notes when they first appear, but in some sort of sensible sequence.
Depth of Scan
To address the first of these problems, I have introduced a depth of scan, so that we don't loop endlessly. This also allows topics to be looked at in greater or lesser depth. Consequently, several printed Notes may appear for the same underlying Note. Also, where a Note in another Notes Group is referenced, I only print the Note itself, not its footnotes. This is to avoid the printed Notes ballooning with irrelevancies.
Secondly, I only print footnotes once within any particular printed Note. There are two options. In the first, all the footnote indicators appear as in the on-screen version as superscripts (subscripts in the case of private notes which don’t appear on the published website), but those that are duplicated refer forward or backward to where the footnote actually appears. Since this can lead to a lot of clutter in certain circumstances, I have an alternative view whereby (for a footnote that's "not printed here") both the subscript / superscript and the “Note forwarding Note” are omitted. There are then gaps in the sequencing of the superscripts. I’ve decided to leave this in to alert the reader to the existence of the omitted references. The alternative “all footnotes showing” view can be consulted it required.
The referencing convention is effectively the Tractatus standard, but with full-stops separating the level of references. So, the 5th footnote on the main form appears as Footnote 5: (Title); the 3rd footnote on that note appears as Footnote 5.3: (Title2); the 7th footnote on that note as Footnote 5.3.7 (Title3); and so on.
Deciding when to print a Note is an art in itself. Currently all I do is print the Note in the place in which it appears as high up the hyperlinking hierarchy as possible. I ought probably to take into account the fact that each Note has encoded a “Natural” parent, and print it below that parent where possible; but I’ve not done this yet.
The Notes pages are dynamic, but each time a Note is changed, the previous version is archived and can be accessed by a hyperlink at the bottom of the Note. This version crystallises the view at that time (ie. all the Notes linked-to from that archived Note are the currently latest archived versions; to achieve this, a Note is archived as soon as it is entered. The printable versions follow this pattern, and earlier versions archived whenever the main Note is changed (this is still work in progress as I can’t store printable versions of all Notes, to any depth, each time anything within range changes. Or at least I don’t think so.)
There are two “privacy” systems in operation. The first allows me to flag a Note as private, in which case a polite message appears on the public site. The second method is to put the Note in a password-protected area. I have a flag that allows printed Notes to include or exclude “flagged as Private” Notes. I think a Note in the secure area would print if it were referred to by a Note from a non-Secure area.
Some Notes have associated reading lists. These arise either because the Note (or a referenced Note within the depth of scan) directly references a Book or Paper, or indirectly via the association between the Note Title, and the Sub-Topic of the Books and Papers. A list of papers (together with hyperlinks to the Paper or Book summaries within the website is produced. This element is currently under development, as the lists (in author sequence) are very long. Currently, a reference appears if it is directly cited, or priority 1-3 within the first level of hyperlinking, or priority 1 below that. Consequently, I’ve allowed the Notes to be printed with or without reading lists.
Note that all this is an on-going research project.
Previous Version of this Note:
Summary of Note Links to this Page
To access information, click on one of the links in the table above.
Authors, Books & Papers Citing this Note
||Thesis - Thesis - The Form of the Argument
Text Colour Conventions
- Black: Printable Text by me; © Theo Todman, 2017
- Blue: Text by me; © Theo Todman, 2017