restructuredtext - Sphinx warning: "Duplicate substitution definition name" - where is the error?

Question

When I build my Sphinx project I get a series of errors like this one -- three times:

content/swdocs.rsts:6: WARNING: Duplicate substitution definition name: "copy".

sdwocs.rsts contains common definitions. I include it in each ReStructuredText file in my doctree.

Many of the files in the doctree include additional RST files, but those files should not include swdocs.rsts, since they are effectively parts of a file that already includes it.

Something has gone wrong with this scheme -- presumably an included RST file that includes its own copy of swdocs.rsts -- but where? The message gives me no clue.

I've tried to find the error the hard way, by looking at every file where it could possibly be, and I've found nothing. Presumably something is wrong about my analysis of the problem, and it is hiding in some place or some form where it "could not possibly" be... but without a more informative message, I'm stuck.

How to get unstuck?

question from:https://stackoverflow.com/questions/65878326/sphinx-warning-duplicate-substitution-definition-name-where-is-the-error

Answer 1

Waitting for answers