편집토론문서 역사

오픈나무 및 미디어위키/확장기능/나무마크: 문서 사이의 차이

(문서 사이의 차이)
Admin_Old (토론)
편집 요약 없음
 
imported>Gaon12
m편집 요약 없음
 
1번째 줄: 1번째 줄:
{{틀:위키 엔진}}<br/>
{{틀:위키 엔진}}


{{틀:인용문|python wiki engine like moniwiki|깃허브 엔진 저장소 설명}}<br/>
{{틀:인용문|A mediawiki extension of PHP namumark parser|[https://github.com/Oriwiki/php-namumark-mediawiki 깃허브 나무마크 설명] }}
 
[https://github.com/2du/opennamu 깃허브 오픈나무 저장소]


==정보==
==정보==
# [[2du]]가 [[파이썬]]을 이용하여 만든 위키 엔진
# [[나무위키]]에서 사용하는 문법인 [[나무마크]]를 [[PHP]]를 사용하는 [[미디어위키]]에서도 사용 할 수 있도록 만든 확장기능이다.
# [[파이썬]]은 3.5 버전 이상을 사용한다.<ref>설치 방법에서는 파이썬 3을 설치하라고 하는데, 깃허브 저장소에서는 "python >=3.5"라고 써져 있다.</ref>
# [[나무마크]]의 대부분의 기능들을 지원한다.
# 엔진 이름으로부터 알 수 있듯 [[나무마크]]를 지원한다.
#  AGPL 3.0 라이선스를 통해 배포된다.
 
# 나무마크를 HTML로 변환하는 라이브러리인 [https://github.com/koreapyj/php-namumark php-namumark]를 포크하여 개발한 것이다.
==설치법==
# 설치법은 아래와 같다. [https://namu.ml/w/ko:오픈나무/설치법 오픈나무 테스트 서버 위키 참조]
===우분투===
* 16.04 기준이다.


<syntaxhighlight lang="sh" line>
==의존 기능==
sudo apt-get install git // git이 설치 되어 있다면 패스
# 나무마크 확장기능을 사용하기 위해서는 설치하려는 미디어위키에 아래의 확장기능이 설치되어 있어야 한다.
git clone -b stable https://github.com/2du/opennamu.git // 깃허브에서 저장소를 클론한다.
## [[미디어위키/확장기능/EmbedVideo|EmbedVideo]] 확장기능
cd opennamu
## [[미디어위키/확장기능/Cite|Cite]] 확장기능
sudo apt-get install python3-pip // 파이썬 설치
## [[미디어위키/확장기능/Math|Math]] 또는 [[미디어위키/확장기능/SimpleMathJax|SimpleMathJax]] 확장기능
sudo pip3 install --upgrade pip // 파이썬 버전 업데이트
## [[미디어위키/확장기능/Poem|Poem]] 확장기능
sudo pip3 install -r requirements.txt // 의존 프로그램 설치/업데이트
# 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문에 설치를 해야 한다.<ref>미디어위키에 Cite 확장기능은 기본적으로 포함되어 있기 때문에 활성화가 되어 있지 않으면 활성화를 시키면 된다.</ref>
python3 app.py // 위키 엔진 실행
</syntaxhighlight>


==장점==
==설치 방법==
===간단한 설치/업데이트===
* git이나 FTP로 파일들을 올린 뒤, 공통 설정 방법 문단으로 이동해 계속 설치를 진행하자
# 웹 인스톨러를 지원하는 위키 엔진을 제외하고 쉘 설치로 해야하는 위키 엔진 중에서는 설치가 쉬운 편.<ref>[[Liberty Engine|리버티 엔진]]에 비하면 이건 껌 정도?</ref>
===git 사용(ssh 지원시)===
# 또한 업데이트를 쉘 뿐만 아니라 웹상에서도 가능하다. <del>XE 쉬운설치</del><ref>참고로 업데이트는 0.0.1씩 하는게 좋다고 함. [https://namu.ml/w/ko:오픈나무/업데이트%20호환 오픈나무 테스트 서버 위키]</ref>
# 이 방법을 추천한다. 간단하기 때문이다.
===스킨의 존재===
# 미디어위키가 설치된 폴더까지 이동한다.
# 스킨은 대부분의 위키에는 존재하지만, [[Liberty Engine|리버티 엔진]]처럼 스킨이 단 하나밖에 없는 경우도 있다.
# 그 다음 아래의 명령어를 차례대로 입력한다.
# 다만 하단의 [[오픈나무#적은 갯수의 스킨 수]]에서도 이야기 하겠지만, 스킨의 수가 적다.
<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만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다.
===파이썬의 사용===
# 파이썬을 사용한다는 것은 일반 웹호스팅에서는 사용이 불가능 하다는 것이다.
# 일반 웹호스팅은 html과 php 같이 자주 사용하는 언어만 설치되어 있기 때문에 파이썬을 사용하는 오픈나무를 일반 웹호스팅에서는 사용이 불가능하다.
===적은 갯수의 스킨 수===
# 2018년 11월 20일 기준, 존재하는 공식 스킨 수는 6개이다.
# 물론 공식 스킨 수 이지만, 아직까지 스킨 개발 가이드가 존재하지 않기 때문에 개발시에는 공개되어 있는 스킨을 분석해야 한다.
# 결국 그만큼 유저들의 선택권이 줄어드는 것이다.
# 그래도 공식 스킨들의 디자인은 나쁘지 않다. (개인적 의견)


==각주==
==각주==

2019년 1월 30일 (수) 20:12 판

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

A mediawiki extension of PHP namumark parser

”
 

정보

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

의존 기능

  1. 나무마크 확장기능을 사용하기 위해서는 설치하려는 미디어위키에 아래의 확장기능이 설치되어 있어야 한다.
    1. EmbedVideo 확장기능
    2. Cite 확장기능
    3. Math 또는 SimpleMathJax 확장기능
    4. Poem 확장기능
  2. 영상 삽입이나 수식 입력 등을 나무마크로 표시하기 위해서는 필요하기 때문에 설치를 해야 한다.[1]

설치 방법

  • git이나 FTP로 파일들을 올린 뒤, 공통 설정 방법 문단으로 이동해 계속 설치를 진행하자

git 사용(ssh 지원시)

  1. 이 방법을 추천한다. 간단하기 때문이다.
  2. 미디어위키가 설치된 폴더까지 이동한다.
  3. 그 다음 아래의 명령어를 차례대로 입력한다.
cd extensions
git clone https://github.com/Oriwiki/php-namumark-mediawiki NamuMark


FTP 이용

  1. https://github.com/Oriwiki/php-namumark-mediawiki로 들어간다.
  2. 초록색 Clone or download 버튼을 클릭한다.
  3. Download ZIP 버튼을 눌러 파일을 다운받는다.
  4. 다운 받은 zip 파일을 압축 해제한다.
  5. FTP 프로그램으로 미디어위키가 설치된 폴더까지 이동한다.
  6. extensions 폴더로 들어간다.
  7. NamuMark라는 폴더를 만든 후 들어간다.
  8. 파일들을 업로드 한다.

공통 설정 방법

  1. 그 이후 미디어위키 설치 폴더로 진입한다.
  2. LocalSettings.php파일을 에디터로 연다.
  3. 최하단에 아래와 같이 입력 후 저장한다.
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만 바이트 이상 버그

  1. 나무마크 확장기능 사용시 글자수 제한이 있다고 한다.[2]
  2. 20만 바이트 이상을 넘어가면 깨지는 등의 버그가 있다.

각주

  1. ↑ 미디어위키에 Cite 확장기능은 기본적으로 포함되어 있기 때문에 활성화가 되어 있지 않으면 활성화를 시키면 된다.
  2. ↑ 확장기능 자체의 제한이 아니라 버그가 있기 때문에 20만 바이트 이하로 제한하여 사용해야 한다.
• 현재 페이지 URL 줄이기