미디어위키/미디어위키 설치 및 관리

미디어위키(Mediawiki) 배포 스킨 다운로드 및 설치 방법

씨실과 날실 2019. 7. 21. 09:00

미디어위키는 현재 상당 수의 스킨을 공식적으로 배포하고 유지보수하고 있습니다.

이글을 게시한 현재, 미디어위키 공식 배포 파일에 기본적으로 포함되어 있는 3개(Vector, MonoBook, Timeless)의 스킨 외에도 총 38개의 추가 스킨이 미디어위키 공식 사이트에 각 스킨마다 공식 페이지를 유지하고 해당 스킨 설명과 함께 스킨 파일을 배포하고 있습니다.

스킨을 내려받을 수 있는 경로는 크게 다음과 같습니다.

스킨 다운로드 방법

미디어위키 내 스킨별 공식 페이지

(https://www.mediawiki.org/wiki/Skin:스킨명)

예시 - Vector 스킨: https://www.mediawiki.org/wiki/Skin:Vector

미디어위키 공식사이트(https://www.mediawiki.org/)에 접속하여 검색상자에서 아래와 같이 skin:스킨명을 입력해줍니다.

Skin:Vector

대소문자는 상관없습니다. :(쌍점)을 기준으로 전자는 분류, 후자는 문서명을 일컫습니다. 모든 스킨 공식 문서들은 Skin 분류에 속해 있습니다. 만약 익스텐션의 공식 문서를 찾는다면  아래와 같이 Extension:익스텐션명을 적어주시면 됩니다.

Extension:Echo

어쨌든 찾고자 하는 스킨을 찾아서 공식 페이지에 접속하면 화면 우측에 다음과 같은 해당 스킨의 정보 상자를 볼 수 있습니다.

오른쪽 정보상자를 보면 라이선스 항목 아래 DownLoad 항목이 있습니다.

Download snapshot을 누르면 미디어위키 사이트 내 스킨 배포 전용 페이지로 자동으로 이동하여 해당 스킨이 자동으로 선택됩니다.

거기서 자신이 사용하고자 하는 버전을 선택하고 Continue 버튼을 눌러줍니다.

그러면 다운로드 페이지로 이동하며 동시에 자동으로 선택한 버전에 맞는 해당 스킨이 다운로드되거나 또는 다운로드 창이 뜹니다.

만약 자동으로 다운로드되지 않는다면 다운로드 페이지에 해당 스냅샷 다운로드 URL 링크가 있으니 해당 링크를 눌러 주시면 됩니다.

다운로드만 한다고 바로 사용할 수 있는 것은 아닙니다. 미디어위키 사이트에서 배포하는 모든 스킨과 익스텐션들은 tar.gz 형식으로 묵이고 압축되어 있습니다.
스킨을 사용하려면 자신의 미디어위키의 skins 폴더에 풀어주어야 합니다.

해당 다운로드 페이지에는 압축 푸는 명령어를 예시를 들어주고 있습니다.

그러나 해당 명령어를 그대로 사용할 수는 없습니다. 미디어위키가 설치된 폴더 위치와 이름부터 기타 서버의 환경이 제각각이기 때문입니다.

tar -xzf Vector-REL1_33-878c1e8.tar.gz -C /var/www/mediawiki/skins

스킨 파일을 다운받은 디렉토리에서 먼저 관리자 권한을 획득해주어야 합니다. 이미 root 권한으로 전환한 상태라면 위 예시처럼 그냥 tar -xzf ... 이렇게 명령을 실행해주시면 됩니다.

그러나 root 권한 계정으로 전환하지 않은 상태라면 tar -xzf ... 앞에 sudo를 붙여 실행해주어야 하비니다. root 권한으로 전환해서 작업하기 보다는 작업 때마다 sudo를 붙여 작업하는 습관을 들이는 것이 안전한 리눅스 작업을 위해 좋습니다.

-C 다음 파일을 압축 풀 디렉토리를 지정해줍니다. 위 예시는 말 그대로 예시일 뿐입니다. 만약 서버 OS가 Ubuntu 18.04 이후 버전이고 제 블로그 연재를 그대로 따라오신 분들이라면 아래와 같이 입력해주시면 됩니다.

sudo tar -xzf Vector-REL1_33-878c1e8.tar.gz -C /var/www/html/w/skins

자세한 스킨 다운로드 및 설치, 설정 방법은 다음 링크를 참고하시기 바랍니다.

미디어위키 내 스킨 배포 전용 페이지

(https://www.mediawiki.org/wiki/Special:SkinDistributor)

이 페이지는 미디어위키에서 현재 지원하고 있는 스킨들 중에서 원하는 스킨을 선택하여 다운로드 받을 수 있는 페이지입니다. 각 스킨 공식 페이지에서 Download snapshot 링크를 누르는 것도 결국은 이 페이지를 이용하는 것입니다.

이 스킨 배포 페이지는 미디어위키가 공식적으로 유지보수를 지원하는 버전의 스킨 파일만 내려받을 수 있습니다. 유지보수 지원이 끊겼거나 개발 버전의 각 브랜치별 스킨 파일은 각 스킨의 깃허브 계정에서 따로 다운받아야 합니다.

사용법은 전술한 미디어위키 내 스킨별 공식 페이지 파트의 안내를 참고하시기 바랍니다.

스킨별 깃허브 계정

(https://github.com/wikimedia/mediawiki-skins-스킨명)

예시 - Vector 스킨 :  https://github.com/wikimedia/mediawiki-skins-Vector


미디어위키 사이트에서는 미디어위키 버전 1.31 이후부터 현재 개발 중인 master 버전까지 각 버전별 지원 스킨을 배포하고 있습니다. 그러나 때에 따라서는 일부 버전은 지원하지 않는 스킨도 있으므로 지원 버전을 확인하고 스킨을 다운받아야 합니다.

만약 미디어위키 1.30 이전 버전 지원 스킨이나 개발 버전 브랜치 별 스킨 파일을 다운받으려면 미디어위키 사이트 내 공식 스킨 페이지나 미디어위키 내 스킨 배포 전용 페이지(https://www.mediawiki.org/wiki/Special:SkinDistributor)가 아니라 각 스킨별 공식 깃허브 페이지에서 다운받아야 합니다.

다운로드를 받는 방법은 2가지입니다. 깃허브 스킨사이트에서 웹브라우저를 통해 파일을 직접 다운 받거나, git 명령어를 이용해 내려받는 방법입니다.

웹브라우저를 통해 내려받기

깃허브 스킨 사이트에 들어가 원하는 버전의 브랜치를 선택하고 Clone or Download 버튼을 누르면 나타나는 Download ZIP 버튼을 클릭해 다운로드 받습니다. 

git으로 내려받기

위 그림의 할당된 깃허브 URL을 클립보드에 복사하여 터미널에서 미디어위키 스킨 디렉토리에서 아래와 같이 입력하여 실행해줍니다.

sudo git clone https://github.com/wikimedia/mediawiki-skins-Vector.git --branch REL1_31 Vector

--branch REL1_31 자리 대신 자신이 사용하는 미디어위키 버전을 적어주시면 됩니다. 만약 1.33을 쓴다면 --branch REL1_33을ㅈ적어주시면 됩니다.

그리고 Vector 자리 대신 자신이 사용할 스킨의 영문명을 적어주시면 됩니다. 만약 Timeless 스킨을 쓸 거라면 Vector 대신 Timeless를 적어주시면 됩니다.

참고로 리눅는 대소문자를 구분하므로 주의하실 필요가 있습니다.

깃을 이용한 스킨 설치 방법은 보다 유용한 기능이 많습니다. 자세한 내용은 아래 링크를 참고하시기 바랍니다.

git으로 내려받을 수 있는 스킨 목록은 아래 링크에서 확인할 수 있습니다.

스킨 설치 후  설정 작업

LocalSettings.php 파일에 다음과 같이 코드를 추가해주어야 합니다.

wfLoadSkin( 'Vector' );

( 'Vector' )의 양 따옴표 사이에 Vector 대신 자신이 사용할 스킨명을 적어주시면 됩니다. 스킨 설치 디렉토리명과 일치해야 하비니다.

때로는 사용하는 미디어위키 버전이 낮은 경우 위 코드 대신 아래와 같은 코드를 적어 주셔야 작동됩니다.

require_once "$IP/skins/Vector/Vector.php";

위의 구식 코드를 써야 되는 버전은 스킨마다 다릅니다. 따라서 스킨 공식 페이지의 안내를 확인하시기 바라비니다.

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