In-page links to other pages using href lead to 404 errors in HTML built by yelp-build, without build-time errors
In GTG's user manual there were places where we directly linked to some other pages of the manual in the contents, such as (rouhly paraphrasing):
<list>
<item><p>Blah blah blah <link href="gtg-some-other-thing.page">yippee</link> blah blah blah.</p></item>
</list>
This leads to 404 errors in the resulting HTML, because those internal links are not converted to have a .html
extension instead of .page
.
So I thought, maybe the .page
part was a mistake, and changed it thusly:
<list>
<item><p>Blah blah blah <link href="gtg-some-other-thing">yippee</link> blah blah blah.</p></item>
</list>
...but it still led to a 404, as it keeps it verbatim and doesn't append .html to the link.
In the end, I realized that this code was using href
instead of xref
, for all those years, without anybody noticing. Maybe yelp could detect non-hyperlink internal links masquerading as hrefs, and warn loudly about that when compiling?
Edited by Jeff Fortin