トラブルシューティング
このページでは、既知の問題の解決策について説明します。
WeasyPrintは外部ライブラリをインポートできません
症状: Windows PowerShellでmmgコマンドを入力すると、次のエラーが発生します。
PS D:\> mmg --version
-----
WeasyPrint could not import some external libraries. Please carefully follow the installation steps before reporting an issue:
https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#installation
https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#troubleshooting
-----
Traceback (most recent call last):
.....
OSError: cannot load library '.....': .....
原因: これは、WindowsにGTKが正しくインストールされていないと発生する問題です。これは、Pythonをインストールする前にGTKをインストールした場合にも発生する可能性があります。
解決策: 最新のGTK3インストーラーをダウンロードしてインストールします。
参考: WeasyPrint > First steps > Installation > Windows
WindowsでGLib-GIO-WARNING警告が出力される
症状: Windows PowerShellでmmgを使用すると、次の警告が出力されます。
GLib-GIO-WARNING **: 13:19:49.232: Unexpectedly, UWP app `*******.*******_0.0.00.0_****__************' (AUMId `*******.*******_************!App') supports 00 extensions but has no verbs
この警告メッセージはMMGの動作に影響を与えないため、無視しても構いません。
解決策: 警告メッセージに記載されているWindowsアプリをMicrosoft Storeから削除または再インストールします。
例えば、次の場合はClipchampアプリを削除または再インストールします。
GLib-GIO-WARNING **: 13:19:49.232: Unexpectedly, UWP app `Clipchamp.Clipchamp_2.7.10.0_neutral__yxz26nhyzhsrt' (AUMId `Clipchamp.Clipchamp_yxz26nhyzhsrt!App') supports 41 extensions but has no verbs
参考: https://stackoverflow.com/a/71053742/17167856
MarkdownにHTMLタグが含まれている場合、HTMLまたはPDF変換が正しく行われない
MMG は HTML を生成するとき、markdown ファイルには markdown パッケージを使用します。 そして PDF を生成する場合も、まず HTML に変換してから PDF に変換します。
しかし、markdown に HTML タグが含まれている場合、次の場合には正しく変換されないことがあります。 これは、markdown パッケージが Markdown in HTML Extension で記述されている構文を要求しているためです。
<div align="center">
Hello, world!
</div>
次のように修正すると、正しく変換されます。
<div align="center" markdown>
Hello, world!
</div>