템플릿:카테고리 핸들러
Template:
템플릿 설명서 | 이 템플릿은 시스템 메시지와 전체 페이지의 약 6%에 해당하는 약 3,160,000페이지에 사용된다. 그것에 대한 변경은 위키백과 사용자 인터페이스에 즉각적인 변화를 일으킬 수 있다. 큰 중단과 서버 로드를 방지하려면 템플릿의 /샌드박스 또는 /테스트케이스 하위 페이지 또는 사용자 하위 페이지에서 변경 사항을 테스트해야 한다.테스트한 변경사항은 한 번의 편집으로 이 페이지에 추가될 수 있다.변경 사항을 적용하기 전에 토크 페이지에서 논의하십시오. |
 | 이 템플릿은 Lua: |
{{카테고리 핸들러}}메타템플릿 입니다.
그것은 다른 템플릿들이 분류와 범주 억제를 모두 자동화하는 것을 돕는다.
이미 이 템플릿은 기본 설정과 함께 사용할 때 일부 네임스페이스와 일반적으로 범주 분류를 원하지 않는 일부 페이지에서 자동 범주화를 방지한다.따라서 가장 기본적인 사용법도 "과 같다.{{category handler [[Category:Somecat]]}}" 템플릿이 잘못된 곳에서 자동으로 조정되지 않도록 주의하십시오.
이 템플리트를 사용하면 템플리트가 분류해야 하는 네임스페이스와 분류하지 않아야 하는 네임스페이스를 쉽게 선택할 수 있다.그리고 그것은 다른 네임스페이스에서 다른 범주를 쉽게 사용할 수 있게 해준다.그리고 이 템플릿은 중앙 블랙리스트를 사용하여 템플릿이 자동 분류되지 않아야 하는 페이지와 페이지 유형을 추가할 수 있다.
이 템플릿을 사용하지 않을 경우
템플리트가 네임스페이스 기본(아티클), 파일(이미지) 또는 카테고리 중 하나로만 분류할 필요가 있는 경우, 이 템플리트를 사용하는 것은 과잉 살상이다.그런 다음 대신 {{main other}, {{file other} 또는 {{category other} 중 하나를 사용하십시오.그러나 템플리트가 다른 네임스페이스에서 분류해야 하는 경우, 적절한 카테고리 억제를 제공하고 다른 네임스페이스에서 분류하는 방법을 쉽게 선택할 수 있으므로 이 템플리트를 사용하십시오.
네임스페이스
이 템플릿은 위키피디아에서 사용되는 모든 다른 네임스페이스를 감지하고 여러 가지 유형으로 분류한다.이러한 유형은 이 템플릿에서 매개 변수 이름으로 사용된다.
- main = 일반 위키백과 기사와 같은 메인/기사 공간.
- talk = "Talk:," "User talk:," "File talk:" 등으로 시작하는 페이지 이름 등 모든 대화 공간.
- 사용자, 위키백과, 파일, 미디어위키, 템플릿, 도움말, 카테고리, 포털 및 책 = 토크 페이지를 제외한 다른 네임스페이스.
- 기타 = 템플릿의 매개 변수로 지정되지 않은 네임스페이스.아래 예제를 참조하십시오.
기본사용
이 템플릿은 두 개 이상의 매개 변수를 사용한다.문서 메시지 상자에 대한 전체 템플릿 코드의 예:
{{Ambox text = 기사에 쓰이는 상자다.}{{{카테고리 핸들러 [[카테고리:Sometcat]] nocat = {{nocat }}}<!--그래서 "nocat=true/false"는 효과가 있다--}}}<{noinclude>}<{Doccentation}}}<!>-------범주를 /doc 하위페이지에 추가한다--</noincludefected>.위의 예에서는 {{category 핸들러}}에 대한 기본 설정을 사용한다.즉, 상자는 다음과 같은 네임스페이스의 페이지에서 분류된다.
- 주, 파일, 도움말, 카테고리, 포털 및 책
그러나 그것은 다음의 네임스페이스로 분류되지 않을 것이다.
- 대화, 사용자, 위키백과, 미디어위키 및 템플릿
그리고 그것은 블랙리스트에 있는 페이지에 분류되지 않을 것이다.(아래 섹션 블랙리스트 참조)
이 템플리트가 네임스페이스의 일부에서 분류되지 않는 이유는 네임스페이스에서 대부분의 템플리트가 사용되지는 않고 단지 시연되거나 나열되기 때문이다.따라서 대부분의 템플릿은 이러한 네임스페이스에서 분류되지 않아야 한다.
이 템플릿이 분류하는 하나 이상의 네임스페이스에 사용할 수 있는 템플릿은 위의 기본 구문을 사용할 수 있다.
고급 사용법
이 템플릿은 위의 섹션 네임스페이스에 나열된 다른 페이지 유형에서 명명된 하나 이상의 매개 변수를 사용한다.이러한 매개변수를 사용하여 템플리트가 분류할 네임스페이스를 정확하게 지정할 수 있다.다음과 같은 경우:
{{mbox 텍스트=기사 및 토크 페이지용 상자다.}{{category 핸들러 main = [[Category:Sometcat1] <!--주요(기사) 공간에서 분류--> 토크 = [[카테고리:Sometcat2] <!--대화 공간에서 범주화--> nocat = {{{nocat }}} <!--그래서 "nocat=true"는 효과가 있다--> }}}}}위의 상자는 메인 공간과 토크 공간에서만 분류된다.그러나 그것은 블랙리스트에 올라 있기 때문에 /아카이브 페이지에 분류되지 않을 것이다.(아래 섹션 블랙리스트 참조)그리고 만약 당신이 대화 페이지에 있는 상자를 시연(논의)할 필요가 있다면, 당신은 그 상자를 먹일 수 있다.nocat=true"을(를) 분류하지 않도록 하기 위해. (아래 섹션 "nocat" 매개변수 참조).다음과 같은 경우:
== 내 새 템플릿 == 얘들아, 내 새 템플릿 봤니?{{mytemp nocat=true}}좋지?--~~~~~~때때로 우리는 몇 개의 네임스페이스에서 동일한 범주를 사용하고 싶다. 그리고 이렇게 한다.
{{mbox text = 여러 네임스페이스에 쓰이는 상자다.}{{category 핸들러 main = [[Category:Sometcat1] 1 = [[범주:Sometcat2] [!] <!--도움말과 사용자 공간--> 도움말 = 1 사용자 = 1 토크 = <!--토크 페이지에 카테고리 없음--> 기타 = [[카테고리:Sometcat3] <!> <!--다른 모든 네임스페이스에 대해서는--> nocat = {{{nocat }}} <!>--그래서 "nocat=true/false"는 효과가 있다--}}}}}}}}}위의 예에서는 범주 중 하나를 공급하기 위해 번호가 매겨진 매개 변수를 사용하고 이 템플릿에 도움말과 사용자 공간 모두에 번호가 매겨진 매개 변수를 사용하도록 지시한다.
이 템플릿은 번호가 매겨진 파라미터 1부터 10까지 이해한다.
다른 매개변수는 명시적으로 데이터를 공급하지 않은 나머지 네임스페이스에서 사용해야 하는 것을 정의한다.
비어 있지만 정의된 토크 매개 변수를 기록해 두십시오.그것은 이 템플릿이 대화 공간에서 다른 매개변수에 공급된 것을 보여주는 것을 막는다.
이 템플릿에는 all이라는 파라미터도 있다.다음과 같이 작동한다.
{{mbox text=모든 네임스페이스에 쓰이는 상자다.}}{{{{property 핸들러all = [카테고리:Sometcat1] <!--모든 네임스페이스로 분류-->nocat = {{nocat }}}<!--그래서 "nocat=true/false"는 효과가 있다--> }}위의 예는 모든 네임스페이스에서 분류되지만 블랙리스트에 오른 페이지에서는 분류되지 않는다.페이지에 해당 상자를 표시하려면 "을 사용하십시오.nocat=true" 템플릿의 범주화를 방지하십시오.
템플릿은 필요한 네임스페이스에서만 분류할 수 있으므로 모든 매개변수를 피하는 것이 좋다.
모든 파라미터는 나머지 파라미터와 결합할 수도 있다.다음과 같은 경우:
{{mbox text=모든 네임스페이스에 쓰이는 상자다.}}{{{{property 핸들러all = [카테고리:Sometcat1] <!--모든 네임스페이스로 분류-->주 = [카테고리:Sometcat2] <!--그리고 이것을 메인 스페이스에 추가...> 기타 = [[카테고리:Sometcat3] <!><-그리고 이것을 다른 모든 네임스페이스에 넣으세요--> nocat = {{nocat }}} <!>--그래서 "nocat=true/false"는 효과가 있다--}}}}}}}}}}}}}}}}.위의 상자가 기사에 배치되면 "Somecat1"과 "Somecat2" 범주가 추가된다.그러나 다른 모든 유형의 페이지에는 대신 "Somecat1"과 "Somecat3"가 추가된다.이 예에서 알 수 있듯이, 모든 파라미터는 나머지 파라미터와 독립적으로 동작한다.
하위 페이지
이 템플릿은 하위 페이지 매개변수를 이해한다.다음과 같은 경우:
{{category 핸들러하위 페이지 = no <!--하위 페이지에서 분류하지 마십시오..>위키백과 = [카테고리:Sometcat]] nocat = {{{nocat }}} <!--그래서 "nocat=true/false"는 효과가 있다--> }}}만약."subpage=no" 그러면 이 템플릿은 하위 페이지에서 분류되지 않는다.드물지만 하위 페이지에서만 분류할 수 있는 경우 "를 사용하십시오.subpage=only". 하위 페이지가 비어 있거나 정의되지 않은 경우 이 템플릿은 기본 페이지와 하위 페이지에서 모두 분류한다.
블랙리스트
이 템플릿에는 템플릿이 자동 범주화되지 않아야 하는 페이지 및 페이지 유형의 블랙리스트가 있다.따라서 이 메타템플릿을 사용하는 템플릿은 예를 들어 /아카이브 페이지와 위키백과의 하위 페이지에서 분류되지 않는다.템플릿 메시지.
블랙리스트에 있는 페이지에서 템플릿을 분류하려면 "feed "nocat = false" 페이지에 배치할 때 템플릿으로 이동하여 블랙리스트 검사를 건너뛰십시오.이 템플릿은 네임스페이스에 대한 데이터가 있는 경우에만 분류된다는 점에 유의하십시오.예를 들어 기본 구문을 사용하는 경우(위의 기본 사용법 참조), "를 설정하더라도nocat = false" 템플리트는 대화 페이지에 대한 데이터가 없기 때문에 대화 페이지에서 분류되지 않는다.그러나 이 페이지에는 도움말 공간에 대한 데이터가 있으므로 블랙리스트에 있는 도움말 페이지에서 이를 분류할 것이다.
블랙리스트는 하위 템플릿 {{카테고리 핸들러/블랙리스트}}에 있다.블랙리스트를 보거나 업데이트하려면 해당 위치로 이동하십시오.
nocat 매개변수
이 템플릿은 nocat 매개 변수를 이해함:
- 만약."
nocat = true" 그러면 이 템플릿은 분류되지 않는다. - nocat가 비어 있거나 정의되지 않은 경우 이 템플릿은 평소와 같이 분류된다.
- 만약."
nocat = false" 이 템플릿은 블랙리스트에 있는 페이지에서도 분류된다.(위의 블랙리스트 섹션 참조)
{{카테고리 핸들러}}}을(를) 사용하는 템플릿은 nocat를 포워드 해야 하므로 nocat도 이해한다.코드 "nocat = {{{nocat }}}이 페이지의 예에 나타난 "는 그렇게 한다.
"카테고리
역호환성을 위해 이 템플릿은 범주 매개변수도 이해한다.그것은 nocat과 같은 작용을 한다.다음과 같은 경우:
- 만약."
categories = no" 그러면 이 템플릿은 분류되지 않는다. - 범주가 비어 있거나 정의되지 않은 경우 이 템플릿은 평소와 같이 분류된다.
- 만약."
categories = yes" 이 템플릿은 블랙리스트에 있는 페이지에서도 분류된다.
이 템플릿을 이미 "을(를) 사용하는 템플릿에 추가할 때categories = no" 논리학, 그러면 기존 사용법을 위반하지 않도록 다음을 수행할 수 있다.
{{카테고리 핸들러 [[카테고리:Sometcat]] nocat = {{{nocat }}} <!--그래서 "nocat=true/false"는 효과가 있다--> 범주 = {{{categories }}} <!--그래서 "categories=no"는 효과가 있다-->}}"category2" 매개변수
역호환성을 위해 이 템플릿의 종류는 이전 "카테고리 =" 매개변수를 지원한다.그러나 "카테고리"라는 매개 변수 이름은 이미 이 템플릿에서 범주 공간에 있을 때 범주 데이터를 공급하기 위해 사용되고 있다.대신 이 템플릿은 nocat와 유사한 사용에 대해 범주2를 사용한다.다음과 같은 경우:
- 만약."
category2 =" (정확하지만 정의됨), 또는 "category2 = no" 또는 범주2가 다른 데이터를 공급받는 경우(다음 두 지점에서 설명한 내용은 제외), 이 템플릿은 분류되지 않는다. - 범주2가 정의되지 않았거나 "인 경우
category2 = ¬", 그러면 이 템플릿은 평소와 같이 분류된다. - 만약."
category2 = yes" 이 템플릿은 블랙리스트에 있는 페이지에서도 분류된다.
이 템플릿을 이미 "을(를) 사용하는 템플릿에 추가할 때category ="논리학, 그럼 이렇게 하면 기존 관용을 어기지 않을 수 있다.
{{카테고리 핸들러 [[카테고리:Sometcat]] nocat = {{{nocat }}} <!--그래서 "nocat=true/false"는 효과가 있다--> 범주2 = {{{category }}}}} <!--그래서 "category ="가 통한다-->}}참고: "¬"는 이 템플릿이 범주 매개변수가 정의되어 있지만 비어 있는지 또는 정의되지 않았는지를 탐지하는 데 도움이 된다.
카테고리 및 텍스트
범주 외에도 이 템플릿에 다른 모든 항목(예: 일부 텍스트)을 제공할 수 있다.다음과 같은 경우:
{{tmbox 텍스트=토크 페이지 메시지 상자다.}}{{카테고리 취급자 토크 = [[카테고리:Sometcat] 다른 = :::::::::이 템플릿은 토크 페이지에서만 사용해야 한다.nocat = {{nocat }}}<!--그래서 "nocat=true/false"는 효과가 있다--> }}위의 템플릿이 토크 페이지 이외의 다른 페이지에 표시되면 다음과 같이 표시된다(상자 아래 텍스트 참고).
 | 이것은 토크 페이지 메시지 상자 입니다. |
