Jump to content

Manual:확장 기능

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 80% complete.
Outdated translations are marked like this.

확장 기능을 사용하면 미디어위키의 모양과 작동 방식을 사용자 지정할 수 있습니다.

일부 확장 기능이 미디어위키 개발자들에 의해 유지보수되고 있으나 그 밖의 확장 기능들은 타사 개발자에 의해 작성되었습니다. 그러므로 다수 확장 기능에 버그가 있으며 이 모두가 서로 호환을 보장하지는 않습니다. 일부는 유지 보수되지 않은 채로 남아있습니다. 즉, 모든 확장 기능이 모든 미디어위키 버전에서 동작하는 것은 아닙니다. 확장 기능을 사용할 때, 특히 "안전하지 않음"으로 태그된 확장 기능을 사용하는 것은 본인이 위험을 각오해야 합니다. 코어 소프트웨어의 패치가 필요한 확장 기능을 사용하고 있다면 반드시 데이터베이스를 백업해 두십시오. 위키를 망가트리는 위험을 막는데 도움이 됩니다.

확장 기능의 종류

파서 태그

파서 태그는 단순한 문자열 처리라든지 온전한 기능의 정보 검색과 같이, 내장 위키 마크업을 추가 기능과 더불어 확장합니다.

파서 함수

파서 함수는 문서 내의 다른 위키 요소와 '상호 작용'할 수 있는 특수한 위키 마크업 문법이며 특정한 출력을 제공합니다.

훅은 일부 정의된 이벤트가 발생할 때(예: 문서 저장 또는 사용자 로그인) 사용자 지정 코드가 실행될 수 있게 합니다.

특수 문서

특수 문서는 특정한 기능을 수행하기 위해 요청하는 즉시 소프트웨어가 만드는 문서입니다.

스킨

스킨은 사용자가 미디어위키의 모습과 레이아웃을 바꿀 수 있게 합니다.

특수 명령

Magic words 는 변칙적인 위키 문자열을 함수에 연관되어 하나의 ID 로 매핑하는 테크닉입니다.

API

미디어위키는 인증, 문서 운영, 검색 등의 위키 기능에 접근을 허용하는 action API 를 제공합니다.

문서 콘텐츠 모델

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.

인증

미디어위키는 사용자지정 인증 매커니즘의 보안을 향상시키는 인증 연관 프레임워크인 SessionManager 와 AuthManager 를 제공합니다.

Finding extensions

확장기능 찾기

카테고리 별 확장기능 이나 Extension Matrix에서 이미 작성된 확장 기능을 찾을 수 있습니다. For information on installing these extensions or writing your own, see below.

설치된 확장기능 보기

Only someone with administration access to the filesystem (and often the database too) on a server can install extensions for MediaWiki, but anyone can check which extensions are active on an instance of MediaWiki by accessing the Special:Version page. 예를 들어 이 확장 기능들은 영어 위키백과에서 사용 중입니다.

자주 사용되는 확장 기능

자주 사용되는 확장 기능을 찾는 방법에는 여러 가지가 있습니다.

The first set is those that are bundled with MediaWiki (a list that is reviewed regularly, and to which anyone can suggest an addition).

ExtensionDistributor 메커니즘을 통해 미디어위키에서 다운로드한 확장 기능은 몇 가지 통계가 수집됩니다. 가장 많이 다운로드된 상위 15개 확장 기능은 Special:ExtensionDistributor에 나와 있으며 해당 확장 기능은 정보상자에 다운로드 수가 표시됩니다. 이 수치는 Git 또는 Composer를 통해 확장 기능을 설치하는 다른 방법을 고려하지 않은 것입니다.

세 번째 방법은 해당 확장 기능이 설치된 WikiApiary 의 위키 수를 살펴보는 것입니다. 이는 단순히 다운로드가 아닌 실제 설치를 보여주는 장점이 있지만 (위키의 API를 쿼리하는 방식), 완전히 최신이 아니라는 단점도 있습니다. (2023년 기준) 또한 비공개 위키에서 설치한 것은 포함되지 않습니다.


