使い方

プラグインは、欠落している文法を自動的に処理して、あなたのためにロードします。これを行うためには、必要なすべての文法のディレクトリへの URL を提供する必要があります。すべての文法を含むローカルディレクトリへのパスや、CDN URL を使用できます。

次のリンクをクリックすると、利用可能なすべての文法をダウンロードできます。.
または、GitHub リポジトリをクローンして、そこから components フォルダを取得することもできます。CDN を使用するには、使用方法のセクションを参照してください。

次に、ダウンロードページから Prism コアと任意のプラグインをダウンロードできます。言語のチェックはせずに（またはデフォルトでロードする必要がある言語だけチェックします。たとえば、頻繁に特定の言語を使用している場合は、追加の HTTP リクエストを保存できる可能性があります）。

設定オブジェクト Prism.plugins.autoloader を使用して、いくつかの追加オプションを使用できます。

文法パスの指定

デフォルトでは、プラグインは components フォルダ内で欠落している文法を検索します。あなたのファイルが別の場所に存在する場合、languages_path オプションを使用して指定できます。

Prism.plugins.autoloader.languages_path = 'path/to/grammars/';

注意: Autoloader はこのパスを推測するのがかなり優れています。このパスを変更する必要はほとんどありません。

開発バージョンの使用

デフォルトでは、プラグインは文法の minify バージョンを使用します。代わりに開発バージョンを使用したい場合は、use_minified オプションを false に設定できます。

Prism.plugins.autoloader.use_minified = false;

追加の依存関係の指定

すべてのデフォルトの依存関係はすでにプラグインに含まれています。ただし、特定のコードブロックに対して追加の依存関係をロードする場合があります。そのためには、コンマ区切りの言語エイリアスのリストを含む <code> または <pre> タグに data-dependencies 属性を追加するだけです。

<pre><code class="language-pug" data-dependencies="less">
:less
	foo {
		color: @red;
	}
</code><pre>

文法の再ロードを強制する

通常、プラグインは文法がすでに存在する場合、その文法を再ロードしません。ただし、特定のケースではそうする必要があります。data-dependencies 属性でエイリアスの後に感嘆符を追加すると、その言語が再ロードされます。

<pre class="language-markup" data-dependencies="markup,css!"><code>

例

デフォルトでは、このページには言語がロードされないことに注意してください。

Perl コードを使用した基本的な使用

my ($class, $filename) = @_;

TypeScript の ts を使用したエイリアスのサポート

const a: number = 0;

Pug で使用される Less フィルター

:less
	foo {
		color: @red;
	}

Markdown

Markdown は Autoloader を使用して、欠落している言語を自動的にロードします。

The C# code will be highlighted __after__ the rest of this document.

```csharp
public class Foo : IBar<int> {
	public string Baz { get; set; } = "foo";
}
```

The CSS code will be highlighted with this document because CSS has already been loaded.

```css
a:hover {
	color: green !important;
}
```