Help:Magic words/ko

매직 워드(Magic words) 또는 특수 명령문은 미디어위키에서 시간, 사이트의 정보 혹은 문서의 이름 등 정해진 값, 문자열 혹은 함수를 출력하는데 사용하는 문자열입니다. 이 문서는 미디어위키에서 기본적으로 제공하는 특수 명령문에 대해서만 설명하고 있습니다. 기술적인 참고 사항에 대해서는 를 보시기 바랍니다.

특수 명령문에는 크게 세 가지 종류가 있습니다.


 * 작동 스위치: 두 개의 밑줄표로 둘러싸이고 대문자로 된 문자열을 가지는 경우가 보통입니다. 예시:  
 * 변수: 두 개의 중괄호로 둘러싸이고 대문자로 된 문자열을 가집니다. 예시:  . 보시다시피, 틀을 사용하는 것과 매우 닮았습니다.
 * 파서 함수: 파라미터가 주어집니다. 또한  나  의 형태를 가집니다. 예시: ., 도 같이 참고해 보세요.

변수와 파서 함수는 틀과 마찬가지로 "풀기:" 혹은 "subst:"를 이용해서 풀어쓴 형태로 나타낼 수도 있습니다. 문서에 의존적인 특수 명령어들은(예시:PAGEID 등)은 명령어들이 본문이 아닌 문서에 인용된 틀이나 시스템 메시지를 통해서 삽입되었을지라도 "현재 문서"에 관련된 값을 출력합니다.



작동 스위치
작동 스위치는 (스킨이 지원하는 경우) 문서의 레이아웃이나 작동을 제어하고 내용을 원하는 대로 넣거나 빼는 데 사용할 수 있습니다. 특히 아래의 것들 중 일부는 미네르바 노이에 스킨에서 지원하지 않습니다.

변수
변수는 현재의 문서와 위키, 날짜의 정보를 표시합니다. 변수의 사용은 틀과 비슷합니다. " [과부하] "표시가 있는 변수(의 사용)는 소프트웨어가 추적하며 문서 내에서 사용할 수 있는 횟수에는 제한이 있습니다.

틀과 변수의 이름이 같을 경우에는 변수가 사용됩니다(불러들일 틀인    :PAGENAME에 $codePAGENAME$code-end 를 기입할 필요가 있습니다). 경우에 따라서는 매개변수 추가로 틀을 호출하기 위해서 파서가 강제됩니다. 예를 들면, $tpl-currentdayname-code 는 변수가 아닌 $tpl-currentdayname-result 를 불러들입니다. In some cases, adding parameters will force the parser to invoke a template; for example,  transcludes     :CURRENTDAYNAME, not the variable.



날짜 및 시간
다음 변수는 현재 날짜와 시간을 UTC로 반환합니다.

미디어위키 및 브라우저 캐싱으로 인해서 이들의 변수는 현재의 날짜가 아닌 문서가 캐싱된 날짜와 시간을 표시합니다.

이들의 변수를 사용하면 문서가 보다 제한된 초 사이가 캐싱됩니다. 이는 MagicWordFactory에서 구성됩니다.

날짜와 시간의 특수 명령문은 위키 컨텐츠의 언어의 포맷으로 표시됩니다. 이후로는 문서 컨텐츠의 언어에 의존합니다.

아래의 변수는 위와 같이 실행하지는 않지만 사이트 서버 설정이나 의 값을 사용합니다.



보다 자세한 시각을 포맷, 또는 현재의 연도와 주를 ISO-8601로 확실히 준거하여서 출력시키려면 를 설치해서  의 파서 함수를 사용해서 사용할 수 있습니다.



통계
Numbers returned by these variables normally contain separators (commas, dots or spaces, depending on the local language) but can return raw numbers with the ":R" flag (for example,  &rarr;  and   &rarr; ).

Use "|R" for magic words that require a parameter like PAGESINCATEGORY (for example  and , or   and  ). Also applicable to hereinbefore.

The number magic words are formatted in the wiki content language. Since, it depends on the page content language.



문서 제목
None of these are affected by changes to the display title using ; the values returned are the original page title.

The  and   magic words only work in namespaces that have subpages enabled. See for information on enabling subpages.

As of 1.15+, these can all take a parameter, allowing specification of the page to be operated on, instead of just the current page:





URL 인코드된 페이지 이름
The following are equivalents encoded for use in MediaWiki URLs (i.e. spaces replaced with underscores and some characters HTML escaped using numeric character encoding):



Note that,   and   have distinct implementations. See for details.

이름공간
The following are equivalents encoded for use in MediaWiki URLs (spaces replaced with underscores and some characters percent-encoded):



As of 1.15+, these can take a full-page-name parameter and will return the requested namespace associated with that page, instead of with the current page:

Parameter must not be a namespace name:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

기타


파서 함수
Parser functions are very similar to variables but take one or more parameters (technically, any magic word that takes a parameter is a parser function), and the name is sometimes prefixed with a hash to distinguish them from templates.

This page only describes parser functions that are integral to the MediaWiki software. Other parser functions may be added by MediaWiki extensions such as the. For those see.



다른 문서의 기술적인 메타데이터


이름공간
returns the current localized name for the namespace with that index, canonical name, or local alias. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.

Don't confuse localised namespaces with custom namespaces.

형식
같이 보기:.

지역화
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular #Date and time, #Formatting, #Miscellaneous. More magic words are added by the.

The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.

Transclusion modifiers
usually transcludes another page, by default from the Template:namespace. These magic words modify that behavior.

잡다한 것들
For parser function #invoke, see w:Wikipedia:Lua.