|


















|
SECTION
2: STRUCTURE
6 Underlying
structure
When structuring a document, the writer needs to consider
the best ways of ordering the information presented to suit the readers’
needs, and how to make that underlying structure clear. Different types
of text, such as discursive, narrative or instructional, will require
different approaches to their structure. Reference works that are not
intended to be read sequentially have other kinds of structure again.
The mode of delivery of a publication has a strong impact on how it will
be structured. Print publications have physical characteristics such as
size and sequence of pages, as well as conventionally placed parts such
as the table of contents, chapters and index, that allow readers to orient
themselves. The writer of electronic publications cannot rely on these
features and, while being able to encourage a more flexible approach to
the contents, must make sure their readers do not get lost in the process.
These differences do not make the print and electronic modes incompatible,
but it is important to be aware of them especially when planning documents
that are intended to be published in both modes. The following paragraphs
present some of the most important structural issues to consider.
6.1
Structural hierarchy
Print-delivered texts present information sequentially.
The means of ordering may be thematic, procedural, alphabetical or chronological.
Electronic texts can make use of short sequences for simple instructions,
but are less well suited for extended sequences because it is harder for
readers to locate themselves.
Ideally, electronic texts should combine depth with breadth either through
a hierarchical or Web-like structure. Such designs allow the reader to
follow distinct themes, while keeping sight of the overall structure of
the document they are reading.
| Sequential
structure |
Hierarchical
structure |
Web–like
structure |
 |
 |
 |
6.2 Headings
The headings in a publication should be worded to give
a clear indication of the subject areas covered. The heading hierarchy
should be clearly indicated by consistent methods such as type weight
and contrast, colour or enumeration systems, as it serves as a means of
indicating the overall scope and structure of the document. No more than
four levels of headings are usually necessary – any more can be
confusing for a reader by making them lose sight of the larger context.
Enumeration is particularly useful in texts that are not intended to be
read sequentially, as typographically based hierarchies might be overlooked
by someone arriving in the middle of a section.
Headings are often hyperlinked in electronic texts to provide a pathway
through particular topics. For on-screen material, the Style manual
(p 138) recommends that there be a maximum of 200 words between each heading,
so that readers are able to see at least one heading on their screen at
any time (see
para 4).
7 Segmentation of text
The paragraph is the basic unit of composition within
any text. Each paragraph needs to have its own coherence. Often it will
be introduced by a topic sentence, which tells the reader what it is about,
and then this will be developed by accumulation of evidence, or logical
argument, or some other way that holds the reader’s attention, until
the end leads the reader to the next topic in the next paragraph. Careful
transitions between paragraphs are crucial in showing the reader which
way the argument is going or how the material is being developed, and
the relation between each paragraph and the next as the writer explores
various aspects or develops a linear argument.
In a print publication the length of each paragraph is variable, as long
as it constitutes a coherent unit. Long paragraphs cause a problem for
screen reading because of the disorientation caused by having to scroll,
and the difficulties of having to read extended text on screen.
Lists can be
a useful alternative as a unit of composition in both print- and electronically
delivered text. They serve to highlight key points and break up the density
of text with the use of white space. This allows certain material to be
visually highlighted.
8
Navigation
Both print and electronic material share the need for navigational
devices to show the reader how to find particular parts of a publication,
how one part relates to another, and where they are within the text. Print
publications provide means of searching via tables of content and indexes,
which are conventionally placed at the beginning or end of the publication,
and so are easy to find. They have orientational devices in the form of
page numbers and running headers/footers that give information such as
chapter title and author name. Electronic publications can make use of
some of these devices, but present a different set of challenges for those
designing and writing them.
8.1 Electronic
navigation
The ability to hyperlink to locations both within and
outside a document is an important feature of electronic publications.
It allows the reader a great deal of flexibility and access to a wide
range of information. At the same time this flexibility can create confusion
– the reader might follow a link out of the document they were originally
in without being aware of it. Navigational devices must therefore signpost
where a reader is as well as where they can go from there. Here are some
of the options that can be used to perform these functions:
- proprietary logos
or other forms of identification to distinguish between different publications
- site maps that
give readers an overview of the structure of a publication and links
to different parts of it
- hyperlinked menus
to give readers a range of related pages they can move onto
- hyperlinked text
that can take readers to further information related to specific words
or phrases
- navigation bars
that orient the reader within a document.
Navigation bars can
be of various types. They can send the reader to different points within
a particular page. They can point to the next page in a sequence, or back
to the homepage. Special navigation bars known as breadcrumb
bars even show the route the reader has taken through the publication
to their current point.


[illustration of Web page showing range of navigational devices]
8.2
Indexes
An index gives the reader a means of finding particular
information in a publication and following up related subjects and their
various aspects. The work of indexing does not begin until the page numbers
are in their final form and will not be affected by any more changes in
the text.
Usually the main headings (concepts, technical terms, names of people
and organisations) are listed alphabetically following the word-by-word
arrangement. This means that in compound words, whether hyphenated or
not, each word is ordered separately. For example:
New England
New South Wales
Newcastle
The space in New
England takes precedence over the c in Newcastle.
Subheadings define particular aspects of a major concept or subject area
and are arranged in a new alphabetical sequence under the main heading.
Indentation is used to set off subheadings and sub-subheadings.
All main headings and subheadings should begin with a lower case letter
unless they are proper nouns, and should be followed by a comma and then
the page reference. When there are several page references for one entry,
each is followed by a comma except the last, where no punctuation is used.
It is not necessary to use p and pp before the page numbers. For example:
Content
influence of, 2–3
questions, 185–6
texts in, 3–5, 16
Cross-references
are indicated by see and see also,
which are always in lower case italics. They do not lead readers to a
reference in the text but to other entries in the index. Knowing when
to cross-reference and when to double index (that is, index the same page
numbers at two different headings instead of using cross-references) is
part of the skill of indexing.
The Style manual gives detailed information on the art and skill
of indexing, including aspects of alphabetical arrangement, when and when
not to use computer programs, writing an introduction to the index, deciding
how many indexes to have, and contracting an indexer.
8.3 Search
engines
Electronic publications can have their own kind of indexes
in the form of internal search engines. These normally work on keywords
within the text, so writers should consider what are the key subjects
or concepts that readers will be looking for in the publication, and employ
appropriate terminology.
Most websites are discovered through Web searches using search tools such
as Google, Altavista and Yahoo. These operate by searching webpage titles
as well as metadata, which is information about the site
included within the coding of a website, rather than the text itself.
Those publishing on the Web should include metadata to make sure their
site is easily locatable. For example, the following line of HTML code
shows the keywords incorporated into the Macquarie University homepage:
<META NAME=”Keywords”
CONTENT=”Macquarie, University, Australia, teaching, learning,
innovation, education, research”>
9.
The formal parts of a book
There are no specific rules about what should be included
in a book or the sequence of those parts. Not all books have the same
parts, but the Style manual recommends the following:
- half-title page
- reverse of half-title
page
- title page
- imprint page (bibliographical
details, copyright notice, publisher’s name and address, list
of editions or reprints, ISBN/ISSN, CIP, name of editor, designer, photographer,
illustrator, printer’s imprint)
- foreword
- list of contents
- list of illustrations
(plates, figures, diagrams, tables, maps)
- preface
- acknowledgments
- summary
- introduction
- text
- appendixes
- abbreviations
or acronyms
- reference list,
endnotes or bibliography
- index.
For reports and other
major official publications, the normal sequence is:
- title page
- imprint page (copyright
notice, ISBN/ISSN, CIP, disclaimer if any, printer’s imprint)
- letter of transmittal/Secretary’s
statement
- terms of reference
- membership of
reporting body
- list of contents
- abbreviations
or acronyms
- summary of conclusions
and recommendations/executive summary
- introduction
- report or text
- conclusions and
recommendations in full
- appendixes
- references
- index.
Not all items in
the above lists will appear in every publication.
See Chapter 13 in the Style manual for further information.
9.1
The parts explained
- The foreword,
unlike the preface and the introduction, is outside the text. Generally
it is written by someone other than the author, to briefly explain purpose
and direction.
- The table, or
list, of contents should set out the main sections of the preliminary
pages, the text and the endmatter, followed either directly, or on the
next right-hand page, by lists of plates, figures, diagrams, tables
and maps, in that order. Subsections of the text may also be listed.
- In the preface,
the author may state the purpose of the book and information about its
preparation, including thanks and acknowledgments unless these are set
out separately. A note should also be made of any new edition or reprint.
In a series, the general editor may wish to write a preface.
- If the introduction
relates to the purpose and production of the book, it should be numbered
with the prelims in roman numerals. If it relates to the subject matter
as part of the text, it should be numbered with arabic figures.
- Appendixes usually
have additional information about topics covered in the main text.
- A bibliography
and/or list of references may be presented as a continuous list or may
be broken up into subject or other groupings.
- An index is an
alphabetical listing of subjects, names, events and other key items
contained in the text of a book.
10.
Graphic material
Tables and illustrations provide effective ways of summarising
or highlighting pieces of information in both print and electronic modes,
making them particularly suitable for bimodal publications. See Chapter
19 of the Style manual for detailed comment and examples, and for the
use of tables in screen layout.
10.1 Tables
Some points:
- Tables should be
set out as clearly and simply as possible. Column headings should be
appropriate and figures should tally.
- If there are only
a few tables, they may be included in the copy exactly where they occur.
Otherwise, they can be separated out and submitted as a batch of hard
copy for the typesetter.
- Tables should always
be numbered, and references to them in the text can then be made in
terms of these numbers – for example, Table 8
rather than the above table. At NCELTR they
are numbered sequentially throughout – for example, Table
18, Table 24 and so on, rather
than separately for each chapter – for example, Table
2.6 for the sixth table in the second chapter. The table
should appear as near as possible to where it is mentioned in the text.
- Any qualifying
information following the heading, or notes after a table, should be
clearly shown as belonging to the table and not to the text.
- Full stops are
not used after headings for and within tables and figures.
The following is an example
of a badly set out table and how it can be improved.

