검색 여닫기
메뉴 여닫기
86
0
4
2천
데브카페
개인 메뉴 토글
로그인하지 않음
만약 지금 편집한다면 당신의 IP 주소가 공개될 수 있습니다.

미디어위키 기본 사용법

데브카페
다른 명령
Devcafe (토론 | 기여)님의 2026년 11월 12일 (목) 12:07 판 (가이드 전면 개편: 입력/결과 표, 안내 상자, 치트 시트 추가 및 문법 오류 수정)
(차이) ← 이전 판 | 최신판 (차이) | 다음 판 → (차이)
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. 두 번째
    1. 두 번째-1
    2. 두 번째-2
  3. 세 번째
    줄만 바꿔 이어 쓰기
글머리 목록 * 
* 하나
** 둘
*** 셋
  • 하나
    • 둘
      • 셋
혼합 목록 
# 설치 순서
#* 파일 내려받기
#* 압축 풀기
# 실행하기
  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" … |}
틀 불러오기 {{틀이름|항목=값}}
분류 달기 [[분류:이름]]
서명 남기기 (토론) ~~~~

더 알아보기

원본 주소 "https://devcafe.co.kr/w/index.php?title=미디어위키_기본_사용법&oldid=2742"