문서 끼워넣기

풋케위키 도움말
풋케위키:소개
위키 작성 도움말

위키백과에서는 {{ }} 문법을 써서, 한 문서를 다른 문서 안에 끼워넣을(transclude) 수 있습니다. HTML의 아이프레임과 비슷한 일을 합니다. 보통 틀을 사용하는 데 씁니다.

• 일반 문서를 끼워넣을 때는 문서 이름 앞에 쌍점을 찍습니다({{:고양이}}).
• 틀 문서는 ‘틀:’을 뺍니다({{생물 분류}}).
• 다른 문서는 문서 이름을 그대로 씁니다({{위키백과:길라잡이}}).

이와 같은 문법을 사용하여 저장한 이후, 나중에 다시 문서의 소스를 보면 해당 문서의 원래 내용 대신, '{{생물 분류}}'와 같은 끼워넣기 문법만 그 자리에 위치해 있습니다. 위키백과는 이러한 끼워넣기 문법을 만나면 문서의 원래 내용을 자동으로 가져와서 사용자에게 보여줍니다. 끼워넣어진 문서의 내용이 바뀌면, 끼워넣은 위치의 내용도 그에 따라 자동으로 바뀝니다.

끼워넣기

아래의 내용은 Includeonly와 onlyinclude의 차이 문서의 내용을 끼워넣은 것입니다.

틀이나 문서의 이름을 중괄호 "{{ }}"로 감싸주면 틀이나 문서의 전체, 또는 일부를 다른 문서에 끼워넣을(Transclude) 수 있습니다. HTML 문법의 iframe(inner frame)과 PHP 문법의 include("문서경로")와 비슷한 기능을 갖습니다. 끼워넣어질 부분을 정하려면 onlyinclude, includeonly, noinclude의 미디어위키 전용 태그를 쓰면 됩니다. 이 세 태그는 모두 속성값은 갖지 않으며, 모두 시작 태그와 마침 태그를 필요로 합니다.

onlyinclude

틀을 사용할 때 끼워넣어질 부분을 정합니다. 이 태그를 사용하지 않으면 기본값으로 문서 전체가 끼워넣어집니다. 세 태그 중에서 가장 빈번하게 쓰이며, 일부러 줄바꿈을 넣을 때 말고는 끼워넣어질 부분의 바로 곁에 붙여주는 것이 좋습니다. 이 영역에 있는 내용은 틀의 내용을 볼 때 같이 보인다.

onlyinclude에 포함되어 있는 내용은 문서 자체를 조회할 때 보인다.⇒ 다른 문서에 끼워넣을 부분들을 보여주는 용도로 사용한다.

includeonly

틀을 다른 문서에 끼워넣을 때에만 나타날 부분을 정합니다. 주로 둘러보기 틀와 같은 특정 분야에 대한 목록 틀을 끼워넣었을 때, 자동적으로 문서를 분류시키는 용도로 자주 쓰입니다. 이 부분은 틀을 조회할 때 설명 부분에 포함되지 않는다.

includeonly 부분은 문서 자체를 조회할 때 보이지 않는다. ⇒ 일반적으로 틀 문서를 만들 때 parse 펑크션 부분 등을 이것으로 처리하면 문서 조회할 때 불필요한 문법들이 보이지 않으므로 조회를 깔끔하게 할 수 있다.

noinclude

끼워넣기를 할 때, 포함되지 않을 부분을 정하며, 주로 틀 자체의 분류와 인터위키에 쓰입니다. 포함될 부분만 onlyinclude로 지정하여, 의도되지 않은 줄바꿈으로 인해 레이아웃이 깨지는 현상을 막는 것이 좋습니다. 또한 틀에 onlyinclude가 쓰이지 않으면 인터위키를 갱신하는 봇이 문서를 망가뜨리게 됩니다. 따라서 이 태그는 가급적 쓰지 말 것을 권장합니다.

문서 풀어넣기

문서 풀어넣기는 풀기: 를 이용해 문서의 내용을 직접 끼워 넣는 방법입니다. 사용법은, 원래 끼워넣기 문법에서 {{ 다음에 풀기: 또는 subst: 를 넣으면 됩니다.

• {{풀기::고양이}}
• {{풀기:생물 분류}}
• {{풀기:위키백과:길라잡이}}

이와 같은 문법을 사용하여 저장한 이후, 나중에 다시 문서의 소스를 보면 끼워넣기 문법과는 다르게 풀기 문법은 사라져 있고 그 자리에 문서의 원래 내용이 그대로 복사되어 들어가 있습니다. 그러므로,

• 대체된 문서의 내용이 바뀌어도, 끼워넣은 위치의 내용에는 영향을 주지 않습니다.
• 문서가 이미 복사되어 들어가 있으므로, 문서의 원래 내용을 자동으로 가져올 필요가 없습니다. 따라서 서버의 부하를 줄여줄 수 있습니다.
• 넘겨주기 문서라면 넘겨받은 문서의 내용이 출력됩니다.