도움말:위키 문법/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:

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

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

목요일 - 현재 요일
6월 - 현재 월
20250626173628 - 현재 타임스탬프

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

중첩 템플릿[원본 편집]

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

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

템플릿 변수[원본 편집]

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

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

주의사항[원본 편집]

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

연습하기[원본 편집]

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

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

@@ 1번째 줄: / 1번째 줄: @@
-{{틀:위키프로젝트}}<br/>
+{{틀:위키프로젝트}}
-{{틀:위키도움이}}<br/>
+{{틀:위키도움이}}
 {{틀:위키 문법 단계}}
-==이 단계의 목표==
+== 4단계: 템플릿과 파서 함수 ==
-* 문서 토론을 할 수 있다.
+템플릿과 파서 함수를 사용하면 문서를 더욱 동적이고 효율적으로 관리할 수 있습니다. 이 단계에서는 템플릿의 기본 사용법부터 고급 파서 함수까지 다룹니다.
-* 각주를 만들 수 있다.
-* 분류 기능을 활용 할 수 있다.
-==문서 토론==
+== 1. 템플릿 기본 ==
-문서를 편집하다보면, 자신의 의견과 다른 내용이 적혀져 있을 수 있습니다. 또는 다른 사람들의 의견을 수렴해서 반영해야 하는 경우(예: 문서 명 등)도 있을 수 있습니다. 이럴때에는 '''문서 토론'''을 하면 됩니다. 문서 토론을 통해 더 나은 문서 작성을 해봅시다!
+=== 템플릿 호출 ===
+템플릿은 미리 정의된 내용을 여러 문서에서 재사용할 수 있게 해주는 기능입니다.
-===토론 개최 방법===
+기본 문법:
-[https://bbs.gaonwiki.com/debate 가온 위키 커뮤니티 - 토론 게시판]으로 이동합니다. 로그인을 한 상태에서, <i class="fa fa-pencil" style="color:blue;">쓰기</i> 버튼을 눌러주세요. 게시물의 제목에는 아래와 같은 형식으로 작성해 주세요.
+<pre>
-* 토론 : 문서명 - 토론 개최 이유 간략히
+{{템플릿명}}
+</pre>
-예를 들어 이렇게 하면 됩니다.
+예시:
-* 토론 : ABC - 의견 모음
+* {{환영}} - 새 사용자 환영 메시지 표시
+* {{인용}} - 인용구 서식 적용
-분류에는 토론 중을 선택하고, 내용 칸에는 근거를 갖추어 작성하시면 됩니다. 또한 해당 문서 또는 문단의 최상단 부분에 <nowiki>{{틀:문서 토론 중}}</nowiki> 이렇게 틀과 토론 페이지의 URL을 입력하면 됩니다.
+=== 매개변수 사용 ===
+템플릿에 값을 전달하여 더 유연하게 사용할 수 있습니다.
-===토론 참여 방법===
+==== 순서 기반 매개변수 ====
-[https://bbs.gaonwiki.com/debate 가온 위키 커뮤니티 - 토론 게시판]으로 이동합니다. 이후, 참여하고 싶은 토론 페이지로 이동합니다. 해당 글 밑에 있는 댓글을 통해 의견을 서로 주고받으면 됩니다.
+<pre>
+{{템플릿명|첫번째값|두번째값|세번째값}}
+</pre>
-===토론 종료===
+예시:
-토론이 종료된 경우, 해당 문서/문단에 있던 <nowiki>{{틀:문서 토론 중}}</nowiki> 틀을 제거하고, 요약된 토론 결과 내용과 토론 페이지 URL을 입력해 주세요. 토론이 끝난 뒤에 토론에 이의가 있는 경우, 다시 열 수 있습니다. 이때에는 [[#토론 개최 방법|토론 개최 방법]]에 따라 열되, 제목 앞부분에 <big><code>[재개최]</code></big>를 붙이고, 분류는 재개최를 선택하며, 게시글 최상단에 전 토론의 URL과 토론을 다시 연 이유에 대해 작성하면 됩니다.
+* {{인용|작성자|내용|출처}}
-토론은 자유롭게 열 수 있지만, 타당한 근거 없이 토론을 개최할 수는 없습니다. 근거 없이 토론을 개최할 경우, 강제로 폐쇄 될 수 있습니다.
+==== 이름 지정 매개변수 ====
+<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를 활용한 동적 정보 표시
+* 중첩 템플릿 사용하기