Q: Packaging wiki documentation.
- Date: Tue, 14 Aug 2018 10:20:55 +0200
- From: Alec Leamas <leamas.alec@xxxxxxxxx>
- Subject: Q: Packaging wiki documentation.
I'm considering packaging OpenCPN. It's mostly straight-forward, but
the documentation seems problematic.
The docs are basicallly a wiki based on DocuWiki . As part of the
release process the site is exported and html and PDF files in the git
tree is updated. This is a manual process which relies on administrative
privileges to the docuwiki instance.
After pushing the generated docs through the packaging toolchain lintian
rightfully complains about missing sources - in this case, the wiki
I have no experience in the docuwiki tool. At a glance, already getting
the markdown sources seems non-obvious. Even if I had the sources, I see
no path to rebuild the docs as part of a package build process.
Is there any experience out there in this situation? Or just some thoughts?