このガイドでは、Discourse の投稿内のコードブロックで使用するプログラミング言語の選択方法と、構文ハイライトを抑制する方法について説明します。
必要なユーザーレベル: 全てのユーザー
投稿で3つのバッククォートを使用してコードを囲むと、Discourse は highlight.js を使用してコードの構文ハイライトを自動的に検出して適用します。ただし、自動検出が期待どおりに機能しない場合は、プログラミング言語を指定できます。
コードブロックのプログラミング言語の指定
コードブロックのプログラミング言語を指定するには、最初のバッククォートの直後に言語名を入力します。
``` your_language
# ここにコードを記述
```
たとえば、Ruby を指定するには次のようになります。
``` ruby
3.times do |stuff|
stuff.do
end
```
結果は次のようになります。
3.times do |stuff|
stuff.do
end
言語は、サイトで構文ハイライト用に設定されている highlighted languages のいずれかである必要があります。言語が機能しない場合は、サイト管理者に確認してください。
ハイライトの抑制
構文ハイライトを一切行わないようにしたい場合は、言語として text、plain、または pre を使用できます。
``` text
ここにハイライトしたくないテキスト
```
結果はハイライトなしのプレーンテキストとして表示されます。
ここにハイライトしたくないテキスト
ベストプラクティス
- 自動検出がコードを正しく認識しない場合は、常に言語を指定してください。
- 管理者向け: 選択した言語が
highlighted languagesサイト設定で構成されていることを確認してください。