Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

Whilst not important in CI as they will get cleaned up, having
temporary files and directories left after building locally is a pain.
Tweak to clean these files up.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

The codeblock tables are being badly formatted, with the column for the
line numbers the same width as that for the content. Tweak the html for
tables with the `lntable` class so that the line numbers are only 3% of
the width.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Martyn Welch authored 4 years ago and Emanuele Aina committed 4 years ago

The PDF generator can't find the images as the paths are relate to
where Hugo will place them on the website. Tweak the path to to point
to the images. We need to convert the SVG files into something the next
step can handle. Don't leave them in the static directory in case this
results in them being exported to the website.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>

Apertis currently has a large number of concept documents on
designs.apertis.org. To improve branding, searchability and reduce
maintenance, it would be better to have all these documents under the
main website. One feature that the website is currently missing that is
provided on designs.a.o is PDF generation, which is used when reviewing
concepts with Bosch.

Carry over the PDF generation functionality from designs.a.o and
implement a mechanism for generating PDFs from the Hugo site on
www.apertis.org so that we can move documents over from designs.a.o
without loosing needed functionality.

To do this we will generate simplfied HTML documents, with the
extension `.pdf-in` when documents require this to be generated in
their frontmatter, for example to generate html and the simplified HTML
add:

    outputs = ["html", "pdf-in"]

The create-pdf script will be run for each of these via the CI pipeline
which will use a lightly modified version of the tooling used for
designs.a.o to create the PDF and place it back into the site.

Signed-off-by: Martyn Welch <martyn.welch@collabora.com>