On 20/01/2025 08:21, Julien Plissonneau Duquène wrote:
Hi Ahmad,
Le 2025-01-19 21:01, Ahmad Khalifa a écrit :
Any views or ideas on this? Example projects would be appreciated.
Are they already distributing an archive of the generated documentation?
If this is the case, and the license allows it, you could use it as the
source for your documentation package, though this is not the most
satisfying way to deal with the issue.
Oh, yes they do have a tarball of the html!
It's not on git so I never considered it, but that solves it.
Does this make it 1 source package with 2 orig tarballs then, or should
I split it completely into 2 source packages?
Perhaps one source won't work on git unless I switch to a plain repo
based on tarballs.
Otherwise, are the documentation generation scripts already included in
your freebasic package(s)? And do they download the generated HTML or
the wiki source from the wiki?
Yes, it's a compiled tool written in freebasic that can download the
wiki source to a cache dir, then use that cache dir to build
html/chm/txt/fbhelp formats. It can run on the cache only, but the tool
currently requires pcre3 (libpcre.so) so I only managed to make it work
locally outside sbuild with lots of manual hacks.
I think the idea above is much cleaner even if I have to track different
git repos and tarballs.
--
Regards,
Ahmad
