미디어위키 기본 사용법

DEVCAFE WIKI GUIDE

10분 만에 익히는 미디어위키 문법

처음 위키를 쓰는 분을 위한 실습형 가이드입니다. 문단·서식·목록·링크·표·틀·분류까지 실제로 가장 많이 쓰는 문법만 골라 입력 → 결과 순서로 정리했습니다. 위에서부터 차례로 따라 하면 바로 문서를 쓸 수 있습니다.

난이도 · 입문 소요 시간 · 약 10분 준비물 · 로그인한 계정

시작하기 전에 : 연습 문서 만들기

위키는 "없는 문서를 검색하면 새로 만들 수 있다"는 방식으로 글을 씁니다. 아래 순서로 나만의 연습 문서를 먼저 만드세요.

1. 상단 검색창에 따라하기를 입력하고 검색합니다.
2. 이미 있는 문서라면 따라하기2, 따라하기3 … 처럼 번호를 붙여 다시 검색합니다.
3. 검색 결과의 "이 위키에 '따라하기2' 문서를 만드세요"(빨간 링크)를 누르면 편집 화면이 열립니다.
4. 아래 예제를 하나씩 붙여 넣고, 저장하기 전에 미리 보기로 결과를 확인합니다.

알아두기 — 미디어위키 문법은 위키텍스트(wikitext)라고 부르는 경량 마크업 언어입니다. 마크다운과 비슷한 개념이지만 기호가 다릅니다. 예를 들어 굵게는 마크다운에서 **굵게**, 위키에서는 '''굵게'''입니다.

문단(제목) 만들기

제목 앞뒤에 붙이는 =의 개수로 수준을 정합니다. 문단을 나누면 문단별 [편집] 버튼이 생겨 필요한 부분만 고칠 수 있습니다.

입력	수준	용도
== 제목 ==	2단계	큰 주제 (본문에서 가장 많이 사용)
=== 소제목 ===	3단계	주제 안의 세부 항목
==== 소제목 ====	4단계	더 작은 세부 항목
===== 소제목 =====	5단계	거의 쓰지 않음

예시

== dev cafe란? ==
=== dev cafe 이용법 ===
==== 글쓰기 규칙 ====

주의 — = 제목 =(1단계)는 문서 제목과 같은 크기라서 본문에서는 쓰지 않는 것이 관례입니다. 항상 2단계(==)부터 시작하세요.

글자 서식

기능	입력	결과
기울임	''기울임''	기울임
굵게	'''굵게'''	굵게
굵은 기울임	'''''굵은 기울임'''''	굵은 기울임
밑줄	<u>밑줄</u>	밑줄
취소선	<s>취소선</s>	취소선
삽입 / 삭제 표시	<ins>추가</ins> <del>삭제</del>	추가 삭제
위첨자 / 아래첨자	x<sup>2</sup> H<sub>2</sub>O	x2 H2O
인라인 코드	<code>SELECT</code>	SELECT
글자 색	<span style="color:#e11d48">강조</span>	강조
문법 무시	<nowiki>'''굵게 안 됨'''</nowiki>	'''굵게 안 됨'''
구분선	----	가로줄 한 줄

목록과 들여쓰기

줄 맨 앞에 기호를 붙입니다. 기호를 겹쳐 쓸수록 한 단계씩 깊어집니다.

종류	입력	결과
번호 목록 #	# 첫 번째 # 두 번째 ## 두 번째-1 ## 두 번째-2 # 세 번째 #: 줄만 바꿔 이어 쓰기	첫 번째 두 번째 두 번째-1 두 번째-2 세 번째 줄만 바꿔 이어 쓰기
글머리 목록 *	* 하나 ** 둘 *** 셋	하나 둘 셋
혼합 목록	# 설치 순서 #* 파일 내려받기 #* 압축 풀기 # 실행하기	설치 순서 파일 내려받기 압축 풀기 실행하기
들여쓰기 :	: 한 칸 들여쓰기 :: 두 칸 들여쓰기	한 칸 들여쓰기 두 칸 들여쓰기
정의 목록 ;	; SGA : 인스턴스 공유 메모리 영역 ; PGA : 세션별 전용 메모리 영역	SGA 인스턴스 공유 메모리 영역 PGA 세션별 전용 메모리 영역

