미디어위키/미디어위키 설치 및 관리

미디어위키(Mediawiki) 1.31.1 소도구 03 - 다수 소스 코드 문서 소도구

씨실과 날실 2019. 1. 13. 13:10

미디어위키 소도구는 소스코드 1개 문서만 필요한 소도구가 있는가 하면 2개 이상의 다수 소스코드 문서가 필요한 소도구도 있습니다.

소스코드 문서가 한 개만 필요하든 두 개 이상 필요하든 위키백과의 소도구를 복사해 사용할 요량이면 아래의 이전글을 참고해 소스코드 문서를 작성해주면 소도구를 사용할 수 있습니다.

그러나 소스코드 문서가 여러 개인 경우, 그것을 일일이 위키백과에서 복사해 붙이는 방식으로 작성하는 것은 여간 귀찮은 것이 아닙니다.

미디어위키는 다른 위키에서 여러 문서들을 하나의 파일로 내보내 자신의 위키로 한번에 가져올 수 있습니다. 이번에는 이 방법을 소개하겠습니다.

위키 검색창에서 특수:소도구로 들어갑니다.

그러면 위와 같은 그림을 볼 수 있습니다. 일단 지난 글에서 위키백과에서 소스코드를 복사해 붙여 만든 소도구 문서 Gadget-searchFocus.js가 보입니다. 존재한 문서이기 때문에 색깔이 빠라간색이 아닌 다른 색입니다. 반대로 글자색이 빨간색인 문서는 위키에 존재하지 않는 깨진 링크 문서입니다.

위키의 문서 내보내기/가져오기 기능으로 다수의 문서를 한번에 입력하는 방식을 보여드리겠습니다. 예로 보여드릴 소도구 문서는 Gadget-ReferenceTooltips-ko.js, Gadget-ReferenceTooltips.css 입니다.


위키백과에 접속해 특수:소도구로 들어갑니다.

위 링크를 클릭하여 접속할 수도 있습니다.


Gadget-ReferenceTooltips-ko.js, Gadget-ReferenceTooltips.css 문서가 사용되는 소도구는 각주 말풍선입니다. 해당 소도구 내보내기 링크를 클릭해줍니다.

위와 같은 화면이 나옵니다. 다운로드 버튼을 눌러줍니다.

위 그림처럼 다운로드 창이 나타나는데요. 파일저장 항목에 체크되어 있는지 확인하고 하단의 화기인 버튼을 눌러줍니다.

그러면 파일 이름과 다운로드 장소를 정하는 창이 나올 겁니다. 파일 이름을 자신이 알아보기 편하게 적당한 이름으로 수정하고 저장할 폴더를 정한 후 저장해줍니다.

이때 저장되는 파일의 화장자명은 xml입니다.

이제 다시 자신의 위키로 돌아와 위키 왼쪽에 특수 문서 목록 링크를 누르거나, 위키 검색창에 특수:특수문서를 입력해 특수 문서 목록 화면으로 들어갑니다. 물론 로그인 상태여야 합니다.

그러면 해당 페이지 하단에 문서 도구용 특수 문서들을 볼 수 있습니다. 그 중에 굵은 글씨로 문서 가져오기 링크가 보입니다. 문서 가져오기를 포함하여 다른 특수 문서보다 굵은 글씨로 써진 특수 문서들은 위키 관리자 등 권한을 가진 자가 로그인 한 상태에만 사용할 수 있는 메뉴입니다.

문서 가져오기 링크를 눌러줍니다.

위와 같은 화면이 나오는데요. 이 기능을 사용하기 위해서는 위키의 인터위키 기능 설정을 해주어야 합니다. 인터위키 기능 설정은 아래 링크를 참고하시기 바랍니다.

찾아보기 버튼을 눌러 아까 저장한 xml 파일을 등록합니다.

지난 인터위키 설정 게시물을 참고하여 새로 추가한 위키백과 인터위키 접두어를 입력해줍니다.

기본위치로 들여오기 항목에 체크하지 말고, 이름공간으로 들여오기 - 미디어위키로 설정해줍니다. 소도구 소스코드 문서는 미디어위키라는 이름공간(namespace)에 위치해야 합니다.

이제 파일 올리기 버튼을 눌러줍니다.

그럼 위와 같은 화면이 나오게 됩니다. 이제 다시 특수:소도구로 들어가봅시다.

위와 같은 화면이 나옵니다. 지난번 특수:소도구 화면과 달라진 부분을 확인하실 수 있습니다.

먼저 Gadget-ReferenceTooltips-ko.js, Gadget-ReferenceTooltips.css 소스코드를 사용하는 소도구의 설명이 보다 자세하게 바뀌고, 해당 소스코드 문서 글자색이 파란색으로 바뀌었습니다.

두 번째로 특수:소도구 문서 내용이 섹션별로 분류되었습니다. 이것은 미디어위키:Gadgets-definition 문서의 내용이 적용된 것입니다.

이제 나머지 소도구의 소스코드 문서들도

위 글을 참고하여 작성하거나, 지금 보고 계시는 이 글을 참고하여 위키백과에서 해당 소도구 문서들을 가져오시면 됩니다.

그러나 이 작업들이 끝난 이후에도 특수:소도구 문서의 수정 내용이 남아 있습니다. 해당 내용은 다음 연재글을 통해 알려드리도록 하겠습니다.