Re: [xml2rfc] help request: suggestions for reconstructing the Tao ToC for use in RFC

[Niels ten Oever <[e-mail]>]

On 11-01-2024 22:47, Kesara Rathnayake wrote:
> On Fri, 12 Jan 2024 at 10:21, Niels ten Oever <[e-mail]> wrote:
>>
>> Thanks a lot Kesara,
>>
>> The problem is that we need a ToC _only for the annex_ (which is the last archival version), not the whole document.
>>
>> Any suggestions how we could do that?
>>
> 
> I think this has to be done in the prepped version of the XML.
> So start with markdown without a ToC,
> kramdown-rfc draft-retirement.md > draft-retirement.xml
> xml2rfc --preptool draft-retirement.xml # generate prepped document
> # make ToC changes in draft-retirement.prepped.xml
> xml2rfc --text --html draft-retirement.prepped.xml
> 

Tremendously helpful - thank you!

Best,

Niels

>    --Kesara
> 
>> Best,
>>
>> Niels
>>
>> On 11-01-2024 22:18, Kesara Rathnayake wrote:
>>> Hi Niels,
>>>
>>> Regarding errors with ToC, remove the ToC from markdown file.
>>> xml2rfc automatically generates the ToC for you.
>>>
>>> Cheers,
>>> Kesara
>>>
>>> On Fri, 12 Jan 2024 at 08:22, Niels ten Oever <[e-mail]> wrote:
>>>>
>>>> Hi all,
>>>>
>>>> I am at a bit of a loss here and would appreciate some guidance.
>>>>
>>>> Greg Wood and I have been working on reverting the html tags that make the ToC work in the current web-version of the Tao, to a ToC that would work in an RFC, but only at the end of an RFC, because we want to create an archival version of the Tao as an annex to a possible Tao tombstone draft.
>>>> But we are a bit at a loss as how to create a working ToC of the headings in the archival version of the Tao?
>>>>
>>>> We are currently working in this document: https://github.com/ietf/tao/blob/main/draft-retirement.md
>>>>
>>>> I am getting a lot of complaints from xml2rfc that <vspace/> is removed, but I am not sure what to replace it with?
>>>>
>>>> All suggestions are very much welcomed!
>>>>
>>>> Thanks in advance,
>>>>
>>>> Niels
>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> Niels ten Oever, PhD
>>>> Co-Principal Investigator - critical infrastructure lab - University of Amsterdam
>>>> Assistant Professor - Department of European Studies - University of Amsterdam
>>>>
>>>> W: https://criticalinfralab.net
>>>> W: https://nielstenoever.net
>>>> PGP: 4254 ECD5 D4CF F6AF 8B91 0D9F EFAD 2E49 CC90 C10C
>>>> _______________________________________________
>>>> xml2rfc mailing list
>>>> [e-mail]
>>>> https://www.ietf.org/mailman/listinfo/xml2rfc
>>>
>>>
>>>
>>
>> --
>> Niels ten Oever, PhD
>> Co-Principal Investigator - critical infrastructure lab - University of Amsterdam
>> Assistant Professor - Department of European Studies - University of Amsterdam
>>
>> W: https://criticalinfralab.net
>> W: https://nielstenoever.net
>> PGP: 4254 ECD5 D4CF F6AF 8B91 0D9F EFAD 2E49 CC90 C10C
> 
> 
> 

-- 
Niels ten Oever, PhD
Co-Principal Investigator - critical infrastructure lab - University of Amsterdam
Assistant Professor - Department of European Studies - University of Amsterdam

W: https://criticalinfralab.net
W: https://nielstenoever.net
PGP: 4254 ECD5 D4CF F6AF 8B91 0D9F EFAD 2E49 CC90 C10C