도움말:틀 만들기

{{틀}}이란 여러 곳에서 반복하여 사용되는 내용을 별도의 독립 문서로 저장한 뒤, 필요한 곳에서 불러와 사용하는 내용을 말합니다. 위키에는 다양한 {{틀}}이 있으므로('도움말:틀' 참조) 필요한 경우 불러와서 사용할 수 있습니다. 여기서는 이러한 {{틀}}을 직접 만드는 방법을 설명합니다.

{{틀}} 만들기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!

가장 간단한 틀을 만들어 보겠습니다. 틀을 사용하려면 최소 2개의 문서가 필요합니다. 하나는 틀을 저장하는 문서이고, 다른 하나는 저장된 틀을 불러와서 사용하는 문서입니다. 틀을 저장하는 문서 만들기 안녕하세요? 반갑습니다. '틀:안녕'이라는 문서를 만들어 보겠습니다. 일반 문서와 달리 틀 문서는 시작 부분이 반드시 "틀: ..."로 시작해야 합니다. 검색창에서 "틀:안녕"이라고 입력하여 "가기" 버튼을 누르면 아직 해당 틀이 없기 때문에 틀:안녕이라고 빨강색으로 표시됩니다. 이 빨강색 글자를 클릭하여 틀 문서를 생성할 수 있습니다. 새 문서에 "안녕하세요? 반갑습니다."라고 쓴 뒤 저장해 주세요. 틀 만들기가 완성되었습니다. 틀을 불러오는 문서 만들기 {{안녕}} 틀을 사용하려면 틀을 불러오는 문서가 필요합니다. '테스트1'이라는 새 문서를 생성해 주세요. 그리고 내용에 {{안녕}}이라고 입력하고 저장해 주세요. 문서에서 틀을 불러오려면 앞뒤로 이중 괄호({{ ... }})를 해야 합니다. 저장하고 나면, {{안녕}}이라고 쓴 부분이 "안녕하세요? 반갑습니다."라는 문구로 치환되어서 표시됩니다. 이와 같이 틀을 사용하려면 원하는 위치에 이중 괄호가 포함된 {{틀 이름}}을 적어주면 됩니다.

{{틀}}에 변수 사용하기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!

{{틀}}에 변수를 사용할 수 있습니다. 그러면 변수로 넘겨준 값을 읽어와 틀에서 정해진 방식으로 처리하여 결과값을 보여줍니다. 변수가 포함된 틀 만들기 안녕하세요? 제 이름은 {{{1}}}입니다. '틀:이름' 문서를 새로 만들고 "안녕하세요? 제 이름은 {{{1}}}입니다."라고 입력하고 저장해 주세요. 여기서 {{{1}}}이란 1번 변수에 해당하는 값을 표시해 주라는 뜻입니다. 1이라는 숫자 앞뒤로 괄호 3개({{{ ... }}})를 써 줍니다. 틀 이름에는 괄호 2개를 쓰지만 변수에는 괄호 3개를 씁니다. 변수가 포함된 틀 사용하기 {{이름|홍길동}} 틀을 불러오기 위해 '테스트2'라는 새 문서를 만들고 그 안에 {{이름|홍길동}}이라고 쓰고 저장해 주세요. 여기서 '이름'이 새로 만드려는 틀의 이름이고, '홍길동'이 변수에 해당합니다. 이 문서를 미리보기하거나 저장하면, "안녕하세요? 제 이름은 홍길동입니다."와 같이 표시됩니다. 1번 변수가 사용된 부분이 "홍길동"이라는 문자로 치환되어서 표시됩니다. 만약 '테스트2' 문서를 수정하여 {{이름|김한국}}이라고 쓰면, {{{1}}}번 변수의 값이 "김한국"으로 치환되어, "안녕하세요? 제 이름은 김한국입니다."와 같이 표시됩니다.

틀에 여러 변수 사용하기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!

하나의 {{틀}}에는 여러 개의 변수를 사용할 수 있습니다. 여러 변수가 포함된 틀 만들기 안녕하세요? 제 이름은 {{{1}}}이고, 성별은 {{{2}}}이며, 나이는 {{{3}}}세입니다. '틀:자기 소개' 문서를 새로 만들고 위와 같이 "안녕하세요? 제 이름은 {{{1}}}이고, 성별은 {{{2}}}이며, 나이는 {{{3}}}세입니다."라고 입력하고 저장해 주세요. 여기서 {{{1}}}은 1번 변수, {{{2}}}는 2번 변수, {{{3}}}은 3번 변수에 해당하는 값을 표시해 주라는 뜻입니다. 여러 변수가 포함된 틀 사용하기 {{자기 소개|홍길동|남성|23}} 틀을 불러오기 위해 새로 '테스트3' 문서를 만들거나 혹은 위에서 만들었던 '테스트1' 또는 '테스트2' 문서의 원하는 위치에 {{자기 소개|홍길동|남성|23}}이라고 입력해 주세요. 이 문서를 미리보기하거나 저장하면, "안녕하세요? 제 이름은 홍길동이고, 성별은 남성이며, 나이는 23세입니다."와 같이 표시됩니다. 만약 {{자기 소개|김보라|여성|21}}이라고 쓰면, "안녕하세요? 제 이름은 김보라이고, 성별은 여성이며, 나이는 21세입니다."와 같이 표시됩니다.

틀에 변수 이름 지정하기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!

