Math 확장은 수학 공식 표현을 지원합니다. 이 확장 기능을 통해 현재 수행할 수 있는 작업에 대한 개요는 이 도움말을 참조하십시오.
구 버전을 포함하여, 설치 및 구성에 대한 자세한 내용은 Extension:Math/advancedSettings에서 확인할 수 있습니다.
Installation
미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.
미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다:
wfLoadExtension( 'Math' );
이 확장에 필요안 데이터베이스 테이블을 자동으로 생성하는 업데이트 스크립트를 실행하십시오.
- cd /var/www/html/w
- php maintenance/update.php
일반 텍스트 출력 이외에 수학 기호를 보기 위해, 다양한 수학 출력 모드를 활성화하는 것에 대해 아래의 지침에 따르십시오.
Special:Version에 접근해서 확장이 정상적으로 설치가 되었는지 확인을 합니다.
수학 확장 기능의 모든 구성 요소가 이제 작동하는지 확인하기 위해 페이지 Special:MathStatus로 추가적으로 이동해야 합니다. 그곳에서 보이는 임의의 문제에 대해, https://phabricator.wikimedia.org 에서 임무를 만드는 것이 가장 좋습니다.
안타깝게도, 수학 확장과 함께 동작해야 하는 Mathoid 및 RESTBase를 설치하는 방법에 대해 잘 정리된 안내서가 없지만, 적어도 작동 중인 초안이 있습니다. mw:Extension:Math/Restbase에 작동하는 내용을 기고해 주십시오.
게다가, MW1.28에는 Restbase와 Mathoid와 함께 미디어위키 설치 및 설정 가이드가 있습니다.
Math output modes
설정 $wgMathValidModes는 렌더링에 사용될 수 있는 출력 모드의 이름을 가진 배열을 보유합니다. 만약 여러 모드가 활성화되면, 로그-인 사용자는 그들의 사용자 환경설정 페이지의 모양 패널(appearance panel)에서 개인 환경설정을 지정할 수 있습니다.
또한, $wgDefaultUserOptions 설정을 사용하여 이러한 모드 중 어느 것을 기본값으로 설정할지 지정할 수 있습니다. 예를 들어,
$wgDefaultUserOptions['math'] = 'mathml';
Mathoid
모드: 'mathml' (pre-July 2015: MW_MATH_MATHML)
MW 1.23 이상에 대해, 서버 측에 대한 texvc 입력을 MathML+SVG 렌더링으로 변환하기 위해 MathJax를 사용하는 Mathoid 서버를 사용할 수 있습니다. 이것이 가장 권장되는 옵션입니다; Mathoid는 앞으로 위키피디아에서 사용될 렌더링 모드입니다.
Mathoid as a service
성능 이점을 가져오는, 하나의 서비스로 Mathoid를 사용하기 위해, 다음 설정을 추천합니다:
// Set MathML as default rendering option
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathFullRestbaseURL = 'https://en.wikipedia.org/api/rest_';
로컬에서 자기 자신의 Mathoid 서버를 실행하는 방법에 대해 Mathoid를 참조하십시오. 2017년 3월 이후로 이것은 RESTBase 서버/설치를 역시 요구하는 점에 주목하십시오 (Phab:T154394 참조하십시오).
Mathoid's CLI interface
설정하는 것이 더 쉽고 영구 메모리 소비가 적어지는 반면에, 성능이 떨어지는, Mathoid의 CLI 인터페이스를 사용하기 위해, 다음 설정을 추천합니다:
// Set MathML as default rendering option
$wgDefaultUserOptions['math'] = 'mathml';
// Please create a config.yaml in advance. Templates are in the Mathoid repository.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// Raise MediaWiki's memory limit to 1.2G for mathoid.
$wgMaxShellMemory = 1228800;
| 이 설정을 직접 사용해 보니, 성능이 떨어지는 문제보다도 렌더링에 관한 오류가 발생하는 것이 더 문제입니다. 이전 설정은 설정 후에는 거의 (절대적으로) 오류는 발생하지 않았습니다. |
만약 mw:SELinux를 포함하는 시스템 아래에서 미디어위키를 실행하고 오류 로그로부터 Mathoid cli '/path/to/mathoid/cli.js' is not executable 메시지를 얻으면, 다음을 실행하십시오:
setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1
또한, 아파치 서버가 시스템 제한을 변경할 수 있는지 확인하십시오.