Skip to content

Duplicate title in navigation bar for top-level pages when features.navigation.tabs is True #440

@bgmeulem

Description

@bgmeulem

I recently encountered something odd that's non-obvious to me how to fix.
When I set "navigation.tabs" to True under features, my top-level pages (index.rst non-included) show their title twice in the navigation pane. Only the top one is clickable.

This only occurs for my API reference and Tutorials pages, not for e.g. Installation. API reference has a hidden toctree, and Tutorials has a handful of nbgallery directives, which I think also use the toctree directive. My index.rst has no navigation pane at all (which I think is default behavior) and any child of API reference or Tutorials also don't have this issue...

Image

My index.rst looks like:

The In-Silico Framework (ISF)
=============================

.. toctree::
   :hidden:
   :maxdepth: 1

   rst_assets/api_reference
   rst_assets/tutorials
   rst_assets/installation
   rst_assets/file_formats
   bibliography

And my api_reference.rst looks like:

.. _api_reference:

API reference
=============

.. toctree::
   :hidden:

   ../autoapi/Interface/index
   ../autoapi/biophysics_fitting/index
   ../autoapi/data_base/index
   ../autoapi/simrun/index
   ../autoapi/single_cell_parser/index
   ../autoapi/singlecell_input_mapper/index
   ../autoapi/spike_analysis/index
   ../autoapi/visualize/index

.. autoapisummary::

   Interface
   biophysics_fitting
   data_base
   simrun
   single_cell_parser
   singlecell_input_mapper
   spike_analysis
   visualize

My directory structure is:

index.rst
rst_assets/
    - api_reference.rst
    - tutorials.rst
    - file_formats.rst
    - installation.rst
    - ...

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions