[관련 게시물]
미디어위키는 현재 굉장히 많은 수의 익스텐션을 배포하고 유지보수하고 있습니다. 배포 상태 또는 유지보수 상태(Release status)는 다음과 같이 구별됩니다.
Release status
stable(녹색) / unmaintained(갈색) / beta(노란색) / experimental(빨간색)
stable( 녹색)
해당 익스텐션을 개발하는 개인 또는 팀이 지속적으로 버그 수정하고 미디어위키의 버전 업에 맞춰 안정적으로 업그레이드하는 상태입니다. 해당 익스텐션 페이지의 정보상자 Release status 색깔은 녹색( 00AF89)입니다.
unmaintained( 갈색)
해당 익스텐션을 개발하는 개인 또는 팀이 더이상 지속적으로 버그 수정하거나 미디어위키의 버전 업에 맞춰 안정적으로 업그레이드를 하지 않는 상태입니다. 지원하는 버전을 초과하는 버전의 미디어위키의 경우 정상적으로 작동하지 않을 수도 있습니다. 해당 익스텐션 페이지의 정보상자 Release status 색깔은 갈색( AC6600)입니다.
beta( 노란색)
해당 상태의 익스텐션은 개발자가 온전한 작동을 보장하지는 않습니다. 해당 익스텐션을 많은 이들에게 공개함으로써 수많은 환경에서의 작동 여부를 검증 받고 회신되는 버그 리포트를 바탕으로 버그를 수정하는 단계입니다. 일종의 오픈 베타 성격이 강합니다. beta라 할지라도 대부분의 환경에서는 핵심 기능은 잘 작동하는 편이며 소소한 버그가 야기될 수는 있습니다. 해당 익스텐션 페이지의 정보상자 Release status 색깔은 노란색( FFCC33)입니다.
experimental( 빨간색)
해당 상태의 익스텐션은 말 그대로 개발자가 실험적인 상태인 개발 초기의 익스텐션을 공개한 것입니다. 이 익스텐션은 일반적인 미디어위키 관리자들에게 공개하여 피드백을 받는 beta 상태보다 이전 단계로 미디어위키 익스텐션 개발이 가능한 동료 개발자들의 피드백을 받는 상태로 일종의 클로즈드 알파 성격이 강합니다. 따라서 해당 상태의 익스텐션은 일반적인 경우 설치 및 사용을 권장하지 않습니다. 해당 익스텐션 페이지의 정보상자 Release status 색깔은 빨간색( FF4500)입니다.
스킨 다운로드 방법
다운로드 예시는 Renameuser 익스텐션입니다.
미디어위키 내 스킨별 공식 페이지
예시 - Renameuser 익스텐션:
미디어위키 공식사이트(https://www.mediawiki.org/)에 접속하여 검색상자에서 아래와 같이 skin:스킨명을 입력해줍니다.
Extension:Renameuser
대소문자는 상관없습니다. :(쌍점)을 기준으로 전자는 분류, 후자는 문서명을 일컫습니다. 모든 익스텐션 공식 문서들은 Extension 분류에 속해 있습니다. 만약 스킨의 공식 문서를 찾는다면 아래와 같이 Skin:스킨명을 적어주시면 됩니다.
Skin:Vector
어쨌든 찾고자 하는 익스텐션을 찾아서 공식 페이지에 접속하면 화면 우측에 다음과 같은 해당 스킨의 정보 상자를 볼 수 있습니다.
오른쪽 정보상자를 보면 라이선스 항목 아래 DownLoad 항목이 있습니다.
Download snapshot을 누르면 미디어위키 사이트 내 익스텐션 배포 전용 페이지로 자동으로 이동하여 해당 익스텐션이 자동으로 선택됩니다.
거기서 자신이 사용하고자 하는 버전을 선택하고 Continue 버튼을 눌러줍니다.
그러면 다운로드 페이지로 이동하며 동시에 자동으로 선택한 버전에 맞는 해당 익스텐션이 다운로드되거나 또는 다운로드 창이 뜹니다.
만약 자동으로 다운로드되지 않는다면 다운로드 페이지에 해당 스냅샷 다운로드 URL 링크가 있으니 해당 링크를 눌러 주시면 됩니다.
다운로드만 한다고 바로 사용할 수 있는 것은 아닙니다. 미디어위키 사이트에서 배포하는 모든 스킨과 익스텐션들은 tar.gz 형식으로 묶이고 압축되어 있습니다.
익스텐션을 사용하려면 자신의 미디어위키의 extensions 폴더에 풀어주어야 합니다.
해당 다운로드 페이지에는 압축 푸는 명령어를 예시를 들어주고 있습니다.
그러나 해당 명령어를 그대로 사용할 수는 없습니다. 미디어위키가 설치된 폴더 위치와 이름부터 기타 서버의 환경이 제각각이기 때문입니다.
tar -xzf Renameuser-REL1_33-fa3f5a1.tar.gz -C /var/www/mediawiki/extensions
익스텐션 파일을 다운받은 디렉토리에서 먼저 관리자 권한을 획득해주어야 합니다. 이미 root 권한으로 전환한 상태라면 위 예시처럼 그냥 tar -xzf ... 이렇게 명령을 실행해주시면 됩니다.
그러나 root 권한 계정으로 전환하지 않은 상태라면 tar -xzf ... 앞에 sudo를 붙여 실행해주어야 합니다. root 권한으로 전환해서 작업하기 보다는 작업 때마다 sudo를 붙여 작업하는 습관을 들이는 것이 안전한 리눅스 작업을 위해 좋습니다.
-C 다음 파일을 압축 풀 디렉토리를 지정해줍니다. 위 예시는 말 그대로 예시일 뿐입니다. 만약 서버 OS가 Ubuntu 18.04 이후 버전이고 제 블로그 연재를 그대로 따라오신 분들이라면 아래와 같이 입력해주시면 됩니다.
sudo tar -xzf Renameuser-REL1_33-fa3f5a1.tar.gz -C /var/www/html/w/extensions
자세한 스킨 다운로드 및 설치, 설정 방법은 다음 링크를 참고하시기 바랍니다.
추후 링크 제공
미디어위키 내 스킨 배포 전용 페이지
이 페이지는 미디어위키에서 현재 지원하고 있는 익스텐션들 중에서 원하는 익스텐션을 선택하여 다운로드 받을 수 있는 페이지입니다. 각 익스텐션 공식 페이지에서 Download snapshot 링크를 누르는 것도 결국은 이 페이지를 이용하는 것입니다.
이 스킨 배포 페이지는 미디어위키가 공식적으로 유지보수를 지원하는 버전의 익스텐션 파일만 내려받을 수 있습니다. 유지보수 지원이 끊겼거나 개발 버전의 각 브랜치별 스킨 파일은 각 스킨의 깃허브 계정에서 따로 다운받아야 합니다.
사용법은 전술한 미디어위키 내 익스텐션별 공식 페이지 파트의 안내를 참고하시기 바랍니다.
스킨별 깃허브 계정
https://github.com/wikimedia/mediawiki-extensions-익스텐션명
예시 - Renameuser 익스텐션:
https://github.com/wikimedia/mediawiki-extensions-Renameuser
미디어위키 사이트에서는 미디어위키 버전 1.31 이후부터 현재 개발 중인 master 버전까지 각 버전별 지원 스킨을 배포하고 있습니다. 그러나 때에 따라서는 일부 버전은 지원하지 않는 익스텐션도 있으므로 지원 버전을 확인하고 스킨을 다운받아야 합니다.
만약 미디어위키 1.30 이전 버전 지원 익스텐션이나 개발 버전 브랜치 별 익스텐션 파일을 다운받으려면 미디어위키 사이트 내 공식 익스텐션 페이지나 미디어위키 내 익스텐션 배포 전용 페이지(https://www.mediawiki.org/wiki/Special:ExtensionDistributor)가 아니라 각 익스텐션별 공식 깃허브 페이지에서 다운받아야 합니다.
다운로드를 받는 방법은 2가지입니다. 깃허브 스킨사이트에서 웹브라우저를 통해 파일을 직접 다운 받거나, git 명령어를 이용해 내려받는 방법입니다.
웹브라우저를 통해 내려받기
깃허브 스킨 사이트에 들어가 원하는 버전의 브랜치를 선택하고 Clone or Download 버튼을 누르면 나타나는 Download ZIP 버튼을 클릭해 다운로드 받습니다.
git으로 내려받기
위 그림의 할당된 깃허브 URL을 클립보드에 복사하여 터미널에서 미디어위키 익스텐션 디렉토리에서 아래와 같이 입력하여 실행해줍니다.
sudo git clone https://github.com/wikimedia/mediawiki-extensions-Renameuser.git --branch REL1_31 Renameuser
--branch REL1_31 자리 대신 자신이 사용하는 미디어위키 버전을 적어주시면 됩니다. 만약 1.33을 쓴다면 --branch REL1_33을 적어주시면 됩니다.
sudo git clone https://github.com/wikimedia/mediawiki-extensions-Renameuser.git --branch REL1_31 Renameuser
Renameuser 198개 452KB
sudo git clone https://github.com/wikimedia/mediawiki-extensions-Renameuser.git
mediawiki-extensions-Renameuser 201개 508KB
깃허브가 아니라 https://gerrit.wikimedia.org/의 저장소를 이용해 clone 복제를 할 수도 있습니다.
sudo git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/익스텐션명 --branch REL1_31
참고로 위 명령어는 미디어위키의 Download from Git 페이지에서 공식적으로 소개하고 있는 방법입니다.
Download from Git
그리고 Renameuser 자리 대신 자신이 사용할 익스텐션의 영문명을 적어주시면 됩니다. 만약 Cite 익스텐션을 쓸 거라면 Renameuser 대신 Cite를 적어주시면 됩니다.
참고로 리눅는 대소문자를 구분하므로 주의하실 필요가 있습니다.
깃을 이용한 스킨 설치 방법은 보다 유용한 기능이 많습니다. 자세한 내용은 아래 링크를 참고하시기 바랍니다.
git으로 내려받을 수 있는 익스텐션 목록은 아래 링크에서 확인할 수 있습니다.
익스텐션 설치 후 설정 작업
LocalSettings.php 파일에 다음과 같이 코드를 추가해주어야 합니다.
wfLoadExtension( 'Renameuser' );
( 'Renameuser' )의 양 따옴표 사이에 Renameuser 대신 자신이 사용할 스킨명을 적어주시면 됩니다. 스킨 설치 디렉토리명과 일치해야 하비니다.
때로는 사용하는 미디어위키 버전이 낮은 경우 위 코드 대신 아래와 같은 코드를 적어 주셔야 작동됩니다.
require_once "$IP/extensions/Renameuser/Renameuser.php";
위의 구식 코드를 써야 되는 버전은 스킨마다 다릅니다. 따라서 익스텐션 공식 페이지의 안내를 확인하시기 바랍니다.
'미디어위키 > 미디어위키 설치 및 관리' 카테고리의 다른 글
| 미디어위키(MediaWiki) 1.31.6, 1.32.6, 1.33.2 보안 업데이트 공개 (0) | 2019.12.27 |
|---|---|
| 미디어위키(Mediawiki) 유지보수 배포판 1.31.5 / 1.32.5 (0) | 2019.11.22 |
| 미디어위키(Mediawiki) 보안 및 유지보수 배포판 1.31.4 / 1.32.4 / 1.33.1 (0) | 2019.11.20 |
| 미디어위키(Mediawiki) 기본 제공 익스텐션 목록 (0) | 2019.10.11 |
| 미디어위키(Mediawiki) 1.33 공식 지원 익스텐션 통합 설치 (0) | 2019.08.08 |
| 미디어위키(Mediawiki) 1.32 공식 지원 익스텐션 통합 설치 (0) | 2019.08.06 |
| 미디어위키(Mediawiki) 1.31 공식 지원 익스텐션 통합 설치(상세 설명) (0) | 2019.08.04 |
| 미디어위키(Mediawiki) 1.33 공식 지원 스킨 통합 설치 (0) | 2019.07.31 |