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

Joe Hildebrand (jhildebr) jhildebr at cisco.com
Mon Feb 29 09:35:37 PST 2016


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


More information about the rfc-interest mailing list