Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

`WARNING: Unknown key in `_toc.yml`: root`

See original GitHub issue

Jupyter Book: 0.10.1.

When I try to build, I get the warning: WARNING: Unknown key in _toc.yml: root

Why is this key unknown? According to https://jupyterbook.org/structure/toc.html, the root key should not be unknown. Right?

Issue Analytics

State:
Created a year ago
Comments:5 (3 by maintainers)

Top GitHub Comments

2reactions

physicshinzuicommented, Apr 13, 2022

@michaelosthege and @mmcky Thank you for your help. I’m sorry that I didn’t give the detail. As mmcky said, I have upgraded jupyter book, and I found it worked! Thank you.

The problem I had was that when I use the following _toc.yml

format: jb-book
root: index
chapters:
- file: path/to/chapter1
- file: path/to/chapter2

, I got the error WARNING: Unknown key in _toc.yml: root. This seemed to be due to the version 0.1.0 I used.

0reactions

mmckycommented, Apr 13, 2022

You may also want to upgrade jupyter-book to the latest version

I see you’re using 10.1 so please upgrade to 0.12.3 using pip install --upgrade jupyter-book which might help with the docs and the _toc structure.

Top Results From Across the Web

root config contains unknown keys: staging - GitLab.org

root config contains unknown keys: staging. Hi I am set CI with following .gitlab-ci.yml content: rspec: stage: test script: - pwd staging: ...

How to fix the YAML syntax error: did not find expected '-'

The error means you've syntax error and this particular is difficult to track, as it could mean multiple things, wrong indentation, including missing...

Configuration - Doxygen Manual

When as file - is specified the warning and error messages are written to standard output ( stdout ). Configuration options related to...

Directives - Sphinx documentation

The “root document” (selected by root_doc ) is the “root” of the TOC tree hierarchy. It can be used as the documentation's main...

Troubleshooting Common Errors - Gatsby

Table of Contents · Problems with the cache · Errors with common plugin configurations. Installing plugins for styling results in Generating SSR bundle...