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

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

A mediawiki extension of PHP namumark parser

 
릴리즈 된 지 1년 이상 된 소프트웨어입니다.

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


정보[편집]

나무위키에서 사용하는 문법인 나무마크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만 바이트 이하로 제한하여 사용해야 한다.