hlxsites / prisma-cloud-docs-website

blocks and gdoc authored content for https://docs.prismacloud.io
Apache License 2.0
3 stars 2 forks source link

[AsciiDoc conversion] ID attributes #204

Closed iansk closed 10 months ago

iansk commented 10 months ago

Writers set element IDs throughout the content so that they can link directly to specific steps in procedures or specific paragraphs. The worker isn't properly handling the AsciiDoc syntax for setting ID attributes, and so we're seeing the following impacts:

For example, see "Step 2" on this page:

https://main--prisma-cloud-docs-website--hlxsites.hlx.live/en/enterprise-edition/content-collections/connect/connect-cloud-accounts/onboard-your-alibaba-account/set-up-your-alibaba-account

The underlying AsciiDoc source looks like this:

. [[create-a-ram-role]]Create a RAM role.

The directive for setting the ID attribute is being rendering as a link. It should be invisible:

franklin-uat-id-attr

The id for the li element isn't being set:

franklin-uat-id-attr-view-source

The HTML output should look like this:

<li id="create-a-ram-role" class="step">

Reference info: