개요[편집 / 원본 편집]
이 문서는 위키 문법 도우미 문서 중 넘겨주기 문서에 대해 자세히 알아보는 문서입니다.
넘겨주기 문서란 특정 문서 제목으로 접속한 사용자를 다른 문서로 안내하는 문서입니다. 예를 들어 어떤 주제가 여러 이름으로 불리거나, 약어·정식 명칭·띄어쓰기 차이·대소문자 차이·옛 문서명과 새 문서명이 함께 쓰이는 경우에 사용됩니다.[1]
예를 들어 smc라는 문서가 메카시티:ZERO 문서로 넘겨주는 문서라면, 사용자가 smc를 입력하거나 해당 링크를 클릭했을 때 최종적으로 메카시티:ZERO 문서가 표시됩니다.
넘겨주기 문서란?[편집 / 원본 편집]
넘겨주기 문서는 문서의 실제 내용 대신 다음과 같은 넘겨주기 명령을 담고 있는 문서입니다.
#REDIRECT [[대상 문서 이름]]
또는 한국어 미디어위키 환경에서는 다음과 같은 형식도 사용할 수 있습니다.
#넘겨주기 [[대상 문서 이름]]
넘겨주기 문서는 일반 문서처럼 문서 역사, 토론 문서, 편집 기능을 가질 수 있습니다. 다만 사용자가 일반적으로 문서 제목을 눌러 접속하면 넘겨받는 대상 문서가 표시됩니다.
작동 원리[편집 / 원본 편집]
A라는 문서가 B라는 문서로 넘겨주는 문서라고 가정하면, 사용자의 이동 흐름은 다음과 같이 이해할 수 있습니다.
(사용자) → (A 문서 요청) → (미디어위키가 A 문서의 넘겨주기 명령 확인) → (B 문서 표시)
중요한 점은, 일반적인 미디어위키 문서 넘겨주기는 단순히 웹 서버의 HTTP 301 또는 HTTP 302 리디렉션과 완전히 같은 개념이 아니라는 점입니다. 미디어위키는 넘겨주기 문서를 해석한 뒤 대상 문서를 표시하고, 문서 제목 아래에 “넘겨받음” 또는 “Redirected from”과 같은 안내 문구를 표시할 수 있습니다.[1]
대상 문서에서 넘겨주기 원본 문서를 직접 보고 싶다면 URL 끝에 다음과 같은 매개변수를 붙여 접속할 수 있습니다.
?redirect=no
예를 들어 다음과 같은 주소 형식입니다.
https://example.org/wiki/넘겨주기문서?redirect=no
이렇게 접속하면 대상 문서로 바로 넘어가지 않고, 넘겨주기 문서 자체를 확인하거나 편집할 수 있습니다.
하드 넘겨주기와 소프트 넘겨주기[편집 / 원본 편집]
미디어위키의 넘겨주기는 크게 하드 넘겨주기와 소프트 넘겨주기로 나누어 설명할 수 있습니다.[1]
하드 넘겨주기[편집 / 원본 편집]
하드 넘겨주기는 사용자가 넘겨주기 문서에 접속했을 때 대상 문서가 바로 표시되는 방식입니다. 일반적으로 문서 맨 앞에 다음과 같은 문법을 넣어 만듭니다.
#REDIRECT [[대상 문서 이름]]
또는
#넘겨주기 [[대상 문서 이름]]
이 문서에서 주로 설명하는 넘겨주기는 하드 넘겨주기입니다.
소프트 넘겨주기[편집 / 원본 편집]
소프트 넘겨주기는 사용자를 자동으로 이동시키지 않고, 현재 문서에 “이 문서로 이동하세요”와 같은 안내 링크를 보여주는 방식입니다. 보통 틀을 사용해 구현합니다.
소프트 넘겨주기는 다음과 같은 경우에 사용할 수 있습니다.
- 다른 위키나 외부 사이트로 안내해야 할 때
- 특수 문서처럼 하드 넘겨주기가 제한될 수 있는 곳으로 안내할 때
- 자동 이동보다 안내 문구를 보여주는 편이 적절할 때
미디어위키 설정에 따라 특수 문서나 다른 위키로의 하드 넘겨주기가 제한될 수 있으며, 이런 경우 소프트 넘겨주기처럼 처리될 수 있습니다.[2]
301 리디렉션? 302 리디렉션?[편집 / 원본 편집]
HTTP 상태 코드에서 페이지 이동과 관련해 자주 언급되는 코드는 301과 302입니다. 자세한 내용은 HTTP 상태 코드/리디렉션 문서를 참고하세요.
| 상태 코드 | 의미 | 일반적인 용도 |
|---|---|---|
| 301 Moved Permanently | 영구 이동 | 주소가 영구적으로 바뀌었을 때 사용합니다. |
| 302 Found | 임시 이동 | 요청한 자원이 임시로 다른 주소에 있을 때 사용합니다. |
301은 요청한 자원이 영구적으로 다른 URL로 이동했다는 뜻입니다. 브라우저는 새 주소로 다시 요청하고, 검색 엔진도 보통 새 주소를 더 중요한 주소로 취급합니다.[3]
302는 요청한 자원이 임시로 다른 URL에 있다는 뜻입니다. 브라우저는 새 주소로 다시 요청하지만, 의미상 “원래 주소가 완전히 사라졌다”는 뜻은 아닙니다.[4]
문서 넘겨주기는 항상 302인가?[편집 / 원본 편집]
결론부터 말하면, “미디어위키의 문서 넘겨주기”와 “HTTP 302 리디렉션”은 구분해야 합니다.
미디어위키의 일반 넘겨주기 문서는 문서 내용에 적힌 넘겨주기 명령을 미디어위키가 해석하여 대상 문서를 보여주는 기능입니다. 따라서 사용자가 개발자 도구에서 보는 HTTP 상태 코드는 접속한 URL, 짧은 URL 설정, 검색 기능, 특수 문서, 서버 설정, 캐시 서버, 확장 기능에 따라 달라질 수 있습니다.
미디어위키에는 PHP 코드에서 특정 URL로 HTTP 리디렉션을 보낼 때 쓰는 OutputPage::redirect() 기능이 있으며, 이 기능의 기본 응답 코드는 302입니다.[5] 그러나 이것은 “모든 넘겨주기 문서가 반드시 HTTP 302를 반환한다”는 뜻이 아닙니다.
따라서 개발자 도구에서 302가 보였다면 다음 중 어느 단계에서 발생했는지 확인해야 합니다.
- 검색창에서 정확한 문서명으로 이동하는 과정
Special:Search에서 문서로 이동하는 과정- 짧은 URL과 실제
index.php주소 사이의 이동 - HTTP에서 HTTPS로 이동하는 서버 설정
- 대소문자나 표준 문서명으로 보정되는 과정
- 확장 기능이나 스킨에서 추가한 별도 리디렉션
- 실제 넘겨주기 문서 처리
Web Sniffer로 확인하기[편집 / 원본 편집]
Web Sniffer는 HTTP 요청 및 응답 헤더를 웹에서 확인할 수 있는 도구입니다. 예를 들어 smc 문서가 넘겨주기 문서인지 확인하고 싶다면 다음 주소를 입력할 수 있습니다.
https://www.gaonwiki.com/w/Smc
이 주소를 Web Sniffer에 입력했을 때 HTTP Response Header 문단에 HTTP/1.1 200 OK가 표시될 수 있습니다.
이 경우 200 OK가 표시된다고 해서 넘겨주기가 작동하지 않는다는 뜻은 아닙니다. 미디어위키가 넘겨주기 문서를 해석하여 대상 문서의 내용을 정상적으로 표시했기 때문에 최종 응답이 200으로 보일 수 있습니다.
왜 개발자 도구와 결과가 다르게 보일 수 있는가?[편집 / 원본 편집]
브라우저 개발자 도구에서는 한 번의 접속 과정에서 발생한 여러 요청이 모두 보입니다. 예를 들어 검색창에 smc를 입력하고 “보기”를 눌렀다면, 처음에는 다음과 비슷한 특수 문서 주소로 요청될 수 있습니다.
/w/index.php?title=특수:검색&search=smc&go=보기
그 다음 미디어위키가 해당 검색어와 일치하는 문서로 보내기 위해 다른 주소로 이동시킬 수 있습니다. 이 과정에서 302가 보일 수 있습니다.
즉, 개발자 도구에서 302가 보였다고 해서 그것이 반드시 “넘겨주기 문서 자체의 HTTP 응답”이라고 단정하면 안 됩니다. 302는 검색 이동, 특수 문서 이동, 표준 URL 보정 등 다른 단계에서 발생했을 수 있습니다.
개발자 도구에서 확인할 때는 각 요청의 주소를 구분해야 합니다.
| 확인할 항목 | 의미 |
|---|---|
| Request URL | 실제로 브라우저가 요청한 주소입니다. |
| Status Code | 해당 요청에 대한 HTTP 응답 코드입니다. |
| Location 헤더 | 301, 302 등에서 이동할 대상 주소를 알려주는 헤더입니다. |
| 최종 문서 URL | 여러 번의 이동이 끝난 뒤 실제로 표시된 문서 주소입니다. |
개발자 도구로 정확히 확인하는 방법[편집 / 원본 편집]
브라우저 개발자 도구에서 넘겨주기 과정을 확인하려면 다음 순서로 진행하면 됩니다.
- 개발자 도구를 엽니다.
- “네트워크” 또는 “Network” 탭을 엽니다.
- “문서” 또는 “Doc” 요청만 필터링하면 보기 쉽습니다.
- “Preserve log” 또는 “로그 보존” 기능을 켭니다.
- 확인할 넘겨주기 문서 주소로 접속합니다.
- 가장 위의 요청부터 순서대로 Request URL, Status Code, Location 헤더를 확인합니다.
이때 가장 중요한 것은 “어떤 URL에서 어떤 URL로 이동했는가”입니다. 단순히 302가 보였다는 사실만으로는 넘겨주기 문서의 동작을 정확히 설명하기 어렵습니다.
넘겨주기 문서 만드는 방법[편집 / 원본 편집]
넘겨주기 문서는 다음 두 방식 중 하나를 사용하면 됩니다.
REDIRECT 사용[편집 / 원본 편집]
가장 널리 쓰이는 방식은 #REDIRECT입니다.
#REDIRECT [[넘겨줄 대상]]
예시는 다음과 같습니다.
#REDIRECT [[미디어위키]]
넘겨주기 사용[편집 / 원본 편집]
한국어 환경에서는 다음과 같은 형식도 사용할 수 있습니다.
#넘겨주기 [[대상 문서 이름]]
예시는 다음과 같습니다.
#넘겨주기 [[미디어위키]]
문단으로 넘겨주기[편집 / 원본 편집]
문서 전체가 아니라 특정 문단으로 넘겨줄 수도 있습니다.
#REDIRECT [[대상 문서#문단 이름]]
예시는 다음과 같습니다.
#REDIRECT [[HTTP 상태 코드#3xx 리디렉션]]
다만 문단 제목이 나중에 바뀌면 넘겨주기가 의도한 위치로 정확히 이동하지 않을 수 있습니다. 중요한 넘겨주기라면 문단 제목 변경 후에도 함께 점검하는 것이 좋습니다.
이름공간을 포함한 넘겨주기[편집 / 원본 편집]
일반 문서가 아닌 다른 이름공간으로 넘겨줄 수도 있습니다.
#REDIRECT [[도움말:위키 문법]]
#REDIRECT [[분류:미디어위키]]
#REDIRECT [[틀:안내]]
단, 파일, 특수 문서, 다른 위키로의 넘겨주기는 위키 설정에 따라 제한될 수 있습니다.
작성할 때 주의할 점[편집 / 원본 편집]
넘겨주기 명령은 문서의 맨 앞에 있어야 합니다. #REDIRECT 또는 #넘겨주기 앞에 일반 글자, 공백이 아닌 다른 내용, 틀, 분류, HTML 태그 등이 있으면 넘겨주기가 작동하지 않을 수 있습니다.[1]
올바른 예시는 다음과 같습니다.
#REDIRECT [[미디어위키]]
잘못된 예시는 다음과 같습니다.
이 문서는 미디어위키로 넘겨줍니다. #REDIRECT [[미디어위키]]
위와 같이 넘겨주기 명령 앞에 문장이 있으면 넘겨주기가 작동하지 않을 수 있습니다.
분류를 넣어야 한다면 보통 넘겨주기 명령 아래에 넣습니다.
#REDIRECT [[미디어위키]] [[분류:넘겨주기 문서]]
기존 내용이 있는 문서를 넘겨주기로 바꿀 때[편집 / 원본 편집]
기존 문서에 내용이 있는데 넘겨주기 문서로 바꾸면, 사용자는 더 이상 기존 내용을 바로 보지 않고 대상 문서로 이동하게 됩니다.
따라서 기존 문서를 넘겨주기로 바꾸기 전에는 다음을 확인하는 것이 좋습니다.
- 기존 내용이 대상 문서에 이미 포함되어 있는가?
- 기존 문서의 역사를 보존해야 하는가?
- 문서 병합이 필요한가?
- 토론 문서에 관련 논의가 있는가?
- 다른 문서에서 해당 문서를 많이 링크하고 있는가?
- 넘겨주기 처리보다 동음이의어 문서가 더 적절하지 않은가?
특히 내용이 많은 문서를 단순히 넘겨주기로 바꾸면 문서 정보가 사실상 숨겨지는 효과가 생길 수 있으므로 주의해야 합니다.
문서 이동과 자동 넘겨주기[편집 / 원본 편집]
미디어위키에서 문서 제목을 바꾸기 위해 “이동” 기능을 사용하면, 보통 이전 문서명에서 새 문서명으로 가는 넘겨주기 문서가 자동으로 만들어집니다.[1]
예를 들어 A 문서를 B로 이동하면, 기존의 A 문서는 B로 넘겨주는 문서가 됩니다.
다만 일부 권한을 가진 사용자는 이동할 때 넘겨주기를 남기지 않을 수도 있습니다. 미디어위키에서는 suppressredirect 권한을 가진 사용자가 문서를 이동하면서 넘겨주기 생성을 생략할 수 있습니다.[1]
이중 넘겨주기[편집 / 원본 편집]
이중 넘겨주기란 A 문서가 B 문서로 넘겨주고, B 문서가 다시 C 문서로 넘겨주는 상태를 말합니다.
A → B → C
미디어위키에서는 이중 넘겨주기가 문제를 일으킬 수 있습니다. 일반적으로 넘겨주기는 한 단계만 따라가는 것으로 처리되므로, A에서 C까지 자동으로 이어지지 않을 수 있습니다.[1]
올바른 처리 방식은 A를 직접 C로 넘겨주도록 고치는 것입니다.
A → C B → C
이중 넘겨주기는 다음 특수 문서에서 확인할 수 있습니다.
또는 영어 인터페이스에서는 다음 특수 문서로 확인할 수 있습니다.
MediaWiki 1.44부터는 넘겨주기 대상이 다시 넘겨주기 문서인 경우 저장 시 경고가 표시됩니다.[1]
끊긴 넘겨주기[편집 / 원본 편집]
끊긴 넘겨주기란 넘겨주기 대상 문서가 존재하지 않는 상태를 말합니다.
예를 들어 A 문서가 다음과 같이 작성되어 있다고 가정합니다.
#REDIRECT [[존재하지 않는 문서]]
이때 대상 문서가 실제로 존재하지 않으면 넘겨주기가 정상적으로 작동하지 않습니다.
끊긴 넘겨주기는 다음 특수 문서에서 확인할 수 있습니다.
또는 영어 인터페이스에서는 다음 특수 문서로 확인할 수 있습니다.
MediaWiki 1.44부터는 존재하지 않는 문서로 넘겨주기를 저장하려 할 때 경고가 표시됩니다.[1]
넘겨주기 문서를 직접 보는 방법[편집 / 원본 편집]
넘겨주기 문서 자체를 직접 보려면 다음 방법을 사용할 수 있습니다.
첫째, 대상 문서 상단 또는 제목 아래에 표시되는 “넘겨옴” 안내 링크를 클릭합니다.
둘째, 주소 뒤에 다음 매개변수를 붙입니다.
?redirect=no
예시는 다음과 같습니다.
https://www.gaonwiki.com/w/Smc?redirect=no
셋째, 넘겨주기 문서의 편집 링크로 바로 접속합니다.
https://www.gaonwiki.com/w/index.php?title=Smc&action=edit
넘겨주기를 사용하면 좋은 경우[편집 / 원본 편집]
넘겨주기는 다음과 같은 경우에 유용합니다.
- 약어에서 정식 명칭으로 넘겨줄 때
- 영문 표기에서 한글 표기로 넘겨줄 때
- 한글 표기에서 영문 표기로 넘겨줄 때
- 띄어쓰기 차이가 있는 문서를 하나로 모을 때
- 대소문자 차이가 있는 문서를 하나로 모을 때
- 옛 문서명에서 새 문서명으로 안내할 때
- 자주 틀리는 표기에서 올바른 표기로 안내할 때
- 별칭, 통칭, 줄임말을 대표 문서로 연결할 때
- 문서 이동 후 기존 링크를 보존할 때
예시는 다음과 같습니다.
#REDIRECT [[미디어위키]]
#REDIRECT [[HTTP 상태 코드]]
#REDIRECT [[가온 위키]]
넘겨주기보다 다른 방식이 나은 경우[편집 / 원본 편집]
항상 넘겨주기가 정답은 아닙니다. 다음 경우에는 다른 방식이 더 적절할 수 있습니다.
| 상황 | 권장 방식 |
|---|---|
| 같은 이름이 여러 의미를 가질 때 | 동음이의어 문서 작성 |
| 단순 안내만 필요할 때 | 소프트 넘겨주기 또는 안내 틀 사용 |
| 기존 문서 내용이 독립적으로 중요할 때 | 문서 병합 또는 요약 문단 작성 |
| 외부 사이트로 보내야 할 때 | 외부 링크 또는 소프트 넘겨주기 사용 |
| 대상 문서가 아직 없을 때 | 먼저 대상 문서를 만들거나 끊긴 넘겨주기 여부 확인 |
예를 들어 “Apple”이라는 제목이 회사, 과일, 음반사 등 여러 의미를 가질 수 있다면 하나의 문서로 넘겨주기보다 동음이의어 문서를 만드는 편이 더 적절할 수 있습니다.
넘겨주기와 검색[편집 / 원본 편집]
넘겨주기 문서는 검색 편의성을 높이는 데 도움이 됩니다. 사용자가 정확한 문서명을 모르더라도 약어, 별칭, 다른 표기법으로 검색했을 때 대표 문서에 도달할 수 있기 때문입니다.
다만 넘겨주기 문서를 너무 많이 만들면 관리가 어려워질 수 있습니다. 특히 의미가 모호한 넘겨주기, 잘못된 표기, 특정 관점이 반영된 넘겨주기는 문서 품질에 영향을 줄 수 있습니다.
따라서 넘겨주기 문서를 만들 때는 다음 기준을 고려하는 것이 좋습니다.
- 실제로 사용자가 검색할 가능성이 높은 표현인가?
- 대상 문서와 의미가 충분히 일치하는가?
- 다른 의미로 해석될 가능성은 없는가?
- 동음이의어 문서가 더 적절하지 않은가?
- 나중에 일반 문서로 독립할 가능성이 있는가?
넘겨주기와 분류[편집 / 원본 편집]
넘겨주기 문서도 분류에 넣을 수 있습니다. 보통 넘겨주기 명령 아래에 분류를 적습니다.
<nowiki>#REDIRECT [[대상 문서]]
[[분류:넘겨주기 문서]]</nowiki>다만 위키마다 넘겨주기 문서를 분류하는 규칙이 다를 수 있으므로, 해당 위키의 편집 지침을 따르는 것이 좋습니다.
넘겨주기와 틀[편집 / 원본 편집]
틀 문서도 넘겨주기로 만들 수 있습니다. 예를 들어 틀:알림을 틀:안내로 넘겨주면, 기존에 {{알림}}을 사용한 문서가 계속 작동하도록 할 수 있습니다.
<nowiki>#REDIRECT [[틀:안내]]</nowiki>미디어위키에서는 넘겨주기 문서를 틀처럼 끼워 넣을 경우 대상 문서가 대신 포함될 수 있습니다.[1] 이 기능은 틀 이름을 바꾸거나 별칭을 만들 때 유용합니다.
넘겨주기와 링크 표시[편집 / 원본 편집]
미디어위키는 넘겨주기 문서로 향하는 내부 링크에 mw-redirect CSS 클래스를 붙일 수 있습니다.[1] 이를 이용하면 스킨이나 사용자 CSS에서 넘겨주기 링크를 일반 링크와 다르게 표시할 수 있습니다.
예를 들어 넘겨주기 링크를 다른 색으로 표시하도록 사용자 CSS를 설정하면, 문서 정리 작업에서 어떤 링크가 넘겨주기 문서를 가리키는지 더 쉽게 확인할 수 있습니다.
관리자와 개발자를 위한 참고[편집 / 원본 편집]
미디어위키는 넘겨주기 정보를 내부적으로 redirect 테이블에 기록합니다.[2]
개발자 또는 사이트 관리자는 다음 설정과 기능을 참고할 수 있습니다.
| 항목 | 설명 |
|---|---|
$wgDebugRedirects |
실제로 이동하지 않고 이동할 위치를 표시하도록 하는 디버그 설정입니다. |
$wgDisableHardRedirects |
특수 문서나 다른 위키로의 하드 넘겨주기 등을 제한하는 설정입니다. |
$wgInvalidRedirectTargets |
넘겨주기 대상으로 허용하지 않을 대상을 지정하는 설정입니다. |
$wgFixDoubleRedirects |
이중 넘겨주기를 자동으로 수정하는 작업과 관련된 설정입니다. |
**STATICREDIRECT** |
특정 넘겨주기 문서가 자동 이중 넘겨주기 수정 대상이 되지 않도록 할 때 사용하는 매직 워드입니다. |
OutputPage::redirect() |
PHP 코드에서 특정 URL로 HTTP 리디렉션 응답을 보낼 때 사용하는 기능입니다. |
주의할 점은 OutputPage::redirect()의 기본 응답 코드가 302라는 사실과, 일반 문서 넘겨주기의 동작 방식이 반드시 동일한 의미는 아니라는 점입니다.[5]
여담[편집 / 원본 편집]
MediaWiki 1.44부터는 이중 넘겨주기 또는 존재하지 않는 문서로의 넘겨주기를 저장하려 할 때 경고가 표시됩니다.[1]