미디어위키/미디어위키 익스텐션

미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) WikiEditor 설치와 활용

씨실과 날실 2020. 4. 29. 14:00

[익스텐션 목록]

기본 익스텐션

2019/10/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Interwiki 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Nuke 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Renameuser 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CiteThisPage 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Replace Text 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) WikiEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CodeEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CategoryTree 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Cite 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ImageMap 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) InputBox 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ParserFunctions 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Poem 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SyntaxHighlight 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) PDF Handler 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ConfirmEdit 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SpamBlacklist 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) TitleBlacklist 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Gadgets 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) LocalisationUpdate 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) MultimediaViewer 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) OATHAuth 설치와 활용




[WikiEditor 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

https://www.mediawiki.org/wiki/Extension:WikiEditor

다운로드

미디어위키 내 배포 페이지

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/WikiEditor

github 페이지

https://github.com/wikimedia/mediawiki-extensions-WikiEditor


WikiEditor 익스텐션 기능

확장 가능한 위키 텍스트 편집 인터페이스와 그외 많은 기능을 가진 모듈을 제공하는 익스텐션입니다.




익스텐션 다운로드 및 설치

다운로드 안내

익스텐션 다운로드 및 설치 방법은 아래 링크를 참고하시기 바랍니다.


사용 중인 미디어위키의 버전에 맞는 배포 익스텐션 압축 파일을 다운로드받습니다.

익스텐션 공식 배포처

미디어위키 내 배포 페이지

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/WikiEditor

github 페이지

https://github.com/wikimedia/mediawiki-extensions-WikiEditor




미디어위키 버전별 익스텐션 다운로드 주소

1.34

https://extdist.wmflabs.org/dist/extensions/WikiEditor-REL1_34-57eb9ad.tar.gz

1.33

https://extdist.wmflabs.org/dist/extensions/WikiEditor-REL1_33-e051a4b.tar.gz

1.32

https://extdist.wmflabs.org/dist/extensions/WikiEditor-REL1_32-aea465f.tar.gz

1.31

https://extdist.wmflabs.org/dist/extensions/WikiEditor-REL1_31-dca935d.tar.gz

위 주소는 코드 수정으로 바뀔 수 있으므로 다운이 받아지지 않는다면 위 공식 루트를 통해 다운받으시기 바라비니다.

다운로드 받은 압축 파일을 서버 안 미디어위키 설치 폴더 내에 있는  extensions폴더 안에 풀어줍니다.

리눅스 서버의 경우

$ sudo tar -xzf WikiEditor-REL1_34-57eb9ad.tar.gz -C /미디어위키 설치 경로/extensions


예시 - Ubuntu

$ sudo tar -xzf WikiEditor-REL1_34-57eb9ad.tar.gz -C /var/www/html/w/extensions

위 명령은 제 블로그를 그대로 따라오신 분의 경우 적용되는 예시입니다.


윈도 서버의 경우

탐색기로 압축 파일을 해당 위치에 풀어주시면 됩니다.


호스팅을 받는 경우

파일질라, 알FTP 등 FTP 프로그램을 이용해 미리 풀어 놓은 익스텐션 폴더(WikiEditor)를 통째로 해당 위치에 전송해줍니다.




WikiEditor 익스텐션 필수 설정

미디어위키의 환경 설정 파일인 LocalSettings.php 파일에 다음과 같은 코드를 추가해줍니다.

wfLoadExtension( 'WikiEditor' );


... 전략 ...

# Enabled extensions. Most of the extensions are enabled by adding
# wfLoadExtensions('ExtensionName');
# to LocalSettings.php. Check specific extension documentation for more details.
# The following extensions were automatically enabled:
wfLoadExtension( 'CategoryTree' );
wfLoadExtension( 'Cite' );
wfLoadExtension( 'CiteThisPage' );
wfLoadExtension( 'CodeEditor' );
wfLoadExtension( 'ConfirmEdit' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Interwiki' );
wfLoadExtension( 'LocalisationUpdate' );
wfLoadExtension( 'MultimediaViewer' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'OATHAuth' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'PdfHandler' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'Renameuser' );
wfLoadExtension( 'ReplaceText' );
wfLoadExtension( 'SpamBlacklist' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'TitleBlacklist' );
wfLoadExtension( 'WikiEditor' );

# End of automatically generated settings.
# Add more configuration options below.

... 후략 ...

미디어위키 설치시 기본 제공 익스텐션을 함께 설치하도록 설정한다면 코드는 보통 위 예시와 같은 위치에 추가됩니다.


설치 확인

미디어위키의 특수:버전(= Special:Version) 문서를 확인하면 위 익스텐션이 추가된 것을 확인할 수 있습니다.




WikiEditor 익스텐션 추가 구성 설정

위의 WikiEditor 설치와 활성화 조치만 하면 바로 모든 사용자가이 확장을 사용할 수 있으며 로그인 한 사용자는 편집 탭 아래의 편집 툴바(도구 모음) 옵션을 통해 기본 설정에서 이 확장을 비활성화할 수 있습니다.


모든 사용자가 이 익스텐션을 비활성화할 수 없도록 하려면 아래의 코드를 추가해줍니다.

$wgHiddenPrefs[] = 'usebetatoolbar';


미디어위키 REL1_31 이전 버전을 사용 중이고 사용자가 미디어위키 사이트에 처음 가입할 때 이 익스텐션 기능인 편집 툴바를 기본값으로 설정하려면 다음 코드를 추가하십시오.

$wgDefaultUserOptions['usebetatoolbar'] = 1;


경우에 따라 설치 후 WikiEditor가 브라우저에 표시되지 않을 수도 있습니다. 이때는 브라우저 캐시를 지우면 문제가 해결됩니다.

 추후 설명 링크

사용자 서명 추가 버튼 (네 개의 물결표)은 토론 페이지 및 $wgExtraSignatureNamespaces에 지정된 이름공간(네임 스페이스)에서 사용할 수 있습니다.




WikiEditor 익스텐션 사용법

위 화면이 WikiEditor의 문서 편집 화면입니다.


사용자가 환경설정의 편집 탭에서 향상된 편집도구 모음 활성화하기를 체크 해제함으로써 WikiEditor 익스텐션을 비활성화할 수 있습니다.


이것은 WikiEditor 익스텐션을 비활성화한 모습입니다. 환경설정의 편집 탭에서 편집도구 모음 보이기마저 체크해제하면 위 그림화면에서 빈약한 편집 도구마저 사라지고 모든 기능을 위키문법을 직접 작성해야 합니다.

따라서 위키에 대한 진입장벽을 조금이라도 낮추기 위해서는 이 WikiEditor 익스텐션의 활성화가 필수적입니다.


중급 이상의 사용자의 경우, 아래의 파일을 수정하여 툴바를 자신의 입맛에 맞게 변경할 수 있습니다.

IP/extensions/WikiEditor/modules/jquery.wikiEditor.toolbar.config.js


IIS 설정 참고 사항

WikiEditor는 .svg 파일를 사용하여 아이콘을 나타냅니다. 그러나 기본적으로 IIS는 .svg 파일을 지원하지 않습니다. 이 문제를 해결하려면 MIME 유형을 추가해야합니다.