Skip to content

asciidoc generated HTML header is bad

The html files generated by asciidoc during ./waf build --enable-docs have a couple of problems in the HTML header. The header looks like this:

<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="AsciiDoc 8.6.9">
<title>The Secure Network Time Protocol (NTPsec) Distribution</title>
<link rel="stylesheet" href="/media/pi/data/ntpsec/docs//asciidoc.css" type="text/css">


<script type="text/javascript" src="./asciidoc.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
asciidoc.install();
/*]]>*/
</script>
</head>

Problem 1. The stylesheet link is an absolute link to the file path for asciidoc.css in the source docs directory. It should be a relative link to a file in the build/docs directory and asciidoc.css should be copied to that directory as part of the build process.

Problem 2. The header refers to a javascript include file (asciidoc.js) that does not exist. This is however a relative link (./asciidoc.js) so the file needs to be created in build/docs/ or to exist and be copied to there.