Re: [xml2rfc] Imaginary vspace?

[Brian E Carpenter <[e-mail]>]

> What did you want to express with the horizontal rule?

Nothing at all, I suspect. I was just trying to fix up an early version of a draft by a newcomer to kramdown, and it included that line.

Regards
    Brian

On 22-Jun-23 09:29, Carsten Bormann wrote:
> On 21. Jun 2023, at 22:50, Brian E Carpenter <[e-mail]> wrote:
>>
>>>> It's kramdown-rfc that adds the vspace.
>>>> Use of `-----------` in line 74 is the line that adds the space.
>>>> I couldn't find any documentation on kramdown-rfc about adding vspace this way.
> 
> In markdown, `———` on a line of its own, surrounded by vertical blank space, is a horizontal rule (<hr in HTML).
> (There are a few similar syntaxes to do the same [1].)
> 
> There are no horizontal rules in RFCXML, so I used this syntactic element to indicate a page break, which has a similar separating function in paginated documents to what you would be trying to achieve with a horizontal rule in HTML.
> 
> The way to effect a page break in RFCXMLv2 was to do a large vspace (e.g., with 999 lines).
> This is what you see here.
> 
> RFCXMLv3 does not provide the author with functionality to influence page breaks (*), so the v2v3 converter we employ to generate RFCXMLv3 throws out the page break (and correctly indicates in a warning that it is simply not doing as told).
> 
> What did you want to express with the horizontal rule?
> 
> Grüße, Carsten
> 
> [1]: https://kramdown.gettalong.org/quickref.html#horizontal-rules
> 
> (*) at least not directly for creating page breaks; there is a keepWithNext and a keepWithPrevious attribute, weirdly only on <t, which can be used to avoid a page break in specific places.
> I have not spent time to check whether there is another trick in xml2rfcv3 that could be employed to create a page break.
>