/syntax-highlighting-line-no-test-docbook

测试 Docbook 中代码语法高亮和行号功能 Test code syntax highlighting and line numbering in docbook

Primary LanguageHTML

简介

在写编程教程时，语法高亮功能往往很有用。 这个小实例测试在 GNU/Linux 中 Docbook 中代码语法高亮和行号功能。

看起来的样子

image

自定义编程语言

10.1. Syntax Highlighting 对自定义语言给出了一个例子。

  • 在 docbook-xsl-1.79.1/highlighting/ 中加入你自己的语言，如 arduino-hl.xml (从 cpp-hl.xml 复制而来), 修改里面的关键字和别的内容。
  • 在 docbook-xsl-1.79.1/highlighting/xslthl-config.xml 中注册上面的文件。
  • 可以在 docbook-xsl-1.79.1/html/ 加一个自己的配置文件，如 highlight-arduino.xsl. 然后在 config.xsl 导入它。
  • 在 config.xsl 中也可以做一些修改。
  • 在 language-hl.xml 中可用正则表达式来匹配关键字。

arduino-hl.xml 中对下面这些词作高亮处理。

  • multiline-comment
  • oneline-comment
  • string
  • hexnumber
  • number
  • keywords

所有的 keywords 用同一种颜色，显然不够，比如代码中的 if, else, for 等 flow control 是不是需要别的高亮？当然，这取决于你想要的效果。

因为 xslthl 是开源的，因此，如果觉得已提供的配置不能满足要求，可以直接修改源代码并提交补丁。

颜色方案

xslthl Examples 有一些例子。

blog 记录

在 blog 上写了一篇相关笔记，见 在 Docbook 中给源代码加语法高亮

另外，最近发现 AsciiDoc 是一个好的工具。

Introduction

Test code syntax highlighting and line numbering functionalities in docbook.