Shareware Overload/ShartewareOverload.cdr/wp/rubicon5.zip/MANUAL.7

Text File | 1989-11-08 | 24KB | 547 lines

                __________________________
               |                          |
               |  Section 7: PAGE LAYOUT  |
               |__________________________|


CONTENTS

7.1 Page Styles
7.2 Multiple Columns
7.3 Leading (Line Spacing)
7.4 Headers and Footers
7.5 Layout Printing Sequence
7.6 The Folio (Page Number)
7.7 Vertical Justification
7.8 Widows and Orphans
7.9 Page Layout Over-Rides


7.1 PAGE STYLES

7.1.1 PAPER SIZES

Many of the printers supported by the Publisher will accommodate more
than one size of paper. The Publisher can be adjusted to conform to
the size of paper in use, by means of the tag:
<PAPER long= short=> where
                    long=<D> the long dimension (length or height) of
                    the paper, and
                    short= the short dimension (width) of the paper,
                    specified in any units accepted by the Publisher.

7.1.2 THE PRINTABLE ZONE

Many printers, especially laser printers, are not capable of printing
right out to the edges of the paper: there are "unprintable" areas
along the top, bottom, and sides of the paper, which the printhead
cannot reach. We will refer to these as the "Unprintable Zone", and the
remaining portion of the page as the "Printable Zone". Note that
the unprintable zone forms a frame around the printable zone.

For the HP Laserjet II printer, in "portrait" (normal) mode, there
are normally unprintable strips 0.50 inches wide across the top and
bottom edges of the page, and 0.25 wide along the left and right edges
of the page.

Unfortunately, different models of printer have different unprintable
zones. If the unprintable zone dimensions for the particular printer
in use are unknown, and cannot be determined from the printer manual,
it is prudent to allow for unprintable zones of up to one-half inch
on all sides, when specifying the page layout co-ordinates.

7.1.3 PAGE LAYOUT CO-ORDINATES

All page layout measurements used by the Publisher are measured from the
TOP LEFT CORNER of the paper. This is called the ORIGIN of the page. It
can be regarded as the origin point (0,0) of a Cartesian co-ordinate
system, of which the x-axis, representing rows, extends down the left
side of the paper, and the y-axis, representing columns, extends across
the top.

PAGE ORIENTATION

The normal orientation of printed text on a page is referred to as
"Portrait" mode: the paper is oriented vertically; that is, one of the
short edges is the top. Ordinary text is almost always printed in
Portrait mode.

The alternative page orientation is called "Landscape". When text is
printed in Landscape mode, the paper is oriented horizontally, or
"turned sideways"; that is, one of the long edges is the top, so the
width of the page is greater than its length. This mode is generally
used only if there is some special reason which makes it necessary, for
example if information is being presented in tabular form, and the table
is too wide to fit on the page in normal (Portrait) orientation.

Landscape printing is initiated by the tag <landscape=on>, and cancelled
by the tag <landscape=off>. If this tag is used, it must be read by
the Publisher at the beginning of the file, before any printable text.
It should be followed by one or more <margin> tags, setting all 6
margins, which must also precede any printable text.

(Note: Landscape printing requires landscape fonts.  The soft fonts
supplied with the shareware distribution version of the Publisher are in
Portrait form only.)

The default mode of printing is Portrait; that is, if there is no
<landscape=> tag, the document will be printed in the normal Portrait
orientation.

PAGE INTERIOR

The tag:

<margin top= left= bottom= right= > where
             top= defines the top margin of the page interior
             left= defines the left margin of the page interior
             bottom= defines the bottom margin of the page interior
             right= defines the right margin of the page interior

is used to define four margins around the edges of the page. These
margins in turn define a rectangle called the "Page Interior". The
Publisher prints the main text within the confines of the page interior.
Auxiliary text such as headers, footers, and footnotes may be printed
outside the page interior, for example, in the top or bottom margins.

