使用方法

外掛程式會自動處理遺失的語法,並載入它們。要這麼做,您需要提供一個 URL 至目錄,其中包含您所有想要的語法。這可能是包含所有語法的本機目錄的路徑,或 CDN URL。

您可以按一下下列連結,下載所有可用的語法.
或者,您也可以複製 GitHub 儲存庫,並從中取出 `components` 資料夾。閱讀我們的 使用區段,以使用 CDN。

然後,您可以從 下載 頁面中下載 Prism 核心和任何外掛程式,而无需勾選任何語言(或僅勾選您想載入為預設的語言,例如,如果您經常使用某種語言,則您可能想儲存額外的 HTTP 要求)。

可透過設定物件 `Prism.plugins.autoloader`,獲得幾個額外的選項。

指定語法路徑

預設情況下,外掛程式會在 `components` 資料夾中尋找遺失的語法。如果您的檔案位於不同的位置,您可以使用 `languages_path` 選項指定它

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

注意: 自動載入器相當擅於猜測此路徑。您很可能不必變更此路徑。

使用開發版本

預設情況下,外掛程式使用語法的已縮小版本。如果您希望改用開發版本,您可以將 `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 會使用自動載入器自動載入遺失的語言。

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;
}
```