- 이 템플릿은 토크 페이지에서만 사용해야 한다.
해당 텍스트는 블랙리스트 페이지에 표시되지 않으므로 이 방법을 사용하여 중요한 정보를 표시하지 마십시오.먹이 주기 "nocat = true"는 어떤 카테고리를 억제하는 것처럼 텍스트를 숨긴다.
페이지 매개변수
테스트 및 시연을 위해 이 템플릿은 페이지라는 매개 변수를 사용할 수 있다.다음과 같은 경우:
{{카테고리 핸들러 메인 = 카테고리:일부 고양이 이야기 = 카테고리:토크캣 nocat = {{nocat }}}<!--그래서 "nocat=true/false"는 효과가 있다--> 페이지 = 사용자 대화:예}}위의 코드에서 우리는 일부러 카테고리 이름 주위의 괄호를 제외해서 우리는 페이지의 출력을 볼 수 있다.위의 코드가 어떤 페이지를 사용하든지 간에 이 코드는 다음과 같이 반환할 것이다.
- 범주:토크캣
페이지 매개변수는 이 템플리트가 해당 페이지의 것과 동일하게 작동하도록 한다.블랙리스트도 통한다.페이지 이름은 기존 페이지일 필요는 없다.
페이지 매개변수가 비어 있거나 정의되지 않은 경우, 현재 페이지의 이름이 결과를 결정한다.
템플리트가 페이지 매개변수를 이해하도록 만들 수 있다.즉, 해당 페이지를 실제로 편집할 필요 없이 템플릿이 다른 페이지에서 어떻게 분류되는지 테스트할 수 있다.그런 다음 이렇게 하십시오.
{{카테고리 핸들러 메인 = 카테고리:일부 고양이 이야기 = 카테고리:토크캣 nocat = {{nocat }}}<!--그래서 "nocat=true/false"는 효과가 있다--> 페이지 = {{{{{{page }}}} <!--시험용-->}}매개변수
모든 매개 변수 목록:
{{카테고리 핸들러 [[카테고리:Sometcat]] 하위 페이지 = no / only 1 = … 10 = all = [Category:Sometcat]] / 텍스트 메인 = 1 / ... / 10 / [카테고리:Sometcat]] / 텍스트...기타 = 1 / ... / 10 / [카테고리:Sometcat]] / 텍스트 nocat = {{nocat }} / true / false 카테고리 = {{{{nocatory }} / no / yes 카테고리2}} / 'empty' / no / 'not defined' / yes 페이지 = {{nocat }} / 사용자:예 }}"메인"에 대한 빈 값..."기타" 매개변수는 특별한 의미를 갖는다(위의 예 참조)."all" 매개변수는 번호가 매겨진 매개변수를 이해하지 못하는데, 이는 절대 그럴 필요가 없기 때문이다.
기술적 세부사항
중앙 집중화된 범주 억제 블랙리스트는 다음 모듈에 있음:범주 처리기/블랙리스트.블랙리스트를 보거나 업데이트하려면 해당 위치로 이동하십시오.
자세한 기술 정보는 대화 페이지를 참조하십시오.
