Invalid HTML generated due to post processing

Open albert-github opened this issue 11 months ago • 0 comments

Due to the CGAL specific postprocessing of the doxygen HTML files ("html_output_post_processing.py") invalid HTML is produced. It is best shown by means of "Manual/how_to_cite.html":

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<link rel="canonical" href="https://doc.cgal.org/latest/Manual/how_to_cite.html"/>

<link rel="icon" type="image/png" href="../Manual/g-196x196-doc.png">
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=9">
<link href="cgal_stylesheet.css" rel="stylesheet" type="text/css">
<title>CGAL 6.1 - Manual: Acknowledging CGAL</title>
</head>
<head>
<link rel="canonical" href="https://doc.cgal.org/latest/Manual/how_to_cite.html"/>
</head>
<body>
....

We see here 2 problems

the link and meta statements are not properly closed (they shoudl end with />)
there are 2 head sections in the file (this is "Manual/how_to_cite.html" specific).

Solution:

the PyQuery generates the problem regarding the missing / , which can be overcome by removing method='html'. At least on Windows the code  appears (i.e. ^M) this is filtered out `
code can be removed as it is already handled in the general part (just above)

Jan 21 '25 13:01 albert-github