構文ハイライト

mdBookは、独自テーマを使ったHighlight.jsで構文をハイライトします。

言語の自動検出は無効になっているため、次のように使用するプログラミング言語を指定するとよいでしょう。

```rust
fn main() {
    // Some code
}
```

対応言語

以下の言語に既定で対応しています。独自のhighlight.jsを用意して、さらに追加できます。

  • apache
  • armasm
  • bash
  • c
  • coffeescript
  • cpp
  • csharp
  • css
  • d
  • diff
  • go
  • handlebars
  • haskell
  • http
  • ini
  • java
  • javascript
  • json
  • julia
  • kotlin
  • less
  • lua
  • makefile
  • markdown
  • nginx
  • nim
  • nix
  • objectivec
  • perl
  • php
  • plaintext
  • properties
  • python
  • r
  • ruby
  • rust
  • scala
  • scss
  • shell
  • sql
  • swift
  • typescript
  • x86asm
  • xml
  • yaml

独自テーマ

テーマのほかの部分と同じように、構文ハイライトに使うファイルも独自のものへ置き換えられます。

  • highlight.js 新しい版を使いたい場合を除き、通常はこのファイルを上書きする必要はありません。
  • highlight.css highlight.jsが構文ハイライトに使うテーマです。

highlight.jsで別のテーマを使いたい場合は、そのウェブサイトからダウンロードするか、自分で作成します。名前をhighlight.cssにして、本のthemeフォルダーへ置いてください。

これで、既定のテーマの代わりに独自のテーマが使われます。

既定のテーマを改善する

既定のテーマが特定の言語で適切に見えない、または改善できると思った場合は、考えていることを説明して新しいIssueを投稿してください。著者が確認します。

改善案を含むプルリクエストを作成することもできます。

全体としては、派手な色を使いすぎず、明るく落ち着いたテーマにしてください。