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로 변경해주세요.

테스트 환경

 * Windows XP Professional (영문판)
 * XAMPP Lite: 1.4.16 (SourceForge에서 받음, 아래는 여기에 포함된 것들)
 * Apache 2.0.54
 * MySQL 4.1.14
 * PHP 5.0.5 + PEAR (basis package)

필요한 소프트웨어
다음의 소프트웨어 4가지를 설치한다. 로컬 컴퓨터에 아무데나 설치해도 된다.
 * Ghostscript (버전 8.53)
 * MikTex (버전 2.5)
 * Object Caml (버전 3.09.3)
 * ImageMagick (버전 6.3.1 Q16)
 * 테스트시에는 ImageMagick-6.3.1-7-Q16-windows-dll.exe를 받음.
 * 테스트시에는 Image Magick 설치시 선택사항 중 'NT-서비스로 구동'을 선택함.

다음 파일을 준비한다.
 * texvc.exe로 컴파일된 것 (테스트시에는 여기에 있는 것 사용)

준비
$wgUseTeX          = true; $wgMathPath        = "{$wgUploadPath}/math"; $wgMathDirectory   = "{$wgUploadDirectory}/math"; $wgTmpDirectory    = "{$wgUploadDirectory}/tmp"; $wgTexvc = "texvc.exe"; # texvc 이진파일 위치
 * 받은 texvc.exe를 미디어위키 폴더에 놓는다. (예. 'e:\xampplite\htdocs\wiki')
 * LocalSettings.php에 몇가지를 설정한다. (기존의 localsettings.php에서 해당 부분을 찾아서 적절히 바꾸어야 한다.)
 * 1) 설치된 소프트웨어가 지원한다면 LaTeX 식을 인라인(inline)으로 사용가능하도록 바꿀 수 있다.

// 디버그 로깅 사용 $wgDebugLogFile = "{$IP}/debug.log.txt"; if ( wfIsWindows ) { # Invoke it within cygwin sh, because texvc expects sh features in its default shell $cmd = 'sh -c '. wfEscapeShellArg( $cmd ); }
 * 테스트 목적으로는 아래의 코드가 유용할 수 있다.
 * 특정 폴더들이 존재하는지와, 웹서버가 그 폴더에 쓸 수 있는지를 확인하라. 테스트시에는 다음과 같았다.
 * /images/tmp/
 * /images/math/
 * /includes/Math.php에서 아래 줄들을 주석처리한다. (테스트시에는 약간의 공백을 없앴기 때문에 파일 내용에서 아래 문구를 찾아도 나타나지 않을 수 있다.)

마지막으로 윈도가 아파치에게 필요한 권한을 주어야 한다.
 * 윈도 서비스로 apache 설치 (xampp 제어판의 "svc" 체크박스 체크):
 * "컴퓨터 관리" 도구 열기 (예, 시작 - 실행 - compmgmt.msc)
 * "Apache2" 프로세스 우클릭
 * '속성' 선택
 * "Log on(로그온)" 탭 선택
 * "This account(이 계정)"로 로그인 선택 (라디오 버튼 누르기).
 * "Browse..."를 누르고 '관리자 권한을 가진 사용자 계정'(예, Administrator)의 이름을 입력한 후 "이름 확인"을 클릭
 * 끝나면 '확인' 클릭
 * '확인' 또는 '적용' 클릭
 * 끝!