Jupyter-book: Issue when using "search" as a filename

Created on 30 Sep 2020  ·  2Comments  ·  Source: executablebooks/jupyter-book

Describe the bug

When building html it seems that if you use search as a filename -- sphinx replaces it with a search page and ignores the content in that file. Perhaps this is a reserved additional page for sphinx?

If _toc.yml contains:

- file: search

the issue occurs.

However if the file is nested in a folder there is no issue.

- file: folder/search

also other names such as my_search don't face the issue.

A minimal example is available here

To Reproduce

Clone minimal example

and jb build ./

with html

Expected behavior

Either a warning for using a special filename or use the user provided file.

Environment

▶ jb --version
Jupyter Book: 0.8.2
MyST-NB: 0.10.1
Sphinx Book Theme: 0.0.37
MyST-Parser: 0.12.10
Jupyter-Cache: 0.4.1
NbClient: 0.5.0
bug topitoc

All 2 comments

ah yeah - I feel like this is an annoying Sphinx bug that has bitten me before too. Perhaps a warning is the right way to go here, so that users know why things are breaking 👍

I think another one -- but a lot less likely to occur is genindex

Was this page helpful?
0 / 5 - 0 ratings

Related issues

abielr picture abielr  ·  4Comments

Cyb3rWard0g picture Cyb3rWard0g  ·  5Comments

sidneymbell picture sidneymbell  ·  5Comments

utterances-bot picture utterances-bot  ·  3Comments

bsamadi picture bsamadi  ·  3Comments