Description
I counted 311 build/validation errors in the log.
Here's a summary by category:
CategoryCountLikely Cause element not allowed252The largest problem by far. PreTeXt does not allow in the locations where it appears. This is probably one systematic conversion issue affecting many exercises. missing required <title>14Every needs a <title> child before the program body. element not allowed12datafile is being used as an element where PreTeXt expects something else.label attribute not allowed7The label attribute is attached to elements that don't permit it. element not allowed4HTML should generally be replaced with PreTeXt markup such as or another semantic element.datafile attribute not allowed3datafile is being used as an attribute instead of an allowed attribute.names attribute not allowed2Unsupported attribute. element not allowed2Appears in the wrong context. not allowed2Nested where only content elements are permitted.Incomplete 2Required children are missing.
There are also a handful of one-off issues:
• 1 × not allowed.
• 1 × ![]()
in an invalid location.
• 1 × alt attribute not allowed.
• 1 × in an invalid location.
• 1 × missing required <title>.
• 1 × <title> in an invalid location.
• 1 × incomplete
.
• 1 × another miscellaneous structural error.
Overall assessment
The good news is that although there are 311 reported errors, they represent only about 10–12 distinct underlying problems. In particular:
• 81% of all errors (252/311) come from the single issue with ..
• The next largest issue is missing <title> elements on (14 occurrences)..
• Most of the remaining errors are repeated misuse of a few elements or attributes..
I would recommend fixing them in roughly this order:
- Fix (eliminates 252 errors).
- Add <title> to every (14 errors).
- Fix usage (15 errors total).
- Remove/replace invalid label attributes.
- Replace HTML with proper PreTeXt markup.
- Address the remaining one-off structural issues.
That approach should remove well over 90% of the build failures with just a handful of systematic edits.
Description
I counted 311 build/validation errors in the log.
Here's a summary by category:
CategoryCountLikely Cause element not allowed252The largest problem by far. PreTeXt does not allow in the locations where it appears. This is probably one systematic conversion issue affecting many exercises. missing required <title>14Every needs a <title> child before the program body. element not allowed12datafile is being used as an element where PreTeXt expects something else.label attribute not allowed7The label attribute is attached to elements that don't permit it. element not allowed4HTML should generally be replaced with PreTeXt markup such as or another semantic element.datafile attribute not allowed3datafile is being used as an attribute instead of an allowed attribute.names attribute not allowed2Unsupported attribute. element not allowed2Appears in the wrong context. not allowed2Nested where only content elements are permitted.Incomplete 2Required children are missing.
There are also a handful of one-off issues:
• 1 × not allowed.![]()
in an invalid location.
• 1 ×
• 1 × alt attribute not allowed.
• 1 × in an invalid location.
• 1 × missing required <title>.
• 1 × <title> in an invalid location.
• 1 × incomplete
• 1 × another miscellaneous structural error.
Overall assessment
The good news is that although there are 311 reported errors, they represent only about 10–12 distinct underlying problems. In particular:
• 81% of all errors (252/311) come from the single issue with ..
• The next largest issue is missing <title> elements on (14 occurrences)..
• Most of the remaining errors are repeated misuse of a few elements or attributes..
I would recommend fixing them in roughly this order:
That approach should remove well over 90% of the build failures with just a handful of systematic edits.