Extension PageImages

PageImages 확장은 페이지에서 사용되는 이미지에 대한 정보를 수집합니다.

이 확장의 최종 목표는 지면과 연관된 가장 적절한 한 개의 쎔네일을 반환하는 것입니다.

Installation

미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.

미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다:

wfLoadExtension( 'PageImages' );

Special:Version에 접근해서 확장이 정상적으로 설치가 되었는지 확인을 합니다.

Configuration

$wgPageImagesBlacklist는 이미지 블랙리스트 소스의 배열입니다. 차단된 이미지는 페이지 이미지로 선택되지 않습니다. 예제:

$wgPageImagesBlacklist = array(
    // Page on local wiki
    array(
        'type' => 'db',
        'page' => 'MediaWiki:Pageimages-blacklist',
        'db' => false,
    ),
    // Page on Wikimedia Commons, for other Wikimedia projects using direct DB access
    array(
        'type' => 'db',
        'page' => 'MediaWiki:Pageimages-blacklist',
        'db' => 'commonswiki',
    ),
    // Page on Commons, for third-party sites using web access
    array(
        'type' => 'url',
        'url' => 'http://commons.wikimedia.org/w/index.php?title=somepage&action=raw',
    ),
);

동시에 여러 소스를 사용할 수 있습니다.

$wgPageImagesBlacklistExpiry는 블랙리스트가 캐시된 기간(초)을 결정합니다. 기본값: 15 * 60 (15분).

$wgPageImagesExpandOpenSearchXml 만약 true로 설정하면, PageImages가 opensearch API 모듈의 이미지 검색을 덮어쓰고, 좀 더 정확한 결과를 얻습니다. 기본값: false.

$wgPageImagesNamespaces는 PageImages가 활성화될 이름 공간의 배열입니다. 기본값: NS_MAIN.

블랙리스트에는 블랙리스트 파일에 대한 위키 링크가 있어야 하며, 나머지 내용은 관련이 없습니다(그리고 다른 페이지에 대한 링크를 포함할 수 있습니다). 예제:

* [[:File:First blacklisted file.png]]
* [[:File:Second blacklisted file.jpeg]]
...

기억할 것은 이미지가 페이지에 추가되는 결과를 가져오는 파일 링크는 작동하지 않는다느 점입니다(이런 이유로 이러한 파일들이 블랙리스트에 올립니다. 맞아요?); 그래서, 링크 앞에는 :을 넣는 것을 잊지 마십시오.

How it works

페이지가 로컬 이미지와 함께 저장되었을 때, 파서는 ParserMakeImageParams 및 LinksUpdate 후크를 실행합니다.

PageImages 확장은 이러한(및 기타 후크)에 응답하고 page_props 테이블에 페이지에 대한 새로운 속성을 삽입합니다.

속성 이름은 page_image이고, 값은 이미지의 이름입니다.

확장 프로그램은 선택한 이미지 이름만 저장합니다. 다른 기능은 입력하는 동안 Page information, Hovercards 및 모바일 검색과 같은 이미지를 표시할 수 있습니다.

Image choice

How does it select images?

페이지의 모든 이미지가 수집되고, 각 이미지의 점수가 계산됩니다. 가장 높은 점수를 가진 이미지가 페이지 이미지로 선택됩니다. 만약 이미지에 자유롭게 라이선스가 부여되지 않았음을 지정하는 메타 데이터가 이미지에 포함되도록 위키를 구성하면, 자유롭게 라이선스가 부여된 최고 점수의 이미지도 저장됩니다. 만약 적합한 이미지가 없거나 모든 이미지의 점수가 나쁘면(예를 들어, 부정적인 점수가 있는 경우), 페이지는 이미지를 갖지 않을 것입니다.

만약 $wgPageImagesLeadSectionOnly가 true 인 경우에는, 단지 리드 섹션의 이미지만 고려됩니다. 현재 위키피디아 프로젝트에만 해당되며, 다른 모든 프로젝트는 외부에서 이미지를 가져올 수 있습니다.

How are images scored?

위키미디어 위키에서 가능한 가장 좋은 페이지 이미지는 400-600픽셀 사이의 너비/높이와 다른 크기 값의 두 배인 높이/너비가 있는 기사의 처음 네 이미지 중 하나입니다.

• 이 알고리듬은 구성 가능합니다.
• 점수는 다음의 조합으로 계산됩니다:
  • $wgPageImagesScores['width']에 정의된 이미지 너비
    • 위키미디어 위키에서 119픽셀보다 작은 이미지는 매우 부정적으로 가중치가 적용됩니다. 400px-600픽셀 사이의 폭을 가진 이미지가 선호되며 하한을 선호합니다.
    • 갤러리 내부의 이미지는 $wgPageImagesScores['galleryImageWidth']를 사용하여 별도로 채점됩니다.
      • 위키미디어 위키에서는 100보다 작은 갤러리 이미지는 무시됩니다.
  • 문서의 위치도 $wgPageImagesScores['position']에 정의된 것으로 고려됩니다.
    • 위키미디어 위키에서는, 문서에 나타나는 처음 4개의 이미지만 고려됩니다.
  • 이미지의 너비와 높이의 비율은 $wgPageImagesScores['ratio']로 고려됩니다.
    • 위키미디어 위키에서 최상의 이미지는 높이가 너비의 절반이거나 높이가 너비의 두 배인 이미지입니다. 비율이 0.5미만인 이미지는 부정적으로 점수가 매겨지며 버려집니다.

Be more technical please...

Pageimages는 LinksUpdate 후크가 실행될 때마다 이미지를 채웁니다.

PageImages에서 이것은 LinksUpdateHookHandler::doLinksUpdate에서 실행됩니다.

Can I exclude certain page images?

그렇습니다! 관리자가 편집할 수 있는 모든 위키에는 MediaWiki:Pageimages-blacklist(예제)라는 블랙리스트가 있습니다. 여기에 표시되는 이미지는 기사의 페이지 이미지로 나타나지는 않을 것입니다.

What about just for one particular article?

안타깝게도 현재 시간까지는 특별한 방법이 없습니다. 블랙리스트를 사용하거나 또는 리드 섹션 외부로 이미지를 이동하십시오.

How can I see the page image for a page?

사이드 바에 있는 Page information 링크(또는 ?action=info를 URL에 추가)를 사용하면, 현재 이미지 선택을 볼 수 있습니다.

How can I purge a bad image?

Pageimage는 오직 기사의 링크가 변경될 때만 변경됩니다. 비상 사태의 경우에는, 페이지에서 링크를 추가/제거하고, 만약 필요하다면 되돌리십시오. Purging은 작동하지 않습니다. 막대한 긴급 상황이 발생하면 Phabricator 티켓을 제출하십시오.

See also

• Popups 확장