On 14 August 2018 10:44:44 CEST, Jonas Smedegaard <jo...@jones.dk> 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 > >-- > * Jonas Smedegaard - idealist & Internet-arkitekt > * Tlf.: +45 40843136 Website: http://dr.jones.dk/ > > [x] quote me freely [ ] ask before reusing [ ] keep private
Alas, pandoc does not support docuwiki input.... Cheers! --alec Sent from my Android device with K-9 Mail. Please excuse my brevity.
