Re: [Xml-sg-cmt] index question

Hi, 
Just an update here regarding item b below (index in the text output) -- relevant ticket: https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/610

Please speak up if you have any objection to the proposal in comment 3. Essentially, it is to use the section number (in all 3 formats) -- without the word "Section".  And for HTML & PDF that section number is a link to the exact location of the iref (so it could be a paragraph-specific link).

For example:

I-D (draft-ietf-extra-imap4rev2-30.txt) contained:
   T
      TEXT (part specifier)  95
      TEXT <string> (search key)  84
      TO <string> (search key)  84
      TRYCREATE (response code)  111

Proposal from Jennifer:
   T
      TEXT (part specifier)  6.4.5.1
      TEXT <string> (search key)  6.4.4
      TO <string> (search key)  6.4.4
      TRYCREATE (response code)  7.1

where "6.4.5.1" would be a paragraph-specific link to 
rfcNNNN.html#section-6.4.5.1-5
(Example: https://www.rfc-editor.org/v3test/test-index-ietf-extra-imap4rev2-30.html#section-6.4.5.1-5)

Thanks,
Alice

> On Mar 12, 2021, at 2:24 PM, Sandy Ginoza <sginoza@amsl.com> wrote:
> 
> Hi team,
> 
> draft-ietf-extra-imap4rev2-30, which is currently in our queue, contains an index.  As noted in ticket 603, xml2rfc crashes when making the PDF file.  Temporarily, we have removed “$” from the <iref>s so we’re able to create the PDF.  
> 
>   https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/603
> 
> Please note I changed the priority of 603 to critical (it’s not yet a blocker).
> We also see <https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/418> related to index.
> 
> Looking at the index in the output files, we have a few questions/comments.  See
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.html#name-index
> 
> a) Does the index look as expected?  The terms appear twice, once as text and once as a link.  
> 
> b) In the text, the index is formatted differently.  Also, I think the index needs to be present so the content in the various outputs is the same, but the index is essentially useless because there are no links and no page numbers.  
> 
> c) The index does not appear in the toc; I’ll file a ticket for this. 
> 
> 
> Partially formatted v3 files are here: 
> 
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.html
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.pdf
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.txt
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.xml
> 
> 
> Thanks,
> Sandy
> 
> 
> -- 
> Xml-sg-cmt mailing list
> Xml-sg-cmt@ietf.org
> https://www.ietf.org/mailman/listinfo/xml-sg-cmt