목차:틀
여러 문서에 반복하여 입력해야 할 문장이 있는 경우, 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}}
|
|
틀에 이름이 지정된 매개변수 사용하기 | |
'''A little thank you...'''<br> <small>for {{{reason}}}.<br> hugs, {{{signature}}}</small> | |
입력 | 출력 |
{{Thankyou |reason=all your hard work |signature=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>
그러면, 사용자는 간단히 예제를 복사해서 사용할 수 있게 된다.