제로원:미디어위키 URL 문서 원본 보기

{{제로원포털}}

이 문서는 미디어위키의 URL에 대한 설정을 정리한 것이다. 

== Short URL ==
미디어위키 URL에서 index.php 부분을 없애는 방법이다. [[mediawikiwiki:Manual:Short_URL/Apache|미디어 위키에서 설명한 방법(영어)]]을 토대로 작성하였다. 현재 [[통진고위키]]에서의 설정은 다음과 같다.
{| class="wikitable"
|+
!접속 URL
!연결되는 URL
|-
|<code>/wiki/*</code>
|<code>/w/index.php/*</code>
|}
이렇게 하면 기술적 세부내용이 사용자에게 노출되지 않게 하고, 백엔드를 수정해도 안정적이며, 가독성이 높고 기억하기 쉬워 방문자를 유도하기 좋다. 또한 검색엔진 최적화에 유리하다.

통진고위키는 루트 계정으로 접속할 수 있으므로 '''루트 계정이 있을 때만''' 쓸 수 있는 비교적 간단한 방법을 사용하였다. 루트 계정이 없을 때 Short URL을 설정하는 방법은 [[mediawikiwiki:Manual:Short_URL/ko|미디어위키(한국어)]]를 참고하라.

=== 서버 설정 ===
<code>/etc/apache2/sites-available/000-default.conf</code> 파일로 사이트에 대한 설정을 바꿀 수 있다. 이 파일에서 다음 구문을 <code>DocumentRoot</code> 명령 뒤에 써넣는다.<syntaxhighlight lang="apacheconf">
# 통진고위키의 미디어위키는 /var/www/html/w에 설치되어 있다.
Alias /wiki /var/www/html/w/index.php
</syntaxhighlight>이 구문의 두번째 인자는 미디어위키의 설치 경로이다. 이제 <code>/wiki</code>로 시작하는 URL로 접속할 때 <code>/w/index.php</code>와 같은 화면을 볼 수 있다.

=== LocalSettings.php ===
위 설정 후에 위키 내부의 링크를 타고 들어가면 여전히 <code>/w/index.php</code>로 연결되는 것을 볼 수 있다. 위키 내에서도 <code>/wiki</code>로 연결되게 하려면 미디어위키 디렉토리의 <code>LocalSettings.php</code> 파일에서 다음과 같은 변수를 설정해야 한다.<syntaxhighlight lang="php" line="1">
## https://www.mediawiki.org/wiki/Manual:Short_URL
$wgScriptPath = "/w";        // 이미 설정되어 있을 것이다.
$wgArticlePath = "/wiki/$1";
$wgUsePathInfo = true;
</syntaxhighlight>

== $wgActionPaths ==
<code>LocalSettings.php</code>에서 이 변수는 미디어위키에서 각종 동작의 경로를 바꾸는 변수이다. [[mediawikiwiki:Manual:$wgActionPaths/ko|미디어위키에서 설명한 방법(한국어)]]를 토대로 작성하였다. 

미디어위키에서는 [[제로원:미디어위키 URL#Short URL|Short URL]]을 먼저 설정할 것을 당부하고 있다.

현재 통진고위키는 <code>/wiki/문서 이름/동작</code><ref>예: <code>/wiki/ZERO-ONE/edit</code></ref> 형태의 경로로 작동한다. 이와 같은 설정은 다음으로 할 수 있다.<syntaxhighlight lang="php">
// 모든 동작에 대해 각각 경로를 설정해준다.
$actions = array( 'edit', 'watch', 'unwatch', 'delete','revert', 'rollback',
  'protect', 'unprotect', 'markpatrolled', 'render', 'submit', 'history', 'purge', 'info' );

foreach ( $actions as $action ) {
  $wgActionPaths[$action] = "/wiki/$1/$action";
}

// 문서 읽기 동작(view)은 뒤에 아무것도 붙이지 않는다.
$wgActionPaths['view'] = "/wiki/$1";
$wgArticlePath = $wgActionPaths['view'];
</syntaxhighlight>