Skip to content

Generating labels could prepend filename (internally) to create globally unique labels #36

Open

Description

@mmcky

Describe the problem

When adding in simple examples such as:

```{exercise}
:label: exercise-1
```

this will cause a warning to be issued if another exercise is labeled the same way in another document.

This is a pretty common pattern and the context should be handeled by the extension.

The downside is referencing would need to be documented if you want to reference an example from another document such as using <filename>:example-1 as a standard reference

Link to your repository or website

No response

Steps to reproduce

  1. build a document with the same label in two documents
  2. build and a warning will be issued such as
/Users/matthewmckay/repos-collab/continuous_time_mcs/ctmc_lectures/uc_mc_semigroups.md: WARNING: duplicate example label 'example-1', other instance in /Users/matthewmckay/repos-collab/continuous_time_mcs/ctmc_lectures/generators.md

The version of Python you're using

No response

Your operating system

No response

Versions of your packages

No response

Additional context

No response

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

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions