如何在GitLab/GitHub中使用AsciiDoc实现彩色文本的正常渲染?
AsciiDoc彩色文本不显示排查方案
- 确认渲染工具匹配
你参考的语法示例属于asciidoc-py的专属扩展特性,如果你当前使用的是Asciidoctor等其他AsciiDoc渲染工具,这类自定义格式属性默认不会被识别,要么切换回asciidoc-py工具渲染,要么额外安装对应兼容插件。 - 检查样式文件引入
你测试的颜色、背景色、特殊划线这类效果完全依赖配套的CSS样式生效,需要确认渲染生成HTML文件时,是否正确嵌入了asciidoc-py自带的样式代码。如果生成的HTML中没有对应样式定义,浏览器自然不会展示预期的彩色效果。 - 核对源码语法
你当前使用的[属性列表]#文本#、[属性列表]*文本*是标准的行内角色写法,要注意属性列表和包裹符号之间不能有多余空格,包裹文本的#、*要成对出现,不要出现漏写、错写的情况。
内容的提问来源于stack exchange,提问作者Brian Hawkins
相关产品推荐
相关产品推荐

