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

2025년 2월 16일 (일) 14:50 기준 최신판

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

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

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

1단계 문법을 기반으로 더 다양한 기능을 사용하는 방법을 설명합니다. 이 문서에서 다루는 문법들은 문서를 더 풍부하고 체계적으로 만드는 데 도움이 됩니다.

1. 파일과 이미지[원본 편집]

이미지나 다른 파일을 문서에 삽입할 수 있습니다.

기본 문법[원본 편집]

[[파일:파일명.확장자|옵션]]

자주 사용하는 옵션[원본 편집]

thumb - 섬네일 형식으로 표시
right, left, center - 정렬 방식
300px - 크기 지정 (숫자는 변경 가능)
설명글 - 이미지 아래에 표시될 설명

입력 예시:

[[파일:예시이미지.jpg|thumb|300px|right|이미지 설명]]
[[파일:문서.pdf|문서 다운로드]]

팁: 여러 옵션을 동시에 사용할 때는 파이프(|)로 구분합니다.

2. 표 만들기[원본 편집]

표를 만들어 정보를 체계적으로 정리할 수 있습니다.

기본 표 구조[원본 편집]

{| class="wikitable"
|+ 표 제목
! 열 제목 1 !! 열 제목 2
|-
| 내용 1 || 내용 2
|-
| 내용 3 || 내용 4
|}

결과:

표 제목
열 제목 1	열 제목 2
내용 1	내용 2
내용 3	내용 4

표 요소 설명[원본 편집]

{| - 표 시작
|+ - 표 제목 (선택사항)
! - 열 제목 (머리글)
|- - 새로운 행
| - 일반 셀
|| - 같은 행의 다음 셀
|} - 표 끝

셀 속성 지정[원본 편집]

{| class="wikitable"
! style="background-color: #ffeb3b;" | 노란 배경
| style="text-align: center;" | 가운데 정렬
|}

팁: class="wikitable"를 추가하면 기본 테두리와 스타일이 적용됩니다.

3. 템플릿 사용[원본 편집]

자주 사용하는 내용을 템플릿으로 만들어 재사용할 수 있습니다.

기본 호출[원본 편집]

{{템플릿이름}}

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

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

예시:

날짜 템플릿: 2025년 1월 1일
정보상자:

4. 분류 지정[원본 편집]

문서를 특정 주제별로 분류하여 관리할 수 있습니다.

기본 분류[원본 편집]

[[분류:주제명]]

다중 분류[원본 편집]

[[분류:프로그래밍]]
[[분류:도움말]]
[[분류:위키 문법]]

팁: 분류는 보통 문서의 맨 아래에 넣습니다.

5. 주석 사용[원본 편집]

편집할 때만 보이는 설명을 추가할 수 있습니다.

HTML 주석[원본 편집]

<!-- 이 부분은 문서에 표시되지 않습니다 -->

긴 주석 예시[원본 편집]

<!--
여러 줄의
주석을
작성할 수 있습니다
-->

6. HTML 태그 활용[원본 편집]

기본적인 HTML 태그를 사용하여 추가 서식을 적용할 수 있습니다.

자주 사용하는 태그[원본 편집]

<div> - 블록 레벨 요소
<span> - 인라인 요소
<blockquote> - 인용문
<code> - 코드 표시
<sub> - 아래 첨자
<sup> - 위 첨자

입력 예시:

<div style="background-color: #f0f0f0; padding: 10px;">
박스 안의 내용입니다.
</div>

<blockquote>
인용된 텍스트입니다.
</blockquote>

H<sub>2</sub>O는 물의 화학식입니다.

결과:

박스 안의 내용입니다.

인용된 텍스트입니다.

H₂O는 물의 화학식입니다.

주의사항[원본 편집]

HTML 태그는 보안상의 이유로 일부만 허용됩니다.
기본적으로 위키 문서 수정 시에는 HTML 태그 사용이 아닌, 기본 미디어위키 문법만을 사용하는 것을 권장합니다.
복잡한 표는 단계적으로 만들면서 결과를 확인하는 것이 좋습니다.
템플릿을 만들 때는 문서에서 직접 테스트해보세요.
파일을 올릴 때는 적절한 라이선스를 확인해야 합니다.

