워드프레스에서 MathJax-LaTeX을 사용하여 수식을 적용하려고 할 때 문제가 발생하는 이유는 여러 가지가 있을 수 있습니다. 아래에서 가능한 원인과 해결 방법을 정리해 드립니다.
1. 플러그인이 제대로 활성화되지 않음
MathJax-LaTeX 플러그인을 설치했지만 활성화되지 않은 경우, 수식이 표시되지 않습니다.
✅ 해결 방법:
- 워드프레스 관리자 패널에서
플러그인 > 설치된 플러그인으로 이동하여 “MathJax-LaTeX”이 활성화되어 있는지 확인하세요.
2. 플러그인이 올바르게 설정되지 않음
MathJax-LaTeX 플러그인에는 여러 설정 옵션이 있습니다. 기본적으로 $...$ 또는 \[...\] 형식으로 입력해야 수식이 인식됩니다.
✅ 해결 방법:
설정 > MathJax-LaTeX에서 적절한 설정이 되어 있는지 확인하세요.- 기본적으로
$기호를 사용하는 것이 차단될 수도 있으므로,\( ... \)또는\[ ... \]형태로 수식을 입력해 보세요.- 예제:
\( E = mc^2 \)\[ \sum_{i=1}^{n} i = \frac{n(n+1)}{2} \]
- 예제:
3. 다른 플러그인과의 충돌
다른 플러그인(특히 캐싱 또는 보안 관련 플러그인)이 MathJax 스크립트 로딩을 방해할 수 있습니다.
✅ 해결 방법:
- 플러그인을 하나씩 비활성화한 후 다시 시도해 보세요.
WP Super Cache,Autoptimize,Cloudflare등의 캐싱 플러그인을 사용 중이라면 일시적으로 비활성화 후 테스트하세요.
4. 테마에서 JavaScript가 차단됨
일부 테마는 외부 JavaScript 실행을 차단할 수 있습니다. MathJax는 JavaScript를 기반으로 동작하므로 차단되면 수식이 표시되지 않습니다.
✅ 해결 방법:
테마 편집기에서<head>태그 안에 아래 코드를 추가해 보세요.<script type="text/javascript" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-AMS-MML_HTMLorMML"> </script>- 또는
functions.php에 아래 코드를 추가하여 MathJax 스크립트를 로드할 수도 있습니다.function add_mathjax() { echo '<script type="text/javascript" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>'; } add_action('wp_head', 'add_mathjax');
5. 캐시 문제
브라우저 캐시나 사이트 캐시가 수식이 렌더링되지 않는 원인이 될 수 있습니다.
✅ 해결 방법:
- 브라우저 캐시를 삭제하고 새로고침 (
Ctrl + Shift + R또는Cmd + Shift + R) 해보세요. WP Super Cache또는W3 Total Cache같은 캐시 플러그인을 사용 중이라면 캐시를 비우고 다시 확인하세요.
6. HTML 편집기 사용 문제
워드프레스에서 수식을 추가할 때, 블록 에디터(구텐베르그)나 클래식 에디터에서 적절한 블록을 사용해야 합니다.
✅ 해결 방법:
- 구텐베르그 블록 에디터:
- “HTML 블록”을 사용하여
<p>\( x^2 + y^2 = r^2 \)</p>같은 형식으로 입력.
- “HTML 블록”을 사용하여
- 클래식 에디터:
- “텍스트 모드”에서 LaTeX 코드를 입력.
결론
워드프레스에서 MathJax-LaTeX이 작동하지 않는 주요 원인은 플러그인 활성화 문제, 설정 오류, 플러그인 충돌, 테마 제한, 캐시 문제 등이 있습니다. 위 해결 방법을 하나씩 적용해 보면 문제를 해결할 수 있을 것입니다.