The documentation built for #34730 needs your attention for checking

[Kwankyu Lee]

Hi,

Trac #34730 rebases sage_autodoc onto the upgraded Sphinx 5.3.0. It is responsible for formatting Sage objects (functions, classes, etc.) to build documentation.

Please check your favorite sections in our documentation 

https://aa74d4badcbe6841833ff983ad5f756c5ac78752--sagemath-tobias.netlify.app/

for any regression due to #34730. 

Thank you in advance.

[Kwankyu Lee]

By the way, please also review

https://trac.sagemath.org/ticket/34710

 to fix the cluttered TOCs.

[Kwankyu Lee]

Here is the link to the ticket #34730

https://trac.sagemath.org/ticket/34730

[Eric Gourgoulhon]

At first glance, looks good, thanks.

Regarding 3D plots, they are rendered with Tachyon, instead of Jmol  for Sage 9.7: compare

https://aa74d4badcbe6841833ff983ad5f756c5ac78752--sagemath-tobias.netlify.app/reference/plot3d/sage/plot/plot3d/plot3d.html

with

https://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/plot3d.html

Any reason for this? (the drawback of Tachyon is that we are loosing axes labels, as well as text3d).

Eric.

[Eric Gourgoulhon]

PS: the loss of text3d is particularly apparent here:

https://aa74d4badcbe6841833ff983ad5f756c5ac78752--sagemath-tobias.netlify.app/reference/plot3d/sage/plot/plot3d/shapes2.html#sage.plot.plot3d.shapes2.text3d

as compared to

https://doc.sagemath.org/html/en/reference/plot3d/sage/plot/plot3d/shapes2.html#sage.plot.plot3d.shapes2.text3d

[John H Palmieri]

I think the use of Tachyon instead of Jmol must be particular to that setup. When I build the docs with #34730, it looks the same as in the develop branch, same as on sagemath.org.

[Kwankyu Lee]

On Thursday, November 10, 2022 at 12:27:55 PM UTC+9 John H Palmieri wrote:

I think the use of Tachyon instead of Jmol must be particular to that setup. When I build the docs with #34730, it looks the same as in the develop branch, same as on sagemath.org.

Right. It's the same here

https://f38dc83cf09c8c1a4e784b97233f1d1a9d635fb0--sagemath-tobias.netlify.app/reference/plot3d/sage/plot/plot3d/shapes2.html#sage.plot.plot3d.shapes2.text3d 

for a ticket not related with #34730.