Flyout menu =========== When you are using a Read the Docs site, you will likely notice that we embed a menu on all the documentation pages we serve. This is a way to expose the functionality of Read the Docs on the page, without having to have the documentation theme integrate it directly. Functionality ------------- The flyout menu provides access to the following bits of Read the Docs functionality: * A :doc:`version switcher ` that shows users all of the active, unhidden versions they have access to. * :doc:`Offline formats ` for the current version, including HTML & PDF downloads that are enabled by the project. * Links to the Read the Docs dashboard for the project. * Links to your :doc:`VCS provider ` that allow the user to quickly find the exact file that the documentation was rendered from. * A search bar that gives users access to our :doc:`/server-side-search/index` of the current version. Closed ~~~~~~ .. figure:: /_static/images/flyout-closed.png :align: center The flyout when it's closed Open ~~~~ .. figure:: /_static/images/flyout-open.png :align: center The opened flyout Information for theme authors ----------------------------- People who are making custom documentation themes often want to specify where the flyout is injected, and also what it looks like. We support both of these use cases for themes. Defining where the flyout menu is injected ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The flyout menu injection looks for a specific selector (``#readthedocs-embed-flyout``), in order to inject the flyout. You can add ``