(Semi-)manual tweaks to get pages building in Hugo

There are a lot of instances of templating in the pages that seems to
break Hugo. Ensure these are escaped for now.

Some pages also get detected as yaml, giving these pages a header seems
to be sufficient to stop these causing an issue.

This gets the pages to the point where `hugo server -D` will run and the
pages can be seen under `pages`, abeit a bit broken (jsut about all
links are broken).

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