トラブルシューティング

English | Français | 한국어 | 日本語

このページでは、既知の問題の解決策について説明します。

Windowsでmmgコマンドが見つからない問題

$ pip3 install mmg
...
  WARNING: The script mmg.exe is installed in 'C:\Users\...\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts' which is not on PATH.
  Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
Successfully installed mmg-2.0.1

この警告は、pipでインストールされたmmg.exeのパスが環境変数PATHに登録されていないために表示されます。 解決するには、まずWindowsキーを押して検索ボックスを開き、"advanced system settings"を検索してクリックしてください。

次に、右下にある「環境変数」ボタンをクリックしてください。

下の画像のようにPATH変数を選択し、「編集」ボタンをクリックします。「新規」ボタンをクリックして、警告メッセージに表示されたパスを追加してください。パスはユーザーごとに異なる場合がありますので、必ず自分のパスを追加してください。 すべてのウィンドウで「OK」をクリックして設定を完了します。

これでPATH変数にパスが追加されたので、コマンドプロンプトを開いてmmgコマンドを使用できます。

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>