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

미디어위키 문법
미디어위키		리버티 엔진
나무위키 문법
the seed	openNAMU	나무마크 (확장기능)	PressDo
기타 문법을 사용하는 엔진들
도쿠위키		모니위키

-
“	A mediawiki extension of PHP namumark parser	”
	— 깃허브 나무마크 설명

릴리즈 된 지 1년 이상 된 소프트웨어입니다. 대체 소프트웨어를 사용해 주세요. (2016년 12월 11일이 마지막 릴리즈) (대체 소프트웨어 : 나무마크 (도다 수정))

정보

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

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

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

의존 확장기능

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

• EmbedVideo 확장기능
• Cite 확장기능
• Math 또는 SimpleMathJax 확장기능
• Poem 확장기능

이러한 의존 확장기능을 추가로 설치/활성화 시켜야 하는 이유는 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문이다..

설치 방법

• 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 폴더 안에 압축 해제한 파일들을 업로드 한다.

그 다음 공통 설정 방법 문단으로 넘어가 설정을 마무리하면 된다.

공통 설정 방법

그 이후 미디어위키 설치 폴더에 있는 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만 바이트 이상 버그

나무마크 확장기능 사용시 글자수 제한이 있다고 한다. 20만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다. 따라서 20만 바이트 이상의 문서를 사용하고 싶다면 미디어위키 문법으로 적응해 사용하거나, 오픈나무 등의 다른 위키 엔진을 사용하는 것을 고려하자.