When specifying margins, it is of course necessary to ensure that the
specified locations (particularly for the right and bottom margins) fall
INSIDE THE PRINTABLE ZONE for the size of paper being used. Note that
all margin locations are measured FROM THE ORIGIN.

EXAMPLE:
<margin top=1.0in left=0.75in right=7.75in bottom=10.0in><qz><R>
defines a page interior 7 inches wide and 9 inches long.

Margins may be specified using any of the units of measurement accepted
by the Publisher. If no units are specified, the values are assumed
to be in Dots (300ths of an inch).

HEADER AND FOOTER DROP

The combination tag:

<MARGIN header=m footer=n>

or the separate tags:

<MARGIN header=m> and <MARGIN footer=n>

are used to define the header-drop m and the footer-drop n, that is, the
locations of the initial baselines of the header and footer; the
distances to drop the print- head, from the top of the page, before
starting to print the header and footer.

Example: the tag <margin header=1in footer=10in> will locate the first
line of the header one inch below the top of the page, and the first
line of the footer ten (10.0) inches below the top of the page.

When specifying header and footer locations, it is necessary to make
sure that they fall INSIDE THE PRINTABLE ZONE. In most cases, it is also
necessary to make sure that they fall OUTSIDE THE PAGE INTERIOR so that
the header and footer will not impinge on the main text. Remember that
the tag <margin header= footer=> specifies the BASELINE for the first
line of the header and the first line of the footer.

In general, the header-drop should be far enough below the top of the
printable zone to leave room for a line of text in the (maximum) font
size being used for the first line of the header, and far enough above
the top of the page interior to leave a reasonable amount of space
between the header and the main text.

Similarly, the footer-drop should be far enough below the bottom of the
page interior to leave room for a line of text in the (maximum) font
size being used for the first line of the footer, plus a reasonable
space to separate the footer from the main text, and should be far
enough above the bottom of the printable zone to leave room for the
entire footer, including any descenders from lower-case letters in the
last line of the footer.

If the header (or footer) consists of more than one line of text, the
definition of the header (or footer) should contain an appropriate
<leading...> tag, to ensure proper line spacing within the header (or
footer).

Normally, the contents of the header are printed entirely above the
page interior, in the top margin, and the contents of the footer are
printed entirely below the page interior, in the bottom margin, with
a reasonable amount of space separating them from the main text. However,
the Publisher has the ability to position items anywhere on the page
while printing a header or footer. For example, it is possible to
place a ruling line between the columns of the page interior, from
a header or footer.

7.2 MULTIPLE COLUMNS

7.2.1 THE COLUMN TAG

The arrangement of text in columns is governed by this very important
tag:

<column...>.

Two alternative procedures are available for specifying a multiple
column layout. The column measure (width) and gutter-width may be
specified, in which case the Publisher will automatically calculate the
number of columns which will fit on a page. Alternatively, the count
(number) of columns and the gutter-width may be specified, in which case
the Publisher will automatically calculate the corresponding column
measure.

7.2.2 COLUMN MEASURE

The first alternative is implemented by the tag:

<column measure= gutter= >   where
             measure= specifies the column measure (width), and
             gutter= specifies the column gutter (space between columns).

The column measure and gutter may be specified with any of the units
of measurement accepted by the Publisher. The tag settings take effect
at the end of the current output line.

At run time, the Publisher will automatically lay out columns and
gutters of the specified dimensions on a page until the space remaining
in the page interior is insufficient for another column, and will
then start a new page. Of course, the specified column measure (width)
must not exceed the width of the page interior.

It is possible to use any column measure which does not exceed the
width of the page interior, but for practical reasons, some choices
are better than others.

Unless blank space is being deliberately preserved to accommodate
illustrations, or for some other reason, it is usually desired to
use all, or at least most, of the page interior for text. Accordingly,
if the page interior is 7 inches wide, a column width of 4 inches
would be a poor choice, since there would be room for only one such
column per page, and more than 40% of the page interior would be left
blank.