확장기능 설치

For further guidance, see also Manual:Extensions/Installation and upgrade

미디어위키는 설치 직후에 확장 기능을 사용할 준비가 됩니다. 확장 기능을 설치하려면 다음 절차들을 거치십시오:

  1. 시작하기 전에
    수많은 확장 기능들은 유닉스 명령어를 이용하여 설치하도록 구성된 지침을 제공합니다. 명령어들을 실행하기 위해서는 셸 접근 권한 (SSH)이 필요합니다.
  2. 확장 기능을 다운로드합니다.
    확장 기능 배포자는 유명한 확장기능들 대부분을 선택, 다운로드할 수 있게 도와줍니다.
    확장 기능들은 보통 모듈식 패키지로 배포됩니다. 그것들은 일반적으로 $IP /extensions/의 하위 디렉토리에 있습니다. 위키미디어 Git 저장소에 저장된 확장 기능의 목록은 git:mediawiki/extensions에 위치해 있습니다. 일부 확장 기능은 버전 관리를 사용하지 않으므로 권장되지 않습니다.
    Some extensions are also available in bundles, composer or package repositories.
    It's recommended to read the README file before installation. It usually contains important info about configuration.
  3. 당신의 확장기능을 설치합니다.
    LocalSettings.php 파일의 끝에 다음을 추가하십시오:
    wfLoadExtension( 'ExtensionName' );
    
    This line forces the PHP interpreter to read the extension file, and thereby make it accessible to MediaWiki.
    Some extensions can conflict with maintenance scripts, for example if they directly access $_SERVER (not recommended).
    In this case they can be wrapped in the conditional so maintenance scripts can still run.
    if ( !$wgCommandLineMode ) {
       wfLoadExtension ( 'ExtensionName' );
    }
    
    The maintenance script importDump.php will fail for any extension which requires customised namespaces which is included inside the conditional above such as Extension:Semantic MediaWiki , Extension:Page Forms .
필요한 권한이 확장기능에 적용 되어 있는지 반드시 확인 하십시오.
이 설치 방법이 대부분의 확장기능에는 적용 되지만 , 일부는 다른 설치 방법이 필요합니다. 자세한 내용은 확장기능의 설명을 확인 하세요.
If you want to alter configuration variables in LocalSettings.php, you have to do this typically after including the extension. Otherwise defaults defined in the extension will overwrite your settings.

확장기능 업그레이드

일부 확장 기능은 다른 사람이 여러 버전을 사용하여 작업하는 경우 미디어위키가 업데이트될 때마다 업데이트해야 합니다. 확장기능을 새 버전으로 업그레이드시키기:

  1. 새 버전의 확장기능을 설치합니다.
  2. extensions/ExtensionName 디렉터리에 있는 모든 확장 기능 파일을 새 파일로 교체합니다. LocalSettings.php에 존재하는 확장 기능 구성을 제거하지 마십시오.
  3. 확장 기능으로 인해 미디어위키 데이터베이스를 변경해야 하는 경우 update.php 유지 관리 스크립트를 실행해야 합니다. 대부분의 확장 기능들은 이 스크립트 실행 여부를 나타냅니다. (스크립트를 실행하기 전에 당신의 데이터를 백업하십시오) If you don't have command line access, you can also use the web updater.
아 명령은 99%의 확장 기능을 포함합니다. If the specific extension you are upgrading has instructions that differ from these, you should probably follow the specific extension's instructions

확장기능 제거

확장 기능을 제거하려면 확장 기능 이름이 있는 줄을 LocalSettings.php에서 제거하면 됩니다:

wfLoadExtension( 'ExtensionName' );
  • 확장 기능의 구성에 관한 줄은 모두 제거해야 합니다.

같이 보기