You are on the right track, unfortunately. In general, correctly
packaging web assets in Fedora is tedious at best, and in some cases
nearly impossible.
Packaging documentation and demos is always nice when it’s tractable,
but there is no requirement to include them in a Fedora package, and I
would definitely proceed without them if I were you. I personally
wouldn’t bother jumping through the necessary hoops to include them
later, either.
– Ben Beasley (FAS music)
P.S.:
In most but not all cases, it’s possible to use Doxygen to produce a PDF
instead of HTML documentation. The result is probably acceptable for
packaging (modulo some nagging questions about whether we should worry
about possible embedded fonts, and, if we should worry, what we can even
do about them). If this approach is something you want to attempt, I can
provide examples or a PR upon request.
On 10/19/22 19:20, Renich Bon Ćirić wrote:
Hello,
Recently, I started packaging janus-gateway. I've run into a wall when dealing
with the documentation and demos, though.
They require jquery, bootstrap (js library only) bootswatch (themed bootstrap)
in order to be able to function properly.
The docs and demos are available here respectively:
https://janus.conf.meetecho.com/docs/
https://janus.conf.meetecho.com/demos.html
In order to make them available in Fedora, I was told to follow:
https://docs.fedoraproject.org/en-US/packaging-guidelines/JavaScript/
https://docs.fedoraproject.org/en-US/packaging-guidelines/Web_Assets/
So, do I have to package and build bootswatch, bootstrap and jquery (v1.9 it
seems) and all their dependencies; then patch the documentation so it consumes
them in order to provide them (the documentation and demos sub-packages)?
If so, can I omit these two for now so I can publish the package ASAP; while I
continue to work on the documentation and demos sub-packages?
Thank you.
_______________________________________________
packaging mailing list -- packaging@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to packaging-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/packaging@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
_______________________________________________
packaging mailing list -- packaging@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to packaging-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/packaging@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
