<-- Title of Article -->

<-- Title of Section -->

[skip to content]

Meta-section: Sample of Hypertext-format Article using HTML Template

This is an example of many types of markup used in the template. This particular paragraph is of type disco for discussing the format of the article, as distinguished from the content.

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).

  1. 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.

  2. <-- Second Subsection -->

    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.

  3. About the References

    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?

This is a navigational note that refers to another part of this article that it could make sense to read now.


References

References for works cited in this text chunk appear below. References for all works cited are available in a separate chunk.

Blustein & Noor (2004)
James Blustein and Mona Noor. Personal glossaries on the WWW: an exploratory study (Hypertext). In Proceedings of the 2004 ACM Symposium on Document Engineering (Milwaukee, Wisconsin, USA, October 28 - 30, 2004). ACM Press, New York, NY, pp. 54–56.
<URL:http://doi.acm.org/10.1145/1030397.1030409>.
Notes:
  1. The article is listed as a hypertext version in 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.
  2. An author's pre-print is available at <URL:http://users.cs.dal.ca/~jamie/pubs/HTML/DocEng04/>.
Blustein (2005)
J. Blustein. Dual Presentation Redux Example. Version Monday, 05-Dec-2005 18:32:36 AST.
<URL:http://users.cs.dal.ca/~jamie/course/CS/4173/Materials/examples/JS/dual-redux/dual-redux.shtml>.
This is an example of an annotation in the bibliography. The <dt> the follows the annotation should include the attribute value class="postann" for browsers that don't understand CSS's + selector.
Kolb (2004)
David Kolb. Twin media: hypertext structure under pressure. In Proceedings of the Fifteenth ACM Conference on Hypertext and Hypermedia (Santa Cruz, CA, USA, August 09 - 13, 2004), pp. 26–27. ACM Press, New York, NY.
<URL:http://doi.acm.org/10.1145/1012807.1012817>.

[Up to navigation links]