View Issue Details
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0027140||mantisbt||documentation||public||2020-08-08 05:49||2020-08-11 12:41|
|Priority||normal||Severity||minor||Reproducibility||have not tried|
|Summary||0027140: tool used for documentation generation (publican) is more or less dead|
Hi! I package mantisbt for Arch Linux.
I realized that I need publican to generate the administrator/developer documentation: https://github.com/mantisbt/mantisbt/tree/master/docbook
Looking at upstream, publican seems rather dead though: https://sourceware.org/publican/en-US/index.html and https://fedoraproject.org/wiki/Infrastructure/Fedorahosted-retirement
Looking at Fedora's own spec file for the publican package (https://src.fedoraproject.org/rpms/publican/blob/master/f/publican.spec) I can download a tarball for release 4.3.2 ("https://fedorahosted.org/released/publican/Publican-v4.3.2.tar.gz") but the tarball is a broken archive... :-/
It would be great to switch to some alternative tool for docbook , that is more widespread and still maintained.
|Tags||No tags attached.|
Meanwhile It's available.
Keep in mind there is not only the missing documentation, but also the missing 3rd party components installed by composer.
I also failed to find Publican binaries after fedorahosted.org was killed, and even reported the issue but never got any response.
As for not being able to download the release tarballs from SourceForge, as an alternative you can always get the nightly build following the release from our own server (https://mantisbt.org/builds.php).
The latest version of the documentation is also available online in different versions including downloadable for offline viewing.
@atrol: Yes, the missing 3rdparty components should be no problem though, as we can use composer to install them in the packaging process.
@dregad: I understand. Do you currently use a Fedora system to generate the docs? Maybe there is an easy alternative solution to publican.