미디어위키(Mediawiki) 로고(Logo)와 파비콘(Favicon) 변경

[관련 게시물]

미디어위키 LocalSettings.php 내용 설명

2018/12/26 - [IT/미디어위키(Mediawiki)] - 미디어위키 설치 직후 LocalSettings.php 기본 설정값 설명

미디어위키 로고 변수

https://www.mediawiki.org/wiki/Manual:$wgLogo

미디어위키 파비콘 변수

https://www.mediawiki.org/wiki/Manual:$wgFavicon

LocalSettings.php 내 경로 관련 설정

로고와 파비콘 변경 작업에 앞서 우리가 LocalSettings.php 파일에서 확인할 부분이 있는데 바로 경로 설정 부분입니다.

## The URL base path to the directory containing the wiki;
## defaults for all runtime URL paths are based off of this.
## For more information on customizing the URLs
## (like /w/index.php/Page_title to /wiki/Page_title) please see:
## https://www.mediawiki.org/wiki/Manual:Short_URL
$wgScriptPath = "/w";

## The protocol and server name to use in fully-qualified URLs
$wgServer = "http://localhost";

## The URL path to static resources (images, scripts, etc.)
$wgResourceBasePath = $wgScriptPath;

## The URL path to the logo.  Make sure you change this from the default,
## or else you'll overwrite your logo when you upgrade!
$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png"; 

위의 해당 내용은 25번째 줄부터 40번째 줄에 걸쳐 있습니다. 오늘 우리가 할 작업에서 우리가 참고하고 수정할 부분입니다.

로고 변경

미디어위키의 설치 후 화면을 보면 거슬리는 부분이 있습니다.

바로 위키 사이트의 로고 그림입니다.

위 로고 그림을 보면 친절하게 로고 이미지 설정 변수를 자신의 로고 이미지 경로로 설정하라고 알려줍니다.

LocalSettings.php 파일에서 해당 변수를 찾아 봅시다.

## The URL path to the logo.  Make sure you change this from the default,
## or else you'll overwrite your logo when you upgrade!
$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png"; 

40번 째 줄 쯤에 $wgLogo 변수 코드를 찾을 수 있습니다. 위 코드가 기본값입니다.

그런데 미디어위키의 버전에 따라 기본값이 다릅니다.

미디어위키 버전이 1.24 이상인 경우

"{$wgScriptPath}/resources/assets/wiki.png" (MW 1.24+)

미디어위키 버전이 1.23 이하인 경우

"{$wgStylePath}/common/images/wiki.png" (MW 1.23 and before)

제가 기준으로 삼고 연재하는 미디어위키는 1.31이므로 첫번째 값이 기본값입니다.

로고 이미지를 바꾸려면 새 로고 이미지를 서버에 올리고 나서 위 코드의 로고 이미지 주소를 해당 이미지 주소로 바꿔 주시면 됩니다.

로고를 올릴 때, 미디어위키 설치 디렉토리/resources/assets/ 디렉토리에 올려주시는 것이 관리하기가 편합니다.

만약 제 연재를 그대로 따라오셨다면 로고 이미지의 절대 경로는 아래와 같을 것입니다.

/var/www/html/w/resources/assets

그런데 위 $wgLogo 설정값에 $wgResourceBasePath가 적혀있군요. $wgResourceBasePath가 뭘까요?

$wgResourceBasePath는 미디어위키의 리소스로더 모듈이 참조하는 remoteBasePath 값입니다. 그리고 이 변수는 다른 값으로 설정되지 않으면 $wgScriptPath의 대체 수단으로 사용됩니다.

우리는 $wgResourceBasePath를 따로 설정하지 않았으므로 $wgScriptPath 값이 적용될 것입니다. 그럼 $wgScriptPath에 대해 알아볼 필요가 있겠군요.

$wgScriptPath는 미디어위키의 기본 경로 값입니다. 우리는 미디어위키를 w라는 이름으로 설치했으므로 /w가 설정값이 됩니다.

많은 다른 변수가 이 $wgScriptPath 변수에 의해 정의됩니다. 만약 LocalSettings.php에서 이것을 다시 정의하면 모든 종속 변수를 검토하여야 하고 다시 정의해야 할 수도 있으므로 함부로 바꾸지 마시기 바랍니다.

/미디어위키 기본 디렉토리/resources/assets 디렉토리(예 : /var/www/html/w/resources/assets)에 로고 이미지 파일을 올려주세요.

그 다음 $wgLogo 변수를 새 로고 이미지에 맞춰 변경해줍니다.

만약 새 로고 이미지 파일 이름이 new_logo.png라면 다음과 같이 수정해주시면 됩니다.

$wgLogo = "$wgResourceBasePath/resources/assets/new_logo.png"; 

변경해주고 저장 후 다시 위키를 방문하면 새 로고로 바뀐 것을 확인할 수 있습니다.

저는 새 이미지를 올리는 대신 미디어위키에 포함되어 있는 다른 이미지로 교체해보도록 하겠습니다.

$wgLogo = "$wgResourceBasePath/resources/assets/mediawiki.png"; 

위 코드를 그대로 쓰면 미디어 위키 안에 포함되어 있는 아래 이미지로 로고가 바뀌게 됩니다.

미디어 위키 설치 직후의 로고와 위 로고 이미지 크기는 135×135 픽셀로, 여러분들이 로고를 바꿀 때도 135×135 픽셀 크기의 이미지를 사용하시는 것이 좋습니다.

로고를 바꾼 후의 위키 메인 화면입니다.

파비콘 변경

파비콘 변수는 로고 변수와는 달리 미리 설정되어있지 않아 새로 설정해주어야 합니다.

마찬가지로 .ico의 파비콘 파일을 /미디어위키 기본 디렉토리/resources/assets 디렉토리에 올리고 나서 LocalSettings.php의 로고 변수 바로 아래 설정해주시면 됩니다.

$wgFavicon = "$wgScriptPath/resources/assets/favicon.ico"; 

위 내용을 추가해주시고 저장 후 다시 위키에 접속하시면 웹브라우저 주소창에 파비콘이 적용된 것을 확인할 수 있습니다.

파비콘 이미지는 16×16이나 32×32 픽셀을 사용하시는 것이 좋습니다.