Web lists-archives.com

Re: Q: Packaging wiki documentation.






On 14 August 2018 10:44:44 CEST, Jonas Smedegaard <jonas@xxxxxxxx> wrote:
Quoting Alec Leamas (2018-08-14 10:20:55)
I'm considering packaging OpenCPN[1]. It's mostly straight-forward,
but the documentation seems problematic.

The docs are basicallly a wiki based on DocuWiki [2]. 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 markdown files.

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?

You could try generate the documentation with Pandoc.


- Jonas

Alas, pandoc does not support docuwiki input....

Cheers!
--alec

Sent from my Android device with K-9 Mail. Please excuse my brevity.