사이드바 편집
탐색 사이드바는 MediaWiki에서와 같은 방식으로, MediaWiki:Sidebar 시스템 메시지를 통해 설정합니다. 소스 디렉터리에 다른 문서들과 나란히 MediaWiki/Sidebar.wikitext 파일을 만드세요.
최상위 * 줄은 각각 제목이고, 그 아래 ** 줄은 각각 page|label 형식으로 쓴 링크입니다. 제목과 라벨은 먼저 시스템 메시지로 조회되고, 그런 메시지가 없을 때만 적힌 글자를 그대로 씁니다(그래서 mainpage와 mainpage-description은 대문서와 그 라벨로 해석됩니다). 라벨을 번역할 수 있게 해 주는 것이 바로 메시지이므로, 여러분의 것도 메시지 이름으로 쓰세요. 소스 언어의 문구는 MediaWiki/Sidebar-docs.wikitext에, 각 언어의 번역은 MediaWiki/Sidebar-docs/<언어>.wikitext에 다른 문서들과 나란히 둡니다. 번역되는 다른 문서의 이름 규칙과 같습니다. 그러면 사이드바는 다음과 같은 모양이 됩니다:
* navigation
** mainpage|mainpage-description
* sidebar-docs
** Getting Started|sidebar-getting-started
** Images|sidebar-images
* sidebar-references
** Configuration|sidebar-configuration
대상도 라벨과 마찬가지로 문서 이름으로 읽히기 전에 먼저 메시지로 조회되며, 그 메시지가 -이면 MediaWiki가 그 항목을 사이드바에서 뺍니다. 자기 기본 항목을 끄는 방식이 그것입니다. 그래서 그런 메시지와 이름이 겹치는 대상은 아무 말 없이 사이드바에서 사라집니다. 알아 둘 것은 업로드 양식의 라이선스 선택 목록인 licenses로, MediaWiki가 이를 -로 정의해 두었습니다. Licenses라는 문서를 대상에 그대로 쓰면 그 항목이 빠지는 이유입니다. 앞에 콜론을 붙여 :Licenses로 쓰면 문서 자체를 가리키며 메시지 조회를 건너뜁니다. 아래의 Special:MyLanguage/ 접두사도 같은 일을 하며, 그래서 그 아래 예시에는 콜론이 없습니다.
번역된 사이트에서 링크하기
대상은 문서 하나를 가리키므로, 항목은 언제나 그 문서로만 이어집니다. 번역된 문서를 읽던 독자도 사이드바를 누르면 원문 언어로 돌아가게 됩니다. MediaWiki의 위키들이 쓰는 것과 같은 표기인 Special:MyLanguage/문서로 대상을 쓰면, 빌드가 문서마다 이를 풀어 줍니다. 어떤 언어의 문서에서는 그 언어의 번역으로 이어지고, 그 언어의 번역이 없으면 원문 문서로 이어집니다. 또 이 접두사는 대상이 위의 메시지 조회를 거치지 않게 하므로, 여기서는 Licenses에 콜론을 붙이지 않아도 됩니다:
* navigation
** mainpage|mainpage-description
* sidebar-docs
** Special:MyLanguage/Getting Started|sidebar-getting-started
** Special:MyLanguage/Images|sidebar-images
* sidebar-references
** Special:MyLanguage/Licenses|sidebar-licenses
표기는 위키의 것이지만 그 뒤의 규칙은 아닙니다. 위키에서는 그 특수문서가 요청 시점에 독자의 인터페이스 언어로 넘겨 주며 링크가 어느 문서에 있었는지는 보지 않으므로, 한 문서를 보는 두 독자가 같은 항목을 눌러도 서로 다른 번역으로 갑니다. 정적 내보내기에는 요청도, 물어볼 독자도 없으므로, 빌드가 각 링크를 그것이 놓인 문서의 언어로 한 번 정해 두며, 그 문서를 보는 독자는 누구나 같은 곳으로 갑니다.
대문 항목은 mainpage 그대로 둡니다. 그 대상은 문서 이름이 아니라 메시지이므로, 접두사는 메시지 쪽에 넣습니다. 메타위키가 그러하듯 MediaWiki/Mainpage.wikitext에 Special:MyLanguage/index라고 쓰면 됩니다(index는 WikvenMainPage가 가리키는 이름입니다). 모든 스킨이 로고를 같은 메시지에 걸어 두므로, 로고도 독자의 언어를 따라갑니다. 대가는 위키가 그 문서를 더 이상 대문으로 인식하지 않는다는 점입니다. 브라우저 탭에 문서 제목이 나오고, MinervaNeue는 대문 전용 스타일을 넣지 않습니다.
제거되는 것
일부 기본 사이드바 블록은 실제로 구동 중인 위키가 있어야 하므로, Wikven은 이를 정적 내보내기에서 뺍니다. 바로 도구모음(여기를 가리키는 문서, 특수 문서, 인쇄용 판 등)과 검색 상자입니다. MediaWiki:Sidebar에서 정의한 탐색 블록은 쓴 그대로 유지됩니다.
지금 보고 있는 문서
지금 읽고 있는 문서의 항목에는 아무 표시도 붙지 않습니다. 독자가 이미 있는 곳으로 이어지는 평범한 링크로 남습니다. 이는 내보내기가 바꾸는 것이 아니라 MediaWiki 본래의 동작입니다. 사이드바 항목은 모두 활성 플래그가 거짓인 채로 만들어지고 이를 바꾸는 곳이 없으므로, 사이드바는 항목과 그 항목이 놓인 문서를 견주어 보는 일이 없습니다. 문서 위의 탭들은 그 비교를 하는데, 사이드바만 건너뜁니다. 대상을 Special:MyLanguage/문서로 쓰더라도 이 점은 달라지지 않습니다.
표시하고 싶은 사이트는 자체 자바스크립트로 할 수 있습니다. 독자의 브라우저는 자기가 어느 문서에 있는지 알고 있으니까요. 지금 읽고 있는 문서로 풀리는 사이드바 링크마다 href를 없애고 aria-current="page"를 붙이면 됩니다. href가 없는 링크는 더 이상 링크가 아니어서 누를 수도 초점을 받을 수도 없고, 링크 색도 알아서 잃습니다. 그리고 aria-current는 화면을 보지 않는 독자에게 어느 항목인지 알려 줍니다. 이 사이트는 MediaWiki:Gadget-SidebarCurrentPage.js 가젯으로 그렇게 하고 있습니다.