[REQ] Element IDs in the web specification

It was thus said that the Great Brian Evans once stated:
> I would like to link to the `text/gemini` portion of the spec for a
> project I am working on. However, there are no IDs on any of the elements.
> This makes it impossible to link someone directly to a section. :(
> 
> If this can get updated it would be much appreciated. I am trying to link
> it as additional information for non-technical users... so linking to the
> full spec might be overwhelming.
> 
> I know it has been brought up before to separate text/gemini from the
> protocol spec, and just thought I would float that here again...

  On the plus side, there are two RFCs (RFC-5147 and RFC-7111) that define
URI fragment semantics to particular resource types.  Downside, they don't
directly apply to text/gemini.

  One method would be to use verbatim text as the ID, starting from the
start of the line.  So for your use case:

gemini://gemini.circumlunar.space/docs/specification.gmi#%235%20The

the fragment portion, decoded, would be "# 5 The" (note:  the '#' here is
encoded as %23).  The client would then scan through the document in
question looking for a line that starts with "# The" and position the
document accordingly in the window/viewport/terminal.

  The second method would be to adapt the one for text/plain (RFC-5147).

  The two methods have the advantage of not modifying text/gemini and could
be a convention of clients util some method clearly beomces the winner.

  -spc

---

Previous in thread (1 of 3): 🗣️ Brian Evans (b__m__e (a) mailfence.com)

Next in thread (3 of 3): 🗣️ Brian Evans (b__m__e (a) mailfence.com)

View entire thread.