도움말:특수 명령문

이 문서는 한국어 위키백과의 정보문입니다. 이 문서는 정책과 지침은 아니지만, 위키백과의 규범과 관습 측면에서 공동체의 확립된 관행을 설명하고 있습니다. 공동체의 총의나 검토를 어느 정도 반영하고 있습니다.

단축 백:매직 백:명령문

위키백과에서는 특정한 기능을 가지고 있는 특수 명령문(또는 매직워드)을 제공하고 있습니다. 이 명령들은 문서 이름에 대한 정보를 보여주거나, 혹은 목차 사용에 관련된 설정을 변경하는 데에 사용됩니다.

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

1. 문서 설정 스위치: behavior switch. 밑줄로 호출. 문서가 표시되는 방법을 설정함. 매개 변수 안 받음. 목차 강제, 목차 숨김, 분류 숨기기 등.
2. 파서 함수: parser function. 중괄호로 호출. URL 처리, 이름공간 출력, 문자열 형식 처리 등을 수행. 매개 변수를 받음. (매개 변수를 받는 특수 변수도 기술적으로는 파서 함수)
3. 특수 변수: variable. 중괄호로 호출. 시간, 서버, 문서, 통계 정보 등을 출력. 매개 변수 안 받는 것이 많으나 일부는 받음. 틀과 이름이 겹칠 경우 우선 순위는 특수 변수임. 틀:지역일 문서가 있을 때 {{지역일}}을 쓸 경우 틀이 호출되지 않고 특수 변수가 호출됨. 틀을 부르려면 {{틀:지역일}}을 씀. 단, 일부 상황에서는 틀이 우선됨. {{지역일|aa|bb}}처럼 파이프문자로 첫째 매개 변수를 지정하면 틀:지역일이 호출됨.

협정 세계시의 시간 표기

• 언어별 위키백과 서버에 설정된 표준시에 따른 시각입니다. 한국어판 위키백과 서버의 현지 시간대는 한국표준시로 설정되어 있습니다. 그러므로 사용자의 현지 시각과 다를 수 있습니다.

• 페이지가 캐시되고 있는 경우에는 최신 자료가 아닐 수도 있습니다.

#expr은 간단한 계산을 할 수 있는 기능으로, 다음과 같이 사용합니다.

