도움말:위키 문법/4단계: 두 판 사이의 차이

2025년 2월 16일 (일) 15:33 기준 최신판

가온 위키 프로젝트
이 문서는 가온 위키 프로젝트를 설명하는 문서입니다.

위키를 시작하는데 도움이 되는 정보를 얻을 수 있습니다. 빠르게 위키를 배우고 싶다면 위키 도움이 틀을 찾아가세요!
위키 도움이

위키 문법
기초			중급				심화				기타
1단계	→	2단계	→	3단계	→	4단계	→	5단계	→	심화	/	이런 것도 있다고요

4단계: 템플릿과 파서 함수[원본 편집]

템플릿과 파서 함수를 사용하면 문서를 더욱 동적이고 효율적으로 관리할 수 있습니다. 이 단계에서는 템플릿의 기본 사용법부터 고급 파서 함수까지 다룹니다.

1. 템플릿 기본[원본 편집]

템플릿 호출[원본 편집]

템플릿은 미리 정의된 내용을 여러 문서에서 재사용할 수 있게 해주는 기능입니다.

기본 문법:

{{템플릿명}}

예시:

틀:환영 - 새 사용자 환영 메시지 표시

인용할 문장을 입력해 주세요.

- 인용구 서식 적용

매개변수 사용[원본 편집]

템플릿에 값을 전달하여 더 유연하게 사용할 수 있습니다.

순서 기반 매개변수[원본 편집]

{{템플릿명|첫번째값|두번째값|세번째값}}

예시:

작성자

이름 지정 매개변수[원본 편집]

{{템플릿명|매개변수1=값1|매개변수2=값2}}

예시:

틀:책 정보

2. 파서 함수[원본 편집]

조건문 (if)[원본 편집]

조건에 따라 다른 내용을 표시할 수 있습니다.

기본 문법:

{{#if: 조건
| 조건이 참일 때 표시할 내용
| 조건이 거짓일 때 표시할 내용
}}

예시:

{{#if: {{PAGENAME}}
| 현재 문서 제목: {{PAGENAME}}
| 문서 제목을 찾을 수 없습니다
}}

선택문 (switch)[원본 편집]

여러 조건에 따른 분기 처리가 가능합니다.

기본 문법:

{{#switch: 비교할값
| 값1 = 결과1
| 값2 = 결과2
| #default = 기본결과
}}

예시:

{{#switch: {{CURRENTDAYNAME}}
| 월요일 = 새로운 한 주의 시작입니다
| 금요일 = 즐거운 주말 시작!
| #default = 평일입니다
}}

3. Magic Words[원본 편집]

기본 변수[원본 편집]

시스템에서 제공하는 특별한 변수들입니다.

주요 Magic Words:

18:46 - 현재 시간
틀:CURRENTDATE - 현재 날짜
2025 - 현재 연도
위키 문법/4단계 - 현재 문서 이름
도움말:위키 문법/4단계 - 전체 문서 경로
도움말 - 현재 이름공간

날짜/시간 관련 변수[원본 편집]

금요일 - 현재 요일
6월 - 현재 월
20250627184643 - 현재 타임스탬프

4. 고급 템플릿 기법[원본 편집]

중첩 템플릿[원본 편집]

템플릿 안에 다른 템플릿을 포함할 수 있습니다.

{{템플릿1|매개변수={{템플릿2|값}}}}

템플릿 변수[원본 편집]

템플릿 내에서 지역 변수를 사용할 수 있습니다.

{{{변수명|기본값}}}

주의사항[원본 편집]

템플릿을 과도하게 중첩하면 성능이 저하될 수 있습니다.
파서 함수의 조건문에서는 빈 문자열이 거짓으로 처리됩니다.
Magic Words는 대소문자를 구분합니다.
템플릿 매개변수 전달 시 공백에 주의해야 합니다.

연습하기[원본 편집]

연습장에서 다음 작업을 연습해보세요:

간단한 템플릿 만들기
조건문을 사용한 내용 분기
Magic Words를 활용한 동적 정보 표시
중첩 템플릿 사용하기

@@ 1번째 줄: / 1번째 줄: @@
-{{틀:위키프로젝트}}<br/>
+{{틀:위키프로젝트}}
-{{틀:위키도움이}}<br/>
+{{틀:위키도움이}}
 {{틀:위키 문법 단계}}
