Extension:RevisionSlider/ko

미디어위키 확장 기능 설명서

RevisionSlider 출시 상태: 안정
구현	사용자 인터페이스
설명	판의 바뀜을 쉽게 비교할 수 있게 하는 슬라이더 인터페이스.
만든 이	독일어 위키미디어 (WMDE)
호환성 정책	스냅샷은 미디어위키와 함께 릴리스됩니다. Master is not backward compatible.
MediaWiki	1.25+
데이터베이스 변경	아니오
사용된 훅 DifferenceEngineViewHeader GetPreferences
Licence	GNU General Public License 2.0 or later
다운로드	확장 기능 다운로드 Git [?]: 저장소 보기 (GitHub) Gerrit 코드 리뷰 Git 커밋 기록 Download source tarball
RevisionSlider 확장 기능 번역 (translatewiki.net에서 가능한 경우)
이슈	미해결 작업 · 버그 보고

판 슬라이더(RevisionSlider)는 문서의 바뀜을 쉽게 비교할 수 있게 하는 슬라이더 인터페이스를 추가시키는 확장기능입니다.

설치

• 파일을 다운로드하고 RevisionSlider 폴더를 extensions/ 디렉토리에 넣어 주세요.
  개발자와 코딩 기여자는 Git을 이용해 확장기능을 다운받는 것이 좋습니다.

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
  

• 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.

  wfLoadExtension( 'RevisionSlider' );
  

• 완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

사용법

	다른 문서로 이동할 때 슬라이더는 기본적으로 접혀 있으며 문서 상단에 "탐색 역사"이라는 레이블이 있는 좁은 막대만 표시됩니다. 이 막대를 클릭하면 RevisionSlider가 펼쳐집니다.
	Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.
	각각의 막대는 페이지의 바뀜을 나타냅니다. 막대는 페이지 내용의 추가・감소를 나타냅니다. 1 막대는 추가된 내용을, 2 막대는 삭제된 내용을 보여줍니다.
	비교할 수정 판을 선택하려면 노란색과 파란색 손잡이를 사용하세요. 파란색 손잡이는 좀 더 최근의 판을, 노란색 손잡이는 좀 더 오래된 판을 제어합니다. 여러가지 방법이 있습니다. 슬라이더에 원하는 위치로 버튼을 끌고 내려 놓을 수 있습니다. 슬라이더 라인에서 원하는 위치에 클릭할 수 있습니다. 최신판을 선택하려면 파란색 선을 클릭하고 오래된 판을 선택하기 위해서는 노란색 선을 클릭하세오. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow. You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line. If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.
	앞 뒤 화살표를 사용하여 더 오래되었거나 새로운 역사를 볼 수 있습니다.

Opt-out

If you are not using the RevisionSlider at all and also don't want to see the collapsed RevisionSlider bar at the top of the diff page, you can opt-out by checking 판 슬라이더를 보지 않기 in your preferences under 외관 → 차이.

Technical Background

자바스크립트 훅

RevisionSlider는 새 수정 사항이 선택될 때 AJAX를 사용하여 차이 문서를 다시 로드합니다. 문서가 다시 로드되면 wikipage.content 및 wikipage.diff 훅이 모두 실행됩니다. 사용자 정의 자바스크립트 또는 확장 기능 자바스크립트가 차이 문서에서 작업을 수행하는 경우 이러한 훅을 수신해야 할 수 있습니다.

예시

• The Thanks extension: phab:rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• The English Wikipedia wikEdDiff gadget: https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

API calls & fetching data

Unless expanded, the tool is not doing any API calls. Only when the user expands the slider, it fetches data about revisions (revision-id, timestamp, user, comment, size and flags). The tool only fetches data for revisions that are currently visible on the screen (maximum 500 revisions) and data about additional revisions is only loaded when the user navigates back or forth on the timeline using the arrows.

배경

The RevisionSlider is a feature to fulfill one of the top wishes of the German Community wishlist and is developed by WMDE's TCB team. It is inspired by DerHexer's revisionjumper gadget and based on a prototype by the WMF Community Tech team.

Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.