7.2.3 COLUMN COUNT

The second alternative is implemented by the tag:

<column count= gutter= >   where
             count= specifies the number of columns per page, and
             gutter= specifies the column gutter (space between columns).

At run time, the Publisher will automatically lay out the specified
number of columns and gutters of the specified dimensions on each
page.

It is possible to use any value for the column count, but for practical
reasons, a value should be chosen which will produce lines of text which
are neither too short nor too long for the size of type being used.
Several narrow columns are easier to read than one very wide column,
provided that each column is wide enough to contain a reasonable number
of words of average length. The proper width for a column therefore
depends on the type size: in general, the smaller the type, the narrower
the columns should be. As an approximate "rule of thumb", the line
length in picas (6ths of an inch) should not exceed twice the type size
measured in points.  For example, a line of 12-point type should not
exceed 24 picas (4 inches).

Of course, the values given by this rule should be regarded as
guidelines, rather than rigid rules. For some documents, it may be
necessary to depart from these values, for a variety of reasons, even
though this will result in some loss of readability. For example, some
kinds of documents set in 12-point or smaller type are routinely
formatted in a single full-width column, much wider than 4 inches, to
comply with custom or tradition, or because such a format is required by
law or government regulation.

7.3 LEADING (LINE SPACING)

Leading (pronounced "ledding") refers to the vertical spacing between
lines of type, measured from baseline of one line to the baseline of the
next.

The tag:

<leading line= para= >, where
         line= defines the inter-line leading or "line spacing", and
         para= defines the inter-paragraph leading or "paragraph
         spacing",

is used to define the vertical spacing between lines and paragraphs.
This tag takes effect at at the end of the current output line. Any unit
of measurment accepted by the Publisher may be used in this tag: if no
unit is specified, the value given will be read as dots (300ths of an
inch).

Line leading is space between output lines, measured from baseline
to baseline. Paragraph leading is an extra amount of vertical space
added between paragraphs. The last line of one paragraph and the first
line of the next paragraph are separated by the normal line leading
plus the paragraph leading (measured from baseline to baseline).

The amount of leading used is to some extent a matter of style: however,
it must be sufficient to ensure that the descenders of one line do
not overlap the capital letters or ascenders of the next line, and
if underlining is being used in the text, additional leading may be
needed to accommodate it. The amount of leading needed obviously depends
on the point size of the type. It may also depend on the typeface:
some styles have longer ascenders and descenders than others.

Naturally, the line leading must be at least as large as the point size
of the type, and preferably somewhat larger.  As an approximate
guideline, a leading 20% greater than the point size is recommended for
small type sizes (less than 12 point); a leading 25% greater than the
point size is recommended for larger type sizes (12 point and up). For
example, the recommended leading for 8-point type is 9.5 points;
the recommended leading for 12-point type is 15 points.

When the type size changes from one line to the next, a value
for the leading between the two lines may be calculated as 1/3 the
leading for the point size of the first line, PLUS 2/3
the leading for the point size of the second line. EXAMPLE:
If one line is in 6-point type and the next line is in 10-point, the
leading between the two lines should be 1/3 x 7
+ 2/3 x 12 = 10.3 points. When the calculated value includes
a fraction, it is prudent to round it up to the next point: 11 points in
the present example.

The leading need not be specified in points: for finer adjustment,
the values in the <leading> tag may be given in dots.

7.4 HEADERS AND FOOTERS

A Header or Running Head consists of one or more lines of text printed
at the top of every page. The contents of the header may be changed from
time to time. Sometimes, there might be no header at all. The header
text may be printed anywhere on the page; it is not restricted to the
top margin above the page interior, although it is normally confined to
that area.

A Footer or Running Foot consists of one or more lines of text printed
at the bottom of every page. The contents of the footer may be changed
from time to time. Sometimes, there might be no footer at all. The
footer text may be printed anywhere on the page; it is not restricted to
the bottom margin below the page interior, although it is normally
confined to that area.

