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

[AsciiDoctor conversion] tt inline macro #138

Closed iansk closed 1 year ago

iansk commented 1 year ago

We need to port a custom AsciiDoctor extension forward to Franklin.

We have a number of AsciiDoctor extensions. We can deprecate all of them except one inline macro that has the following syntax:

tt:[text]

The input text is typically some sort of one or two word "label", that's styled as a pill with white text and a black background. For example:

tt:[Update]

Output:

franklin-uat-tt-macro-output

Example AsciiDoc input:

https://github.com/hlxsites/prisma-cloud-docs/blob/a0d4175a6e85dd7e362e141413520aeb34fe3938/docs/en/cspm/rn/prisma-cloud-release-information/features-introduced-in-2023/features-introduced-in-march-2023.adoc?plain=1#L48

|tt:[Update] *AWS Config*

Current Franklin output:

https://main--prisma-cloud-docs-website--hlxsites.hlx.page/prisma/prisma-cloud/en/cspm/rn/prisma-cloud-release-information/features-introduced-in-2023/features-introduced-in-march-2023

franklin-uat-tt-macro-current-franklin-output

Desired output:

Here's the equivalent page on our current doc site:

https://docs.paloaltonetworks.com/prisma/prisma-cloud/prisma-cloud-release-notes/prisma-cloud-release-information/features-introduced-in-2023/features-introduced-in-march-2023

franklin-uat-tt-macro-current-aem-output
maxakuru commented 1 year ago

141 implements this client-side, imo that's a better option than a custom conversion rule for a relatively small text style