Manual:확장기능

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Extensions and the translation is 76% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎čeština • ‎Ελληνικά • ‎български • ‎мокшень • ‎русский • ‎العربية • ‎سنڌي • ‎پښتو • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
OOjs UI icon puzzle-ltr.svg 확장: 개발 태그 확장기능 파서 함수 Hooks 특수 문서 스킨 Magic words API Content models

확장기능은 미디어위키에서 부족한 기능이나 모양을 추가해 줍니다

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

확장 기능의 종류

OOjs UI icon markup.svg 파서 태그

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


파서 태그에 관해 더 알아보기

OOjs UI icon code.svg 파서 함수

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


파서 함수에 관해 더 알아보기

Plug-in Noun project 4032.svg

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


에 관해 더 알아보기

OOjs UI icon pageSettings.svg 특수 문서

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


특수 문서에 관해 더 알아보기

OOjs UI icon browser-ltr.svg 스킨

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


스킨에 관해 더 알아보기

OOjs UI icon quotes-ltr.svg 특수 명령

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.


특수 명령에 관해 더 알아보기

API - The Noun Project.svg API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.


미디어위키 API에 관해 더 알아보기

OOjs UI icon article-ltr.svg 문서 콘텐츠 모델

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.


콘텐츠 모델에 관해 더 알아보기

OOjs UI icon lock.svg 인증

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.


인증에 관해 더 알아보기

확장기능 찾기

카테고리 별 확장기능 이나 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. 예를 들어 이 확장 기능들은 영어 위키백과에서 사용 중입니다.

확장기능 설치

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

  1. 시작하기 전에
    수많은 확장 기능들은 유닉스 명령어를 이용하여 설치하도록 구성된 지침을 제공합니다. 명령어들을 실행하기 위해서는 셸 접근 권한 (SSH)이 필요합니다.
  2. 확장 기능을 다운로드합니다.
    확장 기능 배포자는 유명한 확장기능들 대부분을 선택, 다운로드할 수 있게 도와줍니다.
    확장 기능들은 보통 모듈식 패키지로 배포됩니다. 그것들은 일반적으로 $IP /extensions/의 하위 디렉토리에 있습니다. 위키미디어 Git 저장소에 저장된 확장 기능의 목록은 git:mediawiki/extensions에 위치해 있습니다. 일부 확장 기능은 버전 관리를 사용하지 않으므로 권장되지 않습니다.
    Some extensions are also available in bundles, composer or package repositories.
  3. 당신의 확장기능을 설치합니다..
    At the end of the LocalSettings.php file, add:
    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 customized namespaces which is included inside the conditional above such as Extension:Semantic MediaWiki , Extension:Semantic 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. extension/ExtensionName 디렉터리의 모든 확장 기능 파일을 새로운 파일로 교체합니다. LocalSettings.php에 존재하는 확장 기능 구성을 제거하지 마십시오.
  3. If the extension requires changes to the MediaWiki database, you will need to run the Update.php maintenance script. Most extensions will mention if this script needs to be run or not. (Perform backup of your data before executing the script). If you don't have command line access, you can also use the web updater.
These instructions cover 99% of extensions. 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' );
  • 확장 기능의 구성에 관한 줄은 모두 제거해야 합니다.
  • 확장 기능이 데이터베이스 변경을 제공하는 경우 이것들을 제거하기 위해 update.php 을 실행해야 합니다.

같이 보기

확장 : 분류 All 요청태그 확장기능 확장기능에 대한 자주 묻는 질문 Extension hook registryExtension default namespaces