-==이 단계의 목표==
+== 4단계: 템플릿과 파서 함수 ==
-# 문서 토론을 할 수 있다.
+템플릿과 파서 함수를 사용하면 문서를 더욱 동적이고 효율적으로 관리할 수 있습니다. 이 단계에서는 템플릿의 기본 사용법부터 고급 파서 함수까지 다룹니다.
-# 각주를 만들 수 있다.
-# 분류 기능을 활용 할 수 있다.
-==문서 토론==
+== 1. 템플릿 기본 ==
-# 문서를 편집하다보면, 자신의 의견과 다른 내용이 적혀져 있을 수 있습니다.
+=== 템플릿 호출 ===
-# 또는 다른 사람들의 의견을 수렴해서 반영해야 하는 경우(예: 문서 명 등)도 있을 수 있습니다.
+템플릿은 미리 정의된 내용을 여러 문서에서 재사용할 수 있게 해주는 기능입니다.
-# 이럴때에는 '''문서 토론'''을 하면 됩니다.
-===토론 개최 방법===
+기본 문법:
-# [https://bbs.gaonwiki.com/debate 가온 위키 커뮤니티 - 토론 게시판]으로 이동합니다.
+<pre>
-# 로그인을 한 상태(가온 위키 커뮤니티 계정이 없는 경우, 회원가입을 합니다.<ref>가온 위키와 회원 목록이 연동되지 않습니다. 따라서 회원가입을 해야 합니다. 닉네임은 왠만하면 가온 위키와 동일하게 만들어 주세요.</ref>)에서, <i class="fa fa-pencil" style="color:blue;">쓰기</i> 버튼을 눌러주세요.
+{{템플릿명}}
-# 게시물의 제목에는 아래와 같은 형식으로 작성해 주세요.
+</pre>
-## 토론 : 문서명 - 토론 개최 이유 간략히
-# 예를 들어 이렇게 하면 됩니다.
-## 토론 : ABC - 의견 모음
-# 내용 칸에는 근거를 갖추어 작성하시면 됩니다.
-# 또한 해당 문서 또는 문단의 최상단 부분에 <nowiki>{{틀:문서 토론 중}}</nowiki> 이렇게 틀과 토론 페이지의 URL을 입력하면 됩니다.
-===토론 참여 방법===
+예시:
-# 개최된 토론에 참여하는 방법을 알려드립니다.
+* {{환영}} - 새 사용자 환영 메시지 표시
-# [https://bbs.gaonwiki.com/debate 가온 위키 커뮤니티 - 토론 게시판]으로 이동합니다.
+* {{인용}} - 인용구 서식 적용
-# 참여하고 싶은 토론 페이지로 이동합니다.
-# 해당 글 밑에 있는 댓글을 통해 의견을 서로 주고받습니다.
-===토론 종료===
+=== 매개변수 사용 ===
-# 토론이 종료된 경우, 해당 문서/문단에 있던 <nowiki>{{틀:문서 토론 중}}</nowiki> 틀을 제거하고, 요약된 토론 결과 내용과 토론 페이지 URL을 입력해 주세요.
+템플릿에 값을 전달하여 더 유연하게 사용할 수 있습니다.
-# 토론에 이의가 있는 경우, 다시 열 수 있으나, 타당한 근거 없이는 열 수 없습니다.
-==각주==
+==== 순서 기반 매개변수 ====
+<pre>
+{{템플릿명|첫번째값|두번째값|세번째값}}
+</pre>
+예시:
+* {{인용|작성자|내용|출처}}
+==== 이름 지정 매개변수 ====
+<pre>
+{{템플릿명|매개변수1=값1|매개변수2=값2}}
+</pre>
+예시:
+* {{책 정보|제목=위키의 이해|저자=홍길동|출판년도=2024}}
+== 2. 파서 함수 ==
+=== 조건문 (if) ===
+조건에 따라 다른 내용을 표시할 수 있습니다.
+기본 문법:
+<pre>
+{{#if: 조건
+| 조건이 참일 때 표시할 내용
+| 조건이 거짓일 때 표시할 내용
+}}
+</pre>
+예시:
+<pre>
+{{#if: {{PAGENAME}}
+| 현재 문서 제목: {{PAGENAME}}
+| 문서 제목을 찾을 수 없습니다
+}}
+</pre>
+=== 선택문 (switch) ===
+여러 조건에 따른 분기 처리가 가능합니다.
+기본 문법:
+<pre>
+{{#switch: 비교할값
+| 값1 = 결과1
+| 값2 = 결과2
+| #default = 기본결과
+}}
+</pre>
+예시:
+<pre>
+{{#switch: {{CURRENTDAYNAME}}
+| 월요일 = 새로운 한 주의 시작입니다
+| 금요일 = 즐거운 주말 시작!
+| #default = 평일입니다
+}}
+</pre>
+== 3. Magic Words ==
+=== 기본 변수 ===
+시스템에서 제공하는 특별한 변수들입니다.
+주요 Magic Words:
+* '''{{CURRENTTIME}}''' - 현재 시간
+* '''{{CURRENTDATE}}''' - 현재 날짜
+* '''{{CURRENTYEAR}}''' - 현재 연도
+* '''{{PAGENAME}}''' - 현재 문서 이름
+* '''{{FULLPAGENAME}}''' - 전체 문서 경로
+* '''{{NAMESPACE}}''' - 현재 이름공간
+=== 날짜/시간 관련 변수 ===
+* '''{{CURRENTDAYNAME}}''' - 현재 요일
+* '''{{CURRENTMONTHNAME}}''' - 현재 월
+* '''{{CURRENTTIMESTAMP}}''' - 현재 타임스탬프
+== 4. 고급 템플릿 기법 ==
+=== 중첩 템플릿 ===
+템플릿 안에 다른 템플릿을 포함할 수 있습니다.
+<pre>
+{{템플릿1|매개변수={{템플릿2|값}}}}
+</pre>
+=== 템플릿 변수 ===
+템플릿 내에서 지역 변수를 사용할 수 있습니다.
+<pre>
+{{{변수명|기본값}}}
+</pre>
+== 주의사항 ==
+* 템플릿을 과도하게 중첩하면 성능이 저하될 수 있습니다.
+* 파서 함수의 조건문에서는 빈 문자열이 거짓으로 처리됩니다.
+* Magic Words는 대소문자를 구분합니다.
+* 템플릿 매개변수 전달 시 공백에 주의해야 합니다.
+== 연습하기 ==
+[[가온 위키:연습장|연습장]]에서 다음 작업을 연습해보세요:
+* 간단한 템플릿 만들기
+* 조건문을 사용한 내용 분기
+* Magic Words를 활용한 동적 정보 표시
+* 중첩 템플릿 사용하기