Bug 297509 - FreeBSD web pages have a lot of invalid HTML
Summary: FreeBSD web pages have a lot of invalid HTML
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Sergio Carlavilla Delgado
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-08-13 21:45 UTC by Yuri Victorovich
Modified: 2026-09-12 08:03 UTC (History)
4 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Yuri Victorovich freebsd_committer freebsd_triage 2026-08-13 21:45:18 UTC
Problem: The FreeBSD web pages have a lot of invalid HTML, particularly in:
1. front page http://freebsd.org (ex. error: The element “label” must not appear as a descendant of the “a” element.)
2. ML archives like https://mail-archive.freebsd.org/mail/archive/2026/dev-commits-ports-all/20260706.dev-commits-ports-all.html

Here is the yet uncommitted but fully functional HTML validator 'vnu': https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=297507

It is distributed by the W3C organization.

It should be installed and HTMLs should be fixed and re-validated.

I am not expecting this to be done fast and don't know who would do that but this should be done. This would be a great task for an AI assistant, once it is pointed to the relevant CGI scripts and HTMLs.

This can probably be done even in one day, but all relevant code should be within reach, hence this is a problem for the WebMeister.
Comment 1 Yuri Victorovich freebsd_committer freebsd_triage 2026-08-13 21:55:41 UTC
Invalid HTML increases the chance of random malfunction in these pages on the user side.
Comment 2 Yuri Victorovich freebsd_committer freebsd_triage 2026-08-14 19:07:12 UTC
@webmaster

Is there a way that the FreeBSD website can be installed in an isolated VM so that such change can be made there and then deployed to production?
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2026-08-18 06:06:25 UTC
Let me take a look please.
Comment 4 commit-hook freebsd_committer freebsd_triage 2026-09-12 08:01:13 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=a8654f311176852b9df7ec5bc2f8d0c175229694

commit a8654f311176852b9df7ec5bc2f8d0c175229694
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2026-09-12 08:00:07 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2026-09-12 08:00:07 +0000

    Website: Fix HTML validation errors

    PR:     297509

 website/themes/beastie/assets/styles/main.css      | 23 +++++++--
 .../beastie/layouts/_partials/site-footer.html     |  3 +-
 .../beastie/layouts/_partials/site-header.html     | 60 +++++++++-------------
 3 files changed, 46 insertions(+), 40 deletions(-)
Comment 5 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2026-09-12 08:03:16 UTC
Fixed in the main page