docs: remove legacy Kramdown topic-type IAL markers (openvox 8.x)#312
Merged
Merged
Conversation
The openvox 8.x docs carried 143 standalone Kramdown topic-type IAL
markers ({:.concept}, {:.section}, {:.task}, {:.reference}, {:.example})
inherited from the old DITA-style Puppet docs build. Kramdown attaches
them as CSS classes to the following heading, but the jekyll-vitepress
theme has no styling for those classes, so they are inert dead cruft.
Remove all of them across 17 files. Lookalike IALs are preserved:
{:class="resolution"} (a real styling class) and {::fact}-style
template/fact examples. Where a marker was orphaned between two blank
lines, the duplicate blank is collapsed; other blank lines are left
untouched.
Verified: jekyll build passes, headings render identically (with their
ids intact), and no markers render as literal text.
Closes OpenVoxProject#274
Signed-off-by: Michael Harp <mike@mikeharp.com>
miharp
force-pushed
the
docs/issue-274-kramdown-ial
branch
from
bfe7459 to
4047532
Compare
tuxmea
approved these changes
Jun 8, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Removes 143 legacy Kramdown topic-type IAL markers (
{:.concept},{:.section},{:.task},{:.reference},{:.example}) from the openvox 8.x docs. They're leftovers from the old DITA-style Puppet docs build.On the deployed site, Kramdown attaches each marker as a CSS class to the following heading (e.g.
<h2 class="concept">), but thejekyll-vitepress-themehas no styling for those classes — verified in both the source SCSS and the built CSS bundles — so they're completely inert dead cruft.Changes
{:.<type>}IAL lines across 17 files indocs/_openvox_8x/{:class="resolution"}(a real styling class, 6×) and{::fact}-style template/fact examples (19×)Pure deletions (144 lines: 143 markers + 1 collapsed orphan blank), no reformatting.
Verification
jekyll buildpasses{:.…}markers render as literal text in the built HTML (they never did on the deployed site — only in GitHub's CommonMark preview)class="concept"/class="section"attributes are gone from the rendered headings, which still render with theirids intactCloses #274