Skip to content

Issue on page /advanced/developers.html of Jupyter Book Documentation #79

Description

@felixchenier

Good morning

I don't know if you run in the same problem, but following your instructions for including my package documentation, I get this message:

WARNING: toctree directive not expected with external-toc [etoc.toctree]

This comes from the toctree directive in my markdown file:

# Classes

```{eval-rst}

.. currentmodule:: kineticstoolkit

.. autosummary::
    :template: custom_class_template.rst
    :recursive:
    :toctree: api

    TimeSeries
    TimeSeriesEvent
    Player
```

I still need this toctree entry because otherwise the package documentation is not built. Do you know what should be the best practice here? I'd be happy to silence this warning since this method works, but I don't know how and if I should.

Thanks

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions