콘텐츠로 이동

문제 해결

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에 등록되지 않아서입니다. 해결하려면 먼저 윈도우키를 눌러 검색창을 열고 "advanced system settings"를 검색해 클릭해주세요.

Windows Path Solution 1

그런 다음 오른쪽 아래에 있는 "환경 변수" 버튼을 클릭하세요.

Windows Path Solution 2

아래 그림과 같이 PATH 변수를 선택하고 "편집" 버튼을 클릭합니다. "새로 만들기" 버튼을 클릭하여 경고 메시지에 나온 경로를 추가해주세요. 경로는 사용자마다 다를 수 있으니 반드시 본인의 경로를 추가하셔야 합니다. 모든 창에서 "확인" 버튼을 클릭하여 설정을 완료합니다.

Windows Path Solution 3

이제 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 확장에서 요구하는 문법을 지키지 않았기 때문입니다.

<div align="center">
Hello, world!
</div>

이를 다음과 같이 고치면 제대로 변환이 됩니다.

<div align="center" markdown>
Hello, world!
</div>