Skip to content

Fix id names in rst renders after docutils 0.18#2081

Open
pudiva wants to merge 1 commit into
masterfrom
rst-auto-id-prefix
Open

Fix id names in rst renders after docutils 0.18#2081
pudiva wants to merge 1 commit into
masterfrom
rst-auto-id-prefix

Conversation

@pudiva

@pudiva pudiva commented Jun 30, 2026

Copy link
Copy Markdown

Fix id names changing in rst renders with the upgrade to docutils 0.18 by enforcing the old default value for auto_id_prefix.

See: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-18-2021-10-26

co-authored-by: @TylerDixon

Copilot AI review requested due to automatic review settings June 30, 2026 15:32
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 15:33 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 15:33

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR aims to stabilize reStructuredText (Docutils) HTML anchor/id generation after upgrading to Docutils 0.18 by explicitly setting auto_id_prefix to the pre-upgrade default.

Changes:

  • Adds an explicit auto_id_prefix override in the Docutils settings_overrides used by the rest2html renderer.
Show a summary per file
File Description
lib/github/commands/rest2html Overrides Docutils settings to control how automatic IDs are generated in rendered HTML.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Low
Comment thread lib/github/commands/rest2html
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from 0f716e8 to 24f8e1f Compare June 30, 2026 16:30
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 16:30 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 16:31
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from 9b3bdad to d9f8ee6 Compare June 30, 2026 17:05
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 17:05 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 17:06
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from d9f8ee6 to 5c2f877 Compare June 30, 2026 17:22
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 17:22 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 17:23
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from 5c2f877 to e329f55 Compare June 30, 2026 17:26
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 17:27 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 17:27
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from e329f55 to d7b5b51 Compare June 30, 2026 17:32
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 17:33 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 17:33
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from d7b5b51 to d1da2c3 Compare June 30, 2026 17:35
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 17:35 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 17:35
@pudiva

pudiva commented Jun 30, 2026

Copy link
Copy Markdown
Author

i don't get why the tests are failing... it looks like they're stuck running 0470db7 even though i force pushed to d1da2c3 ...

Fix id names changing in rst renders with the upgrade to docutils 0.18
by enforcing the old default value `id` for `auto_id_prefix`.

See: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-18-2021-10-26

co-authored-by: Tyler Dixon <tylerdixon@github.com>
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from d1da2c3 to a5d7bbe Compare June 30, 2026 18:47
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 18:47
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from a5d7bbe to c430d21 Compare June 30, 2026 18:56
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 18:56 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 18:57
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from c430d21 to f0c175d Compare June 30, 2026 19:03
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 19:03 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 19:04
@pudiva

pudiva commented Jun 30, 2026

Copy link
Copy Markdown
Author

oh okay it's because those were running on the merge with the master branch... so i rebased on top of it instead of v6.0.0 and it's passing...

@pudiva pudiva force-pushed the rst-auto-id-prefix branch from f0c175d to 0b012a4 Compare June 30, 2026 20:31
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 20:31 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 20:31
@pudiva pudiva force-pushed the rst-auto-id-prefix branch from 0b012a4 to a5d7bbe Compare June 30, 2026 20:32
GitHub Advanced Security started work on behalf of pudiva June 30, 2026 20:32 View session
GitHub Advanced Security finished work on behalf of pudiva June 30, 2026 20:33
@pudiva

pudiva commented Jun 30, 2026

Copy link
Copy Markdown
Author

i had to base this on top of v6.0.0 because master already has unreleased changes that cause other problems for me. could someone help me figure out the right way to incorporate this change in the codebase?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants