Skip to content

Plot directive may be confused by ..include:: #17860

Closed

Description

@QuLogic

Bug report

In our docs, we have users/whats_new.rst that does .. include:: prev_whats_new/whats_new_3.3.0.rst.

For any plot directives, this latter file creates files like build/plot_directive/users/prev_whats_new/whats_new_3-3-0-*.*. Somehow this also gets copied to build/plot_directive/users/whats_new-*.*. Then in the final docs (in build/html), this ends up in coming from _images/whats_new-*.*. I don't really understand why that third copy is made, since the other two still exist in build/html, but whatever.

The problem occurs when you update plots in whats_new_3.3.0.rst. Only the first image is updated, and nothing is copied to the second or third locations.

Matplotlib version

  • Operating system: Fedora 31
  • Matplotlib version: master (actually, head of Refresh what's new page for 3.3.0 #17858)
  • Matplotlib backend (print(matplotlib.get_backend())): TkAgg
  • Python version: 3.7.6
  • Other libraries: Sphinx 3.1.2

Activity

  1. added
    Difficulty: Mediumhttps://matplotlib.org/devdocs/devel/contribute.html#good-first-issues
    🌱 Good first issueOpen a pull request against these issues if there are no active ones!
    on Jul 8, 2020
  2. QuLogic commented on Jul 10, 2020

    @QuLogic
    MemberAuthor

    I think this pretty self-contained to the sphinx extension code only, so should be a good first issue. However, since it requires understanding sphinx it's at least medium difficulty.

  3. added this to the v3.4.0 milestone on Jul 11, 2020
  4. modified the milestones: v3.4.0, v3.5.0 on Jan 27, 2021
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

    Difficulty: Mediumhttps://matplotlib.org/devdocs/devel/contribute.html#good-first-issuestopic: sphinx extension🌱 Good first issueOpen a pull request against these issues if there are no active ones!

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions