Skip to content

536 html tags visible in technical specification pages - #201

Merged
jpherr merged 2 commits into
mainfrom
536-html-tags-visible-in-technical-specification-pages
Jul 10, 2026
Merged

536 html tags visible in technical specification pages#201
jpherr merged 2 commits into
mainfrom
536-html-tags-visible-in-technical-specification-pages

Conversation

@jpherr

@jpherr jpherr commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

What type of PR is this? (check all applicable)

  • Refactor
  • Feature
  • Bug Fix
  • Optimization
  • Documentation Update

Description

Enable links in description blocks.

We currently have a number of instances where html tags are being output to the page inside description blocks instead of displaying active links.

Example: https://digital-land.github.io/specification/specification/tree-preservation-order/

This is due to Jinja escaping HTML. This change flags the html as safe and allows the tags to be rendered on the page without escaping.

There is also a change to rectify broken anchors since IDs were out of date.

Note: This change was attempted by Pedro previously, but applied to the html files which are generated during the build step. So whilst the change was merged, all the changes were overwritten during the build because the source markdown files had not been updated.

Related Tickets & Documents

QA Instructions, Screenshots, Recordings

Before After
Screenshot 2026-07-02 at 13 41 55 Screenshot 2026-07-02 at 13 42 52

Added/updated tests?

We encourage you to keep the code coverage percentage at 80% and above. Please refer to the Digital Land Testing Guidance for more information.

  • Yes
  • No, and this is why: visual output
  • I need help with writing tests

[optional] Are there any post deployment tasks we need to perform?

[optional] Are there any dependencies on other PRs or Work?

jpherr added 2 commits July 3, 2026 08:45
We currently have a number of instances where html tags are being output
to the page inside description blocks instead of displaying active links.

This is due to Jinja escaping HTML. This change flags the html as safe
and allows the tags to be rendered on the page without escaping.
Previously links themselves were broken due to html tags being escaped
by Jinja. They were fixed in a previous commit (a8990bd)
but numerous anchor links are out of data and no longer works. This
change corrects the links.
@jpherr
jpherr force-pushed the 536-html-tags-visible-in-technical-specification-pages branch from 76f9e47 to 0b58257 Compare July 3, 2026 07:45
@jpherr
jpherr merged commit ca5c334 into main Jul 10, 2026
1 check passed
@jpherr
jpherr deleted the 536-html-tags-visible-in-technical-specification-pages branch July 10, 2026 07:48
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.

html tags visible in technical specification pages

1 participant