search

sphinx-contrib / confluencebuilder

Confluence Markup Builder Plugin for Sphinx
BSD 2-Clause "Simplified" License
315 stars 99 forks source link

Debugging "unknown node:" #969

Closed neongreen-sc closed 2 months ago

neongreen-sc commented 4 months ago

During a build, I encounter this warning:

WARNING: unknown node: PassthroughTextElement

However, it doesn't say which page causes it.

How can I debug this? I tried passing -vvv to sphinx-build but it didn't help.

neongreen-sc commented 4 months ago

Update: after searching the entire GitHub for PassthroughTextElement, it turns out that it comes from sphinx-design. Makes sense.

Still, is there any option to report document path / debug info / anything when an unknown node is encountered?

jdknight commented 4 months ago

At this time, there is no detailed output on unknown node scenarios in this extension. It does look like docutils does track some data that could be used to better detail the origin of unknown nodes.

jdknight commented 3 months ago

Changes have been introduced via #980, which should now attempt to print the origin document and line number when an unknown node is detected.

jdknight commented 2 months ago

v2.6 is now available on PyPI -- marking as closed.