이 도움말에서는 틀의 "사용법"을 안내합니다. 틀의 "제작법"에 대한 내용은 제이위키/유저가이드/고급문법 문서의 고급틀 제작 문단을 참고하십시오.

이 문서는 제이위키의 도움말입니다.

이 문서는 제이위키 초보자를 위한 문서로, 훌륭한 기여자 분들의 기여를 언제나 기다립니다.

제이위키는 미디어위키 기반의 위키 중에도 문법에 뛰어난 사용자들의 훌륭한 기여 덕분에 여러 가지 복잡한 문법을 단순한 틀로 사용할 수 있습니다. 이 도움말에서는 틀의 사용법과 편집에 유용한 일부 틀들에 대해 안내합니다.

틀이란?

틀(template)은 다른 문서에 끼워넣어지기 위해 만들어지는 특수 문서를 말합니다. 예를 들어 틀:abc라는 제목의 틀 문서를 이 문서에 사용하면 틀:abc에 작성된 내용이 이 문서에 나타나게 됩니다. 틀:abc의 문법 자체를 그대로 복사해 가져오는 것이 아니라 iframe처럼 문서 자체를 삽입하는 쪽에 가깝기 때문에, 끼워넣기된 틀의 내용을 수정하고자 한다면 틀:abc로 직접 가서 내용을 수정해야 합니다.

{{스포일러}}처럼 끼워넣기 할 때 틀의 내용을 임의로 수정할 수 없는 틀이 있는 반면, {{나무위키 국가 정보}}처럼 틀에 들어갈 내용을 사용자가 완전히 새롭게 입력할 수 있는 틀도 있습니다. 후자의 틀을 제이위키에서는 보급형 틀이라고 칭하며, 인정단체 에른스트의 아무튼 공방을 중심으로 일부 뛰어난 사용자들에 의해 제작·배포되고 있습니다.

틀 사용법

가장 기본적인 틀의 사용법은 두 쌍의 중괄호 안에 틀의 제목을 넣는 것입니다. 만약 틀:스포일러를 넣고 싶다면 {{스포일러}}처럼 입력합니다. 그러면 입력한 곳에 스포일러 틀의 내용이 삽입될 것입니다.

문법 결과
{{스포일러}}
이 문서에 스포일러가 포함되어 있습니다.

이 문서가 설명하는 작품이나 인물 등에 대한 줄거리, 결말, 반전 요소 등을 직·간접적으로 포함하고 있습니다.

또한 틀:이라는 이름공간[1]을 가진 문서가 다른 틀 문서로 넘겨주기될 때, 이 넘겨주기 제목으로도 기존 틀을 사용할 수 있습니다.

예를 들어 틀:공방틀:공방 (구)로 넘겨주기되지만, {{공방}}으로 입력해도 틀:공방 (구)의 내용이 나타납니다.

문법 결과
{{공방}}
{{공방 (구)}}

매개변수 사용하기

매개변수란 틀 제작자가 틀을 다른 문서에 끼워넣기 할 때 사용자가 틀의 내용을 임의로 바꿀 수 있도록 설정한 값을 말합니다.

틀 문서에서 매개변수는 세 쌍의 중괄호로 표현됩니다. 이 안에는 변수의 순서 또는 이름이 들어갑니다. 중괄호 안에 숫자가 들어가면 변수의 순서를 의미하고, 숫자가 아닌 문자열이 들어가면 변수의 이름을 의미합니다.

본격적으로 틀을 끼워넣기 할 때 변수는 틀 이름 뒤에 파이프 문자(|)[2]를 통해 사용할 수 있습니다.

  • 순서 변수인 경우, 파이프 문자 뒤에는 변수에 들어갈 값을 바로 입력합니다.예를 들어 틀:예시 틀의 내용이 이 틀은 {{{1}}}을 갖습니다.라고 해 봅시다. 이 틀을 다른 문서에 끼워넣기 위해 {{예시}}만 입력한다면 바로 앞서 작성한 문장이 중괄호와 숫자 그대로 출력될 것입니다.그러나 변수의 값을 입력하기 위해 파이프 문자를 넣어 {{예시|샘플}}처럼 입력한다면 끼워넣기된 문서에는 이 틀은 샘플을 갖습니다.처럼 출력될 것입니다.
  • 이름 변수인 경우도 순서 변수와 크게 다르지는 않습니다. 다만 이름 변수는 틀을 제작할 때 변수의 이름으로 정해진 문자열을 끼워넣기 할 때도 입력해 주어야 합니다.예시를 바로 위의 순서 변수와 같이 설정하되, 틀의 내용이 이 틀은 {{{변수}}}을 갖습니다.라고 해 봅시다. 이때는 {{예시|샘플}}로 입력하면 원하는 대로 출력되지 않고, {{예시|변수=샘플}}처럼 사용할 변수가 "변수"라는 이름을 가지고 있음을 정확히 선언해 주어야 합니다. 변수의 이름 뒤에 등호를 넣고, 이 등호 뒤에 본격적으로 변수의 내용이 될 것을 작성하면 됩니다.

복잡한 변수를 다수 사용하는 틀이라면 대부분은 제작자가 친절하게 틀의 사용법이나 템플릿을 안내해 줄 것입니다. 겁내지 마시고 먼저 이것저것 시도해 보세요.

각주

  1. 어떤 문서의 제목이 ○○:으로 시작할 때, 콜론 앞의 문자열을 이름공간이라고 합니다. 예를 들어 제이위키:감사합니다라는 문서의 이름공간은 "제이위키"입니다.
  2. 표 문법에 사용하는 세로 막대 문자가 맞습니다. 키보드 상으로 닫는 중괄호/대괄호 옆의 역슬래시를 쉬프트를 누른 채 입력합니다.