미디어위키/미디어위키 스킨

미디어위키(Mediawiki) 추가 제공 스킨(skin) Minerva Neue(미네르바)

씨실과 날실 2020. 3. 29. 22:06

Minerva Neue(미네르바)는 전세계 Wikimedia 프로젝트에 모바일 접속 환경의 인터페이스를 제공하는 스킨입니다. Vector와 같은 다른 스킨에 비해 훨씬 단순한 사용자 인터페이스를 제공하며 모바일 사용자에게 친화적이도록 디자인이 고안되고 모바일 환경에서의 성능 최적화에 중점을 두고 개발되었습니다.

MobileFrontend 익스텐션과 함께 사용하도록 설계되었습니다.


스킨 다운로드

공식 배포 페이지를 통한 다운로드

Minerva Neue(미네르바) 스킨의 공식 배포 페이지는 아래와 같습니다.

공식 배포 페이지 스킨 정보 상자에서 Downlad snapshot을 눌러 자신의 미디어위키 버전을 선택 후 Continue ,버튼을 눌러줍니다. 그러면 파일 다운로드 창이 자동으로 뜰 겁니다. 만약 자동으로 파일 다운로드가 진행되지 않는다면 해당 스킨 다운로드 페이지 상단의 스냅샷 주소 링크를 눌러 다운받으시면 됩니다.


SkinDistributor를 통한 버전별 다운로드

위 링크에 접속하여 스킨명을 선택하고 미디어위키 버전을 선택 후 Continue 버튼을 눌러줍니다. 그러면 파일 다운로드 창이 자동으로 뜰 겁니다. 만약 자동으로 파일 다운로드가 진행되지 않는다면 해당 스킨 다운로드 페이지 상단의 스냅샷 주소 링크를 눌러 다운받으시면 됩니다.


터미널을 통한 버전별 다운로드

1.34

study@study-VirtualBox:~/다운로드$ wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-REL1_34-d0be74a.tar.gz

1.33

study@study-VirtualBox:~/다운로드$ wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-REL1_33-1903d1a.tar.gz

1.32

study@study-VirtualBox:~/다운로드$ wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-REL1_32-e1c3fb6.tar.gz

1.31

study@study-VirtualBox:~/다운로드$ wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-REL1_31-2e70e79.tar.gz


스킨 설치

스킨의 설치 디렉토리는 $IP/skins 폴더입니다. $IP는 미디어위키가 설치된 경로를 뜻합니다. 예를 들어 제 설치 과정을 따라오셨다면 경로가 다음과 같을 것입니다.

$IP

/var/www/html/w

스킨 설치 경로

/var/www/html/w/skins


다운받은 스킨 파일 압축 풀어 설치

형식

study@study-VirtualBox:~/다운로드$ sudo tar -xzf 스킨 파일명.tar.gz -C /var/www/w/skins

예시 - 1.31

study@study-VirtualBox:~/다운로드$ sudo tar -xzf MinervaNeue-REL1_31-2e70e79.tar.gz -C /var/www/w/skins


Git을 통한 설치

Timeless(타임리스) 스킨의 Github(깃허브) 사이트 주소는 다음과 같습니다.

터미널에서 아래와 같은 명령어를 실행해줍니다.

study@study-VirtualBox:/var/www/html/w/skins$ sudo git clone https://github.com/wikimedia/mediawiki-skins-MinervaNeue

그 다음 디렉토리명을 바꾸어 줍니다.

study@study-VirtualBox:/var/www/html/w/skins$ sudo mv mediawiki-skins-MinervaNeue MinervaNeue

보통 MonoBook라는 이름을 씁니다. 이때 중요한 것은 리눅스를 포함한 유닉스 계열 OS들은 영문자 대소문자를 구분한다는 것입니다. 따라서 Timeless와 timeless는 별개의 디렉토리입니다.


LocalSetting.php 파일 설정

$IP/skins 폴더 안에 MonoBook 스킨 압축 파일을 풀어주거나, 혹은 Git clone 명령을 통해 스킨을 복제한 후, LocalSettings.php 파일에 다음과 같은 코드를 적어줍니다.(참고로 $IP는 미디어위키 폴더 경로를 의미합니다.)

wfLoadSkin( 'MinervaNeue' );

위 구문은 스킨을 활성화하는 코드입니다.

$wgDefaultSkin = 'minerva';

위 구문은 기본 스킨을 설정하는 코드입니다. 이 코드를 사용하면 데스크톱 보기에서도 Minerva가 기본 스킨이됩니다. 그러나 데스크톱에서 이 스킨을 사용하는 것은 UX 측면에서 좋은 선택은 아닙니다.

따라서 이 코드는 기존 스킨 설정값으로 놔두고 아래 코드를 추가해주는 것을 권장합니다.

$wgMFDefaultSkinClass = "SkinMinerva";

이 구문은 MobileFrontend 익스텐션을 사용한 모바일 접속 환경에서 위키에 접속할 때만 MinervaNeue 스킨을 사용하도록 서절정해주는 코드입니다.

위  코드는 반드시 추가되어야 하면 순서 역시 바뀌면 안됩니다.

코드 작성 순서

반드시 wfLoadExtension를 호출한 다음에  wfLoadSkin을 호출해야 합니다.


MobileFrontend 익스텐션과 통합

Minerva Neue(미네르바) 스킨을 제대로 활용하기 위해서는 MobileFrontend 익스텐션을 설치해주어야 합니다.


설치 확인

위키의 특수:버전(= Special:Version) 문서로 이동하여 스킨이 성공적으로 설치되었는지 확인합니다.


구성

메뉴 구성

기본 메뉴의 특정 URL을 조정할 수 있습니다.

무작위 (MediaWiki:Randompage-url 편집을 통해)
포털 URL (MediaWiki:Portal-url을 통한 고급 편집 모드)

관련 익스텐션(MobileFrontend)이 추가되면 특정 메뉴 항목이 자동으로 활성화됩니다.


데스크톱 및 모바일 모드

MobileFrontend는 MediaWiki 코어에서 사용할 수 없는 추가 기능을 제공합니다. 데스크탑과 모바일 모드 전환 기능을 제공합니다.

모바일 모드에서 작동하는 경우 다음 기능을 사용할 수 있습니다.

섹션을 축소하거나 확장가능

메뉴에 다른 옵션이 존재
(예 : 특수:환경설정을 데스크탑에서 사용 가능)

MediaWiki:Mobile.css(모바일 모드) 또는 MediaWiki:Common.css(데스크톱 모드)가 로드

모바일에 최적화 된 다양한 페이지
(예 : Special:Watchlist)


모바일 접속 환경 구축 실무

모바일 접속 환경 구축 실무는 아래 링크를 참고하시기 랍니다.