imported>Gaon12 m편집 요약 없음 |
(순번 사용 제거) |
||
4번째 줄: | 4번째 줄: | ||
==정보== | ==정보== | ||
[[나무위키]]에서 사용하는 문법인 [[나무마크]]를 [[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이나 FTP로 파일들을 올린 뒤, 공통 설정 방법 문단으로 이동해 계속 설치를 진행하자 | ||
===git 사용(ssh 지원시)=== | ===git 사용(ssh 지원시)=== | ||
SSH를 지원하는 호스팅/서버 환경인 경우에는 이 방법을 사용하자. 매우 간단하다. | |||
'''cd''' 명령어를 이용하여 미디어위키가 설치된 폴더까지 이동한 다음, 아래의 명령어를 차례대로 입력한다. | |||
<syntaxhighlight lang="SH"> | <syntaxhighlight lang="SH"> | ||
cd extensions | cd extensions | ||
git clone https://github.com/Oriwiki/php-namumark-mediawiki NamuMark | git clone https://github.com/Oriwiki/php-namumark-mediawiki NamuMark | ||
</syntaxhighlight><br/> | </syntaxhighlight><br/> | ||
그 다음 [[#공통 설정 방법|공통 설정 방법 문단]]으로 넘어가 설정을 마무리하면 된다. | |||
===FTP 이용=== | ===FTP 이용=== | ||
SSH를 사용 할 수 없는 환경에서는 다음과 같은 방법으로 설치 할 수 있다. | |||
웹 브라우저를 통해 [https://github.com/Oriwiki/php-namumark-mediawiki https://github.com/Oriwiki/php-namumark-mediawiki]로 들어간다. | |||
그 다음 초록색 '''Clone or download''' 버튼 → Download ZIP 버튼을 눌러 파일을 다운받는다. | |||
다운 받은 zip 파일을 압축 해제한다. | |||
# | |||
FTP 프로그램으로 미디어위키가 설치된 폴더 안 extensions 폴더로 들어간다. | |||
NamuMark라는 폴더를 만든 후 NaumMark 폴더 안에 압축 해제한 파일들을 업로드 한다.<ref>이때 조심해야 할 점은 압축 해제를 할 때 압축 파일명으로 폴더 생성 후 압축 풀기 옵션을 선택한 경우 '''미디어위키 설치 폴더/extensions/NamuMark/NamuMark''' 형식으로 올라갈 수 있으니 조심하자. 저런식으로 올라가면 작동하지 않는다.</ref> | |||
그 다음 [[#공통 설정 방법|공통 설정 방법 문단]]으로 넘어가 설정을 마무리하면 된다. | |||
===공통 설정 방법=== | ===공통 설정 방법=== | ||
그 이후 미디어위키 설치 폴더에 있는 [[미디어위키/LocalSettings.php|LocalSettings.php]]파일을 에디터로 연 뒤, 파일의 최하단에 아래와 같이 입력 후 저장한다. | |||
<syntaxhighlight lang="PHP"> | <syntaxhighlight lang="PHP"> | ||
require_once "$IP/extensions/NamuMark/namumark.php"; | require_once "$IP/extensions/NamuMark/namumark.php"; | ||
53번째 줄: | 65번째 줄: | ||
==이슈== | ==이슈== | ||
===20만 바이트 이상 버그=== | ===20만 바이트 이상 버그=== | ||
나무마크 확장기능 사용시 글자수 제한이 있다고 한다.<ref>확장기능 자체의 제한이 아니라 버그가 있기 때문에 20만 바이트 이하로 제한하여 사용해야 한다.</ref> 20만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다. 따라서 20만 바이트 이상의 문서를 사용하고 싶다면 [[도움말:위키 문법|미디어위키 문법]]으로 적응해 사용하거나, [[오픈나무]] 등의 다른 위키 엔진을 사용하는 것을 고려하자. | |||
==각주== | ==각주== |
2019년 12월 6일 (금) 10:29 판
미디어위키 문법 | |||
---|---|---|---|
미디어위키 | 리버티 엔진 | ||
나무위키 문법 | |||
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만 바이트 이상의 문서를 사용하고 싶다면 미디어위키 문법으로 적응해 사용하거나, 오픈나무 등의 다른 위키 엔진을 사용하는 것을 고려하자.