Skip to content

Unify heading anchor format and cross-file link style#597

Open
abn2357 wants to merge 4 commits into
tronprotocol:masterfrom
abn2357:unify_english_anchor
Open

Unify heading anchor format and cross-file link style#597
abn2357 wants to merge 4 commits into
tronprotocol:masterfrom
abn2357:unify_english_anchor

Conversation

@abn2357
Copy link
Copy Markdown
Contributor

@abn2357 abn2357 commented May 12, 2026

Summary

  • Convert <a id=\"x\"></a> tags and {: #x } syntax to inline { #id } attr_list attributes on the target heading across all docs with anchors.
  • Rename non-descriptive anchor IDs (e.g. #step1, #defi, #gasfree, #rndstep1, #other, #get-energy) to kebab-case slugs that fully reflect the heading text, and update all in-file link references.
  • Replace absolute https://tronprotocol.github.io/documentation-en/... cross-file links with repo-relative file.md#anchor paths so navigation works locally and survives site moves; retarget the stale architecture/plugin/#tron-event-subscription link to architecture/event.md and the moved developers/litefullnode link to using_javatron/litefullnode.md.

Test plan

  • Build the MkDocs site locally and verify each renamed heading still receives the expected anchor.
  • Click-through every link touched in this PR and confirm it resolves to the intended page/section.
  • Confirm no <a id=\"...\"></a>, {: #...}, or https://tronprotocol.github.io/documentation-en/... patterns remain (grep).

abn2357 added 4 commits May 12, 2026 17:13
Convert <a id="x"></a> tags and {: #x } syntax to inline { #id }
attributes on the target heading. Rename #primary/backup_upgrade and
#standard_process to kebab-case slugs and update their refs.
Replace vague or partial IDs (#step1, #other, #get-energy, #defi, etc.)
with kebab-case slugs derived from the full heading, and update all
in-file link references.
Replace https://tronprotocol.github.io/documentation-en/... links with
repo-relative file.md (or file.md#anchor) references so cross-file
navigation works locally and survives site moves. Retarget the stale
architecture/plugin link to architecture/event.md and the moved
developers/litefullnode link to using_javatron/litefullnode.md.
The previous absolute URL auto-linked in the renderer; the relative
path replacement did not, leaving the reference as plain text. Wrap
it in Markdown link syntax and correct the anchor to match the
heading (#leveldb-startup-optimization-tool).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant