[rfc-i] draft-iab-html-rfc-02: references

jhildebr at cisco.com (Joe Hildebrand (jhildebr)) Mon, 29 February 2016 17:35 UTC

From: jhildebr at cisco.com (Joe Hildebrand (jhildebr))
Date: Mon, 29 Feb 2016 17:35:37 +0000
Subject: [rfc-i] draft-iab-html-rfc-02: references
In-Reply-To: <56D1D4C4.1090007@gmx.de>
References: <56D16672.4000708@gmx.de> <0EB37407-B7F1-4022-9822-6D5720D45B8C@vpnc.org> <56D1CFD8.2090909@gmx.de> <017E4EA1-75C5-4891-AC5C-D5ABD845A1D3@vpnc.org> <56D1D4C4.1090007@gmx.de>
Message-ID: <64E8088C-4B3B-4445-B3DF-C673579EEE14@cisco.com>

In the prototype, I have a couple of bugs around preparing the name of <references>.  What I think should happen is that:

<references><name>Informational References</name></references>

Gets prepared to:

<references><name slugifiedName='n-informational-references'>Informational References</name></references>


Which gets turned into this HTML:

<section id="n-references">
  <h2 id="s-4">
    <a class="selfRef" href="#s-4">4.</a>
    <a class="selfRef" href="#n-references">References</a>
  </h2>
  <section id="n-informational-references">
    <h3 id="s-4.1">
      <a class="selfRef" href="#s-4.1">4.1.</a>
      <a class="selfRef" href="#n-informational-references">
        Informative References
      </a>
    </h3>
...


I think if there's an anchor on <references>, it's supposed to replace "n-informational-references" in the HTML.

-- 
Joe Hildebrand







On 2/27/16, 9:54 AM, "rfc-interest on behalf of Julian Reschke" <rfc-interest-bounces at rfc-editor.org on behalf of julian.reschke at gmx.de> wrote:

>On 2016-02-27 17:38, Paul Hoffman wrote:
>> ...
>>> but it's also not what the tools generate today,
>>
>> Right: we're talking about new tools for a new vocabulary
>>
>>> and most likely not what the RFC production center wants.
>>
>> Neither you or I work for the RPC; we can let them comment on what they
>> want.
>
>Please.
>
>>>>>> <section id="n-references">
>>>>>> <h2 id="s-3">
>>>>>> <a href="#s-3" class="selfRef">3.</a>
>>>>>> <a href="#n-references" class="selfRef">References</a>
>>>>>> </h2>
>>>>>> <section id="n-informative-references">
>>>>>> <h3 id="s-3.1">
>>>>>> <a href="#s-3.1" class="selfRef">3.1.</a>
>>>>>> <a href="#n-informative-references" class="selfRef">
>>>>>> Informative References</a></h3>
>>>>>> <dl class="reference">...
>>>>>> </dl>
>>>>>> </section>
>>>>>> </section>
>>>>>
>>>>> This doesn't explain where the ID for the enclosing section comes from.
>>>>
>>>> Which ID are you referring to? Both of those look pretty clear to me,
>>>> but maybe I'm missing something.
>>>
>>> It's not clear where they come from; from the source document? Are
>>> they automatically inserted?
>>
>> They are automatically inserted by the prep tool, as described in
>> section B.2.1 of the v3 vocabulary document.
>
>OK, I missed that, sorry.
>
>What's not clear then is where the value of an anchor attribute on 
><references> would end up.
>
>Best regards, Julian
>
>_______________________________________________
>rfc-interest mailing list
>rfc-interest at rfc-editor.org
>https://www.rfc-editor.org/mailman/listinfo/rfc-interest