/[public]/psiconv/trunk/docs/html4
ViewVC logotype

Annotation of /psiconv/trunk/docs/html4

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2 - (hide annotations)
Sun Oct 3 21:10:47 1999 UTC (24 years, 5 months ago) by frodo
File size: 3163 byte(s)
Imported sources

1 frodo 2 This README provides information about the psiconv HTML4 output generator.
2    
3     Output files generated using the option `-t HTML4' use cascading style sheets
4     (CSS1) with embedded style rules to specify all text formatting information,
5     rather than using the more commonly-used HTML version 2.0 and 3.2 elements such
6     as <FONT>, <B>, <CENTER> etc. Output files can thus only be properly displayed
7     on the more recent web-browsers such as Netscape 4.x and IE 4.0, but the output
8     is a much more accurate conversion from the original Psion document than is
9     possible with HTML 2.0 or 3.2. Browsers that do not support cascading style
10     sheets will show the text but no character or paragraph formatting.
11    
12     Output files that do not contain user-written HTML constructs should comply
13     with W3C's HTML 4.0 Strict DTD [not checked yet; anj 20-Jun-1999].
14    
15     The text on the first line of the document header is used as the page title.
16    
17     Hard page-breaks are converted into a horizontal rule <HR>. Unfortunately in
18     Netscape 4.51 any text following in the same paragraph loses its styling, so
19     this should really only be used at the end of a paragraph.
20    
21     Paragraph borders using the types dot-dash and dot-dot-dash are converted to
22     dashed and dotted respectively, as these two Psion types do not have a direct
23     equivalent in HTML 4.0. However Netscape 4.51 only seems to display borders as
24     solid, and in only one color (black).
25    
26     Netscape also doesn't seem to handle superscript and subscript properly using
27     the style sheet approach, so the reason these don't work is due to their bug,
28     not mine.
29    
30     Bullets are supported, but the output is not quite the same as on the Psion.
31     HTML lists don't allow you to pick your own character for the bullet like the
32     Psion does (you could use an image of the relevent character, but you'd have to
33     create it on-the-fly to get the right foreground color for full support), and
34     they're not particularly straight-forward to use, so I don't.
35    
36     Short HTML constructs such as hyperlinks and images can be entered in the Word
37     document by using the Psion characters CTRL+139 and CTRL+155 (the single
38     angle-quote characters lsaquo and rsaquo), which are converted into < and >
39     respectively in the output file. Longer constructs such as tables would
40     probably interact with the paragraph formatting to the detriment of both,
41     although if kept "on one line" (ie within a single Psion paragraph) they may be
42     feasible.
43    
44     The only major facilities provided by Psion Word that are missing from the
45     HTML4 output are support for tabs and embedded objects. Tabs look to be
46     impossible to implement properly because HTML does not provide an equivalent
47     construct (tables are not suitable for anything other than superficial support.
48     The classical typewriter model of tabs needs to know the current print position
49     in order to work out which tab stop to align to next; the print position of a
50     particular character will depend upon the font in use). Embedded objects need
51     the relevent stream formats to be documented and suitable converters
52     implemented (embedded Sheet files could be converted into tables, and Sketches
53     into inline images).
54    
55     - Andrew Johnson <anjohnson@iee.org>

frodo@frodo.looijaard.name
ViewVC Help
Powered by ViewVC 1.1.26