Web lists-archives.com

Re: Q: Packaging wiki documentation.




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

Attachment: signature.asc
Description: signature