sphinx-build reports duplicated label

[gucio321]

Describe the bug

I'm getting the following warnings in my project :

/home/user/git/fizyka/assets/dzial_1/temat_3/intro.rst:34: WARNING: duplicate label of equation V, other instance in assets/dzial_1/index

How to Reproduce

$ git clone https://github.com/gucio321/fizyka && cd fizyka
$ pip install -r requirements.txt
$ make html

you'll see warnings

Expected behavior

warning about duplicated label shouldn't appear because the label isn't duplicated

Your project

https://github.com/gucio321/fizyka

Screenshots

No response

OS

linux - fedora 34

Python version

Python 3.9.7

Sphinx version

4.2.0

Sphinx extensions

extensions = [ "sphinx.ext.githubpages", "sphinxcontrib.images", "myst_parser", "cloud_sptheme.ext.issue_tracker" ]

Extra tools

No response

Additional context

No response

[tk0miya]

The label V is defined at assets/dzial_1/temat_3/intro.rst. It's appeared twice in your project because assets/dzial_1/index.rst includes the file. In other words, both assets/dzial_1/index.rst and assets/dzial_1/temat_3/intro.rst have the same label. It's correct behavior.

[gucio321]

hmm, but intor.rst is only used in index.rst so this label isn't duplicated in fact. the intro.rst isn't used in any other way and I'd expect file is not included anywhere warning for it.
Why does sphinx consider it otherway than from assets/dzial_1/index.rst?

[tk0miya]

Sphinx scans source files from the source directory. So intro.rst is also processed because it has .rst extension. As a result, the label is defined twice. To avoid this behavior, please consider 1) renaming the file to other extensions (like .txt), or 2) setting exclude_patterns up in your conf.py.

[gucio321]

1. renaming the file to other extensions (like .txt),

I don't think it is good solution because:

• rst syntax will not work anymore
• it is after all rst file, so it should have rst extension

2. setting exclude_patterns up in your conf.py

it may work but it will be a bit annoing to add a new path each time i'm adding a new chapter/topic

I cannot even understand why it isn't a bug.
is including another rst files non-standard solution?
And why Sphinx scans source files from the source directory.? Shouldn't it scan only the files included anyway?

[tk0miya]

And why Sphinx scans source files from the source directory.? Shouldn't it scan only the files included anyway?

This is the current design of Sphinx. Indeed, it would be nice if improved. We'll welcome your contribution :-)