On 21/08/24 13:22, Kwankyu Lee wrote:
On Wednesday, August 21, 2024 at 9:42:42 AM UTC+9 John H Palmieri wrote:

    ... maybe we should consider distributing all of the documentation
    pre-built as a tarball, not just some png files. (I have resisted
    this in the past, but I am changing my mind.) Packages that are
    necessary to build the documentation could be "optional," or there
    could be a new type for them. The standard "make" would use the
    pre-built tarball, while another "make" target could build the
    documentation from scratch. This could make the build process faster
    with fewer associated standard packages.


Good idea. Though we have the dichotomy that installing sage from source is for developers and installing prebuilt sage is for non-developer users, it is not a bad idea for a non-developer user to install sage from source. For such users, installing pre-built doc, which is platform-independent, would save much time.

Alternatively, the standard "make" would first attempt to download the pre-built tarball (from github release assets), and rebuild the doc only if downloading fails or sagelib is modified (which would entail installing all "optional" packages necessary for doc build).

I used to provide pre-built doc for sage-on-gentoo. I stopped when I started to move to modular sage packages (sage_conf, sage_setup,...).
I think it totally make sense.

However developers and people that work on the documentation are still left with having to use the unpalatable stuff. Is playwright any better than jmol? Well it is easier to install and possibly better maintained but it is still a big blob of binary goo. In fact, I suspect it will turn out to be a bigger blob. My jmol install is clocking at 91.7MB and my chrome install is 298MB. Now having the plot looking exactly like what you will typically produce instead of being similar is a big plus.

François

--
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/9362ca47-ffff-42d5-92ed-4d18880ba7e0%40gmail.com.

Reply via email to