{{ #expr: 계산식 }}

입력할 때에 0이 false, 나머지의 값이 true로 처리됩니다. 계산 결과로는 false가 0, true가 1로 나옵니다.

#if는 if-then-else 조건문입니다. 다음과 같이 사용합니다.

{{ #if: <조건 문자열> | <조건이 참이면 나올 문장> | <조건이 거짓이면 나올 문장> }}
{{ #if: <조건 문자열> | <조건이 참이면 나올 문장> }}

이때 조건의 판단은 "조건 문자열"이 비어 있느냐 비어 있지 않느냐입니다. 다시 말해, 조건 문자열이 비어 있지 않을 때 참, 비어 있을 때 거짓을 반환합니다. 그러므로 조건 문자열이 공백 문자들로만 구성되어 있으면 거짓으로 판단하고, 결과로 "조건이 거짓이면 나올 문장"이 반환됩니다.

거짓일 때 나올 문장은 생략할 수 있습니다. 이런 경우에는, 조건이 거짓이면 빈 문장이 반환됩니다.

주의해야 할 점은, 이것은 기존의 {{{parameter|}}} 동작과 다릅니다. 다음의 두 작동을 비교해 보세요.

또한, 조건이 참/거짓일 때 나오는 문장에는 자동으로 앞뒤로 빈 문자열이 삭제됩니다.

{{#ifeq: 문자열 1 | 문자열 2 | 같을 경우 | 다를 경우}}

• {{#ifeq: aa | aa | same | different}} -> same

문자열 부분에 숫자가 들어오면 숫자 값으로 검사합니다.

• {{ #ifeq: +07 | 007 | 1 | 0 }} -> 1
• {{ #ifeq: "+07" | "007" | 1 | 0 }} -> 0

매개변수가 정의되었는지를 #if로는 검사할 수 없습니다. 이를 검사하려면 #ifeq문을 사용해야 합니다.

• {{ #if: {{{x| }}}|not blank|blank}} = blank
• {{ #ifeq: {{{x| }}}| |blank|not blank}} = blank
• {{ #ifeq: {{{x| }}}|{{{x|u}}}|defined|undefined}} = undefined

{{#ifexist: 문서 이름 | 문서가 있을 경우 | 문서가 없을 경우}}

만약 문서 이름에 인터위키를 넣으면 결과는 항상 문서가 없는 경우로 나옵니다.

{{#ifexpr: 계산식 | true일 경우 | false일 경우}}

계산식이 빈 문자열일 때도 false가 나옵니다.

• {{#ifexpr: {{ns:0}}|Toast|'''or else'''}} = or else

true, false 두 문장을 쓰지 않으면 아무것도 출력되지 않습니다. 단, 오류가 있을 경우에는 오류 메시지가 출력됩니다. 이를 이용해서 수식에 오류가 있는지 없는지 확인하는 것도 가능합니다.

• {{#ifexpr: 1/0}} -> 0으로 나눴습니다.
• {{#if: {{#ifexpr: 1/0}} | 오류 있음 | 오류 없음}} -> 오류 있음

다른 프로그래밍 언어의 switch문과 비슷한 구조를 가지고 있습니다.

{{#switch: 비교할 값
| <value1> = <result1>
| <value2> = <result2>
| ...
| <valuen> = <resultn>
| <default result>
}}

마지막 default값은 모든 비교가 실패했을 때의 값으로, 항상 있어야 합니다. 만약 default 값에 등호가 들어간다면, #default = <값>를 사용할 수 있습니다.

{{ #time:  형식 }}
{{ #time:  형식 | 시간 }}

현재 년월일과 시간을 출력합니다. #timel의 경우 한국어 위키백과에서 기본적으로 설정된 시간대의 값을 보여줍니다.

상대 주소를 절대 주소로 바꿔줍니다.

• “도움말:가나/다라”에서 {{ #rel2abs: ../마바 }}를 호출한 경우, 결과는 도움말:가나/마바가 됩니다.
• “도움말:가나”에서 {{ #rel2abs: ../마바 }}를 호출한 경우, 결과는 마바가 됩니다.
• “도움말:가나”에서 {{ #rel2abs: ../../마바 }}를 호출한 경우, 아래와 같은 오류 메시지가 출력됩니다.
  • 오류: 경로 구조가 잘못되었습니다: "도움말:가나/../../마바" (루트 노드 위의 노드에 접속을 시도했습니다)
• {{ #rel2abs: ../마바 | 도움말:가나/다라 }}를 호출한 경우, 결과는 도움말:가나/마바가 됩니다.
• {{ #rel2abs: 도움말:가나/다라/../마바 }}를 호출한 경우, 결과는 도움말:가나/마바가 됩니다.

해당 언어 코드에 맞는 언어명을 출력합니다.

• {{ #language: ko }} → 한국어
• {{ #language: vi }} → Tiếng Việt
• {{ #language: zh-min-nan }} → 閩南語 / Bân-lâm-gú

위키백과:모듈을 불러 들여와 실행합니다.

• {{ #invoke: Bananas|hello }} → 모듈:Bananas의 hello 함수를 호출한 결과를 출력합니다.

한국어의 조사 확장 기능이 존재합니다. 루아 기반의 모듈:hangul을 대체할 수 있으나, 로마자 등은 지원되지 않습니다. 자세한 사항은 여기를 참고하세요.

• {{ #은는: 사과 }} → 사과는
• {{ #은는: 사과|조사만 }} → 는
• {{ #을를: 연필 }} → 연필을
• {{ #이가: 친구 }} → 친구가
• {{ #과와: 인터넷 }} → 인터넷과
• {{ #아야: 영희 }} → 영희야
• {{ #이: 태준 }}가 → 태준이가
• {{ #으로: 위키백과 }} → 위키백과로

• 미디어위키 도움말 Magic words 항목