Skip to content

:numref: not working in :include: directives #14413

@pyenyo

Description

@pyenyo

Describe the bug

I've seen this bug posted here before but I want to know if anyone has come up with alternative solutions to just putting the :include: files in an exclude_patterns array. This is what I've done for now, but the project I'm working on is very extensive and we've been specifically asked by our customer to include inline references and links wherever possible. Many of our .rst files reference other .rst files, which I do using the :doc: directive. This throws errors when the :doc: directive is pointing to a file in the exclude_patterns array, which happens often. I'm kind of at a loss here, we need to use :numref: (I know :ref: will work fine but the figures and tables need to be numbered in our project) and our :include: files are huge and copying them into the other .rst files would be a massive duplication of work and a pain. Whenever I make a build I get the duplicate label error, or any number is not assigned, or that the document doesn't exist (if it's referencing one in the exclude_patterns array).

Has anyone actually figured out a workaround for this issue? I'm surprised this hasn't been fixed yet, this seems like a huge bug. I can't copy and paste any content here unfortunately as it is proprietary information.

How to Reproduce

Our project is proprietary, unfortunately cannot include info but others who have made tickets for this issue are a good representation of the issue I'm having

Environment Information

Using VS code

Sphinx extensions

No extensions used

Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions