Re: Problematic indentation in HTML output of makeinfo

[Thomas Keller]

Am 22.11.09 20:15, schrieb Patrice Dumas:
> On Sun, Nov 22, 2009 at 07:47:52PM +0100, Thomas Keller wrote:
>>
>> Apparently texi2html makes this better, though the indentation is
>> "emulated" as HTML table here, which could be hacked around, but is
>> still not optimal. Actually I think there is little to no reason to
>> render the indentation "hard" at all, CSS' `margin-left` and
>> `padding-left` properties should be enough for everyone adding the
>> correct padding afterwards. And the CSS box model already takes care of
>> proper indentation on different levels, because the margins of all outer
>> boxes add up.
> 
> The issue is that it doesn't allow for imbrication of 'preformatted' styles.
> For example
> 
> @example
> 
> The example
> 
> @display 
> this part is displayed
> @end display
> 
> End of the example
> 
> @end example

Its not clear to me what you mean by "imbrication" - makeinfo creates
the following HTML for that:

<pre class="example">
     The example
     <pre class="display">          this part is displayed
</pre>

     <p>End of the example

</pre>


(note the unmatched <p> at the end - is this another bug?)

If I remove the unwanted whitespace from this example, then you're
right, all contents are shifted to the left by default - but hey, thats
why we have CSS, right? Putting

pre { margin-left: 3.2em; }

in the style definition gives us back the original 5 whitespace
indentation between the inner and the outer preformatted area.

> Also other kind of nesting wouldn't be that good if the indentation was done
> for each preformatted fragment. For example for a @multitable in @example,
> I think that it is better to indent the whole @example and not the 
> individual preformatted fragments in the @multitable. To be honest, this is
> not clear that this is correct texinfo, but such constructs happen in 
> manuals.

Can you give me a specific example?

Thanks,
Thomas.

-- 
GPG-Key 0x160D1092 | address@hidden | http://thomaskeller.biz
Please note that according to the EU law on data retention, information
on every electronic information exchange might be retained for a period
of six months or longer: http://www.vorratsdatenspeicherung.de/?lang=en

signature.asc
Description: OpenPGP digital signature