The Publisher does not calculate line breaks or perform paragraphing
inside headers or footers. It is the user's responsibility to place all
desired line breaks inside header and footer definitions.

HEADER/FOOTER POSITIONING

When the header is printed, the printhead starts at co-ordinates
(header-drop,0); when the footer is printed, the printhead starts at
co<148>rdinates (footer-drop,0).

The header- and footer-drop are set via the tags
<margin header= > and <margin footer= >, or the combined tag
<margin header= footer= >
To position header/footer lines after the first line, the interline
leading, line break tags, and alignment instructions can be used.
The positioning of headers and footers is described in more detail
under "Page Layout Co-Ordinates".

HEADER/FOOTER DEFINITION

The text for a header is defined by placing it between the tags

<header>
....
....
....
....
<end>

The text for a footer is defined by placing it between the tags

<footer>
....
....
....
....
<end>

The tags <header>, <footer> and <end> are PUBLISHER DIRECTIVES. Unlike
other tags, a directive must appear by itself on a separate line. That
is, there should be no material whatsoever on the same line as the
directive tag, either before or after it.

Headers and footer definitions may consist of any number of input lines.
Each input line should end with a line break tag (quad tag). Headers and
footers may be defined inside include files.

7.5 LAYOUT PRINTING SEQUENCE

The Publisher goes through the following steps, in the given order,
as it lays out each page.

1. Header. Print the most recently defined header (defined before the
first printable character of the page interior). Note: the header for
the first page must be placed in the initialization sequence.

2. Page Interior. Format and print the page interior, according to the
paragraphing, columning, etc. specified by the user.

3. Footer. Print the most recently defined footer (defined before the
last printed character of the page interior).

There are certain special tags that only function inside headers and
footers. They have no effect in the page interior. See the Folio section
below.

PRESERVED VARIABLES

The following variables are saved before a header or footer is printed,
and are restored afterward. In this way, tag settings in the page
interior will not affect tag settings in a header or footer, and vice
versa.
         font
         direction (horizontal)
         column width
         justification
         para indent
         left indent
         right indent
         interline leading

7.6 THE FOLIO (PAGE NUMBER)

The "folio" is the usual typesetting term for the page number. The
Publisher can automatically print the folio as part of the header or
footer text. The digit representation of the folio can be in Arabic
Numerals (1, 2, 3, 4, etc.) or Roman Numerals (I, II, III, IV, etc.).
Roman numerals may be printed in upper case or lower case letters. The
folio is optional; it can be disabled, or printed at a particular
location, as specified by the user.

The tag for printing the page number is:

<PN> - Print Page Number (Print Folio)

This command may appear anywhere in the header or footer definitions. As
it occurs in an output line, it is replaced by the current page number.
Example: to print the folio at the bottom, center of each page, place
the following code into the footer definition: <PN><QC>

The tag:

<PN=n> -  Set Page Number (Set Folio)

sets the folio number to the specified value n. It will take effect for
the next folio that is printed. The page number will be increased by one
on each subsequent page. In the absence of a <PN=n> tag, page numbering
will start at "1".

DIGIT REPRESENTATIONS

The folio can appear in ordinary Arabic digits (1,2,3...), in uppercase
Roman numerals (I, II, III ...) or in lowercase Roman numerals (i, ii,
iii ...). The digit representation of the folio is controlled as
follows:

<folio roman= case= >
         roman= `1' Roman Numerals; `0' Arabic Numerals
         case= `1' Upper Case Numerals; `0' Lower Case Numerals (only
         applicable to Roman numerals)

