The Antora server will include a language-switching link
and an edit link for each file, both of which aren't
valid in the preview and need to be ignored.
The edit link takes the form `file:///antora/...`,
a path that's only valid inside the container.
The language link points from every document
`https://localhost:8080/guidelines/foo`
to a language-specific URL like
`https://localhost:8080/en-US/guidelines/foo`
The latter may need to be tweaked if they're dependent on
the system locale of the user running linkchecker.
Ignoring `https://localhost:8080/en-US` works for me,
but may not be universal.
Instead of using podman commands directly in the Makefile, add
the `docsbuilder.sh` script from the [docs templates repo][1].
Rewrite the Makefile to use docsbuilder commands to perform
its functions.
Changes:
- The preview URL changes from `https://localhost:8000` to
`https://localhost:8080/`
- `build` is now a synonym for `doc`
- `serve` now runs `docsbuilder -p` which automatically
rebuilds the doc first
- `watch` is now available to start a server that
automatically rebuilds the preview on file changes
- `linkcheck` will automatically start a preview server
before running `linkchecker`
[1]: https://gitlab.com/fedora/docs/templates/fedora-docs-template
