원문 보기: https://dawoum.duckdns.org/wiki/Help:A_quick_guide_to_templates
이것은 간략한 템플릿의 개요입니다. 전체 내용은 Help:Template 및 m:Help:Advanced templates에서 구해질 수 있습니다.
템플릿은 다른 페이지에 포함되도록 만들어진 다움위키 페이지입니다. 그것은 종종 사용자-지정-가능한 입력과 함께 보통 여러 기사 또는 페이지에 표시되어야 할 필요가 있는 반복적인 자료를 포함하고 있습니다. 대부분의 템플릿은 간단한 스크립팅 언어, "마법 단어"라는 별명을 가진 미디어위키 파서 함수를 사용하는 스크립트입니다.
템플릿 페이지는 템플릿 이름공간에 있습니다. 이것은 "Template:foo"와 같은 제목이 "Template:"으로 시작하는 임의의 페이지는 해당 목적으로 사용될 수 있음을 의미합니다. Template:foo라는 템플릿의 콘텐츠는 페이지를 편집하고 그것에 {{foo}}를 입력함으로써 다움위키 페이지에 추가될 수 있습니다. 그런-다음 그 페이지를 볼 때, {{foo}}는 "Template:foo" 페이지의 콘텐츠로 자동 대체됩니다. 만약 "Template:foo" 페이지가 나중에 변경되면, {{foo}}를 포함하는 모든 페이지가 자동으로 변경될 것입니다.
무엇보다도, 템플릿은 페이지에 반복되는 메시지를 일관된 방식으로 추가하고, 상용구 메시지를 추가하고, 탐색 상자를 만들기 위해 사용됩니다.
템플릿이 자동으로 확장되고 페이지에 표시될 때, "전달-삽입" 되었다고 합니다.
템플릿은 해당 페이지에 문서화되어 있습니다 (또는 있어야 합니다). 따라서 만약 이름이 "foo"인 템플릿을 사용하는 방법을 알고 싶다면 (아마도 기사 소스에서 {{foo|...}}를 보았기 때문에), "Template:foo"로 이동하십시오. (문서 자체는 보통 "Template:foo/doc"에 위치되지만, 역시 "Template:foo" 이름 공간에 전달삽입됩니다.)
Creating, editing, and using templates
기사 페이지를 시작하는 것과 같은 방식으로 새 템플릿을 시작할 수 있습니다. 유일한 차이점은 제목이 Template:으로 시작해야 한다는 것입니다.
템플릿을 만든 후 (예를 들어, Template:foo), {{foo}}를 사용하려는 페이지에 추가할 수 있습니다. 이 템플릿을 사용하는 모든 각 페이지는 사용자가 그 페이지를 방문할 때마다 같은 보일러플레이트 텍스트를 사용합니다. 템플릿이 업데이트될 때, 템플릿 태그를 포함하는 모든 페이지가 자동으로 업데이트됩니다.
대안적으로, 페이지에 템플릿에 대한 향후 업데이트를 반영하지 않도록 하려면, 보일러플레이트 텍스트를 사용하려는 페이지에 {{subst:foo}}를 추가할 수 있습니다. 시스템은 템플릿 텍스트의 일회성 사본을 가져와서 템플릿 태그 대신 그것을 페이지에 대체합니다. 누군가가 나중에 템플릿을 편집하면, subst: 키워드를 사용한 페이지는 업데이트되지 않습니다. 때로는 그것이 원하는 것입니다.
편집하려는 템플릿이 {{foo}}처럼 보인다면, Template:foo로 가서 편집하면 됩니다. 거기에 가려면, 검색창에 "Template:foo"를 입력하거나 (검색 참조), 샌드박스와 같은 어딘가에 [[Template:foo]]와 같은 위키링크를 만들고 그것을 클릭하십시오.
일단 거기에 도착하면, 단지 페이지 맨 위에 있는 "edit" 또는 "edit this page"을 클릭하고 (아래에 있는 문서 편집 버튼이 아닙니다) 임의의 다른 페이지와 같은 방식으로 편집하십시오. 텍스트, 이미지, 및 기타 템플릿을 포함하여 정규 페이지에 추가할 수 있는 모든 것을 추가할 수 있습니다. 사용된 템플릿을 편집할 때, 템플릿 샌드박스 및 테스트 사례 방법 안내서에 설명된 대로 샌드박스를 사용하는 것이 좋습니다.
Parameters
템플릿은 페이지가 동적으로 전달-삽입된 페이지에 통합할 수 있는 매개변수를 가질 수 있습니다. 단지 {{foo}}와 같은 템플릿 이름 대신, 삽입된 템플릿 태그에는 세로 막대 (|)로 구분된 추가 값이 있습니다 (예를 들어, {{foo|July|lc=yes}}). 여기서 July는 첫 번째 이름없는 매개변수의 값입니다; yes는 이름있는 매개변수 lc의 값입니다. 매개변수를 갖는 템플릿에 대한 템플릿 페이지를 작성하는 것은 매개변수를 가지지 않는 템플릿에 대한 템플릿 페이지를 작성하는 것보다 더 복잡합니다. Help:Template을 참조하십시오.
Editing existing templates
사용 중인 템플릿을 편집할 때, 다움위키 전체의 여러 페이지에 한꺼번에 영향을 미칠 수 있습니다.
w:Wikipedia:Template editor § Use는 문제를 피하는 데 도움이 되는 팁입니다.
Template link template
다움위키 문서에 템플릿의 실제 전체 이름을 텍스트 (주변 중괄호 포함)로 포함하기 위해, 템플릿 링크 템플릿을 적용하십시오. 이를 수행하는 주된 동기는 안내서와 문서입니다. 간단한 예는 다음 코드입니다:
{{tl|foo}}
다음을 생성합니다:
{{foo}}
FAQ
기존 템플릿을 사용하는 방법을 어떻게 알 수 있습니까?
이름이 "foo"인 템플릿에 대한 설명서를 보기 위해, "Template:foo"로 이동하십시오.
템플릿이 어디에 사용되는지 어떻게 알 수 있습니까?
템플릿이 전달-삽입된 모든 페이지를 나열하기 위해, Special:WhatLinksHere를 사용하고 template:templatename (자세한 정보)을 입력하십시오.
여러 프로젝트에서 템플릿을 사용할 수 있습니까?
아니요, 예를 들어 두 개의 다른 언어 위키피디아에 템플릿을 사용하기 위해, 그것을 두 번 만들어야 합니다.
템플릿은 대소문자를 구분합니까?
네, 단 보통 첫 글자는 예외입니다.
매개변수를 어떻게 추가할 수 있습니까?
지침에 대해 Help:Template을 참조하십시오.
템플릿을 편집했는데, 템플릿을 사용하는 페이지는 왜 변경되지 않습니까?
다움위키와 클라이언트 컴퓨터는 모두 웹 페이지 캐시 또는 저장된 사본을 저장하고 항상 업데이트된 페이지를 표시하지는 않습니다. 먼저 ⌘R, Ctrl+R, 또는 F5를 눌러 브라우저의 캐시를 우회해 보십시오. 그것에 실패하면, 페이지의 캐시를 제거해야 할 수도 있습니다 (여러 가지 방법으로 수행할 수 있습니다). 아마도 이것을 수행하는 가장 쉬운 방법은 템플릿이 나타나는 페이지에서 edit를 클릭하고, 그런-다음 아무것도 변경하지 않고 Publish changes를 클릭하는 것입니다 – 변경 사항이 생성됨에 따라 이에 대한 임의의 history가 없으므로 Summary 필드를 채울 필요가 없습니다.
템플릿을 새 이름으로 옮길 수 있습니까?
네, 이것은 일반 페이지 이동과 정확히 같은 방식으로 작동합니다. 포함을 요청한 페이지가 리다이렉션 페이지일 때, 리다이렉션 대상이 대신 포함됩니다.
템플릿 내에서 템플릿을 사용할 수 있습니까?
네.
새로운 템플릿을 어떻게 추가합니까?
새 템플릿은 일반 페이지를 시작하는 것과 같은 방식으로 시작합니다. 유일한 차이점은 제목이 Template:으로 시작해야 한다는 것입니다. 다른 편집자가 사용할 수 있도록 문서화하는 것을 잊지 마십시오!
템플릿을 작성하는 데 사용되는 프로그래밍 언어의 매뉴얼은 어디에 있습니까?
템플릿 내부의 언어는 정규 위키 마크업과 같은 언어이지만, 템플릿 작성자는 #if: 문과 같은 보다 복잡한 사용 가능한 함수를 사용하는 경향이 있습니다. 다움위키의 Help:Template과 위키피디아의 w:Help:Template을 참조하십시오. 여기에는 해당 페이지 하단에 나열된 모든 "advanced functioning" 도움말 페이지가 포함됩니다.
Examples
- w:en:Template:stub: an often used message (at English Wikipedia).
- w:en:Template:Biological classification: a template with parameters (at English Wikipedia).
- b:en:Template:GeneralChemTOC: a horizontal menu bar (at English Wikibooks).
- w:en:Template:Underwater work: a template as a simple table with a picture (at English Wikipedia).
Wikipedia-specific help
- Help:Template (more details)
- m:Help:Templates (details from Wikimedia)
- m:Help:Advanced templates (advanced details from Wikimedia)
- Wikipedia:Template namespace (the usual namespace for templates)
- Wikipedia:Transclusion (transcluding templates)
- Wikipedia:Substitution (substituting templates)
- Wikipedia:Template messages (categorised list of links to available templates)