| 미디어위키 문법 | |||
|---|---|---|---|
| 미디어위키 | 리버티 엔진 | ||
| 나무위키 문법 | |||
| the seed | openNAMU | 나무마크 (확장기능) | PressDo |
| 기타 문법을 사용하는 엔진들 | |||
| 도쿠위키 | 모니위키 | ||
- “ A mediawiki extension of PHP namumark parser
”
정보
나무위키에서 사용하는 문법인 나무마크를 PHP를 사용하는 미디어위키에서도 사용 할 수 있도록 만든 확장기능으로, 나무마크의 대부분의 기능들을 지원한다.
나무마크는 AGPL 3.0 라이선스를 통해 배포된다.
나무위키의 문법체계인 나무마크를 HTML로 변환하는 라이브러리인 php-namumark를 포크하여 개발한 것이다.
의존 확장기능
나무마크 확장기능을 사용하기 위해서는 설치하려는 미디어위키에 아래의 확장기능이 설치되어 있어야 한다.
- EmbedVideo 확장기능
- Cite 확장기능
- Math 또는 SimpleMathJax 확장기능
- Poem 확장기능
이러한 의존 확장기능을 추가로 설치/활성화 시켜야 하는 이유는 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문이다..[1]
설치 방법
- git이나 FTP로 파일들을 올린 뒤, 공통 설정 방법 문단으로 이동해 계속 설치를 진행하자
git 사용(ssh 지원시)
SSH를 지원하는 호스팅/서버 환경인 경우에는 이 방법을 사용하자. 매우 간단하다.
cd 명령어를 이용하여 미디어위키가 설치된 폴더까지 이동한 다음, 아래의 명령어를 차례대로 입력한다.
cd extensions
git clone https://github.com/Oriwiki/php-namumark-mediawiki NamuMark
그 다음 공통 설정 방법 문단으로 넘어가 설정을 마무리하면 된다.
FTP 이용
SSH를 사용 할 수 없는 환경에서는 다음과 같은 방법으로 설치 할 수 있다.
웹 브라우저를 통해 https://github.com/Oriwiki/php-namumark-mediawiki로 들어간다.
그 다음 초록색 Clone or download 버튼 → Download ZIP 버튼을 눌러 파일을 다운받는다.
다운 받은 zip 파일을 압축 해제한다.
FTP 프로그램으로 미디어위키가 설치된 폴더 안 extensions 폴더로 들어간다.
NamuMark라는 폴더를 만든 후 NaumMark 폴더 안에 압축 해제한 파일들을 업로드 한다.[2]
그 다음 공통 설정 방법 문단으로 넘어가 설정을 마무리하면 된다.
공통 설정 방법
그 이후 미디어위키 설치 폴더에 있는 LocalSettings.php파일을 에디터로 연 뒤, 파일의 최하단에 아래와 같이 입력 후 저장한다.
require_once "$IP/extensions/NamuMark/namumark.php";
$wgRawHtml = true;
$wgAllowImageTag = true;
$wgNamespacesWithSubpages[NS_MAIN] = true;
$wgNamespacesWithSubpages[NS_TEMPLATE] = true;
$wgAllowDisplayTitle = true;
$wgRestrictDisplayTitle = false;
$wgDefaultUserOptions['numberheadings'] = 1;
이슈
20만 바이트 이상 버그
나무마크 확장기능 사용시 글자수 제한이 있다고 한다.[3] 20만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다. 따라서 20만 바이트 이상의 문서를 사용하고 싶다면 미디어위키 문법으로 적응해 사용하거나, 오픈나무 등의 다른 위키 엔진을 사용하는 것을 고려하자.