목차:틀

창조 위키
Community Help.png

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

틀 생성하기

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

틀 사용하기

틀 역시 하나의 위키 문서이며, 세 가지 방법으로 다른 위키 문서에서 사용될 수 있다.

  • {{이름}}은 이 코드를 포함하고 있는 문서를 웹 브라우저로 열 때, "[[틀:이름]]" 문서의 내용을 그 위치에 포함시킨다. (즉, 항상 최신의 "[[틀:이름]]" 문서의 내용을 포함하게 된다.)
  • {{subst:이름}}은 이 코드를 포함하고 있는 문서에, "[[틀:이름]]" 문서의 내용을 그 위치에 포함시켜서 저장한다. (즉, 문서를 작성하던 시점의 "[[틀:이름]]" 문서의 내용을 포함하게 된다.)
  • {{msgnw:이름}}{{이름}}와 동일하지만, <nowiki>를 사용한 것 처럼 위키 문서 문법을 처리하지 않고 문서를 포함시킨다.

틀에서 매개변수 사용하기

틀에 이름이 없는 매개변수 사용하기
 
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
입력 출력
{{Thankyou|all your hard work|Joe}}
Example sunflower image
A little thank you...
for all your hard work.
hugs, Joe
틀에 이름이 지정된 매개변수 사용하기
 
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
입력 출력
{{Thankyou
|reason=all your hard work
|signature=Joe}}
Example sunflower image
A little thank you...
for all your hard work.
hugs, Joe

틀에는 {{{1}}}와 같이 이름이 없는 매개변수와 {{{param}}}와 같이 이름을 지정한 매개변수를 모두 사용할 수 있다.

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

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

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

틀의 포함 영역 제어하기

<noinclude><includeonly> 를 사용하면 틀의 포함 영역을 제어할 수 있다.

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

유용하게 사용될 수 있는 경우는 다음과 같다.

  • 틀 분류를 작성할 때
  • 다른 언어로 작성된 틀에 대한 연결들을 작성할 때
  • 틀 사용 방법과 같은 내용

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

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

틀 정리하기

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

<noinclude>
==사용법==
어떤 주제에 대한 연결을 생성할 수 있도록 한다:
{{틀이름|단어1+단어2+단어3}}
</noinclude>

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