Skip to content

Mobile view is slightly broken on Read the Docs (probably due to injected ads) #90

Open

Description

@dantownsend

Note the nav bar:

Image

As an experiment, I tried it with an Adblocker enabled, and the problem went away.

Activity

  1. joswhite commented on Feb 20, 2026

    @joswhite

    I'm getting a similar issue on Desktop. Tested in the latest Chrome and Firefox (this URL):

    Image

    The app bar is tall enough it blocks the "Contents" text in the sidebar.

    Seems to be related to the ad being displayed, since I'm not seeing the issue in my project, which uses the Piccolo theme without ads.

  2. dantownsend commented on Feb 21, 2026

    @dantownsend
    MemberAuthor

    Thanks for sharing that screenshot. I wonder if there's some piece of markup which needs adding for Readthedocs to correctly insert their ads. Perhaps it's documented somewhere.

  3. JustinTArthur commented on May 20, 2026

    @JustinTArthur

    Filed upstream as readthedocs/readthedocs.org#13055.

    If you don't want to wait for a fix on their end, you can rename static/js/theme.js to something like static/js/piccolo_theme.js so it doesn't get mistaken for RTD's in-house theme.

    For everyone else, if using Sphinx, you can add something like this to your conf:

    html_css_files = ['css/piccolo_overrides.css']

    then in docs/_static/css/piccolo_overrides.css:

    div#top_nav nav {
      padding-bottom: 1rem !important;
    }
  4. dantownsend commented on May 20, 2026

    @dantownsend
    MemberAuthor

    @JustinTArthur Thanks for figuring this out! I was really struggling with this one.

  5. JustinTArthur commented on Jun 9, 2026

    @JustinTArthur

    This has been resolved upstream this week, as far as I can tell.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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