연습하기[원본 편집]

연습장에서 위의 문법들을 실제로 사용해보면서 익숙해지세요. 특히 표 만들기는 처음에는 어려울 수 있으니 차근차근 연습하시기 바랍니다.

@@ 1번째 줄: / 1번째 줄: @@
-{{틀:위키프로젝트}}<br/>
+{{틀:위키프로젝트}}
-{{틀:위키도움이}}<br/>
+{{틀:위키도움이}}
 {{틀:위키 문법 단계}}
-==이 단계의 목표==
+단계 문법을 기반으로 더 다양한 기능을 사용하는 방법을 설명합니다. 이 문서에서 다루는 문법들은 문서를 더 풍부하고 체계적으로 만드는 데 도움이 됩니다.
-# 미디어 자료를 넣을 수 있다.
-# 이미지 파일의 크기를 조절 할 수 있다.
-==이미지==
+== 1. 파일과 이미지 ==
-위키 문서에 이미지를 삽입 할 수 있습니다. 이미지 파일은 직접 업로드 후 불러오는 방법과, [[위키미디어 공용]]에 있는 이미지를 불러오는 방법이 있습니다.
+이미지나 다른 파일을 문서에 삽입할 수 있습니다.
-우리는 이 두가지 방법을 모두 알아보겠습니다.
+=== 기본 문법 ===
+<pre>
+[[파일:파일명.확장자|옵션]]
+</pre>
-===위키미디어 공용에서 불러오기===
+=== 자주 사용하는 옵션 ===
-{{안내문|
+* '''thumb''' - 섬네일 형식으로 표시
-. [[위키미디어 공용]]에 원하는 파일이 있는 경우에만 사용이 가능합니다.<br/>2. svg 버전이 존재하는 경우, svg 파일을 사용해 주세요.}}
+* '''right''', '''left''', '''center''' - 정렬 방식
+* '''300px''' - 크기 지정 (숫자는 변경 가능)
+* '''설명글''' - 이미지 아래에 표시될 설명
-먼저 [https://commons.wikimedia.org 위키미디어 공용] 사이트에 접속합니다. 그 다음 자신이 원하는 파일을 검색합니다. 단어로 검색하면 더욱 정확히 검색 할 수 있습니다.
+입력 예시:
+<pre>
+[[파일:예시이미지.jpg|thumb|300px|right|이미지 설명]]
+[[파일:문서.pdf|문서 다운로드]]
+</pre>
-원하는 이미지를 찾으셨나요? 그러면 그 이미지 페이지로 들어갑니다. 상세 정보가 나오는데, 거기서 '''이 파일 이용하기 (위키용)''' 버튼이 있을 겁니다. 클릭해 주세요.
+'''팁:''' 여러 옵션을 동시에 사용할 때는 파이프(|)로 구분합니다.
-'''위키에서 이 파일 이용하기'''라는 제목의 창이 뜹니다. 두번째 '''이미지:''' 란 문구 밑에 있는 내용 전체를 복사해 주세요.
+== 2. 표 만들기 ==
+표를 만들어 정보를 체계적으로 정리할 수 있습니다.
-마지막으로 넣고 싶은 부분에 이미지를 넣으시면 됩니다. 이렇게요! (가독성을 위해 결과 부분의 이미지의 크기를 줄였습니다.)
+=== 기본 표 구조 ===
+<pre>
 {| class="wikitable"
-| <nowiki>[[File:Kono Subarashii Sekai ni Shukufuku o! logo.svg]]</nowiki> || [[File:Kono Subarashii Sekai ni Shukufuku o! logo.svg|250px]]
+|+ 표 제목
+! 열 제목 1 !! 열 제목 2
 |-
-! align="center" | 입력한 내용 !! align="center" | 결과
+| 내용 1 || 내용 2
+|-
+| 내용 3 || 내용 4
 |}
+</pre>
-===가온 위키에 업로드 후 불러오기===
+결과:
-====업로드하기====
-{{안내문|
-. 위키미디어 공용에 없는 이미지인 경우, 가온 위키에 업로드 후 불러 올 수 있습니다.<br/>2. 이때 업로드 하는 이미지의 라이선스는 다른 라이선스를 사용 할 수 있으며, 업로드시 선택 할 수 있습니다.<br/>3. 이미지를 업로드 하는 경우 저작권 문제에 대해서는 가온 위키에 책임이 없습니다. 확인 후 올려주세요!<br/>4. 중복 파일이 있을 수 있으므로 확인해 주세요.중복 파일은 [[특수:중복된파일목록]]에서 확인이 가능하며, 확장자가 다른 경우 서로 다른 파일로 인식되므로 주의하시길 바랍니다.}}
-[[특수:업로드]] 페이지로 이동해 주세요.
-원본 파일 부분에는 올리고 싶은 이미지 파일을 선택해 주세요. 파일의 새 이름은 위키 내에서 사용할 파일명을 입력해 주세요. 이해하기 쉽게 작성하시면 됩니다.
-요약 부분에는 출처 등을 입력하시면 됩니다. 라이선스 부분에는 해당 이미지의 라이선스를 선택하시면 됩니다. 만약 원하는 라이선스가 존재하지 않는다면, 용약 부분에 라이선스를 입력 후 라이선스 선택 부분은 '''선택하지 않음'''으로 선택하시면 됩니다.
-마지막으로 {{글씨 색|white|lightgreen|파일 올리기}} 버튼을 누르면  업로드는 끝!
-{{안내문|대부분의 이미지는 비자유 저작물이므로 비자유 저작물을 입력하시면 됩니다. 출처 표기 꼭! 해주세요!}}
-====불러오기====
-이미지를 불러오는 방법은 위의 [[도움말:위키 문법/2단계#위키미디어 공용에서 불러오기|위키미디어 공용에서 이미지를 넣는 방법]]이 동일합니다. 업로드한 이미지의 문서 풀 네임을 아래와 같은 방식으로 입력하시면 됩니다.
-<nowiki>[[파일:이런식으로.png]]</nowiki>
-이렇게요! (가독성을 위해 결과 부분의 이미지의 크기를 줄였습니다.)
 {| class="wikitable"
-| <nowiki>[[파일:Gaonwiki kr.png]]</nowiki> || [[파일:Gaonwiki kr.png|250px]]
+|+ 표 제목
+! 열 제목 1 !! 열 제목 2
+|-
+| 내용 1 || 내용 2
 |-
-! align="center" | 입력한 내용 !! align="center" | 결과
+| 내용 3 || 내용 4
 |}
-===이미지 크기 조절===
-이미지 크기를 조절 할 수 있습니다.
-<nowiki>[[파일:이미지.png|원하는 크기 값(숫자)px]]</nowiki> 형식으로 입력하면 됩니다.
+=== 표 요소 설명 ===
+* '''{|''' - 표 시작
+* '''|+''' - 표 제목 (선택사항)
+* '''!''' - 열 제목 (머리글)
+* '''|-''' - 새로운 행
+* '''|''' - 일반 셀
+* '''||''' - 같은 행의 다음 셀
+* '''|}''' - 표 끝
-이렇게요!
+=== 셀 속성 지정 ===
+<pre>
 {| class="wikitable"
-| <nowiki>[[File:Rail Wars logo.png|300px]]</nowiki> || [[File:Rail Wars logo.png|300px]]
+! style="background-color: #ffeb3b;" | 노란 배경
-|-
+| style="text-align: center;" | 가운데 정렬
-! align="center" | 입력한 내용 !! align="center" | 결과
 |}
+</pre>
+'''팁:''' class="wikitable"를 추가하면 기본 테두리와 스타일이 적용됩니다.
-==영상==
+== 3. 템플릿 사용 ==
-위키에 영상도 넣을 수 있습니다. 다만 이미지와 달리 직접 업로드를 할 순 없습니다. 왜냐하면 용량이 부족하기 때문이죠. 그래서 외부 서비스의 힘을 빌릴 수 밖에 없어요.
+자주 사용하는 내용을 템플릿으로 만들어 재사용할 수 있습니다.
-지원하는 서비스는 아래와 같습니다.
+=== 기본 호출 ===
-* 유튜브
+<pre>
-* 비메오
+{{템플릿이름}}
-* 니코니코동화
+</pre>
-* 카카오TV
-* 네이버TV
-* 기타 (기타는 코드만 알려드릴게요.)
-: * Archive.org의 오디오<nowiki><aoaudio> </aoaudio> </nowiki>
-: * Archive.org의 비디오 <nowiki><aovideo> </aovideo> </nowiki>
-: * WeGame의 영상 <nowiki><wegame> </wegame></nowiki>
-: * Tangler forum 영상 <nowiki><tangler> </tangler> </nowiki>
-: * Gametrailers 영상 <nowiki><gtrailer> </gtrailer></nowiki>
-: * GoGreenTube 영상 <nowiki><ggtube> </ggtube></nowiki>
-=== 서비스별 자동 재생 및 썸네일 지원 여부 ===
+=== 매개변수 사용 ===
-서비스별로 "Load video" 버튼을 누르면 바로 재생이 되는 곳도 있고, 되지 않는 곳도 있습니다. 또한 썸네일도 뜨는 곳도 있고, 뜨지 않는 곳도 있습니다. 주요 서비스 별 자동 재생 및 썸네일 지원 여부를 표시합니다.
+<pre>
+{{템플릿이름|매개변수1=값1|매개변수2=값2}}
-{| class="wikitable" style="text-align: center;"
+</pre>
-! 서비스명 !! 자동 재생 지원 !! 썸네일 표시
-|-
-| '''유튜브''' || V || V
-|-
-| '''비메오''' || V || V
-|-
-| '''카카오 TV''' || X || V
-|-
-| '''니코니코동화''' || X || X
-|-
-| '''네이버 TV''' || X || X
-|}
+'''예시:'''
+* '''날짜 템플릿:''' {{날짜/출력|2025-01-01}}
+* '''정보상자:''' {{정보상자|제목=위키 문법|종류=도움말}}
-===유튜브===
+== 4. 분류 지정 ==
-유튜브 영상을 불러오는 방법은 간단합니다. 원하는 유튜브 영상의 URL 주소를 복사합니다.
+문서를 특정 주제별로 분류하여 관리할 수 있습니다.
-그 다음 <nowiki><youtube>유튜브 영상 URL 주소</youtube></nowiki> 이러한 형식으로 입력하면 됩니다.
+=== 기본 분류 ===
+<pre>
+[[분류:주제명]]
+</pre>
-물론 풀 주소 뿐만 아니라 고유 주소<ref><nowiki>https://www.youtube.com/watch?v=</nowiki> 뒷부분, <nowiki>https://youtu.be/</nowiki> 뒷부분</ref>를 입력해도 정상적으로 작동합니다.
+=== 다중 분류 ===
+<pre>
+[[분류:프로그래밍]]
+[[분류:도움말]]
+[[분류:위키 문법]]
+</pre>
-예는 아래와 같습니다.
+'''팁:''' 분류는 보통 문서의 맨 아래에 넣습니다.
-{| class="wikitable"
-| <nowiki><youtube>iBCyYbxYz7M</youtube></nowiki> || <youtube>iBCyYbxYz7M</youtube>
-|-
-! align="center" | 입력한 내용 !! align="center" | 결과
-|}
-===비메오===
+== 5. 주석 사용 ==
-비메오도 '''전체 주소'''와 '''고유 주소''' 모두 사용 할 수 있습니다.
+편집할 때만 보이는 설명을 추가할 수 있습니다.
-<nowiki><vimeo></vimeo></nowiki> 태그를 활용하면 됩니다.
+=== HTML 주석 ===
+<pre>
+<!-- 이 부분은 문서에 표시되지 않습니다 -->
+</pre>
-예는 아래와 같습니다.
+=== 긴 주석 예시 ===
-{| class="wikitable"
+<pre>
-| <nowiki><vimeo>13783187</vimeo></nowiki> || <vimeo>13783187</vimeo>
+<!--
-|-
+여러 줄의
-! align="center" | 입력한 내용 !! align="center" | 결과
+주석을
-|}
+작성할 수 있습니다
+-->
+</pre>
-===카카오 TV(구 티비팟)===
+== 6. HTML 태그 활용 ==
+기본적인 HTML 태그를 사용하여 추가 서식을 적용할 수 있습니다.
-예전에는 '''tvpot'''으로 사용했지만, 카카오tv로 넘어오면서 '''<nowiki><kakaotv></kakaotv></nowiki>'''으로 바뀌었습니다.
+=== 자주 사용하는 태그 ===
-* 고유 ID 값은 채널 값이 아닙니다. '''[https://tv.kakao.com/channel/채널%20값/cliplink/영상%20ID https://tv.kakao.com/channel/채널 값/cliplink/영상 ID]''' 이런 식으로 URL이 있으면, 맨 뒤의 영상 ID만 사용합니다.
+* '''<nowiki><div></nowiki>''' - 블록 레벨 요소
+* '''<nowiki><span></nowiki>''' - 인라인 요소
+* '''<nowiki><blockquote></nowiki>''' - 인용문
+* '''<nowiki><code></nowiki>''' - 코드 표시
+* '''<nowiki><sub></nowiki>''' - 아래 첨자
+* '''<nowiki><sup></nowiki>''' - 위 첨자
-예는 아래와 같습니다.
+입력 예시:
-{| class="wikitable"
+<pre>
-| <nowiki><kakaotv>301955673</kakaotv></nowiki> || <kakaotv>301955673</kakaotv>
+<div style="background-color: #f0f0f0; padding: 10px;">
-|-
+박스 안의 내용입니다.
-! align="center" | 입력한 내용 !! align="center" | 결과
+</div>
-|}
-===니코니코동화===
+<blockquote>
-SSL을 사용하는 가온 위키에서 SSL을 사용하지 않는 니코니코동화(이하 니코동) 영상을 불러 올 수 없었습니다.
+인용된 텍스트입니다.
+</blockquote>
-하지만 패치를 통해 가능하게 되었죠. 패치에 대한 자세한 내용은 [[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!#니코동 영상 가져오기|누가 해결책을 알려주세요!#니코동 영상 가져오기]]에서 확인하시길 바랍니다.
+H<sub>2</sub>O는 물의 화학식입니다.
+</pre>
-니코동의 태그는 <nowiki><niconico></niconico></nowiki>이며, 마찬가지로 전체 주소와 고유 ID값 모두 사용이 가능합니다.
+결과:
+<div style="background-color: #f0f0f0; padding: 10px;">
+박스 안의 내용입니다.
+</div>
-예는 아래와 같습니다.
+<blockquote>
-{| class="wikitable"
+인용된 텍스트입니다.
-| <nowiki><niconico>sm23328696</niconico></nowiki> || <niconico>sm23328696</niconico>
+</blockquote>
-|-
-! align="center" | 입력한 내용 !! align="center" | 결과
-|}
-===네이버TV===
+H<sub>2</sub>O는 물의 화학식입니다.
-[[가온 위키:기능 구현 불가-누가 해결책을 알려주세요!/영상 가져오기#네이버 TV|패치]] 사용이 가능해 졌습니다.
-예는 아래와 같습니다.
-{| class="wikitable"
-| <nowiki><navertv>1380912</navertv></nowiki> || <navertv>1380912</navertv>
-|-
-! align="center" | 입력한 내용 !! align="center" | 결과
-|}
-==분기==
+== 주의사항 ==
-{{분기|도움말:위키 문법|4920||가온 위키}}
+* HTML 태그는 보안상의 이유로 일부만 허용됩니다.
-{{분기|도움말:위키 문법/영상 삽입|||가온 위키}}
+* 기본적으로 위키 문서 수정 시에는 HTML 태그 사용이 아닌, 기본 미디어위키 문법만을 사용하는 것을 권장합니다.
+* 복잡한 표는 단계적으로 만들면서 결과를 확인하는 것이 좋습니다.
+* 템플릿을 만들 때는 문서에서 직접 테스트해보세요.
+* 파일을 올릴 때는 적절한 라이선스를 확인해야 합니다.
-==각주==
+== 연습하기 ==
+[[가온 위키:연습장|연습장]]에서 위의 문법들을 실제로 사용해보면서 익숙해지세요. 특히 표 만들기는 처음에는 어려울 수 있으니 차근차근 연습하시기 바랍니다.