问题描述
我有一个网页,其标题由asciidoctor
生成,标题为“ C ++”。在源代码中,我使用了{cpp}
字符替换属性,但是在生成的HTML文件中,asciidoctor将其呈现为C++
而不是普通的C++
。我只是想知道网络搜索引擎的索引编制,这两个变体之间是否有任何区别。 (例如,《 Google HTML样式指南》建议使用avoiding HTML entities)。或者,是否有可能选择强制asciidoctor产生C++
?
解决方法
内置的{cpp}
属性使用HTML实体表示加号,因为它可能会在URL中使用。如果确定使用不涉及URL,则只需重新定义属性即可:
:cpp: C++
,
我认为可以安全地假设搜索引擎足够聪明,可以在编制索引之前对HTML实体进行解码。
样式指南说避免它们的原因很可能是为了提高可读性。 Google的JS样式指南中有一个similar recommendation:
/* Best: perfectly clear even without a comment. */ const units = 'μs'; /* Allowed: but unncessary as μ is a printable character. */ const units = '\u03bcs'; // 'μs' /* Poor: the reader has no idea what character this is. */ const units = '\u03bcs';