やってみる

アウトプットすべく己を導くためのブログ。その試行錯誤すらたれ流す。

AsciiDoctorでhighlight.jsを使いシンタックスハイライトする

これが一番簡単な方法だった。

前回まで

ブログを書くのにAsciiDocを使いたい。

シンタックス・ハイライトする方法

asciidoctor.org

Attributes設定

:source-highlighter: <value>

AsciiDocファイルに上記のように属性を設定する。

CodeRay, Pygments, Rougeはインストールが必要

To use CodeRay, Pygments, or Rouge, you must have the appropriate library installed on your system. See the CodeRay or Pygments section to find installation instructions. (We don’t yet have a section about Rouge).

翻訳すると以下。

CodeRay、Pygments、またはRougeを使用するには、システムに適切なライブラリがインストールされている必要があります。インストール手順については、CodeRayまたはPygmentsのセクションを参照してください。 (まだルージュに関するセクションはありません)。

highlight.jsはネット接続が必要

On the other hand, if you’re using a client-side syntax highlighting library like highlight.js or prettify, there’s no need to install additional libraries. The generated HTML will load the required source files from a CDN (or custom URL or file path).

翻訳すると以下。

一方、highlight.jsのようなクライアント側の構文ハイライトライブラリを使用している場合や、prettifyの場合は、追加のライブラリをインストールする必要はありません。生成されたHTMLは、CDN(またはカスタムURLまたはファイルパス)から必要なソースファイルをロードします。

コンパイル時点でネット接続されていればCDNから取得してくれる。つまりAsciiDocファイルに以下の設定をするだけでOK。

:source-highlighter: highlightjs

所感

highlight.jsならインストール不要で楽ちん。