If the document in the text file is going to stand alone, the page
numbering will normally start at `1'. However, if it is part of a
lengthy document occupying several files, and if the whole document
is to be numbered continuously when published, the numbering of the
pages in the second and subsequent files will start at values other
than `1'. For example, if the first file of a long document takes
up 11 pages when published, the numbering of the second file would
start at `12'; if the second file, when published, ends at page `21',
the numbering of the third file would start at `22'; and so on.

7.7 VERTICAL JUSTIFICATION

The term Vertical Justification is applied to the process of making a
small alteration in the length of the space occupied by the text; this
is often done to make the text fit into a specified number of pages, or
columns. Such "vertical justification" of a document may be accomplished
by adjustment of such variables as the line leading, the paragraph
leading, the top margin and the bottom margin, to change the number of
lines of text appearing on each page.

EXAMPLE: A document is processed by the Publisher; it fills 4 pages,
and runs over on to a fifth page that contains only 3 lines of text.
This not only has a clumsy, unprofessional appearance, but is also
wasteful, particularly if 5000 copies of the document are going to
be printed. We will assume that the document is being printed in 10-point
type with the optimum line leading of 12 points, which is 50 dots,
that the paragraph leading is also 50 dots, and the page interior
is 9 inches long. The need for the short 5th page can be eliminated
by the simple step of reducing the line leading and paragraph leading
by a single dot, from 50 dots to 49 dots. The reduced leading
is still well within the recommended range for 10-point type: indeed,
the change is so small that it will hardly be visible to the naked
eye; but it will make room for an extra line of text on each page,
so that the document will end one line short of the bottom of the
4th page.

In this Example, the need for a 5th page could also be eliminated
by increasing the length of the page interior to allow an extra line
of text on each page, for example by reducing the bottom margin by
50 dots, or reducing the top and bottom margins by 25 dots each. This
method would be more visible, but may be acceptable in some cases,
provided that it leaves enough space for the header and footer (if
any), and that a minor alteration in margins and page interior is
not otherwise objectionable.

In the foregoing Example, vertical justification was applied to an
entire document, but it can also be applied to part of a document.
For example, the leading of part of the document may be reduced or
increased to change the location of a column break or page break.

7.8 WIDOWS AND ORPHANS

In typesetting parlance, the term orphan is often applied to:

1. The last line of a paragraph, standing alone at the
beginning of a page or column; and

2. A heading for a new paragraph or section, or the
first line of a new paragraph, standing alone at the end of a page
or column.

Orphans look awkward, impair the legibility of the document, and should
therefore be avoided.

An orphan of type (1) can be removed by using vertical justification;
that is, the leading of part (or all) of the document preceding the
orphan can be reduced slightly in order to pull the orphan back into
the preceding column, or it can be increased slightly to push one
or more lines forward into the new column to keep the orphan company.

Essentially the same method can be used to correct orphans of type
(2). That is, the technique of vertical justification may be used
to push the heading (or first line) forward into the next column,
or to pull some text back from the next column.

In typesetting parlance, the short last line of a paragraph, if less
than one-third the normal line length, is called a widow. The
best typsetting practice is to avoid widows. (A widow which contains
nothing but the concluding part of a hyphenated word is particularly
objectionable.) A short widow at the end of a paragraph can generally
be eliminated by Tracking part or all of the paragraph, to pull the
contents of the widow back into the preceding line. A relatively long
widow at the end of a paragraph can generally be eliminated by Expanding
part or all of the paragraph to push additional text into the last
line so that it will no longer be a widow.

7.9 PAGE LAYOUT OVER-RIDES

When a document is being processed by the Publisher, the areas available
for text in a column, and on a page, are defined by the page layout
instructions, and the Publisher automatically starts a new column
or page when the current one is full. However, it is sometimes desirable
to override these automatic functions, and force the start of a new
column or page before the current one is completely full.  This may be
done by  means of the following tags:

<NP> -  New Page. Ends the current line, justifies it using the current
        scheme of justification, and begins a new page.

<NC> - New Column. Ends the current line, justifies it using the current
       scheme of justification, and begins a new column.