Gentoo mwmath

개요

수식을 입력할 일이 얼마나 있겠느냐마는 적어도 대학원이나 연구기관 같은 곳에서 위키 페이지에 수학 수식을 그럴싸하게 입력해보고 싶을 때가 있을 것이다. 물론 입력한 내용을 보고서로 만들어야 할 경우 급하게 간단한 포매팅을 제공하는 위키를 통해 수식 내용과 설명을 넣어야 할 필요가 생기기도 한다. 여기에서는 바로 이러한 목적을 달성하기 위한 수단을 완성함을 목표로 내용을 진행하도록 하겠다. 물론 참고로 수식은 TeX문법을 적용해서 입력한다.

가져오기

• 우선 다음의 패키지가 필요하다 (만일을 위해)

[ gentoo ~ ] # emerge texlive-core dvipsk dvipng ghostscript-gpl

참고: 고스트 스크립트는 aclocal의 동작문제로 설치가 안될 수도 있다. 하지만 앞서 걸어놓은 dvipsk와 dvipng를 제대로 설치하고 나면 설치가 안돼도 무방하다

• 미디어위키의 확장을 설치할 디렉터리로 이동한다. 여기서는 /var/www/mediawiki에 미디어 위키를 설치하고, 확장 기능은 /var/www/mediawiki/extensions에 설치한다고 가정한다.

[ gentoo ~ ] # cd /var/www/mediawiki/extensions

• git을 설치하지 않았다면 git을 설치한다. 그리고 다음 명령으로 Math 확장 패키지를 가져온다

[ gentoo extensions ] # git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Math.git

• 별도의 디렉터리(ex. 웹 루트)로 이동하여 수학 수식을 제대로 표시할 MathJax를 가져온다. MathJax는 웹에서 접근 가능해야 한다. MathJax 이전에 수식을 렌더링해서 뿌려주는 서버가 있었지만, MathJax는 서버의 부하를 분산하기 위해 클라이언트 단에서 서버로부터 소스코드를 받아 로컬에서 렌더링을 하고 이미지를 자체적으로 만들어서 출력하게 한다. IEEE, Elsevier 등의 유명한 학술 단체의 지원을 받는 프로젝트인만큼 굉장히 훌륭한 수식 표현 수단이다.

[ gentoo extensions ] # cd /var/www
[ gentoo www ] # git clone git://github.com/mathjax/MathJax.git MathJax

설정 작성

• Math 확장 패키지를 설정할 차례이다. MediaWiki LocalSettings.php 파일에 몇 줄만 넣어주면 된다. 여기서 조건은 서버 도메인은 foo.baz이고 MathJax를 설치할 디렉터리는 /var/www/MathJax 라고 앞서 정했다고 가정한다. (가져오기 단계를 그대로 따랐을 경우)

required_once( "$IP/extensions/Math/Math.php" );

# End of automatically generated settings.
# Add more configuration options below.
$wgUseTeX = true;
$wgUseMathJax = true;
$wgMathJaxUrl = "http://foo.baz/MathJax/MathJax.js?config=TeX-AMS_HTML";
$wgDefaultUserOptions['math'] = MW_MATH_MATHJAX;

테스트

다음과 같은 수식이

\[
\frac{-b\pm\sqrt{b^2-4ac}}{2a}
\]

다음과 같이 출력되어야 한다. 구문 분석 실패 (구문 오류): {\displaystyle \[ \frac{-b\pm\sqrt{b^2-4ac}}{2a} \] }

참고

• http://meta.wikimedia.org/wiki/MediaWiki_math_markup
• http://meta.wikimedia.org/wiki/Help:Formula
• https://www.mediawiki.org/wiki/Extension:Math
• http://www.mathjax.org