Validation-plus: advise "@xml:id" and "@label" on divisions

Aperta
#3,076 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
xml
Ambito
tooling

Direzione di ricerca

The check belongs in pretext-validation-plus.xsl; read how its existing context-dependent checks are written, and read #1061 and #2991 for background on why Schematron was retired. Add an advisory message for division elements that lack xml:id or label, keeping the wording non-authoritative as the issue asks. Done when a sample document with an unlabelled, unidentified division produces the message and one with both attributes does not.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Carried forward from #1061, which requested this as a Schematron warning; Schematron was retired in #2991, and pretext-validation-plus.xsl is now the home for context-dependent checks.

The check: an advisory message when a division lacks @xml:id (and now @label). Automatic identifiers are unstable across edits, and stable identifiers matter more than ever: cross-references, visible URLs, and Runestone database keys all lean on them, and current authoring guidance asks for both attributes, with matching values, on every division.

Original caveat, retained: the check cannot know the chunk level a publisher will elect, so the message should stay advisory rather than authoritative about which divisions matter.

Claude Fable 5, acting as a coding assistant for Rob Beezer

Lingua principale
XSLT
Stelle
466
Fork
251
Merge medio
4m
PR unite (30g)
13

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di PreTeXtBook/pretext

Tutte le issue di PreTeXtBook/pretext

Issue simili

Altre issue su DevTools

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.