This is an example of many types of markup used in the template.
This particular paragraph is of type
for
discussing the format of the article, as distinguished from the
content.
disco
Text such as <-- First Subsection -->
are
placeholders which are meant to be replaced by your text.
Most of the links in this example do not work. The template was adpated from an article by Blustein & Noor (2004) (the details of which are below).
This is the first paragraph in the body of this section. It is typically an introduction to what follows or a summary of background and motivation that is necessary to understand what follows. My personal style is to start each sentence in the HTML file on a new line.
This is a marginal note.
Marginal notes
are not, strictly speaking, part of the
body of the text:
Readers should be free to ignore them without becoming confused.
The exact position of the marginal note in the source (HTML file) may need to be pragmatically determined.
This is the second paragraph in the body of this section. If this were an actual article, and not just a template, then it would contain more detail about the content of this section than are in the first paragraph.
This is the second subsection in this section.
Note that each subsection is numbered automatically.
The numbering is done by making each heading (and its following
paragaphs, etc.) inside <li> and
</li>, and all of the body of the section
inside <ol> and </ol>.
I expect that modern HTML editing tools (such as Composer and Dreamweaver) support editing the text (i.e. the interesting part of the article) separate from the markup. Such editing facilities will, I expect, make it much simpler to write a WWW-based scholarly hypertext article than the purely-manual method I used way back in 2004. Other tools, such as TinderBox and XSLT-based applications, can be programmed to generate HTML from slightly marked-up text.
In the interest of making each section easier to read alone, I
included references to each citation from the section in the
section itself.
This made for a lot of extra typing (or cutting and
pasting
).
David Kolb (2004) used a different, and quite beautiful,
approach:
He made links directly from the sections to his references list
and used a combination of JavaScript and CSS
to make a link from the publication details to the citation.
That method can be made slightly more elegant by using
JavaScript to alter CSS properties (Blustein, 2005).
By the way, did you notice that the citation links in the previous paragraph appear as ordinary text until the cursor is in the paragraph? And that the link colour is not as bright as the blue used for other links?
References for works cited in this text chunk appear below. References for all works cited are available in a separate chunk.
hypertext versionin the Appendices and Supplements (in accord with the prevailing ACM policy at the time of publication) although it is a stand-alone article that was separately reviewed.
<dt> the follows the annotation should
include the attribute value class="postann" for
browsers that don't understand CSS's
+ selector.