Reference · SemText · Definitions & citations

`<sem-references>`

SemText element

You wrap one sem-reference per source. Numbers come from position. With JavaScript off the list still reads as an ordinary numbered list.

A numbered list of sources the document cites. You wrap one sem-reference per source. Numbers come from position. With JavaScript off the list still reads as an ordinary numbered list. `footnotes` | `bibliography` (free token; these two get distinct styling). Optional.

(required; on each `sem-reference`): the citation target — the global `id`.

(optional; on each `sem-reference`): external location (`data-href` in the class form).

(optional; on each `sem-reference`): short citation label (`RFC 6749`).

Example

sem-references.html

source

              
              <p>Rotate refresh tokens per use<a href="#r-rfc">[1]</a>.</p>
            
              <sem-references id="refs" kind="bibliography" role="list">
            
                <sem-reference id="r-rfc" role="listitem"
            
                     href="https://www.rfc-editor.org/rfc/rfc6749" cite="RFC 6749">
            
                  The OAuth 2.0 Authorization Framework, §10.4.
            
                </sem-reference>
            
                <sem-reference id="r-note" role="listitem">
            
                  A footnote with no external target.
            
                </sem-reference>
            
              </sem-references>

render

Live render boots with JavaScript — the authored source is alongside.

variant: no kind — the plain numbered list

The base display: CSS counters number the entries 1-based in DOM order in every tier, JS-off included. The container here carries no `kind`, so it gets the default spacing rather than the bibliography hanging indent. The second entry has no `href` — a note with no external target, which never grows the external-link chrome.

variant: no kind — the plain numbered list

sem-references-default-kind.html

source

              
              <p>Rotation follows the provider guidance<a href="#r-oidc">[1]</a>.</p>
            
              <sem-references id="refs-default" role="list">
            
                <sem-reference id="r-oidc" role="listitem" href="https://openid.net/specs/openid-connect-core-1_0.html" cite="OIDC Core 1.0">
            
                  OpenID Connect Core 1.0, §3.1.3.7 — rotating refresh tokens.
            
                </sem-reference>
            
                <sem-reference id="r-internal" role="listitem">
            
                  Internal runbook: token rotation window, ops wiki.
            
                </sem-reference>
            
              </sem-references>

render

Live render boots with JavaScript — the authored source is alongside.

variant: kind="footnotes" — compact list

The compact display for notes tied to nearby prose: tighter margins than the default, unlike the hanging-indent bibliography. Authored citation text is never renumbered — `[a]` and `[b]` stay as written; only the entries themselves carry the CSS counter. Rendered panes also append backlinks (`↩`) to any entry the prose cites; JS-off the list still numbers and `:target` still highlights.

variant: kind="footnotes" — compact list

sem-references-footnotes.html

source

              
              <p>Migrations run before the swap<a href="#r-fn-1">[a]</a>; the drain window is 90 seconds<a href="#r-fn-2">[b]</a>.</p>
            
              <sem-references id="refs-notes" kind="footnotes" role="list">
            
                <sem-reference id="r-fn-1" role="listitem">Schema first, image second — the Liquibase changeset lands in the same release train.</sem-reference>
            
                <sem-reference id="r-fn-2" role="listitem">Readiness gate holds at 90 s; the zero-ready window is expected under a Recreate rollout.</sem-reference>
            
              </sem-references>

render

Live render boots with JavaScript — the authored source is alongside.

Source: spec/schema/sem-references.md