{{틀}}에 사용되는 변수는 {{{1}}}, {{{2}}}, {{{3}}}, {{{4}}}, {{{5}}}, ...처럼 아라비아 숫자로만 표시할 수 있는 것은 아닙니다. 순서와 상관없이 변수에 이름을 부여하고, 그 이름에 맞는 변수 값을 불러와서 사용할 수 있습니다. 변수 이름이 지정된 틀 만들기 안녕하세요? 제 이름은 {{{성명}}}이고, 성별은 {{{성별}}}이며, 나이는 {{{연령}}}세이고, 사는 곳은 {{{거주지}}}입니다. '틀:자기 소개2'라는 문서를 새로 만들고 위와 같이 입력하고 저장해 주세요. 여기서 {{{성명}}}, {{{성별}}}, {{{연령}}}, {{{거주지}}} 등은 변수입니다. 위에서 아라비아 숫자로 연속하여 변수명을 붙인 것과 달리 이번에는 변수에 이름을 지정하여 순서에 상관없이 작동하도록 하였습니다. 변수 이름이 지정된 틀 사용하기 {{자기 소개2|성명=홍길동|연령=23|성별=남성|거주지=서울}} 틀을 불러오기 위해 위에서 만들었던 '테스트1'이나 '테스트2' 또는 '테스트3' 등 테스트 문서의 원하는 위치에 {{자기 소개2|성명=홍길동|연령=23|성별=남성|거주지=서울}}이라고 입력해 주세요. 이 문서를 미리보기하거나 저장하면, "안녕하세요? 제 이름은 홍길동이고, 성별은 남성이며, 나이는 23세이고, 사는 곳은 서울입니다."와 같이 표시됩니다. 여기서 중요한 점은 변수의 위치를 마음대로 바꾸더라도 변수의 이름에 의해 값이 제대로 표시된다는 사실입니다. 예를 들어 {{자기 소개2|성별=남성|연령=23|성명=홍길동|거주지=서울}}과 같이 변수의 순서를 옮기더라도 결과는 위와 동일하게 표시됩니다. 이와 같이 틀에서 변수 이름을 지정할 경우, 변수를 사용하는 순서에 영향을 받지 않습니다.

조건부 틀 만들기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!
위에서 가장 기초적인 틀 만들기 방법을 설명하였습니다. 만약 if 조건절을 사용한다면, 주어진 상황에 맞게 조건부로 작동하는 틀을 만들 수 있습니다. 도움말:if : 조건부로 작동하는 {{틀}}에 대한 자세한 내용은 도움말:if를 참조해 주세요.

틀에 설명 달기

이 글을 숨기려면 오른쪽 '접기' 버튼을 누르세요!

틀 문서는 복잡한 경우가 많기 때문에 별도의 설명을 달아주는 것이 좋습니다. 틀에 설명을 달기 위해 <noinclude>...</noinclude> 명령어를 사용합니다. <onlyinclude>틀 부분</onlyinclude> <noinclude> == 설명 == 틀에 대한 설명 내용 </noinclude> 위와 같이 틀 부분의 맨 앞과 맨 뒤에 <onlyinclude>...</onlyinclude>를 사용하여 감싸줍니다. 그러면 이렇게 <onlyinclude>로 감싼 부분만 틀로 작동하고 나머지 부분은 틀에 영향을 미치지 않습니다. 틀에 대한 설명 부분은 <noinclude>...</noinclude>를 사용하여 감싸줍니다. 그러면 이렇게 <noinclude>로 감싼 부분은 틀이 작동하는데 아무런 영향을 미치지 않습니다. 틀 문서 자체에서는 작동하지 않지만, 이 틀을 불러서 사용하는 다른 문서에서는 작동하도록 하는 부분이 있다면, <includeonly>...</includeonly>를 사용하여 감싸줍니다. 이상 3가지 태그를 정리하여 설명하면 다음과 같습니다. <onlyinclude> : 이 태그로 감싼 부분만 해당 문서에서 불러와 사용합니다. 해당 문서와 틀 문서 모두에서 작동합니다. <noinclude> : 이 태그로 감싼 부분은 해당 문서에서 불러오지 않습니다. 틀 문서에서만 작동합니다. <includeonly> : 이 태그로 감싼 부분은 해당 문서에서는 불러와 사용하지만 틀 문서 자체에서는 작동하지 않고 무시합니다.

같이 보기

• 도움말:틀
• 도움말:if

참고자료

• "위키백과:틀" - 위키백과

일반 : 자연, 생물, 동물, 식물, 정치, 군사, 경제, 사회, 교육, 문화, 예술, 스포츠, 역사, 역사인물, 인간, 인체, 건강, 정신, 성격, 행동, 언어, 수학, 위키 도움말 □■⊕ 문서 편집 문서 수정 • 기록 • 문서 구성 • 위키문법 • 새 문서 • 표제어 • 넘겨주기 • 메모 • 출처 • 다단 • 한글 • 특수문자 • 태그 • 글자색 • 테두리 • 표 • 행사 멀티미디어 사진 • 동영상 • 로고 • 인물사진 • 블록 • 로고블록 • 이미지블록 • 발음 • 이름 • 지도 • 파일 • 수학 • 바둑 문서 관리 문서 관리 • 동음이의어 • 문서 이동 • 상호 링크 • 같이 보기 상자 • 위키 고급 문법 틀 틀 • 특수문자 틀 • 위키 아이콘 • 틀 만들기 • if • switch • 변수 • 계산 지도 지도 • 행정 지도 • 특:버전 저작권 저작권 • 저작권 있음 • 저작권 없음 • 업무상 저작물 • 크리에이티브 커먼즈 • 회사 사용권 • 1회 사용권 사용자 사용자 • 회원 • 차단 위키 : 자동차, 교통, 지역, 지도, 산업, 기업, 단체, 업무, 생활, 쇼핑, 블록체인, 암호화폐, 인공지능, 개발, 인물, 행사, 일반