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

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

씨실과 날실 2020. 5. 6. 09: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 설치와 활용




[Gadgets 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

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

다운로드

미디어위키 내 배포 페이지

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

github 페이지

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


Gadgets 익스텐션 기능

사용자가 환경 설정 페이지에서 JS 기반의 사용자 제공 소도구(가젯)를 사용하도록 설정할 수 있는 기능을 제공하는 사용자 환경 설정과 특수 문서 형식의 익스텐션입니다.

각 소도구(가젯)는 MediaWiki:Gadgets-definition의 줄(행)로 정의되어 소도구의 이름과 설명, 그리고 사용하는 JS 및 CSS 스니펫 목록을 제공합니다.




익스텐션 다운로드 및 설치

다운로드 안내

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


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

익스텐션 공식 배포처

미디어위키 내 배포 페이지

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

github 페이지

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




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

1.34

https://extdist.wmflabs.org/dist/extensions/Gadgets-REL1_34-1cefbf1.tar.gz

1.33

https://extdist.wmflabs.org/dist/extensions/Gadgets-REL1_33-3dc8276.tar.gz

1.32

https://extdist.wmflabs.org/dist/extensions/Gadgets-REL1_32-fe3c8a7.tar.gz

1.31

https://extdist.wmflabs.org/dist/extensions/Gadgets-REL1_31-bac29ae.tar.gz

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

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

리눅스 서버의 경우

$ sudo tar -xzf Gadgets-REL1_34-1cefbf1.tar.gz -C /미디어위키 설치 경로/extensions


예시 - Ubuntu

$ sudo tar -xzf Gadgets-REL1_34-1cefbf1.tar.gz -C /var/www/html/w/extensions

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


윈도 서버의 경우

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


호스팅을 받는 경우

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




Gadgets 익스텐션 필수 설정

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

wfLoadExtension( 'Gadgets' );


... 전략 ...

# 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) 문서를 확인하면 위 익스텐션이 추가된 것을 확인할 수 있습니다.




Gadgets 익스텐션 사용법

위키 관리자

$wgGadgetsRepoClass에 따라 소도구를 정의하는 두 가지 방법이 있습니다.

'MediaWikiGadgetsDefinitionRepo'(기본값)를 사용하는 경우,  이용 가능한 소도구 목록은 MediaWiki:Gadgets-definition에서 정의됩니다.

다른 방법으로, $wgGadgetsRepoClass를 'GadgetDefinitionNamespaceRepo'로 설정된 경우 소도구 정의 이름공간(네임 스페이스)의 페이지에 정의됩니다.

참고로 이미 정의된 소도구 정의 정보 이전은 지원되지 않습니다. 따라서 이 설정을 변경하면 이전에 정의된 소도구가 손실됩니다.

하나 이상의 유효한 소도구가 생성되면 정의된 소도구가 Special:Preferences의 "Gadgets"섹션에 표시됩니다.

사용자는 사용하려는 소도구를 선택할 수 있습니다. MediaWiki:Gadgets-definition에서 정의한 소도구에 대한 개요는 Special:Gadgets에 표시되며 각 시스템 메시지에 대한 링크와 함께 쉽게 편집할 수 있습니다. 기본 제공이 아닌 소도구 사용에 대한 통계는 Special:GadgetUsage에서 확인할 수 있습니다.


미디어 위키 소도구 정의 사용

하나 이상의 "*"(별표) 문자로 시작하는 MediaWiki:Gadgets-definition의 각 줄은 하나의 소도구를 정의합니다.

다음과 같은 형식이어야합니다.

* gadget_name [옵션 (생략 가능)] | 페이지 이름

첫 번째 항목 ("gadget_name")은 소도구의 내부 이름이며 위키 구문을 사용하여 소도구에 대한 간단한 설명이 포함된 시스템 메시지 ( 예 : MediaWiki:Gadget-gadget_name)를 참조합니다.

내부 이름은 양식 필드의 이름의 일부로, NAME 속성 값에 대해 정의된 규칙을 사용하고 따라야합니다.

즉, 문자 ([A-Za-z])로 시작해야하며 뒤에 문자, 숫자 ([0-9]), 하이픈 ("-"), 밑줄 ("_"), 콜론 ( ":") 및 마침표 ( ".")가 올 수 있습니다.


미디어위키:Gadgets-definition


== 둘러보기 소도구 ==
* searchFocus[ResourceLoader]|searchFocus.js
* modrollback[ResourceLoader|rights=rollback]|modrollback.js
* ReferenceTooltips[ResourceLoader|default]|ReferenceTooltips-ko.js|ReferenceTooltips.css
* Navigation_popups[ResourceLoader|dependencies=mediawiki.user,mediawiki.util]|popups.js|popups-strings-ko.js|navpop.css

== 편집 소도구 ==
* HotCat[ResourceLoader|rights=edit,purge]|HotCat.js
* noSignAlert[ResourceLoader]|noSignAlert.js
* purgetab[ResourceLoader|dependencies=mediawiki.util,mediawiki.api,mediawiki.notify]|purgetab.js
* charinsert[ResourceLoader|peers=charinsert-styles]|charinsert.js
* charinsert-core[ResourceLoader|hidden|dependencies=mediawiki.toolbar,jquery.textSelection,user]|charinsert-core.js
* charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css

== 인터페이스 소도구 ==
* exlinks[ResourceLoader|dependencies=mediawiki.util]|exlinks.js
* RollbackComment[ResourceLoader|rights=rollback]|RollbackComment.js


특수:소도구



옵션

옵션 형식 :

[옵션 1 | 옵션 2 | ... 옵션 N]

공백은 생략할 수 있습니다. 단일 옵션은 단일 옵션 이름 (이 경우 플래그 옵션)으로 구성되거나 쉼표로 구분된 값 목록을 포함 할 수 있습니다.

옵션 = value1, value2, value3

* mygadget | mygadget.js|mygadget.css

* mygadget [ResourceLoader] | mygadget.js | mygadget.css

* mygadget [rights = foo, bar] | mygadget.js | mygadget.css

* mygadget [ResourceLoader | rights = foo, bar] | mygadget.js | mygadget.css


각 옵션별 기능


 
소도구 정의 네임 스페이스 사용

소도구 정의 이름공간(네임 스페이스)을 사용하는 것은 고급 사용자가 아니라면 권장하지 않습니다.

자세한 내용은 아래 링크를 참고하시기 바랍니다.


기타




실무

프로그래밍이 가능한 고급 관리자는 자신이 직접 소도구를 작성하여 위키에 적용할 수 있겠지만 그러실 수 있는 분이라면 제 연재를 굳이 보고 있지는 않겠지요.

초중급 관리자가 소도구를 사용하는 방법은 전세계의 다른 위키에 적용되어 있는 소도구를 복사해와 자신의 위키에 적용하는 것입니다.

이것에 대한 실제 적용 예시는 소도구 설치 연재를 참고하시기 바랍니다.

2019/01/07 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 01 - 인터위키 설정

2019/01/09 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 02 - 단일 소스 코드 문서 소도구

2019/01/13 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 03 - 다수 소스 코드 문서 소도구

2019/01/18 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 04 - 소도구 관련 추가 편집 작업

2019/01/19 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 04 - 환경설정(소도구) + 주시문서 목록 비우기

2019/01/23 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 위키 대문 접속 시 키보드 커서 검색상자에 놓기

2019/01/24 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 되돌리기된 사용자의 기여 내역 보기 + 되돌리기, 편집 취소

2019/01/25 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 각주 말풍선 + 기본적인 각주 사용 방법

2019/01/26 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 내비게이션 팝업

2019/01/27 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - HotCat(핫캣) + 미디어위키 분류 기능 사용하기

2019/01/28 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 토론 작성 후 서명 확인 + 토론 문서 작성법, 서명 태그 사용법, 새 서명 사용법

2019/01/29 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 캐시 삭제(= 새로 고침)

2019/01/30 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - CharInsert

2019/01/31 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 외부 링크 새창으로 띄우기 + 내부 링크, 외부 링크 걸기

2019/02/01 - [미디어위키/미디어위키 설치 및 관리] - 미디어위키(Mediawiki) 1.31.1 소도구 - 되돌리기 기능 추가 + 되돌리기, 편집 취소 사용법


위키 사용자

일반 위키 사용자는 위키 관리자가 구성한 소도구들을 환경설정 - 소도구 탭에서 활성화하여 사용하거나 비활성화하여 끌 수 있습니다.