[Oberon] Re (2): Re (2): suggestions for documentation.

[peter at easthope.ca]

From:	Jan Verhoeven <jan at verhoeven272.nl>
Date:	Thu, 3 Apr 2014 09:48:54 +0200
> In HTML the ultimate format is defined 
> by webbrowser, screen parameters, window parameters. 

Exactly!  The principle of local browser responsibility 
for presentation, which is appropriate for many requirements. 
But not the only possibility.

> In a PDF I can force MY format.

And HTML has the preformatted element.
http://www.w3.org/TR/html-markup/pre.html
For example, it can be used to make a facsimile of a 
historical document, possibly within a contemporary document.
"Preformatted" tends to be abused when browser responsibility 
for presentation is not understood.  Sorry to be repetative 
but the concept is important.  Some additional examples are here.
http://www.w3.org/wiki/HTML/Elements/pre

> For technical matters, especially the kind where there is 
> a sequence in figures and text, ...

Such as 
http://en.wikipedia.org/wiki/Multiview_orthographic_projection ?
As an exercise, view it on desktop system, then on a 
laptop and then on a smart phone.  The page is legible 
in all three environments.  Then on your desktop, make 
a screenshot of the page or part of it.  Save as PDF 
or JPG or PNG.  Then try to read the result on the smart 
phone.

> ... sequence in figures and text, ...

That is a part of the subject of styling and is discussed here.
http://www.w3.org/wiki/Floats_and_clearing
http://www.w3.org/wiki/CSS_static_and_relative_positioning

> For entertainment purposes, HTML will do just fine. For technical 
> matters, ...

Are pages such as these entertainment or are they technical 
documents?
http://en.wikipedia.org/wiki/Multiview_orthographic_projection
http://www.ocp.inf.ethz.ch/wiki/Documentation/Installation
I can't make the distinction.

Regards,           ... Peter E.

-- 
123456789 123456789 123456789 123456789 123456789 123456789 123456789 12
Tel +1 360 639 0202  http://carnot.yi.org/  New address Bcc: peter at easthope. ca