Skip to content

Unhelpful Warning for Missing Index references #2838

@cycomachead

Description

@cycomachead

Proposal

I'm talking about warnings like this:

⚠️  manual-index.md Cross reference target was not found: index-kfw0kijjdo
⚠️  manual-index.md Cross reference target was not found: index-smivf5gxkn

These read as a Term, [Paragraph] on the index page, I believe. It's actually hard to interpret interpret if that's the specific issue. On the built index, the "Paragraph" text does actually like to the right page, just the text is 'wrong'.

Would it be possible to at least get the term in the error message, if not the source file/line location?

Additional notes

I'm in the process of converting a large book from Quarto (initially from a painstakingly typeset Word document) to Jupyter Book 2, for both a web version and a typeset (latex) PDF.
We have about 1000 index entries, and in the conversation, the location of many of these was put after the paragraph and not before. My bad. I'm happy to fix them, and I don't hate there's a basic 'Paragraph' text as a guess. The real problem is I can't super easily go make sure I'm getting all the index entries. (I'd like to, ideally, group them by source location of work on a section at time, rather than going A-Z from the built index.)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions