Page semi-protected

위키백과:템플릿 네임스페이스

Wikipedia
위키백과 자료 구조
네임스페이스
제목 네임스페이스 대화 네임스페이스
0 (주요/기사) 말해라. 1
2 사용자 사용자 대화 3
4 위키백과 위키백과 토크 5
6 파일 파일 토크 7
8 미디어위키 미디어위키토크 9
10 템플릿 템플릿 토크 11
12 도와 주세요. 도움말 대화 13
14 카테고리 카테고리 토크 15
100 포털 포털 토크 101
118 초안 초안 토크 119
710 시간 지정 텍스트 시간 지정 문자 대화 711
828 모듈 모듈 토크 829
사용되지 않음
2300 가젯 가젯토크 2301
2302 가젯 정의 가젯 정의 토크 2303
설치되지 않음
90 스레드 토크 91
92 요약 요약토크 93
108 북토크 109
442 코스 강좌 강좌 443
444 기관. 기관토크 445
446 교육 프로그램 교육 프로그램 토크 447
2600 주제 2601
가상 네임스페이스
-1 스페셜
-2 미디어
현재 목록(API 호출)

위키백과의 템플릿 네임스페이스는 템플릿저장하는 데 사용되며, 일반적으로 여러 페이지에 포함하기 위한 Wiki 마크업이 포함되어 있습니다.템플리트 네임스페이스는 대부분의 템플리트를 저장하는 데 사용되지만, 다른 네임스페이스에서 제외하고 [1]대체할 수 있으므로 일부 템플리트 페이지는 사용자 네임스페이스와 같은 다른 네임스페이스에 배치됩니다.

템플리트는 일관된 형식을 유지하고 문서 간의 탐색을 지원합니다.옵션 요소 및/또는 변수 요소가 매개 변수에 의해 제어되어 특수한 용도로 사용되는 경우가 많습니다.템플릿은 또한 다양한 Wikipedia 유지 관리 작업을 지원하는 데 사용됩니다.각 템플릿에는 일치하는 항목이 있습니다.Template talk:편집자가 관련 템플릿의 설계 및 구현에 대해 논의할 수 있는 페이지(도움말:대화 페이지를 사용하여 대화 페이지 토론에 참여하는 방법).

템플리트는 해당 페이지의 내용에 템플리트 태그를 포함하여 다른 페이지로 변환됩니다.템플릿 태그에는 이중 중괄호로 둘러싸인 템플릿 페이지 이름이 들어 있습니다. 예를 들어, 템플릿의 페이지 이름이 네임스페이스와 콜론으로 시작하지 않으면 템플릿 네임스페이스에 있는 것으로 간주됩니다.

