문제 해결
이 페이지에서는 알려진 문제들에 대한 해결 방법을 설명합니다.
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 확장에서 요구하는 문법을 지키지 않았기 때문입니다.
<div align="center">
Hello, world!
</div>
이를 다음과 같이 고치면 제대로 변환이 됩니다.
<div align="center" markdown>
Hello, world!
</div>