Includeonly와 onlyinclude의 차이

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

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

onlyinclude

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

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

includeonly

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

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

noinclude

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