템플릿 페이지에 대한 내부 링크는 다음을 사용하여 만들 수 있습니다.Template:접두사(예:[[Template:Disambiguation]]이러한 연결은 기본 템플리트와 문서를 직접 포함하는 페이지로 이동합니다.

가이드라인

  • 템플릿은 일반적으로 문서 텍스트를 저장하는 데 사용되어서는 안 됩니다. 이렇게 하면 내용을 편집하기가 더 어려워지기 때문입니다.또한 판독기에서 내용을 "붕괴"하거나 "숨기기" 위해 사용해서는 안 됩니다.
  • 문서에 사용되는 템플리트는 탐색 보조 도구, 서식 지정 또는 내용이 표준 이하임을 알리는 경고와 같은 정보를 독자에게 제공하도록 설계되었습니다.편집자에게 서비스에 대한 정보만 제공하는 템플릿은 기사 페이지에 나타나지 않아야 합니다. 기사의 대화 페이지나 다른 기사가 아닌 이름 공간을 사용하십시오.
  • 템플릿 기능은 템플릿 이름에서 명확해야 하지만, 매우 인기 있는 템플릿의 일상적인 사용을 지원하기 위해 리디렉션을 만들 수 있습니다.
  • 위험성이 높은 템플릿은 반보호, 템플릿 보호 또는 완전히 보호되어야 합니다(위키백과:보호 정책).이는 사용률이 높은 템플릿 리디렉션에도 적용됩니다.
  • 템플릿은 용도와 범위에 대해 명확하게 문서화되어야 합니다.
  • 카테고리, 목록 페이지 또는 "참고 항목" 섹션 목록이 동일한 기능을 수행할 수 있는 경우 템플릿을 사용하여 다른 문서에 대한 링크 목록을 작성하면 안 됩니다.
  • User_talk: 페이지와 같이 빠르게 제거되거나 변경될 가능성이 없는 텍스트가 포함된 짧고 임시 메시지 템플릿은 대체와 함께 호출되어야 합니다(subst:장기적인 사용을 목적으로 하고 변경이 필요할 가능성이 높은 일반 템플릿은 향후 업데이트가 용이하도록 제외해야 합니다.
  • 이 페이지의 지침을 위반하거나, 기능이 제대로 정의되지 않았거나, 중복되거나, 고아가 되거나, 한 페이지에서만 사용되거나, 위키백과 정책을 위반하는 템플릿은 위키백과에서 삭제 대상으로 지정될 수 있습니다.토론용 템플릿입니다.

권장 프랙티스

템플릿 참조

때때로 템플릿을 실제로 호출하는 대신 참조하기를 원할 수 있습니다.이렇게 하는 쉬운 방법은 템플릿을 호출하는입니다.Tl("템플릿 링크"의 줄임말).예를 들어 정리 템플릿을 참조하려면 다음과 같이 입력합니다.{{tl Cleanup}}{{Cleanup}}이(가) 생성됩니다.템플릿을 사용하여 매개 변수를 추가할 수도 있습니다.Tlp; 예를 들어,{{tlp Convert 1 m}}{{Convert 1m}}(으)로 표시됩니다.

템플릿의 템플릿 설명서를 확인합니다.{{tlb}}(굵은 글씨)와 같은 다른 옵션의 경우,{{tlx}}(코드),{{tlxi param1 param2}}(이탤릭체 매개변수) 등이 있습니다.

템플릿 이름

템플릿 이름은 다음과 같은 하나 이상의 단어로 만들 수 있습니다.첫 번째 문자(만)는 대소문자를 구분하지 않으므로 및 및 는 동일한 템플릿이지만 그렇지 않습니다.템플리트 이름이 표준 영어 철자, 공백 및 대문자를 따를 경우 가장 쉽게 기억할 수 있습니다(문서 이름 지정 규칙 참조).이름이 대소문자, 공백 또는 구두점만 다른 템플릿은 사용하지 마십시오.

실험용 샌드박스

템플릿을 사용하여 실험을 수행하려는 경우(실험을 완료하기 전에 삭제하지 않음) 템플릿 샌드박스에서 실험을 수행할 수 있습니다.실험 목적으로 템플릿 X1, X2, X3, X4, X5, X6, X7, X8, X9, X10, X11X12를 사용할 수도 있습니다.테스트 템플릿을 포함하려면 템플릿 X1, 템플릿 X2 등의 양식을 사용합니다.

기존 템플릿에는 자체 샌드박스테스트 사례 페이지가 있는 경우가 많습니다(특히 {{Documentation}}을(를) 사용하는 템플릿).많은 페이지가 의도하지 않게 손상되지 않도록 기본 템플릿에 적용하기 전에 변경 사항을 철저히 테스트해야 합니다.

가독성

많은 수의 모수를 사용하는 템플릿의 경우 각 모수를 별도의 선에 배치하고 등호를 정렬하면 유용할 수 있습니다.이것은 미래의 편집자들이 위키코드를 더 쉽게 읽을 수 있도록 도와줍니다.

{{예시 템플릿 이름 first_parameter = first_value second_parameter = second_value second_parameter = third_parameter 등의 텍스트}}

줄 바꿈

일부 템플릿은 실수로 렌더링된 아티클에서 줄 바꿈을 추가할 수 있습니다.템플릿 페이지에는 추가 줄이 표시되지 않으므로 일반적으로 문서 오른쪽에 뜨는 정보 상자 템플릿 및 기타 템플릿 상자에 특히 해당됩니다.자세한 내용은 위키백과를 참조하십시오.줄 바꿈 처리.

일반적인 지침으로 템플릿에서 두 줄 바꿈을 함께 사용하지 마십시오.이는 문서의 다른 줄 바꿈과 "합계"되어 원하지 않는 공백으로 표시될 수 있습니다.

치환

양식을 사용하여 템플리트 호출

{{subst:name of template ( parameters ...)}}

(즉, 여는 괄호 쌍 바로 뒤에 삽입) 템플릿 텍스트의 복사본을 만들어 원본에서 볼 수 있는 페이지에 배치합니다.템플릿은 더 이상 제외되지 않으며 이후에 템플릿을 변경하면 텍스트가 변경되지 않습니다.지침으로 이 방법은 User_talk: 페이지와 같이 빠르게 제거되는 모든 짧고 임시 메시지에 사용해야 합니다.표준 신규 사용자{{Welcome}}메시지가 좋은 예입니다.

메시지를 페이지에 포함한 후 편집해야 할 경우에도 subst:를 사용합니다.편집할 필요가 없고 메시지가 템플릿 변경사항과 함께 자동으로 업데이트되도록 하려면 subst:를 사용하지 마십시오.

문서화

템플릿은 초보 편집자에게 어려운 단계를 나타내므로 템플릿의 사용(선택적 매개 변수)과 범위(사용해야 하는 위치)를 설명하는 문서가 제공되어야 합니다.이 작업에는 두 가지 다른 방법이 있습니다.

한 가지 대안은 <no include>를 사용하여 템플릿에 직접 보조 설명을 추가하는 것입니다. 예를 들어 다음과 같습니다.

'''{1}}개 기사입니다.''' <no include> 설명이 필요한 모든 기사에 이 템플릿을 배치합니다.기사를 설명하는 데 사용되는 형용사인 하나의 매개 변수가 필요합니다.예를 들어 {{article-description bad}}을(를) 입력하면 '이것은 나쁜 기사입니다.' ' </no include>라는 텍스트가 생성됩니다.

또 다른 대안은 문서에 대한 공식 /doc 하위 페이지를 작성하고(여러 매개변수가 있는 템플리트에 대해 선호됨) 추가하는 것입니다.<noinclude>{{Documentation}}</noinclude>실제 템플릿 뒤에.첫 번째 "포함 안 함" 태그는 다음과 같은 방법으로 실제 템플릿의 끝 괄호와 동일한 줄에 배치해야 합니다.

{{(가칭)(제한된 매개 변수)}}<noinclude>...

"포함 안 함" 태그가 템플리트의 닫는 중괄호 아래 줄에서 시작하는 경우, 문서 및 다른 페이지에서 사용될 때 원하지 않는 공백이 템플리트의 맨 아래에 나타납니다.

모듈

Lua 모듈은 재사용 가능한 재료를 저장하기 위해 템플릿 대신 사용되기도 합니다.그 이유로는 루프 또는 저장된 값과 같은 모듈별 기능의 사용이 포함되며 복잡한 코드는 모듈에서 읽고 유지하기가 더 쉬운 경우가 많습니다.템플릿에서 모듈을 쉽게 구현할 수 있는 경우 템플릿을 편집한 경험이 있는 사용자가 더 많기 때문에 일반적으로 구현해야 합니다.

모듈이 기사나 토크 페이지에서 사용되도록 의도된 경우, 일반적으로 템플릿 래퍼를 생성하여 직접적으로 필요하지 않고 사용을 단순화해야 합니다.#invoke파서 기능그런 다음 설명서는 대부분 템플리트의 /doc 페이지에 위치하며, 모듈의 설명서는 템플리트를 가리키거나 기본 템플리트 설명서에서 불필요한 추가 기술 세부사항을 설명합니다.

그러나 템플릿 제한과 관련하여 잠재적인 문제가 발생하는 등 템플릿 래퍼를 사용하지 않는 이유가 있을 수 있습니다. 모듈에 너무 많은 매개 변수를 전달하는 템플릿 래퍼는 직접 호출에 비해 효율성이 훨씬 떨어집니다.또한 일반적으로 다른 템플릿에 템플릿 래퍼를 사용하는 것은 바람직하지 않습니다.

역사

이전에는 페이지에서 사용할 때 템플릿 이름 앞에 "msg:" 접두사를 추가해야 했습니다.예를 들어 {{stub}} 대신 {{msg:stub}}을(를) 입력했습니다.이것은 더 이상 필요하지 않습니다.

위키백과의 첫 35개월 동안에는 템플릿이나 트랜스클루전 메커니즘이 전혀 없었습니다.Wikipedia 페이지:다양한 위키백과 과정에서 자주 사용되는 텍스트를 수집하기 위해 2002년 9월에 상용어구가 만들어졌습니다.MediaWiki 네임스페이스는 2003년 12월 6일 MediaWiki 1.2.6과 함께 도입되었으며 사용자 인터페이스뿐만 아니라 {{msg:...}를 사용하여 기사에 삽입할 상용판 텍스트 메시지를 만드는 데에도 사용되었습니다.통사론이 기능은 2004년 5월 30일에 MediaWiki 1.3으로 소프트웨어를 업그레이드하는 동안 Template 네임스페이스로 대체되었습니다."템플릿 네임스페이스 초기화 스크립트"의 기능으로 시스템이 아닌 모든 메시지가 새 네임스페이스로 이동되었습니다.초기화 스크립트는 또한 이동에 의해 생성된 리디렉션을 우회하기 위해 Template: 기사의 MediaWiki: 참조를 대체했습니다.

잠시 동안 위키백과:삭제를 위한 기사(당시 삭제 투표 또는 VfD로 알려짐)는 "MediaWiki:VfD-article name" 형식으로 명명된 MediaWiki: 메시지를 사용했습니다.이것들은 2004년 6월에 Template: space로 이동되었고 "Template:"라는 이름으로 명명되었습니다.VfD-article name".이 사용은 이제 하위 페이지를 위해 더 이상 사용되지 않습니다.

2005년경 템플릿 기능의 복잡성이 증가하고 유사한 템플릿을 통합하려는 욕구가 중첩된 템플릿 및 CSS 트릭과 같은 매우 복잡한 조건부 해킹을 만들었습니다.이러한 바람직하지 않은 방법은 m의 개발로 이어졌습니다.확장:2006년 미디어위키 1.7과 함께 추가된 파서 함수.2009년까지 템플릿 가독성 및 복잡성과 관련된 많은 문제가 여전히 남아 있었습니다(템플릿 프로그래밍 언어).2013년에는 주로 느린 템플릿 렌더링으로 인한 페이지 로드 시간을 해결하기 위해 Lua가 활성화되어 프로그래머가 사용할 모듈: 네임스페이스를 만들었습니다(새로운 Lua 템플릿은 위키더 빠르고 유연한 페이지를 가져옵니다).

템플릿 검색 중

이 양식을 사용하여 Template: 또는 Template_talk: 이름 공간에서 검색합니다.도움말 참조:자세한 정보를 검색하는 입니다.

일반적으로 사용되는 템플릿에 대한 정보가 포함된 페이지:

상황에 맞는 기존 템플릿을 찾을 수 없지만 직접 템플릿을 만드는 것이 부담스럽다면 Wikipedia에 도움을 요청할 수 있습니다.요청된 템플릿입니다.

참고 항목

노트

  1. ^ 변환이 허용되지 않는 네임스페이스는 Wiki에서 $wgNonincludeableNamespaces 변수로 지정됩니다.