jupyter-book
jupyter-book copied to clipboard
Unable to change Book Title in Left panel TOC after creating a book from toc
Describe the bug
context I created
- source files of a Jupyter Book skeleton from TOC and
- the Jupyter Book skeleton itself in subfolder _build/ of book/
expectation
The book title My Fancy Book
in _toc.yml
should appear in the left panel TOC above the search field when opening _build/html/docs/index.html
in a browser.
bug But instead the correct book title only appeared in the left panel TOC below the search field since I updated the title of chapter 1 accordingly
- Above the search box the title “My Jupyter Book” is still shown in the left panel TOC.
- Searching for the wrong title “My Jupyter Book” in all files below the folder
book/
does not yield any result, except the generated filed below book/_build/. I wonder where it magically comes from… - The correct title “My Fancy Book” does not show up anywhere.
problem Without finding the wrong title “My Jupyter Book” people don't know where to overwrite it with the correct title.
Related Issue #478.
I found out the tag <h1 class="site-logo" id="site-title">
is not populated with the title I expect to see but this is just a naive observation of someone without knowledge of the implementation of Jupyter Book.
Reproduce the bug
mkdir "My Fancy Book"
cd "My Fancy Book"
mkdir book
cd book
cat >_toc.yml <<EOF
title: My Fancy Book
format: jb-book
root: docs/index
chapters:
- file: docs/1. chapter/index
sections:
- file: docs/1. chapter/1. section
EOF
cd ..
jupyter-book toc to-project -e md book/_toc.yml
jupyter-book build book
List your environment
Jupyter Book : 0.13.0 External ToC : 0.2.4 MyST-Parser : 0.15.2 MyST-NB : 0.13.2 Sphinx Book Theme : 0.3.3 Jupyter-Cache : 0.4.3 NbClient : 0.5.13