around the property
instance.
* html2ps will normally indicate the generated link by inserting a
page number after it. To suppress that, add "noxref":
'propname'
(The way this works is that the addlinks script copies the "noxref"
to the tag it generates, and html2ps looks at that tag.)
************
Value types
************
There are three types of value types:
(1) Key words
(2) Basic
(3) Other
Each Value specification in a property definition will include
some combination of these three.
- Basic values will be delimited by single < marks. (E.g., )
and will link to their definitions in syndata.src
- Other values will be defined below the property definition. They
will be indicated by single < marks *and*
by . They will link to their definitions.
MarkUp all value definitions with:
value
* You cannot put any s
inside the around the value definition.
Note that the name attribute is first.
MarkUp all value instances with:
value
* You cannot put any s
inside the around the value instance.
The "value" in the text may be marked up (e.g., <value>)
This will generate the same thing with an A element around the inner
span:
value
* html2ps will normally indicate the generated link by inserting a
page number after it. To suppress that, add "noxref":
value
************
Indexes
************
* Index markup appears within a element or a element.
* Definitions are marked up with class="index-def"
[Decided in NYC] The content of index definitions should be
marked within ..
* Non-definitions are marked up with class="index-inst".
* The title attribute determines the index keys:
a) title="keyword" produces in the index:
...
keyword, n
...
where n refers to the nth appearance of that keyword
in the index. If keyword is a definition, n will be
rendered specially
b) title="keyword::subkey" produces in the index:
...
keyword
subkey, n
...
c) title="keyword1|keyword2" puts both keywords in the index.
* You may have as many alternate entries in a span as you want,
separating all of them with a "|".
* You may only have one level of subkey (i.e., a::b::c is illegal).
For example:
mydef text
mydef text
mydef text
* If the title attribute is not set, the span content goes in the
index (alphabetized) and links to the marked-up source. This
practice is supported, but discouraged since markup may appear
in the content.
* This markup is converted into an anchor during processing. However,
the processor looks to see whether an anchor has already been
defined within the span and reuses it if it has. Thus,
..
will work, as will any markup that generates an anchor
with "name" set. (the index is processed after the other stuff).
* You may not, however, embed index markup. You don't need to,
however, since the "|" mechanism allows any number of index
keys at the same place.
* [TODO] In the printed version, the links are printed as page
numbers.
************
Examples
************
* In accordance with the HTML spec, use uppercase for
HTML element names and lowercase for HTML attribute names.
* Markup CSS examples with the classes "example",
"deprecated-example", "illegal-example".
* Markup HTML examples with the classes "html-example",
"deprecated-html-example", "illegal-html-example".
* Markup XML examples with the classes "xml-example",
"deprecated-xml-example", "illegal-xml-example".
* Indentation of examples? [HAKON TODO]
**********
References
**********
* References. *All* references to WWW pages, books, etc. will appear in
a single file: refs.src. Each reference entry will contain
an anchor whose name has the prefix "ref-". If the reference is to a
document online, the URL of the document will be displayed as well
as linked to (for printing).
References in refs.src should either be marked normative
or informative and should be specified in the proper section.
A normative reference is marked as class="normref":
[FLEX]
"Flex: The Lexical Scanner Generator", Version 2.3.7, ISBN 1882114213.
An informative reference is marked as class="informref".
Please put the "name" attribute before the "class" attribute.
All references within the rest of the specification will point to
the appropriate entry in references.src. These links should have the
following syntax:
[[SYMBOL]]
or
[[-SYMBOL]]
The latter forces the reference to be informative ('informref').
This will automatically be expanded to something like:
[SYMBOL]
Note the appearance of class="normref" | class="informref"
at the end of the anchor start tag. It is possible to
have an informative link to a normative reference, but you
should not have a normative link to an informative reference.
You can check to see that links to refs.src are ok with respect
to normref/informref by running "make checkrefs".
**********
Document HEAD
**********
CSS2 Specification
CSS2 Specification
**********
Images
**********
Style guidelines from From Bert:
*Choose one font (Helvetica or Helvetica Narrow)
*Choose three colors (black, white, red)
*Choose two line thicknesses (1px, 3px)
*Choose two line styles (solid, dotted)
*Choose two image sizes (large: as wide as the page, and small: half as
wide)
*If one of us turns out to be a good cartoonist, we can liven up the
pictures a bit with one human or animal figure per picture, and maybe
even one or two free-hand curves, but better not force ourselves
here.
*Images should be centered (in a )
From Chris:
Ian wrote:
> As I begin to think about replacing ASCII art with
> images, I would like to raise the following issue: what
> tools/formats do we use for these images?
Whatever tools are handy and do the job correctly. As to formats,
bitmapped images should be available in PNG and GIF for paletted images
and JPEG for suitable 24bit images; we should also retain a lossless master
image (24bit PNG). If the artwork was generated from a vector format, the
vector master should also be retained.