본문 바로가기
미디어위키

Help A quick guide to templates

by 다움위키 2024. 12. 13.

원문 보기: https://dawoum.duckdns.org/wiki/Help:A_quick_guide_to_templates

 

이것은 간략한 템플릿의 개요입니다. 전체 내용은 Help:Templatem: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는 문제를 피하는 데 도움이 되는 팁입니다.

다움위키 문서에 템플릿의 실제 전체 이름을 텍스트 (주변 중괄호 포함)로 포함하기 위해, 템플릿 링크 템플릿을 적용하십시오. 이를 수행하는 주된 동기는 안내서와 문서입니다. 간단한 예는 다음 코드입니다:

{{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

Wikipedia-specific help