在 MoinMoin 中使用 Pygments¶
從 Pygments 0.7 開始,原始碼發行版提供了一個 Moin 解析器外掛程式,可用於在 Moin wiki 頁面中取得 Pygments 的語法高亮顯示。
若要使用它,請將 Pygments 發行版中的 external/moin-parser.py 檔案複製到您 Moin 實例的 data/plugin/parser 子目錄中。編輯檔案頂端的選項 (目前為 ATTACHMENTS
和 INLINESTYLES
),並將檔案重新命名為解析器指令應該具有的名稱。例如,如果您將檔案命名為 code.py
,您可以使用此 Wiki 標記取得已高亮顯示的 Python 程式碼範例
{{{
#!code python
[...]
}}}
其中 python
是要使用的 Pygments 詞法分析器的名稱。
此外,如果您將 ATTACHMENTS
選項設定為 True,Pygments 也將會針對所有未註冊其他解析器的附件的檔案名稱進行呼叫。
您有責任包含 CSS 規則,將 Pygments CSS 類別對應到顏色。您可以使用 pygmentize 輸出樣式表檔案,將其放入您 Moin 實例的 htdocs 目錄中,然後將其包含在 Moin 設定中的 stylesheets 設定選項中,例如:
stylesheets = [('screen', '/htdocs/pygments.css')]
如果您不想這麼做,並且願意接受較大的 HTML 輸出,您可以將 INLINESTYLES
選項設定為 True。