如何在ASCIIdoc的链接文本中添加角色？

在ASCIIdoc里给链接显示文本的部分内容添加内联角色时，若文本包含逗号，直接嵌套角色语法会触发解析异常：

比如你原本的链接代码是：

https://example.com[Group 1: C1, E1]

想要给C1设置role1、E1设置role2，直接写成下面的形式会因为逗号被ASCIIdoc误解析为链接属性的分隔符，导致显示异常：

https://example.com[Group 1: [.role1]#C1#, [.role2]#E1#]

解决方法是用双引号包裹整个链接显示文本，让解析器将括号内的内容完整识别为显示文本，而不是拆分属性：

https://example.com["Group 1: [.role1]#C1#, [.role2]#E1#"]

这样处理后，内联角色[.role1]#C1#和[.role2]#E1#会正常生效，逗号也能正确显示，不会再出现解析异常。

内容的提问来源于stack exchange，提问作者Marko