미디어위키/확장기능/나무마크

미디어위키 문법 Liberty Engine 미디어위키
the seed openNAMU 나무마크 (확장기능)
기타 도쿠위키 모니위키
-

A mediawiki extension of PHP namumark parser

 

정보

나무위키에서 사용하는 문법인 나무마크PHP를 사용하는 미디어위키에서도 사용 할 수 있도록 만든 확장기능으로, 나무마크의 대부분의 기능들을 지원한다.

나무마크는 AGPL 3.0 라이선스를 통해 배포된다.

나무위키의 문법체계인 나무마크를 HTML로 변환하는 라이브러리인 php-namumark를 포크하여 개발한 것이다.

의존 확장기능

나무마크 확장기능을 사용하기 위해서는 설치하려는 미디어위키에 아래의 확장기능이 설치되어 있어야 한다.

이러한 의존 확장기능을 추가로 설치/활성화 시켜야 하는 이유는 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문이다..[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만 바이트 이상의 문서를 사용하고 싶다면 미디어위키 문법으로 적응해 사용하거나, 오픈나무 등의 다른 위키 엔진을 사용하는 것을 고려하자.

각주

  1. 미디어위키에 Cite 확장기능은 기본적으로 포함되어 있기 때문에 활성화가 되어 있지 않으면 활성화를 시키면 된다.
  2. 이때 조심해야 할 점은 압축 해제를 할 때 압축 파일명으로 폴더 생성 후 압축 풀기 옵션을 선택한 경우 미디어위키 설치 폴더/extensions/NamuMark/NamuMark 형식으로 올라갈 수 있으니 조심하자. 저런식으로 올라가면 작동하지 않는다.
  3. 확장기능 자체의 제한이 아니라 버그가 있기 때문에 20만 바이트 이하로 제한하여 사용해야 한다.