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

Abierto
#3,076 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
45/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
xml
Área
tooling

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
XSLT
Estrellas
466
Forks
251
Merge medio
4 min
PR fusionados (30 d)
13

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de PreTeXtBook/pretext

Todos los issues de PreTeXtBook/pretext

Issues similares

Más issues de DevTools

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.