팁 — 번호 목록 중간에 빈 줄이 들어가면 번호가 1부터 다시 시작됩니다. 목록 안에서 설명을 이어 쓰려면 빈 줄 대신 #:를 사용하세요.

링크와 이미지

종류	입력	결과
내부 링크	[[대문]]	대문
다른 이름으로 표시	[[대문|데브카페 홈]]	데브카페 홈
문단으로 바로 가기	[[문서이름#문단 제목]]	해당 문서의 문단으로 이동
외부 링크	[https://www.mediawiki.org 미디어위키]	미디어위키
이미지	[[파일:이름.png|섬네일|300px|설명]]	오른쪽에 300px 섬네일 + 설명
분류 페이지 링크	[[:분류:미디어위키]]	분류:미디어위키

이미지 옵션 — 섬네일(thumb), 위치 left · center · right, 크기 300px를 |로 이어 붙입니다. 이미지는 먼저 특수:파일올리기에서 업로드해야 합니다. 링크 대상 문서가 없으면 빨간 링크로 표시되며, 누르면 새 문서를 만들 수 있습니다.

표(wikitable) 만들기

표는 몇 가지 기호만 알면 됩니다.

기호	의미
{|	표 시작 (뒤에 class="wikitable" 같은 속성 지정)
|+	표 제목(캡션)
|-	새 행 시작
! / !!	머리글 셀 / 같은 줄의 다음 머리글 셀
| / ||	일반 셀 / 같은 줄의 다음 셀
|}	표 끝

입력

{| class="wikitable sortable"
|+ Oracle 인스턴스 기동 단계
|-
! 단계 !! 읽는 파일 !! 주요 용도
|-
| NOMOUNT || 파라미터 파일 (spfile / pfile) || 컨트롤 파일 재생성, DB 생성
|-
| MOUNT || 컨트롤 파일 || 아카이브 로그 모드 변경, 복구
|-
| OPEN || 데이터 파일, 리두 로그 파일 || 정상 서비스 (READ WRITE / READ ONLY)
|}

결과

Oracle 인스턴스 기동 단계

단계	읽는 파일	주요 용도
NOMOUNT	파라미터 파일 (spfile / pfile)	컨트롤 파일 재생성, DB 생성
MOUNT	컨트롤 파일	아카이브 로그 모드 변경, 복구
OPEN	데이터 파일, 리두 로그 파일	정상 서비스 (READ WRITE / READ ONLY)

팁 — class="wikitable sortable"로 쓰면 머리글을 눌러 열 단위 정렬이 됩니다. 셀 병합은 colspan="2", rowspan="2" 속성을 셀 앞에 colspan="2" | 내용 형태로 붙입니다.

코드 블록

개발 문서의 핵심입니다. lang에 언어를 지정하면 문법 강조가 적용됩니다.

입력

<syntaxhighlight lang="python">
import oracledb

conn = oracledb.connect(user="scott", password="tiger", dsn="localhost/ORCLPDB")
print(conn.version)
</syntaxhighlight>

결과

import oracledb

conn = oracledb.connect(user="scott", password="tiger", dsn="localhost/ORCLPDB")
print(conn.version)

방법	특징
<syntaxhighlight lang="sql">	문법 강조 (권장). python, sql, bash, html, css, javascript 등
<source>	syntaxhighlight의 옛 이름. 기존 문서 호환용
<pre>	강조 없이 입력한 그대로 표시. 위키 문법도 해석하지 않음
줄 맨 앞 공백 한 칸	간단한 고정폭 블록. 단, 안의 위키 문법은 해석됨

목차(TOC) 제어

문단이 4개 이상이면 목차가 자동으로 만들어집니다. 아래 매직 워드로 동작을 바꿀 수 있습니다.

입력	동작
__TOC__	입력한 위치에 목차 표시
__FORCETOC__	문단이 4개 미만이어도 목차 강제 생성
__NOTOC__	목차 숨기기

틀(Template)

머리말, 알림, 주의 사항처럼 여러 문서에서 반복되는 내용을 한 번 만들어 두고 불러 쓰는 기능입니다. 틀을 고치면 사용하는 모든 문서에 한 번에 반영됩니다.

① 틀 만들기 — 틀:알림 문서를 만들고 아래처럼 작성합니다. {{{이름}}}은 불러올 때 채워질 자리입니다.

<div style="padding:12px;border-left:4px solid #3b82f6;background:#eff6ff;">
'''{{{제목}}}''' — {{{내용}}}
</div>

② 문서에서 불러 쓰기

{{알림
|제목=점검 안내
|내용=이번 주 토요일 02:00~04:00 DB 정기 점검이 있습니다.
}}

구분	틀(Template)	양식(Form)
역할	문서 안에 자주 쓰는 구문·형식을 끼워 넣음	정해진 입력 칸으로 문서 전체를 만들어 줌
사용 예	알림 상자, 정보 상자, 출처 표기	장애 보고서, 작업 일지처럼 형식이 같은 문서
필요 조건	기본 기능	Page Forms 확장 기능 설치

분류(Category)

문서 맨 아래에 분류를 달면 같은 주제의 문서가 자동으로 모입니다.

입력	동작
[[분류:미디어위키]]	이 문서를 '미디어위키' 분류에 넣기 (보통 문서 맨 아래)
[[분류:미디어위키|정렬키]]	분류 목록에서의 정렬 기준 지정
[[:분류:미디어위키]]	분류에 넣지 않고 분류 페이지로 링크만 걸기

팁 — 분류 문서(예: 분류:미디어위키)에 설명을 적어 두고, 그 분류 문서에도 상위 분류를 달면 주제별 계층 구조를 만들 수 있습니다.

양식(Form) 만들기

Page Forms 확장 기능을 설치하면, 같은 형식의 문서를 입력 칸만 채워 만들 수 있습니다. 최소한의 작성 규칙을 지키게 하거나 작성 편의를 높일 때 유용합니다.

1. 먼저 특수:CreateTemplate에서 양식에 쓸 틀(입력 항목)을 만듭니다.
2. 특수:CreateForm으로 이동합니다.
3. 양식 이름을 입력하고, 앞에서 만든 틀을 추가한 뒤 필요하면 문단을 추가합니다.
4. 저장한 뒤 특수:FormEdit/양식이름으로 접속하면 입력 화면으로 새 문서를 만들 수 있습니다.

대문 꾸미기 (관리자)

아래 시스템 메시지 문서는 관리자 권한이 있어야 수정할 수 있습니다.

문서	역할
MediaWiki:Mainpage-nstab	대문 탭에 표시되는 이름 변경
MediaWiki:Mainpage	대문으로 사용할 문서 지정
MediaWiki:Sidebar	사이드바 메뉴 항목 변경
MediaWiki:Common.css	사이트 전체에 적용되는 CSS

대문의 큰 제목(문서명)을 숨기려면 MediaWiki:Common.css에 다음을 추가합니다.

body.page-대문 h1.firstHeading { display: none; }

한눈에 보는 치트 시트

하고 싶은 것	입력
문단 제목	== 제목 ==
굵게 / 기울임	'''굵게''' / ''기울임''
번호 / 글머리 목록	# 항목 / * 항목
내부 / 외부 링크	[[문서|표시]] / [https://주소 표시]
이미지	[[파일:이름.png|섬네일|300px]]
코드 블록	<syntaxhighlight lang="python"> … </syntaxhighlight>
표	{| class="wikitable" … |}
틀 불러오기	{{틀이름|항목=값}}
분류 달기	[[분류:이름]]
서명 남기기 (토론)	~~~~

더 알아보기

• 미디어위키 공식 도움말 : 서식
• 미디어위키 공식 도움말 : 표
• 미디어위키 공식 도움말 : 틀