Re: font copies in sphinx generated documentation

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

 



On Mon, Feb 07, 2022 at 04:51:35PM +0100, Petr Menšík wrote:
> Hi!
> 
> I maintain bind package, which generates html documentation using sphinx
> and sphinx_rtd_theme. I admit this format is quite popular. Once I have
> noticed that bind-doc package is quite big. When looking why, I have
> found not a small number of static copies were generated by
> documentation process.
> 
> If I remember correctly, fonts are allowed to be shipped only by font
> packages. Not only sphinx packages ships static copies of javascript
> underscore and jquery, but it seems every such package includes also set
> of fonts contained in its documentation.

Perhaps I'm mis-interpreting the guidelines, but I don't feel
like the font packaging rules should apply in this case. When
we describe the rules for packaging fonts, I feel like that was
related to fonts that are to be installed for shared usage.
ie stuff going into /usr/share/fonts should be provided by a
fonts-xxx package, not as a side effect of some other package.

The fonts that get copied/around embedded in documentation are
for private usage by only that documentation. Any shared docs
generator tools would ideally pull their fonts from common source,
but whatever they do for output we should just accept. It is not
a sane use of resources to expect package maintainers to hack the
generated docs to change how they deal with fonts. Sphinx is just
one docs tool, there are many other tools, often written just to
suit the one app in question.

Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|
_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-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/devel@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure




[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Users]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]

  Powered by Linux