Re: font copies in sphinx generated documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 2/8/22 20:13, Miro Hrončok wrote:
> On 08. 02. 22 19:50, Petr Menšík wrote:
>> Is FESCO okay with bundled javascript libraries in similar
>> packages?
>
> FESCo/FPC does allow bundling. See e.g.
> https://docs.fedoraproject.org/en-US/packaging-guidelines/#bundling
>
> This is no different. Except what you describe is a lot of work for
> the sphinx maintainers. As one of the I'd rather outright ban packaged
> documentation than have to make it work myself.

It seems ban is quite radical solution. I thought I have seen that in
guidelines and indeed. Fonts should not be bundled by other packages
[1]. Are system libraries only native code libraries? Doesn't jquery
count as system library itself? If javascript libraries do not require
any attempts to not duplicate shared code, shouldn't it be mentioned
somewhere in guidelines? It seems they try to avoid current situation [2].

I could certainly help with some pull requests, but any change cannot be
done at all without cooperation of theme package maintainers.

Fedora theme would help to avoid local fonts, but would leave unresolved
jquery and underline bundles. Those are part of basic sphinx theme. So
change of theme might help only partially. But it would be
self-contained change, I guess worth trying. I admit npm processed
theme.css is far outside of my expertise. I found we already have some
infrastructure for similar things at /usr/share/web-assets/fonts/ and
/usr/share/web-assets/javascript/, perhaps it should be reused also for
html manuals.

Unless documentation build time would be simple to modify,
post-processing of installed documentation to (sym)link to shared assets
might be simpler. And would require almost no work from sphinx or themes
maintainers.

Cheers,
Petr

1.
https://docs.fedoraproject.org/en-US/packaging-guidelines/#_avoid_bundling_of_fonts_in_other_packages
2.
https://docs.fedoraproject.org/en-US/packaging-guidelines/JavaScript/#_wrappers_for_other_languages_or_environments

-- 
Petr Menšík
Software Engineer
Red Hat, http://www.redhat.com/
email: pemensik@xxxxxxxxxx
PGP: DFCF908DB7C87E8E529925BC4931CA5B6C9FC5CB
_______________________________________________
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 on the list, report it: https://pagure.io/fedora-infrastructure




[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite Forum]     [KDE Users]

  Powered by Linux