Help:Templates/ko

여러 문서에 반복하여 입력해야 할 문장이 있는 경우, MediaWiki의 틀 기능이 유용하게 사용될 수 있다. (도움말 namespace의 모든 문서에 포함되어있는 위와 같은 tag가 틀 기능의 좋은 사용예이다.)

틀 생성하기
틀(Template) 이름은  로 시작하며, 다른 보통의 문서를 만드는 것과 같은 방법으로 생성할 수 있다.

틀 사용하기
틀 역시 하나의 위키 문서이며, 세 가지 방법으로 다른 위키 문서에서 사용될 수 있다.
 * 은 이 코드를 포함하고 있는 문서를 웹 브라우저로 열 때, "틀:이름" 문서의 내용을 그 위치에 포함시킨다. (즉, 항상 최신의 "틀:이름" 문서의 내용을 포함하게 된다.)
 * 은 이 코드를 포함하고 있는 문서에, "틀:이름" 문서의 내용을 그 위치에 포함시켜서 저장한다. (즉, 문서를 작성하던 시점의 "틀:이름" 문서의 내용을 포함하게 된다.)
 * 은 와 동일하지만,  를 사용한 것 처럼 위키 문서 문법을 처리하지 않고 문서를 포함시킨다.

틀에서 매개변수 사용하기
틀에는 와 같이 이름이 없는 매개변수와  와 같이 이름을 지정한 매개변수를 모두 사용할 수 있다.

예: 토론 페이지에서 사용할 작은 감사 노트를 만들고 싶다고 생각해보자. 그 노트에는 감사의 이유와 서명이 들어있어야 할 것이다. 이런 경우 위 표에 사용된 것과 같은 Template:Thankyou를 만들어 사용할 수 있을 것이다.

문서에서 틀을 사용하는 경우에는 매개변수들을 파이프(|)로 분리해서 입력해야 한다:. 이름이 있는 매개변수의 경우에는 매개변수로 "이름=값" 쌍을 파이프로 분리해서 입력해야 한다:. 이름이 있는 매개변수를 사용하는 것은 매개변수의 사용 순서가 자유롭다는 장점이 있다. 그리고, 매개변수가 많아지더라도 틀을 쉽게 사용할 수 있다는 장점도 있다. 이름이 없는 매개변수를 사용하는 경우에 그 순서를 바꾸고 싶다면, 본래의 순번을 매개변수의 이름으로 지정해 주어야만 한다:.

매개변수의 기본값을 설정할 수도 있다. 예를 들면,  는 reason 매개변수가 주어지지 않은 경우에는 "all your hard work"를 출력할 것이다.

틀의 포함 영역 제어하기
와 를 사용하면 틀의 포함 영역을 제어할 수 있다.

와  의 사이에 있는 내용은 그 문서를 직접 접근할 때만 화면에 표시되며, 다른 문서에 포함되어 나타나지는 않는다.

유용하게 사용될 수 있는 경우는 다음과 같다.
 * 틀 분류를 작성할 때
 * 다른 언어로 작성된 틀에 대한 연결들을 작성할 때
 * 틀 사용 방법과 같은 내용

반대의 역할을 하는 것이 이다. 와 사이의 문자열은 문서가 다른 문서에 포함될 때에만 화면에 나타난다. 간단한 사용예가 틀을 사용하는 모든 문서들은 category에 포함시키면서, 틀은 그 분류에 포함시키지 않는 경우이다.

Note: 틀에 의해 적용된 분류를 변경하는 경우, 그 틀을 포함하는 문서의 분류는 문서가 그 이후에 수정되기 전까지는 변경된 분류가 적용되지 않는다. 이 문제는 현재 job queue에 들어있다..

틀 정리하기
틀이 효과적으로 사용되기 위해서는 사용자들이 틀을 쉽게 찾아서 사용할 수 있도록 해야한다. 가장 간단한 방법은 틀 문서에 사용 예제를 입력해 두는 것이다. 예를 들면 다음과 같다.

사용법
어떤 주제에 대한 연결을 생성할 수 있도록 한다:

그러면, 사용자는 간단히 예제를 복사해서 사용할 수 있게 된다.