Manual:Enable TeX/ko

From MediaWiki.org

Jump to: navigation, search

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

Contents

[edit] 요구 사항

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

[edit] 설치 전에 필요한 프로그램

texvc 
미디어위키 폴더 안의 math 폴더에 들어있습니다.
OCaml 
최신 OCaml 릴리즈
GNU make 
리눅스 환경에는 이미 설치되어 있습니다.
윈도 환경이라면 MinGW, Cygwin 등을 참고해주세요.
기타 환경에서는 GNU Make 페이지를 참고해주세요.
LaTeX, dvips 
대부분의 리눅스 배포판에는 이미 설치되어 있습니다.
윈도 환경의 경우에는 MiKTeX 등의 프로그램을 설치해주세요.
ImageMagick 
ImageMagick 바이너리 배포 페이지
Mac OS X의 경우에는 binary distribution for MacOSX 페이지를 참고해주세요.
Ghostscript 
리눅스 환경에서는 이미 설치되어 있거나, 배포판 패키지로 설치할 수 있습니다.
윈도 환경인 경우에는 여기에서 설치해주세요.
Ghostscript 소스 파일

[edit] 리눅스에서 설치하기

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

[edit] 윈도에서 설치하기

[edit] 설치

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

[edit] 설정

(위키가 설치된 폴더 = $)

  • $/includes/Math.php의 내용을 이것(클릭)으로 바꾼다.
  • $/LocalSettings.php의 내용을 다음과 같이 수정한다.
$wgUseTeX= true;
  • $/LocalSettings.php에 다음 내용을 추가한다.
#ImageMagick
$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';

[edit] 확인

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

[edit] 문제 해결

오류가 발생한다면 $/LocalSettings.php를 아래와 같이 주석처리해보자.

#$wgMathPath         = "{$wgUploadPath}/math";
#$wgMathDirectory    = "{$wgUploadDirectory}/math";
#$wgTmpDirectory     = "{$wgUploadDirectory}/tmp";

[edit] 제한점

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

English  • 한국어
Retrieved from "http://www.mediawiki.org/wiki/Manual:Enable_TeX/ko"