10.2
Illustrations and captions
The preparation of photographs, illustrations and other art material such
as graphs and maps is described in detail in the Style manual.
Discussion of the design and printing of illustrations forms an important
part of the production process (see
Section 6).
Illustrations are usually numbered as figures. At NCELTR they are numbered
sequentially throughout. When a figure is referred to in the text, ‘Figure’
is not abbreviated – for example, In Figure 25 we see
the scale … – but if the reference is in parentheses,
the short form is used – for example, The scale (Fig
25) …
Sometimes, as well as the numbering sequence for figures, there can be
separate numbering sequences for tables or for graphs, charts, maps etc.
Caption copy, usually provided by the author, should be edited to conform
with the style of the text. It is important to check that:
- all tables, figures
etc are correctly numbered
- the numbers match
up with each reference to the tables and figures in the text
- the numbers and
captions match up with those in the lists of tables and figures.
Captions are usually
set in a smaller type size than the text and are usually in italics
or bold. A caption does not require a full stop unless
it includes a full sentence.
All graphs should be identifiable by title. To be fully comprehensible,
both axes need to be adequately captioned, with each caption followed
by the symbol of the units in which it is expressed, in parentheses.
11 Copyright
and defamation
The following material is based on Chapter 22 of the Style
manual, which recommends that authors, editors and printers seek
advice from the Attorney-General’s Department when specific legal
problems arise. However, the department cannot advise on publishing practice.
11.1
Copyright
The law of copyright in Australia, set out in the Copyright
Act 1968 (as amended), confers certain rights on authors of original
material. The merit of the work is not relevant: it may be a computer
program, a table of figures, or a literary work. What matters for copyright
is that the work be original – that is, the result
of the author’s skill and labour. Copyright protects the work, but
not the information and ideas in it.
The rights of copyright owners include the right to copy or reproduce
the work in a material form, to publish it, to adapt or translate it,
and to broadcast it. These rights arise as soon as the work is created.
No application or registration is required. However, the symbol ©
must be displayed with the name of the copyright owner and the year of
first publication.
The owner of copyright is usually the author of the material. However,
if the author is an employee, the copyright owner is usually the employer
unless there is an agreement to the contrary. Publishers own the copyright
in the edition of works published by them, and permission must be sought
from them before a work, or part of it, is reproduced, as well as permission
from the owners of copyright in the artwork or text.
A copyright owner can assign the whole of the copyright to another person
or can divide it up, or it can descend, on death, by will or intestacy.
Copyright continues to exist in a published work for 50 years after the
author’s death, or, if the work is published after the author’s
death, for 50 years after publication. The 50 years is calculated from
the end of the relevant calendar year.
Copying a work, or a substantial part of a work, without
the authorisation of the copyright owner is the most common form of infringement
of copyright.
Under two international conventions, overseas works are protected in Australia
under Australian law, and Australian works receive protection in other
countries who are members of those conventions, under their law.
11.2
Electronic copyright
It is commonly assumed that material published on the World
Wide Web is in the public domain and not governed by the same rules of
copyright as other published material. For this reason extra care should
be taken in protecting original material with a copyright notice, and
ensuring that you are not making use of any electronic material that has
been copyrighted.
Providing a link to someone else’s website will not normally infringe
their copyright, but permission should be sought as a courtesy. The contents
of any websites to which you have provided a link should be regularly
checked, to make sure you are not giving implied endorsement to inappropriate
content or material that infringes copyright.
The Copyright Act 1968 has been reformed to address the issue
of electronic reproduction of material. The relevant Act is Copyright
reform: ‘Copyright Amendment (Digital Agenda) Act 2000’.
11.3
Defamation
Defamation relates to any statement, spoken or written,
which tends to lower a person or corporation in the estimation of ordinary
reasonable people. The statement must be published to a third person,
and liability for the defamation falls on the author, the publisher and
the printer.
Defamation can occur even if it was not intended, or if a reasonable mistake
was made, or if the person is taken to be referred to even though not
identified by name.
There are four main defences that allow the publication of defamatory
material: absolute privilege (statements made under parliamentary privilege);
qualified privilege (where publication is not made with any improper motive
or in bad faith); truth of the imputations held to arise from the published
material; and comment on matters of public interest (so long as it is
based on facts commonly accepted as true). However, the legal interpretation
of these defences is restricted and complex. |
 |