Manual:Enable TeX/ko

이 문서에서는 미디어위키에서 TeX 수식을 사용하는 방법을 설명합니다.

요구 사항

 * texvc는 미디어위키의 수식을 해석하는 데에 필요합니다. 이 프로그램은 미디어위키가 설치된 폴더의 math 폴더에 포함되어 있습니다.
 * OCaml 3.06(Objective Caml) 이상이 필요합니다. 이 프로그램은 texvc를 컴파일하기 위해 사용됩니다. OCaml 프로그램은 http://caml.inria.fr/ 사이트에서 받아 설치할 수 있습니다.
 * GNU make가 texvc 컴파일에 필요합니다. 이 프로그램은 대부분의 리눅스 환경에 이미 설치되어 있습니다.
 * LaTeX, dvips, ImageMagick, Ghostscript 프로그램은 수식을 그림으로 변환하는 데에 필요합니다. 이 프로그램은 대부분의 리눅스 환경에 이미 설치되어 있습니다. 또한 PATH 환경 변수에 각 프로그램의 경로를 추가해주세요.,  ,  ,   프로그램이 커맨드 라인에서 사용됩니다.
 * ASCII 이외의 유니코드 문자를 표시하기 위해서는 추가 TeX 패키지가 필요합니다. (데비안의 경우 "cjk-latex" 패키지입니다.)

설치 전에 필요한 프로그램

 * texvc : 미디어위키 폴더 안의 math 폴더에 들어있습니다.
 * OCaml : 최신 OCaml 릴리즈
 * GNU make : 리눅스 환경에는 이미 설치되어 있습니다.
 * 윈도 환경이라면 MinGW, Cygwin 등을 참고해주세요.
 * 기타 환경에서는 GNU Make 페이지를 참고해주세요.


 * LaTeX, dvips : 대부분의 리눅스 배포판에는 이미 설치되어 있습니다.
 * 윈도 환경의 경우에는 MiKTeX 등의 프로그램을 설치해주세요.


 * ImageMagick : ImageMagick 바이너리 배포 페이지
 * Mac OS X의 경우에는 binary distribution for MacOSX 페이지를 참고해주세요.


 * Ghostscript : 리눅스 환경에서는 이미 설치되어 있거나, 배포판 패키지로 설치할 수 있습니다.
 * 윈도 환경인 경우에는 여기에서 설치해주세요.
 * Ghostscript 소스 파일

리눅스에서 설치하기

 * 1) 미디어위키를 설치한 경로로 들어가, math 디렉토리로 들어가주세요.
 * 2) 'make'를 실행해주세요. (만약 GNU make가 기본값이 아니라면 'gmake'를 실행해주세요) 문제가 없다면 texvc가 컴파일됩니다.
 * 3) LocalSettings.php 파일에서 $wgUseTeX, $wgEnableUploads 값을 true로 변경해주세요.

설치
path latex dvips convert gs
 * MikTeX를 C:\wikitex\miktex 에 설치한다.
 * ImageMagick을 C:\wikitex\imagick 에 설치한다.
 * AFPL GhostScript을 C:\wikitex\gs 에 설치한다.
 * C:\wikitex\gs\gs8.54\bin\gswin32c.exe 를 C:\wikitex\gs\gs8.54\bin\gs.exe 로 복사한다(사본을 만들어 이름을 고친다).
 * 명령 프롬프트 실행(시작 -> 실행 -> cmd.exe)
 * 명령 프롬프트에서 다음 명령어를 실행한다.
 * PATH에 다음 항목들이 있는지 확인한다.
 * C:\wikitex\mixtex\mixtex\bin (자동으로 설정됨)
 * C:\wikitex\imagick (자동으로 설정됨)
 * C:\wikitex\gs\gs8.54\bin
 * 위에서 빠진 항목을 윈도 PATH 환경 변수에 추가한다.
 * 내 컴퓨터 - 속성 - 시스템 등록 정보 - 고급 - 환경 변수 - 시스템 변수 - Path - 편집
 * PATH 적용을 위해 기존의 명령 프롬프트 창을 닫고 새로운 명령 프롬프트(cmd.exe)를 실행한다. PATH가 제대로 설정되었는지 확인한다.
 * 명령 프롬프트에서 다음 명령어가 실행되는지 확인한다.

설정
(위키가 설치된 폴더 = $) $wgUseTeX= true; $wgImageMagickConvertCommand   = 'C:\wikitex\imagick\convert.exe'; $wgImageMagickIdentifyCommand  = 'C:\wikitex\imagick\identify.exe'; #Tex $wgLaTexCommand                = 'C:\wikitex\miktex\miktex\bin\latex.exe'; $wgDvipsCommand                = 'C:\wikitex\miktex\miktex\bin\dvips.exe';
 * $/includes/Math.php 의 내용을 이것(클릭)으로 바꾼다.
 * $/LocalSettings.php 의 내용을 다음과 같이 수정한다.
 * $/LocalSettings.php 에 다음 내용을 추가한다.
 * 1) ImageMagick

확인
$$\sqrt{2}$$
 * 연습장 등에서 아래 내용을 입력해보자. 제대로 나오면 끝!
 * "images" 폴더 아래에 "math"와 "tmp" 폴더가 자동적으로 생성될 것이다.

문제 해결
오류가 발생한다면 $/LocalSettings.php 를 아래와 같이 주석처리해보자.
 * 1) $wgMathPath        = "{$wgUploadPath}/math";
 * 2) $wgMathDirectory   = "{$wgUploadDirectory}/math";
 * 3) $wgTmpDirectory    = "{$wgUploadDirectory}/tmp";

제한점

 * 한글이 지원되지 않는다. 수식에 한글을 입력할 경우, 에러 메시지가 발생한다.