On Tuesday, August 20, 2024 at 7:07:54 PM UTC+9 Eric Gourgoulhon wrote:

There are tons of png files in the "3d Graphics" section of the 
documentation:  
https://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/plot3d.html
It would be quite a burden to maintain this manually. 


Meanwhile I looked into the responsible code and studied how Jmol/Tachyon 
is used in rendering images from 3d graphics via sphinx_plot() via ".. 
PLOT::"

As generating these images is already automated, I would not advocate for 
switching to a manual way. Moreover, I now see that the automated way helps 
in keeping the documentation source small (while compiling the 
documentation takes longer).

I just want to note that maintaining png files is no burden once added 
(either manually or in bulk using playwright) as the documentation rarely 
changes.
 

The drawback of Jmol-generated png files is that they do not exactly 
correspond to what the user gets on his/her screen in a Jupyter notebook 
with the default viewer (threejs). 


I agree. Manually-generated images have the same benefit :-)

-- 
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/bc5a478b-236e-44c6-b89f-9eee6ca0b12cn%40googlegroups.com.

Reply via email to