Formatting issues pointed out by Paul Knight (#7)

README.md

@@ -38,11 +38,13 @@ This additional syntax is resolved with the Node.js module [`lib/number.js`](lib
 
 ## How to view the documents
 
-To view mathematical formulas, install pandoc as explained in the section on [Document Conventions](odata-data-aggregation-ext/1%20Introduction.md).
+To view mathematical formulas, install pandoc as explained in the section on [Document Conventions](odata-data-aggregation-ext/1%20Introduction.md). This is invoked by the Node.js module [`lib/pandoc.js`](lib/pandoc.js).
 
-Clone this repository, run `npm install` and `npm start` to start a Node.js server and access the HTML pages at, for example, `http://localhost:8080/odata-data-aggregation-ext`.
+Clone this repository, run `npm install` and `npm start` to start a Node.js server and access the HTML pages at, for example, `http://localhost:8080/odata-data-aggregation-ext` (see [`lib/server.js`](lib/server.js)).
 
-Run `npm run build` to build HTML and Markdown files for publication on github.io.
+Run `npm run build` to build HTML and Markdown files for publication on github.io (see [`lib/build.js`](lib/build.js)).
+
+Run `npm run pdf` to convert the HTML files into PDF files (using puppeteer, see [`lib/pdf.js`](lib/pdf.js)).
 
 ## To Do
 

docs/odata-data-aggregation-ext/odata-data-aggregation-ext.html

@@ -165,6 +165,7 @@ <h4 id="notices">Notices</h4>
 <p>Distributed under the terms of the OASIS <a href="https://www.oasis-open.org/policies-guidelines/ipr/">IPR Policy</a>.</p>
 <p>The name "OASIS" is a trademark of <a href="https://www.oasis-open.org/">OASIS</a>, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs.</p>
 <p>For complete copyright information please see the full Notices section in an Appendix <a href="#Notices">below</a>.</p>
+<hr />
 <h1 id="table-of-contents">Table of Contents</h1>
 <div class="toc">
 <ul>

docs/odata-data-aggregation-ext/odata-data-aggregation-ext.md

@@ -97,6 +97,8 @@ The name "OASIS" is a trademark of [OASIS](https://www.oasis-open.org/), the own
 
 For complete copyright information please see the full Notices section in an Appendix [below](#Notices).
 
+-------
+
 # Table of Contents
 
 ::: toc

lib/pdf.js

@@ -17,6 +17,7 @@ module.exports = async function(name) {
   await page.pdf({
     path: `${__dirname}/../docs/${name}/${name}.pdf`,
     format: "letter",
+    printBackground: true,
     displayHeaderFooter: true,
     headerTemplate: '<div style="font-size: 10px; width: 100%; text-align: center;">Standards Track Work Product</div>',
     footerTemplate: `<div style="font-size: 8px; width: 90%; margin: auto; margin-top: 40px; display:flex; flex-flow:row wrap;">

odata-data-aggregation-ext/0 frontmatter.md

@@ -96,3 +96,5 @@ Distributed under the terms of the OASIS [IPR Policy](https://www.oasis-open.org
 The name "OASIS" is a trademark of [OASIS](https://www.oasis-open.org/), the owner and developer of this specification, and should be used only to refer to the organization and its official outputs.
 
 For complete copyright information please see the full Notices section in an Appendix [below](#Notices).
+
+-------