Reference · NPL

`<npl-directive>`

NPL element

You write the instruction, and optionally a longer note, inside this element. The page shows it as a small chip the reader can spot while scanning.

Marks a short instruction inside a sentence, so it stands out from the prose. You write the instruction, and optionally a longer note, inside this element. The page shows it as a small chip the reader can spot while scanning. required; the emoji or symbol leading the chip. Rendered by `.npl-directive-glyph` (dropped, gracefully, when absent) and mirrored to `data-glyph` when non-empty.

one of `directive` | `prefix`. A `prefix` chip renders the `➤` arrow between glyph and instruction, the prefix form's source grammar. Mirrored to `data-kind` (resolved value).

optional; a trailing label beside the instruction, rendered by `.npl-directive-qualifier` and mirrored to `data-qualifier` when non-empty.

per the global attribute catalog (conventions.md §2)

Example

npl-directive.html

source

              
              <npl-directive glyph="🔮" kind="directive" qualifier="style">
            
                be terse | because the reader is skimming
            
              </npl-directive>

render

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

variant: kind="prefix"

The prefix form of the source grammar — the ➤ arrow renders between glyph and instruction.

variant: kind="prefix"

npl-directive-prefix.html

source

              
              <npl-directive glyph="⚡" kind="prefix">cite sources</npl-directive>
            

render

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

variant: minimal

Glyph and instruction only — no qualifier, no elaboration.

variant: minimal

npl-directive-minimal.html

source

              
              <npl-directive glyph="🔒">never print secret values</npl-directive>
            

render

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

Source: spec/schema/npl/npl-directive.md