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

{{틀:위키 엔진}}

{{틀:인용문|A mediawiki extension of PHP namumark parser|[https://github.com/Oriwiki/php-namumark-mediawiki 깃허브 나무마크 설명] }}

==정보==
# [[나무위키]]에서 사용하는 문법인 [[나무마크]]를 [[PHP]]를 사용하는 [[미디어위키]]에서도 사용 할 수 있도록 만든 확장기능이다.
# [[나무마크]]의 대부분의 기능들을 지원한다.
#  AGPL 3.0 라이선스를 통해 배포된다.
# 나무마크를 HTML로 변환하는 라이브러리인 [https://github.com/koreapyj/php-namumark php-namumark]를 포크하여 개발한 것이다.

==의존 기능==
# 나무마크 확장기능을 사용하기 위해서는 설치하려는 미디어위키에 아래의 확장기능이 설치되어 있어야 한다.
## [[미디어위키/확장기능/EmbedVideo|EmbedVideo]] 확장기능
## [[미디어위키/확장기능/Cite|Cite]] 확장기능
## [[미디어위키/확장기능/Math|Math]] 또는 [[미디어위키/확장기능/SimpleMathJax|SimpleMathJax]] 확장기능
## [[미디어위키/확장기능/Poem|Poem]] 확장기능
# 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문에 설치를 해야 한다.<ref>미디어위키에 Cite 확장기능은 기본적으로 포함되어 있기 때문에 활성화가 되어 있지 않으면 활성화를 시키면 된다.</ref>

==설치 방법==
* git이나 FTP로 파일들을 올린 뒤, 공통 설정 방법 문단으로 이동해 계속 설치를 진행하자
===git 사용(ssh 지원시)===
# 이 방법을 추천한다. 간단하기 때문이다.
# 미디어위키가 설치된 폴더까지 이동한다.
# 그 다음 아래의 명령어를 차례대로 입력한다.
<syntaxhighlight lang="SH">
cd extensions
git clone https://github.com/Oriwiki/php-namumark-mediawiki NamuMark
</syntaxhighlight><br/>
===FTP 이용===
# [https://github.com/Oriwiki/php-namumark-mediawiki https://github.com/Oriwiki/php-namumark-mediawiki]로 들어간다.
# 초록색 '''Clone or download''' 버튼을 클릭한다.
# Download ZIP 버튼을 눌러 파일을 다운받는다.
# 다운 받은 zip 파일을 압축 해제한다.
# FTP 프로그램으로 미디어위키가 설치된 폴더까지 이동한다.
# extensions 폴더로 들어간다.
# NamuMark라는 폴더를 만든 후 들어간다.
# 파일들을 업로드 한다.
===공통 설정 방법===
# 그 이후 미디어위키 설치 폴더로 진입한다.
# [[LocalSettings.php]]파일을 에디터로 연다.
# 최하단에 아래와 같이 입력 후 저장한다.
<syntaxhighlight lang="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;
</syntaxhighlight><br/>

==이슈==
===20만 바이트 이상 버그===
# 나무마크 확장기능 사용시 글자수 제한이 있다고 한다.<ref>확장기능 자체의 제한이 아니라 버그가 있기 때문에 20만 바이트 이하로 제한하여 사용해야 한다.</ref>
# 20만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다.

==각주==