hello-world Example doesn't Follow Schema

16 views
Skip to first unread message

Jason Siefken

unread,
May 6, 2026, 6:56:03 PMMay 6
to prete...@googlegroups.com
I noticed today that https://github.com/PreTeXtBook/pretext/blob/master/examples/hello-world/hello-world.xml doesn't validate according to the schema because an article must have a <title>.

Is this a bug in the schema or a bug in the example? 

Rob Beezer

unread,
May 7, 2026, 2:05:13 PMMay 7
to prete...@googlegroups.com
Thanks for catching that, Jason!

Well, that example is over 10 years old. ;-) It is mostly meant as a place to
throw in some extra stuff for testing, but I tend to use (and encourage) the
sample article for that, since unanticipated side-effects are more likely to
surface (and we are faster than we used to be!).

I could see an argument for a short, unstructured, one-page something, without a
#title. But almost everything structural *requires* a #title, so I'd say the
schema is right, and the example needs a title.

I can catch that (and update the very old code comments), unless you are dying
to do it. Let me know, one way or the other.

Thanks,
Rob
> --
> You received this message because you are subscribed to the Google Groups
> "PreTeXt development" group.
> To unsubscribe from this group and stop receiving emails from it, send an email
> to pretext-dev...@googlegroups.com <mailto:pretext-
> dev+uns...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/
> e5aab2d5-2216-4fe2-a328-1b3e3973eeeb%40gmail.com <https://groups.google.com/d/
> msgid/pretext-dev/e5aab2d5-2216-4fe2-a328-1b3e3973eeeb%40gmail.com?
> utm_medium=email&utm_source=footer>.

Jason Siefken

unread,
May 7, 2026, 4:25:18 PMMay 7
to prete...@googlegroups.com
I'm happy for you to make the update :-)

PS: this came out of some work I'm doing to get schema validation without JING. Hopefully it ends up being useful.

Rob Beezer

unread,
May 8, 2026, 5:32:33 PMMay 8
to prete...@googlegroups.com
On 5/7/26 13:25, Jason Siefken wrote:
> I'm happy for you to make the update :-)

Done. Thanks again for the report.

> PS: this came out of some work I'm doing to get schema validation without JING.
> Hopefully it ends up being useful.

I suspected something bigger was in the preliminary stages. ;-) Yes, that will
be interesting.

Would you like more on your plate? We have constructions we can't express with
a simple parent-child relationship. For example. a #var can appear as a
*descendant* of #webwork, but not just any old place. So it is an
ancestor-descendant relationship, at a variable number of generations. We have
a tool to comment on these, in the "validation-plus" stylesheet. Something to
think about for v2.0.

Rob
Reply all
Reply to author
Forward
0 new messages