도움말:마법의 단어
마법의 단어 ( 파서 기능 , 변수 및 동작 스위치 포함 )는 Wikipedia의 기본 MediaWiki 소프트웨어에 지침을 제공 하는 Wiki 마크업의 기능입니다 . 예를 들어, 마법의 단어는 목차를 억제하거나 배치하고, 외부 검색 엔진에 의한 인덱싱을 비활성화하고, 현재 페이지 또는 사용자 정의 조건부 논리를 기반으로 동적으로 출력을 생성할 수 있습니다. 이러한 기능 중 일부는 템플릿에 특히 유용합니다 .
이 페이지는 마법의 단어에 대한 빠른 참조입니다. 자세한 내용은 주요 MediaWiki 문서를 참조하십시오.
- mw:Help:Magic words : "표준" 파서 기능을 포함한 모든 표준 매직 워드.
- mw:Help:Extension:ParserFunctions : 조건식을 포함한 추가 파서 기능.
일반 정보
일반적으로 마법의 단어에는 세 가지 유형이 있습니다.
- 동작 스위치 : 종종 이중 밑줄로 표시되며 모두 대문자입니다(예:
__NOTOC__
. 값을 반환하는 대신 페이지의 동작을 변경합니다. - 파서 기능 : 모두 소문자입니다. 파서 함수 뒤에는 콜론과 파이프로 구분된 매개변수가 옵니다(예:
{{#ifexpr:Y|Yes|No}}
이중 중괄호로 묶인 ). 그들은 값을 가져 와서 값을 반환합니다. - 변수 : 모두 대문자입니다(예:
{{PAGENAME}}
. 변수는 이중 중괄호로 묶이고 그 자리에 값을 반환합니다.
소프트웨어는 일반적으로 다음과 같은 방식으로 마법의 단어를 해석합니다.
- 마법의 단어는 대소문자를 구분 합니다.
- 가독성을 위해 공백 을 넉넉히 허용합니다. 키워드 및 매개변수의 시작과 끝에서 제거됩니다(템플릿 내에서도 수행됨).
- "현재 페이지에 대한" 변수도 포함 할 수 있습니다 . 이것은 구문 분석 순서에 의해 보장됩니다.
- 마술처럼 HTML 명령어로 변환하는 대신 태그는 이 마술을 제거하여 마술 단어 자체가 표시(문서화)될 수 있도록 합니다(예: 또는 .
<nowiki>
<nowiki>{{#magic:}}</nowiki>
{{#magic:<nowiki />}}
템플릿과 비교한 마법의 단어:
- 템플릿과 마찬가지로, 마법의 단어 수 의 매개자 및 교체 .
- 마법 단어의 이름은 템플릿 이름과 달리 의도적으로 선택되며 그 반대의 경우도 마찬가지입니다. 많은 파서 함수 이름은
#
( 파운드 또는 해시 )로 시작#
하지만 템플릿 이름 은 a 로 시작 하지 않으며 아마도:
(콜론)으로 끝나지 않거나 모두 대문자일 것입니다. - 첫 번째 매개변수의 구문이 다릅니다. 에서
{{#magic: p1 | p2 | p3}}
, 이름은#magic
과는 unspaced 뒤에:
, 그리고 필요한 입력 파라미터p1
. 주형으로p1
선택적이며 그것은 앞에는|
대신의 (파이프):
예{{template|p1}}
.
동작 스위치
스위치 | 설명 |
---|---|
__TOC__ | 페이지의 목차(TOC) 를 단어 위치에 배치합니다. |
__FORCETOC__ | TOC가 기본 위치에 나타나도록 합니다. 페이지의 어느 곳에서나 사용할 수 있습니다. |
__NOTOC__ | 페이지 목차의 모양을 억제합니다. 페이지의 어느 곳에서나 사용할 수 있습니다. |
__NOEDITSECTION__ | 페이지의 모든 제목 옆에 일반적으로 "편집" 링크를 숨깁니다 . 특정 제목 옆에 편집 링크를 숨기려면 일반적인 wiki 등호 구문(예: ) 대신 와 같은 HTML 태그를 사용하여 제목을 지정합니다 .
<h2>heading</h2> == heading == |
__NEWSECTIONLINK__ | 논토크 페이지에서 페이지에 새 섹션을 추가하는 수단으로 "새 섹션" 링크를 추가합니다. |
__NONEWSECTIONLINK__ | 토론 페이지에서 "새 섹션" 링크(새 섹션 추가 링크)를 제거합니다. |
__NOGALLERY__ | 카테고리 페이지의 썸네일을 일반 링크로 바꿉니다. |
__HIDDENCAT__ | 해당 카테고리 페이지에 포함될 때 카테고리를 숨 깁니다 . |
__INDEX__ | 검색 엔진 에 페이지를 인덱싱하도록 지시 합니다. |
__NOINDEX__ | 검색 엔진이 페이지를 인덱싱하지 않도록 지시합니다. Wikipedia:검색 엔진 인덱싱 제어 를 참조하십시오 . |
__STATICREDIRECT__ | 리디렉션되는 페이지가 이동될 때 리디렉션 페이지 의 링크 가 자동으로 업데이트되는 것을 방지합니다 ("원본 제목을 가리키는 리디렉션 업데이트"가 선택됨). 또한 페이지를 기사처럼 취급 하도록 인터위키 봇 에 지시 합니다. |
__DISAMBIG__ | 를 마크 같은 페이지 동음이의 문서는 ,에 추가 특별 : DisambiguationPages 의 안쪽과 장소 링크 특별 : DisambiguationPageLinks . ( mw:Extension:Disambiguator 를 참조하십시오 .) |
{{DISPLAYTITLE:title}} | 페이지 제목 의 표시된 형식 을 수정하는 데 사용 됩니다 . |
{{DEFAULTSORT:sortkey}} | 페이지가 분류되는 기본 키 (색인)를 설정합니다 . |
{{NOEXTERNALLANGLINKS}} | ( {{NOEXTERNALLANGLINKS|*}} 와 동일 ) 페이지 왼쪽에 Wikidata 언어 간 링크 가 자동으로 포함되지 않도록 합니다. 모든 언어가 아닌 특정 언어에 대한 링크는 {{NOEXTERNALLANGLINKS| 목록 }} 여기서 목록 파이프 - 분리 의 목록 언어 코드 (예 : {{NOEXTERNALLANGLINKS | FR | ES | 프랑스 ( "FR"), 스페인어 ( "ES")와 일본어를 억제하는 JA}} ( "JA") 언어 간 링크). |
변수
페이지 이름 변수 | 산출 | 설명 |
---|---|---|
{{FULLPAGENAME}} | 도움말:마법의 단어 | 표준 페이지 이름 . 제목 줄 . 로 대소문자를 변경하지 않는 한 제목입니다 {{DISPLAYTITLE}} .
|
{{PAGENAME}} | 마법의 단어 | 네임스페이스를 제외한 제목 줄 . |
{{BASEPAGENAME}} | 마법의 단어 | 네임스페이스를 제외한 상위 페이지의 제목입니다. |
{{ROOTPAGENAME}} | 마법의 단어 | 네임스페이스를 제외한 최상위 부모의 제목(모든 하위 페이지 이전). |
{{SUBPAGENAME}} | 마법의 단어 | 하위 페이지에서 현재 제목의 가장 오른쪽 부분 . 상위 하위 페이지 이름은 백링크로 표시됩니다 . |
{{ARTICLEPAGENAME}} | 도움말:마법의 단어 | 현재 페이지와 연결된 주제 페이지의 제목입니다. 이들은 토론 페이지에서 유용합니다(그러나 범주 토론 페이지에 대한 참고 사항 참조). |
{{SUBJECTPAGENAME}} | 도움말:마법의 단어 | |
{{TALKPAGENAME}} | 도움말 말하기: 마법의 단어 | 현재 페이지와 연결된 토론 페이지의 제목입니다. 주제 페이지에 유용합니다. |
{{NAMESPACENUMBER}} | 12 | 현재 페이지의 네임스페이스 번호입니다. |
{{NAMESPACE}} | 돕다 | 제목의 네임스페이스입니다. |
{{ARTICLESPACE}} | 돕다 | 토론 페이지에서 관련 주제 페이지 제목의 네임스페이스 부분. |
{{SUBJECTSPACE}} | 돕다 | |
{{TALKSPACE}} | 도움 이야기 | 현재 페이지와 연결된 토론 페이지의 네임스페이스입니다. |
{{FULLPAGENAMEE}},
{{PAGENAMEE}}, (등) |
도움말:Magic_words,
Magic_words 등 |
위의 변수 끝에 E를 추가하면 위의 내용이 MediaWiki URL 에서 사용하도록 인코딩 됩니다 (즉, 공백을 밑줄로 대체). |
{{SHORTDESC}} | 모바일 플랫폼의 기사 제목 아래에 짧은 설명이 표시되는 영어 Wikipedia에서만 작동합니다. |
참고: 위의 마법 단어는 현재 페이지가 아닌 다른 페이지의 값을 구문 분석하기 위해 매개변수를 사용할 수도 있습니다. :매개변수를 전달하는 데 콜론( )이 사용됩니다 . |와 같이 템플릿에서 사용되는 파이프( ) 가 아닙니다 {{MAGICWORD:value}}. 예를 들어, {{TALKPAGENAME:Wikipedia:MOS}}반환위키피디아 토크:MOS 모든 페이지에서.
참고: "Category" 및 "Category talk" 네임스페이스에서 위키링크(일부) 페이지 이름 변수는 원치 않는 분류를 피하기 위해 콜론 을 접두사로 사용해야 할 수 있습니다 .
사이트 변수 | 산출 | 설명 |
---|---|---|
{{SITENAME}} | 위키피디아 | |
{{SERVER}} | //en.wikipedia.org | |
{{SERVERNAME}} | ko.wikipedia.org | |
{{SCRIPTPATH}} | /w | |
{{CURRENTVERSION}} | 1.38.0-wmf.5(42a8fbc) | 현재 미디어위키 버전을 반환합니다. |
유형별 기타 변수
세계시 | 로컬 웹사이트 시간 | ||
---|---|---|---|
변하기 쉬운 | 산출 | 변하기 쉬운 | 산출 |
{{CURRENTYEAR}} | 2021년 | {{LOCALYEAR}} | 2021년 |
{{CURRENTMONTH}} | 10 | {{LOCALMONTH}} | 10 |
{{CURRENTMONTHNAME}} | 십월 | {{LOCALMONTHNAME}} | 십월 |
{{CURRENTMONTHABBREV}} | 10월 | {{LOCALMONTHABBREV}} | 10월 |
{{CURRENTDAY}} | 25 | {{LOCALDAY}} | 25 |
{{CURRENTDAY2}} | 25 | {{LOCALDAY2}} | 25 |
{{CURRENTDOW}} | 1 | {{LOCALDOW}} | 1 |
{{CURRENTDAYNAME}} | 월요일 | {{LOCALDAYNAME}} | 월요일 |
{{CURRENTTIME}} | 22:53 | {{LOCALTIME}} | 22:53 |
{{CURRENTHOUR}} | 22 | {{LOCALHOUR}} | 22 |
{{CURRENTWEEK}} | 43 | {{LOCALWEEK}} | 43 |
{{CURRENTTIMESTAMP}} | 20211025225305 | {{LOCALTIMESTAMP}} | 20211025225305 |
변하기 쉬운 | 산출 |
---|---|
{{REVISIONDAY}} | 28 |
{{REVISIONDAY2}} | 28 |
{{REVISIONMONTH}} | 08 |
{{REVISIONYEAR}} | 2021년 |
{{REVISIONTIMESTAMP}} | 20210828190022 |
{{REVISIONUSER}}a | 레드로즈64 |
- 이 편집에 마지막으로 사용자가 페이지를 보여줍니다. 기술적인 제한으로 인해 페이지를 보고 있는 사용자를 보여줄 수 있는 방법이 없습니다.
{{NUMBEROFPAGES}} | 54,503,126 |
---|---|
{{NUMBEROFARTICLES}} | 6,400,188 |
{{NUMBEROFFILES}} | 895,890 |
{{NUMBEROFEDITS}} | 1,047,129,029 |
{{NUMBEROFUSERS}} | 42,438,080 |
{{NUMBEROFADMINS}} | 1,077 |
{{NUMBEROFACTIVEUSERS}} | 124,416 |
파서 기능
메타데이터
기능 | 설명 |
---|---|
{{PAGEID}} | 고유한 페이지 식별자 번호(예: 이 페이지의 ID는 3235121) |
{{PAGESIZE:fullpagename}} | 명명된 페이지의 크기(바이트)입니다(예: 이 페이지는 29,285바이트). |
{{PROTECTIONLEVEL:action|fullpagename}} | 명명된 페이지 에서 작업 ("편집", "이동" 등)에 할당된 보호 수준 입니다. |
{{PROTECTIONEXPIRY:action|fullpagename}} | 명명된 페이지 에서 작업 ("편집", "이동" 등)에 할당된 보호 만료 입니다. |
{{PENDINGCHANGELEVEL}} | 현재 페이지에서 보류 중인 변경 사항 에 대한 보호 수준입니다 . |
{{PAGESINCATEGORY:categoryname}} | categoryname 이라는 범주 의 페이지 수입니다 . 각 하위 범주는 하나의 항목으로 계산됩니다. |
{{NUMBERINGROUP:groupname}} | groupname 이라는 사용자 그룹 의 사용자 수입니다 . |
쉼표 구분 기호 없이 숫자를 출력하려면 (예: "123,456,789"가 아닌 "123456789"로) 매개변수를 추가합니다 |R.
서식
기능 | 설명 |
---|---|
{{lc:string}} | 문자열의 모든 문자 를 소문자로 변환합니다 . |
{{lcfirst:string}} | 문자열의 첫 번째 문자 를 소문자로 변환합니다 . |
{{uc:string}} | 문자열의 모든 문자 를 대문자로 변환합니다 . |
{{ucfirst:string}} | 문자열의 첫 번째 문자 를 대문자로 변환합니다 . |
{{formatnum:unformatted_number}} {{formatnum:formatted_num |R}} |
unformatted_number에 쉼표 구분 기호를 추가합니다 (예: 123456789는 123,456,789가 됨). 이러한 형식을 제거하려면 (예 를 들어, 7654321을 생성)를 사용하십시오. {{formatnum:formatted_number|R}}{{formatnum:7,654,321|R}} |
{{#dateformat:date|format}} {{#formatdate:date|format}} |
사용자 기본 설정에 따라 날짜 형식을 지정합니다. 기본값은 날짜 기본 설정이 없는 사용자를 위한 선택적 대소문자 구분 두 번째 매개변수로 제공될 수 있습니다. 날짜를 기존 형식 dmy 에서 mdy , ymd , 또는 ISO 8601 형식 으로 변환할 수 있으며 사용자의 기본 설정은 지정된 형식을 재정의합니다.
|
{{padleft:xyz|stringlength}} {{padright:xyz|stringlength}} {{padleft:xyz|length|padstr}} {{padright:xyz|length|padstr}} |
주어진 길이를 채우기 위해 오른쪽이나 왼쪽에 0을 0으로 채웁니다. 대체 패딩 문자열을 세 번째 매개변수로 지정할 수 있습니다. 길이가 필요한 문자 수를 균등하게 나누지 않으면 반복되는 패딩 문자열( padstr )이 잘립니다. |
{{plural:N|singular|plural}} | 출력 단수 경우 N은 1과 동일하고, 그렇지 않으면 출력 복수 . 자세한 내용은 mediawiki.org 의 문서 를 참조하십시오. |
{{#time:format|object}} {{#timel:format|object}} {{#time:d F Y|date|langcode}} |
ISO 형식, 점 또는 영어 월 이름의 경우 날짜 및 시간 형식을 지정하는 데 사용됩니다. #timel각 위키에 대해 정의된 현지 시간을 기반으로 합니다. 영어 Wikipedia의 경우 와 동일합니다 #time. 선택적인 세 번째 매개변수는 출력 언어 코드입니다(프랑스어, 독일어, 스웨덴어: fr, de, sv 등). 핀란드어 예: {{#time:d F Y|June 30, 2016|fi}}쇼: 30 kesäkuu 2016(6월). ISO에서 독일어로: {{#time:d. M Y|1987-10-31|de}}쇼: 31. Okt. 1987. 형식 코드는 mw:Help:Extension:ParserFunctions##time을 참조하십시오 . 형식 {{#time: H:i, j F Y (e)|...}}을 사용하여 서명의 타임스탬프가 사용하는 형식 과 일치시킵니다. |
{{gender:user|m_out|f_out|u_out}} | 사용자 의 기본 설정에 지정된 성별 이 각각 남성, 여성 또는 미지정 인지에 따라 m_out , f_out 또는 u_out을 출력 합니다 . 다른 매개변수 순열을 사용할 수 있습니다( mw:Help:Magic words#gender 및 translatewiki:Gender 참조) . |
{{#tag:tag|content with magic}} | 를 생성하기 위해 태그 내에서 마법의 단어 를 평가하는 유일한 방법 입니다. 또한 태그 속성을 처리합니다.
<tag>magic</tag> |
경로
기능 | 설명 |
---|---|
{{localurl:fullpagename |query}} | 페이지 이름에 대한 상대 경로 입니다. 쿼리 매개 변수는 선택 사항입니다. |
{{fullurl:fullpagename |query}} | 페이지 이름에 대한 프로토콜 접두사 (예 : " http: " 등 제외)가 없는 절대 경로 입니다. 쿼리 매개 변수는 선택 사항입니다. |
{{canonicalurl:fullpagename |query}} | 프로토콜 접두사를 포함한 페이지 이름의 절대 경로입니다. 쿼리 매개 변수는 선택 사항입니다. |
{{filepath:filename}} | 미디어 파일 filename 의 절대 경로 입니다. |
{{urlencode:string}} | URL 쿼리 문자열 에 사용할 문자열 을 인코딩 합니다 . {{urlencode:test string}}예를 들어, test+string을 생성합니다. URL 경로 또는 MediaWiki 페이지 이름에 사용할 문자열 을 인코딩하려면 각각 |PATH 또는 |WIKI ("test%20string" 또는 "test_string"을 생성하기 위해)를 추가합니다.
|
{{anchorencode:string}} | MediaWiki URL 섹션 앵커 에서 사용하기 위해 인코딩된 입력 입니다. |
{{ns:n}} | 인덱스가 숫자 n 인 네임스페이스 의 이름을 반환합니다 . MediaWiki URL의 경우 . {{nse:}} |
{{#rel2abs:path}} | 상대 파일 경로를 절대 경로로 변환합니다. |
{{#titleparts:fullpagename|number|first segment}} | 전체 페이지 이름(제목)을 해당 세그먼트 수로 분할합니다. |
가정 어구
기능 | 설명 |
---|---|
{{#expr:expression}} | 표현식을 평가 합니다 ( m:Help:Calculation 참조 ). |
{{#if:string |result1 |result2}} | string 이 비어 있으면 result2 를 출력하고 , 그렇지 않으면 result1 을 출력 합니다. |
{{#ifeq:string1|string2 |result1 |result2}} | 출력 결과 1 경우 문자열 1 과 문자열 2가 (알파벳이나 숫자) 동일 달리 출력 result2 . |
{{#iferror:test_string |result1 |result2}} | 출력 결과 1 경우 test_string이 구문 분석 에러를 생성하고, 그렇지 않으면 출력 result2 . |
{{#ifexpr:expression |result1 |result2}} | 출력 결과 1 경우 식이 참이고, 그렇지 출력 result2 . |
{{#ifexist:pagetitle |result1 |result2}} | [[ pagetitle ]] 페이지가 있으면 result1 을 출력 하고 , 그렇지 않으면 result2 를 출력 합니다 . 네임스페이스의 공백에는 밑줄이 필요합니다. |
{{#switch:string |c1=r1 |c2=r2 ... |default}} | 문자열 이 c1 이면 r1을 출력하고 , 문자열 이 c2 이면 r2를 출력하고, 그렇지 않으면 기본값을 출력합니다 (제공된 경우). |
이러한 조건부 함수에서 이름이 지정되지 않은 비어 있는 매개변수가 텍스트가 아닌 비어 있는 것으로 구문 분석되어야 하는 경우(즉, "{{{1}}}", "{{{2}}}" 등의 텍스트가 아닌 비어 있는 것으로 구문 분석됩니다. .), 그들은 즉 (후행 파이프가 필요합니다 {{{1|}}}, {{{2|}}}보다는, 등 {{{1}}}, {{{2}}}), 등.
- 테이블에서 이러한 함수를 사용하려면 도움말:조건부 테이블을 참조하십시오 .
다른
기능 | 설명 |
---|---|
{{#babel:code1|code2|...}} | 귀하의 언어 능력을 알려주는 사용자 상자를 렌더링 하십시오. {{ Babel }}(대안)을 개선합니다. |
{{#categorytree:category|...}} | 재귀적으로 카테고리의 페이지를 나열합니다. |
{{#coordinates:arg1|arg2|...}} | 페이지의 데이터베이스에 주제 의 GeoData 좌표 를 저장 합니다. {{ coord }} 에서 사용됩니다 . |
{{#invoke:module|function|arg1|...}} | Scribunto 를 사용 하여 루아 템플릿(예: 모듈 String의 함수 교체) 을 포함 합니다 . |
{{#language:code1|code2}} | 언어 코드로 표시되는 이름을 인쇄하십시오(예: en → English ) . 주어진 경우 언어 2로 인쇄(예:{{#language:en|zh}}英语 인쇄) |
{{#lst:}} {{#lsth:}} {{#lstx:}} | 페이지의 섹션 을 트랜스클루드하는 세 가지 방법 . |
{{#property:arg1|arg2|...}} | 페이지의 기본값 대신 명명된 엔터티 의 속성 ( Wikidata )을 포함합니다 . |
{{#related:...}} | 독자의 참여를 유도하기 위해 유사한 주제에 대한 링크. (베타 기능입니다.) |
{{#section:}}{{#section-h:}}{{#section-x:}} | {{#lst:}} {{#lsth}} {{#lstx}}(위)에 대한 별칭 . |
{{#statements:arg1|...}} | 항목에 포함된 명령문(Wikidata)의 값을 표시합니다. |
{{#target:fullpagename}} | MassMessage 기능을 사용하여 fullpagename 의 토론 페이지 목록에 메시지를 보냅니다 . |
{{int:pagename}} | MediaWiki 네임스페이스 의 페이지 이름과 같은 인터페이스 메시지를 트랜스클루드 합니다. |
또한보십시오
- mw:현지화
- mw:Manual:위키 마크업 확장
- CoreParserFunctions.php
- 템플릿 및 구문 분석기 기능에 대한 구문 강조 표시가 있는 MediaWiki 편집기 wikEd
- 기본 설정 → 가젯 → 편집 →
구문 형광펜
- 환경 설정 → 베타 기능 →
Wiki 구문 강조 표시
- Special:Version , 마지막 섹션 "파서 함수 후크" 참조: 이 페이지의 모든 마법 단어를 포함해야 하는 목록
- {{ Ifexist not redirect }}, {{#ifexist:}} 표현식과 함께 작동하면서 리디렉션을 식별하고 다르게 구문 분석할 수 있습니다.