Docbuild workflow broken because furo is too new

[mkoeppe]

As seen for example in
https://8f7574169b6743890bc32b58d9d2afcb4a5d6375--sagemath-tobias.netlify.app/

ERROR: This page was generated by inheriting from "layout.html".

Furo (the documentation theme that this site is generated with) does not support this, and has generated this page. If you are the author of this documentation, please look into why this page was generated using the "layout.html" template and fix the root cause.

Debugging information, if you need to report this error somewhere:
Sphinx: 4.4.0
Furo: 2022.06.21

pagename: index

As a workaround, we back out the use of furo on the docbuild CI.

CC: @tobiasdiez @kwankyu

Component: documentation

Author: Matthias Koeppe

Branch/Commit: 889fcc1

Reviewer: Kwankyu Lee

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

[mkoeppe]

Branch: u/mkoeppe/docbuild_workflow_broken_because_furo_is_too_new

[mkoeppe]

New commits:

256ca4b

build/pkgs/furo/requirements.txt: Set an upper bound

[mkoeppe]

Commit: 256ca4b

[mkoeppe]

Author: Matthias Koeppe

[mkoeppe]

comment:3

Also fails with Furo: 2022.04.07 - https://256ca4be1c5defc9de1f43a18a475258c5b19a00--sagemath-tobias.netlify.app/

[mkoeppe]

comment:4

Or perhaps something else changed on our side since #33601?

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. This was a forced push. New commits:

889fcc1

Revert "Use furo on ci"

[sagetrac-git]

Changed commit from 256ca4b to 889fcc1

[kwankyu]

comment:7

Okay. I have no idea either. It works locally well.

[kwankyu]

Reviewer: Kwankyu Lee

[mkoeppe]

comment:8

Thanks!

[tobiasdiez]

comment:9

This seems to only affect the index page, eg https://8f7574169b6743890bc32b58d9d2afcb4a5d6375--sagemath-tobias.netlify.app/reference/ is working. How is the starting page generated?

[kwankyu]

comment:10

Replying to @tobiasdiez:

This seems to only affect the index page, eg https://8f7574169b6743890bc32b58d9d2afcb4a5d6375--sagemath-tobias.netlify.app/reference/ is working. How is the starting page generated?

Indeed. It is generated by sage_docbuild.WebsiteBuilder using the template src/doc/en/website/templates/index.html, which has the first line {% extends "layout.html" %}! It seems this line conflicts with the furo theme.

[vbraun]

Changed branch from u/mkoeppe/docbuild_workflow_broken_because_furo_is_too_new to 889fcc1