Sphinx/docutils update for Sage 9.4

[mkoeppe]

We are at 3.1.2, current is 4.0.1

https://repology.org/projects/p/?inrepo=sagemath

Depends on #30551

CC: @kiwifb @antonio-rojas @jhpalmieri @slel

Component: packages: standard

Author: Antonio Rojas

Branch/Commit: bc84af8

Reviewer: John Palmieri

Issue created by migration from https://trac.sagemath.org/ticket/31696

[mkoeppe]

Dependencies: #30551

[antonio-rojas]

Branch: u/arojas/sphinx_docutils_update_for_sage_9_4

[sagetrac-git]

Commit: ad51564

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

c8272c0	Sync autodoc with upstream to fix deprecation warnings
1ed5bd7	Remove duplicate modules, which throw a warning with sphinx 4
ad51564	Upgrade sphinx to 4.0.0

[sagetrac-git]

Changed commit from ad51564 to b9e390f

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

b9e390f

Upgrade sphinx to 4.0.1

[antonio-rojas]

comment:5

Pushed the sphinx 4 update, with the usual batch of deprecation fixes. We should really try to get rid of the custom autodoc fork, most of the breakage comes from it getting out of sync with upstream.

[sagetrac-git]

Changed commit from b9e390f to d5a374a

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

d5a374a

Clear LANGUAGE too

[sagetrac-git]

Changed commit from d5a374a to 285ea99

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

285ea99

Update test for different sphinx output

[sagetrac-git]

Changed commit from 285ea99 to 5bf10dd

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

e74c40f	Merge branch 'develop' of https://github.com/sagemath/sage into t/31696/sphinx_docutils_update_for_sage_9_4
5bf10dd	Update docutils to 0.17.1

[kiwifb]

comment:10

Replying to @antonio-rojas:

Pushed the sphinx 4 update, with the usual batch of deprecation fixes. We should really try to get rid of the custom autodoc fork, most of the breakage comes from it getting out of sync with upstream.

For the custom autodoc fork, we should just open a ticket and see what needs fixing when we remove it. May be not for 9.4, but we need to work on this.

[jhpalmieri]

comment:11

Building the documentation fails for me with WARNING: rST localisation for language "hu" not found.

[jhpalmieri]

comment:12

Replying to @kiwifb:

Replying to @antonio-rojas:

Pushed the sphinx 4 update, with the usual batch of deprecation fixes. We should really try to get rid of the custom autodoc fork, most of the breakage comes from it getting out of sync with upstream.

For the custom autodoc fork, we should just open a ticket and see what needs fixing when we remove it. May be not for 9.4, but we need to work on this.

How about #30893?

[sagetrac-git]

Changed commit from 5bf10dd to 5272520

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

5272520

Ignore warnings from docutils about missing rST localisation

[jhpalmieri]

comment:14

Thank you, that fixes the html build problems. The PDF documentation doesn't build though: the Japanese documents fail with

! Class jsbook Error: You are running upLaTeX.
(jsbook)              Please use pLaTeX instead, or add 'uplatex' to
(jsbook)              the class option list.

See the jsbook class documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              
                                                  
l.229       {\@ehc}
                   
? 
! Emergency stop.
 ...                                              
                                                  
l.229       {\@ehc}

[antonio-rojas]

comment:15

Looks like sphinx-doc/sphinx@1d9eeed

Anyway, this is where I give up. I never build PDF docs myself so I'm not really motivated to keep digging into this.

[jhpalmieri]

Changed branch from u/arojas/sphinx_docutils_update_for_sage_9_4 to u/jhpalmieri/sphinx_docutils_update_for_sage_9_4

[jhpalmieri]

Changed commit from 5272520 to bc84af8

[jhpalmieri]

Author: Antonio Rojas

[jhpalmieri]

comment:17

This works for me. Please test. I am happy to positively review everything but my own contribution.

---

New commits:

bc84af8

trac 31696: fixes for Japanese documentation, PDF build

[jhpalmieri]

Reviewer: John Palmieri

[jhpalmieri]

comment:18

In fact I don't think all of my changes were necessary, but we don't need to include stuff about the French documentation in doc/ja/....

[antonio-rojas]

comment:19

PDF build works for me, setting to positive review as per comment:17

[vbraun]

Changed branch from u/jhpalmieri/sphinx_docutils_update_for_sage_9_4 to bc84af8