도움말:틀
| 문서 편집 도움말 |
|---|
| 표 사용하기 |
| 문서 옮기기 |
| 문서 끼워넣기 |
| 틀 사용하기 |
| 인터위키 |
| 분류 |
미디어위키의 틀 기능은 여러 문서들 간에 공통적인 부분이 있을 때, 그 부분을 따로 모아서 편집하기 쉽게 만들어 주는 기능입니다.
이러한 틀은 일반적으로 틀:이라는 이름공간이 앞에 붙고, 사용할 때에는 {{틀 이름}}과 같이 사용합니다.
틀을 사용하는 경우
[편집]- 문서에 자주 사용되는 정보를 간단하게 표시하는 경우
- 같은 주제를 가진 글의 목록
- 같은 주제, 같은 양식을 사용하는 문서들을 간단하게 관리하려는 경우
- {{러시아의 도시}} 등의 틀이 이에 해당됩니다.
틀 사용하기
[편집]틀을 사용하려면, 틀 이름을 중괄호로 두 개씩 감싸면 됩니다. {{스포일러}} 틀을 사용하려면, 적당한 위치에
{{스포일러}}
와 같이 붙입니다. 그러면 다음과 같이 틀의 내용이 들어가게 됩니다.
스포일러 경고: 아래에는 이 작품의 줄거리나 자세한 결말이 나와 있습니다.기본 틀
[편집]미디어위키에는 기본적으로 내장되어 있는 틀이 있습니다.
| 틀 이름 | 값 |
|---|---|
|
|
매개변수
[편집]틀에 매개변수를 사용할 수도 있습니다. 매개변수를 넘겨 주려면 다음과 같이 사용합니다.
- {{틀 이름|매개변수1|매개변수2}}
이때, 각각의 매개변수 사이에 |를 사용하여 구분합니다. 또한, 매개변수 사이의 공백은 무시됩니다. 따라서, 다음과 같이 사용할 수도 있습니다.
- {{틀 이름
- |매개변수1
- |매개변수2
- }}
이와 같은 방식은 매개변수가 많이 들어가는 경우에 유용합니다.
몇몇 틀은 매개변수에 이름을 사용하는 경우도 있습니다.
- {{틀 이름|변수이름=매개변수값}}
틀 만들기
[편집]틀을 만들거나 고칠 때에는 틀의 이름 앞에 틀:을 붙인 문서를 만들면 됩니다. 예를 들어, {{토막글}} 틀을 편집하고 싶을 때는 틀:토막글을 편집하면 됩니다.
매개변수
[편집]틀 내부에서 매개변수를 이용하려면 {{{1}}}와 같이, 각 매개변수의 순서 값을 중괄호 세 개로 감싸줍니다. 만약 틀을 사용할 때
- {{사용하려는 틀|123|456}}
와 같이 사용하였다면, {{{1}}}에는 123, {{{2}}}에는 456의 값이 들어가게 됩니다.
매개변수에 이름을 붙인 경우에는 {{{매개변수 이름}}}과 같이 사용하면 됩니다.
- {{사용하려는 틀|값1=123|값2=456}}
- {{{값1}}}=123, {{{값2}}}=456
설명 쓰기
[편집]틀이 들어가는 문서에 삽입되지 않는, 틀 자체에 대한 설명을 쓰려면 다음과 같이 합니다.
- 틀의 내용을 <onlyinclude></onlyinclude>로 감쌉니다.
- 그 아래에 틀 자체에 대한 설명이나 분류, 인터위키 등을 추가합니다.
문서에 삽입되지만 틀 설명에서 보이지 않게 하고 싶은 내용은 <includeonly></includeonly>로 감쌉니다.
이 문법기능에 대해 자세한 내용은 아래의 #끼워넣기 문법을 참고하세요.
다른 언어판에서 틀을 도입할때 위의 예를 따르지 않고
{{틀이름|
변수1 = |
변수2 = |
변수3 = |
변수4 = |
}}
와 같이 쓰기도 합니다. 저 방식이 |가 값을 감싸서 깔끔해 보이기도 하지만, 실제 편집에 end키를 사용하기 어려워지고 마지막 변수 뒤에 불필요한 |가 또 들어간다는 문제가 있습니다. 따라서 위의 예시를 쓰는것이 더 좋습니다.
끼워넣기 문법
[편집]틀이나 문서의 전체, 또는 일부를 다른 문서에 끼워넣기(Transclude)를 할수 있는데, 틀이나 문서의 이름을 중괄호 “{{}}” 로 감싸주는 것으로, 끼워넣을수 있습니다. HTML 문법에서 iframe(inner frame)과 PHP 문법에서 include("문서경로")와 유사한 기능을 갖습니다. 끼워넣어질 부분을 정하려면 onlyinclude, includeonly, noinclude의 미디어위키전용 태그로 할수 있으며, 이 3개의 태그는 모두 속성값은 갖지 않으며, 모두 시작 태그와 마침 태그를 필요로 합니다.
- onlyinclude
- 기본값으로, 이 태그를 이용하여 끼워넣어질 특정 부분이 정하지 않으면, 틀이나 문서의 전체가 자동적으로 onlyinclude로 감싼 것과 같은 효과를 나타냅니다. 3개의 태그중에서 가장 빈번하게 쓰이며, 의도적인 줄바꿈할때 이외에는 끼워넣어질 부분의 바로 곁에 붙여주는 것이 좋습니다.
- includeonly
- 이 태그로 지정한 부분은 문서에 끼워넣어질때, 비로서 효과가 발휘됩니다. 주로 둘러보기 틀와 같은 특정 분야에 대한 목록 틀을 끼워넣었을때, 자동적으로 문서를 분류시키는 용도로 자주 쓰입니다.
- noinclude
- 끼워넣기를 할때, 포함되지 않을 부분을 정하며, 주로 틀자체의 분류와 인터위키에 쓰입니다. 포함될 부분만 onlyinclude로 지정하여, 의도되지 않은 줄바꿈으로 인한 레이아웃이 깨지는 현상을 막는 것이 좋습니다. 또한 onlyinclude가 쓰이지 않은 틀은 인터위키를 갱신하는 봇이 문서를 망가뜨리게 됩니다. 따라서 이 태그는 가급적 쓰지 말 것을 권장합니다.