검수요청.png검수요청.png

위키문법

위키원
choo6078 (토론 | 기여)님의 2021년 8월 10일 (화) 17:51 판
이동: 둘러보기, 검색

위키문법은 미디어위키 소프트웨어 등 여러 위키엔진에서 쓰이는 구문과 키워드를 이용하여 문서를 꾸미는 방법 및 규칙이다.[1]

개요

위키 문법은 위키의 문서 작성에 필수적이거나, 편집할 때 유용하게 사용할 수 있다. 대중적으로 쓰이는 위키 문법은 미디어위키 소프트웨어에서 쓰이는 위키 문법으로, 미디어위키는 복잡한 마크업의 사용을 피하고자 문단과 줄의 바뀜이나 굵은 글씨나 기울임 글씨의 표현과 같은 단순한 편집은 별도의 마크업 없이 처리하고 있다. 예를 들어 이어지는 글의 문단을 바꾸고자 할 때는 단순히 엔터를 두 번 입력하면 된다. 그렇지만 특수 문자나 기호의 표시나 수식의 표현, 글자의 정렬과 같은 기능을 위해 자체 마크업을 사용한다.[1]

미디어위키의 위키문법

배치

문단

문단은 하나의 글을 여러 개로 나눈 글의 단위로, 문단을 사용하면 목차에 그 문단의 제목이 표시되며, 이러한 문단은 문서의 내용을 쉽게 읽고 이해할 수 있도록 하기 위해 사용 한다.[1]

문단 머리글

글의 내용을 여러 문단으로 나누기 위해 문단 머리글을 사용한다. 문단에는 적절한 머리글이 있어야 하는데, 자동으로 생성되어 문서의 표제어를 나타내는 1단계 머리글을 빼면, 2단계 머리글이 편집자가 문서 내에서 쓸 수 있는 최고 단계의 머리글이다. 2단계 머리글은 양옆에 '==' 를 적으면 된다. 더 작은 하위 문단의 머리글은 '=' 의 수를 늘려 표시하는데, 즉, 3단계는 '===' 사이에, 4단계는 '====' 사이에 머리글을 쓰면 된다.[1]

구분 선

한 문단 내에서 간단한 구분을 위해 구분 선을 쓸 수 있는데, '----' 를 적으면 수평의 구분 선으로 문서를 나눈다.[1]


목차의 표시

문서에 네 개 이상의 문단이 있으면, 문서의 개요와 첫 문단 사이에 자동으로 목차가 나타나게 되지만, 목차의 위치를 바꾸고 싶을 때는 문서의 어느 곳이든 '<dic>_TOC_</dic>' 를 적으면 기본 위치가 아니라 '<dic>_TOC_</dic>' 를 적은 위치에 목차가 표시된다. 문서의 어떤 곳이든 '<dic>_NOTOC_</dic>' 를 적으면 목차가 사라진다.[1]

줄 넘김

미디어위키에서 문단을 구분하거나 줄을 바꿀 때는 엔터키를 두 번 입력하면 되는데, 한 번 줄을 넘겨도 글 배치에는 영향을 주지 않는다. 이 방법 외에도 태그를 이용해서 줄을 넘길 수 있는데 '<br />' 태그를 이용하면 엔터를 입력하지 않고도 줄을 바꿀 수 잇는데, 이 태그에는 오류가 많은데, 알려진 오류에는 미디어위키 이름공간에서 작동되지 않아 일부 도구에서 오류를 일으키게 되는 오류, 태그의 시작과 끝이 한 줄 안에 없을 때 오류를 일으키며, 링크 안에서 사용하거나 기울임꼴, 굵은 글씨와 함께 태그를 사용하고 나서 다음 줄에서 태그를 닫을 경우, 마지막으로 목록 안에서 쓰이면 태그 뒤의 글 배치에 영향을 주는 오류로, 알려진 것만 해도 다섯 가지로 많은 오류가 있다. 그런 이유로 엔터를 두 번 치는 것이 좋다.[1]

들여쓰기

왼쪽 들여쓰기

콜론을 이용하여 왼쪽 들여쓰기를 할 수 있는데, 줄 앞에 콜론 하나를 넣으면 된다. 줄 앞에 콜론을 하나 넣은 줄에 콜론을 하나 더 넣으면 그 줄을 더 들여쓰게 만든다.[1]

토막 인용을 이용한 양쪽 들여 쓰기

유명인사의 발언과 같은 잉용구를 문서의 다른 부분과 구분하고자 할 때 주로 쓰이는 토막 인용은 양쪽 들여쓰기를 하는데, '<blockquote></blockquote>' 태그를 사용하면 양쪽을 들여쓰게 된다.[1]

문장의 정렬 방식

HTML 태그를 이용해서 문장의 정렬 방식을 바꿀 수 있는데, '<div style="text-align:center; width:auto; margin-left:auto;margin-right:auto;">가운데로 정렬된 문구</div>' 로 문구를 가운데로 정렬할 수 있고, '<div style="text-align:right; width:auto; margin-left:auto;margin-right:auto;">오른쪽으로 정렬된 문구</div>' 로 문구를 오른쪽으로 정렬할 수 있다.[1]

목록

정렬되지 않은 목록

정렬되지 않은 목록은 매 문자열마다 앞에 별표를 넣어 만들 수 있다. 별이 많을 수록 더 깊은 단계를 표시하며 새로운 문자열이 목록 중에 나타나면 그 목록이 끝났음을 나타내는데, 물론 다시 시작할 수도 있다. 별표 끝에 콜론을 넣어 그 단계 목록에 이어지는 내용을 적을 수도 있다.[1]

정렬된 목록

번호가 매겨진 목록은 체계적이고 흐름을 따르기 쉽다. 이러한 목록은 매 문자열마다 앞에 샵표를 넣어 만들 수 있고, 샵표를 한번 더 넣으면 새로운 목록이 시작되며 새 번호 1 부터 시작된다. 마찬가지로 새로운 문자열은 그 목록이 끝났음을 나타내며, 샵표 끝에 콜론을 넣어 그 단계 목록에 이어지는 내용을 적을 수 있다.[1]

정렬된 목록에 정렬되지 않은 목록

번호가 매겨진 목록과 그렇지 않은 목록을 혼합하여 사용할 수 있는데, 그냥 문자열 앞에 샵표 별표를 넣으면 만들어지며, 이 반대의 경우인 별표 샵표도 가능하다. 이 또한 마찬가지로 새로운 문자열은 그 목록이 끝났음을 나타내며, 별표 혹은 샵표 끝에 콜론을 넣어 그 단계 목록에 이어지는 내용을 적을 수 있다.[1]

poem 태그

첫 글자가 빈 칸으로 시작되는 글은 점선으로 이뤄진 글상자에 적힌 글로 변환되지만, 편집자는 종종 시, 가사, 좌우면, 선서 같은 것들을 표현할 때 글의 빈칸을 두고도 다른 글들과 같이 표시되기를 바라는데, 때로는 여러 개의 빈칸이 그대로 표시되기를 바란다. 이럴때 '<poem></poem>' 태그를 사용하면 태그 안에 적힌 텍스트를 적힌 그대로 표시해준다. 이 태그는 '<blockquote></blockquote>' 와 같은 다른 태그 안에서 쓰일 수도 있다.[1]

글자 모양

글씨체

두 개의 작은따옴표를 양쪽에 입력하면 글자가 기울임체로 표시되며, 세 개의 작은따옴표는 진한 글씨체, 다섯 개의 작은따옴표는 진한 기울임체의 글자 모양을 만든다.[1]

소스 코드

컴퓨터 코드는 배경색이 존재하며 좀 더 엄격한 형식을 취하는데, 컴퓨터 코드의 경우에는 우선 '<code></code>' 로 컴퓨터 코드를 입력할 수 있고, '<syntaxhighlight lang="cpp"></syntaxhighlight>' 를 사용하여 컴퓨터 코드에 배경색을 입힐 수 있다.[1]

글씨 크기

큰 글씨는 '<big></big>' 를 통해 큰 글씨를 쓸 수 있는데, '<small></small>' 로 만들어진 작은글씨 사이에 놓이는 경우 외에는 사용을 잘 안한다.[1]

단어 묶음

'&nbsp ;' 를 사용해서 아무것도 안보이지만 빈킨이 아닌 칸을 입력할 수도 있는데, 이를 두 단어 사이에 입력해 한 단어로 인식하도록 하여 자동 줄 넘김으로 두 단어가 갈리는 것을 방지할 수 있다.[1]

여백

문자열 내에서의 넓은 빈칸은 '{{여백|4em}}' 를 통해 삽입할 수 있다.[1]

링크와 URL

자유 링크

다른 위키 문서로의 링크

미디어위키 소프트웨어의 마크업 언어를 이용하여, 가리키고 싶은 문서의 제목 앞쪽에 대괄호를 두 개씩 넣음으로써 자유롭게 링크를 만들게 된다. 예를 들어 '[[위키백과]]' 를 입력하면 위키백과로 나타난다. 내부적으로, 대소문자가 있는 문자의 경우, 링크 대상 문서의 제목 첫 글자는 자동으로 대문자가 되며 빈 칸의 경우 밑줄로 변환된다. 붉은 링크는 존재하지 않는 문서일 경우에 나타나며, 링크를 따라가면 그 이름을 가진 문서를 만들 수 있으며, 자기 자신을 가리키는 링크는 단순히 굵은 글씨체로 나타난다.[1]

다른 이름이 부여된 링크

원한다면 파이프 문자를 사용하여 링크의 제목을 변경할 수도 있는데, 예를 들어 '[[위키백과|인터넷 사전]]' 는, 링크가 인터넷 사전 으로 나타나며, '인터넷 사전' 으로 보이지만, 사실 위키백과로 연결된다. 이와 같은 링크는 같은 대상을 가리키지만 다른 이름을 갖고 있으며, 대상 문서 표제어는 앞에 위치해야 하며, 그 뒤에 표시될 이름이 위치한다.[1]

자동으로 링크 이름 수정하기

링크 뒤에 단순히 파이프 문자를 입력하는 것 만으로도 링크 제목을 일정한 형식으로 바꿀 수 있는데, 편집 후 다음 번에 다시 편집 창을 열게 되면 파이프 문자로 확장된 링크를 볼 수 있다. 예를 들어 '[[위키백과 (위키)|]]' 로 괄호에 적힌 내용을 자동으로 숨겨지며, '[[도움말:위키문법|]]' 으로 이름공간을 자동으로 숨길 수 있으며, 이 두 기능을 모두 사용하여 '[[도움말:위키문법 (중복)|]]' 괄호 안에 적힌 내용과 이름공간을 자동으로 숨길 수도 있다. 그렇지만 문단 링크는 자동으로 수정되지 않는다.[1]

현재 문서 내 문단을 링크하기

샵표 뒤에 따르는 부분은 해당 문서의 문단 머릿글과 일치해야 한다. 철자 뿐 아니라 대소문자, 구두점까지 정확히 일치해야 제대로 기능하며, 존재하지 않는 문단으로 링크가 될 경우 그 링크가 깨지는 게 아니라 해당 문서의 맨 윗부분으로 연결된다. 만일 같은 이름을 가진 문단이 여러 개일 경우, 그 이름을 가진 첫 번째 문단 이외의 문단으로 링크하려면 그 순서대로 숫자를 추가하면 된다. 예를 들어 '[[#머릿말 예제 3]]' 의 경우 '머릿말 예제' 라는 이름을 가진 문단 중 세 번째 문단으로 이동시켜 준다. 파이프 문자를 이용하면 샵 기호를 보이지 않게 할 수 있고, 원하는 링크 제목을 넣을 수도 있다. 이 모든 예를 들면 '[[도움말:위키문법#링크' 는 다른 문서의 한 문단으로 연결되며, '[[#링크와 URL]]' 은 이 문서의 다른 문단으로 연결되는데, '[[#링크와 URL|링크와 URL]]' 은 같은 문단으로 연결되지만 # 기호가 숨겨져 있다 '[[도움말:위키문법#링크|링크]]' 는 다른 문서의 한 문단으로 이어지지만 이름이 '링크'로 바뀐 링크이다.[1]

넘겨주기

한 문서의 표제어를 다른 문서로 넘겨주기 하면, 도달하는 문서의 맨 위 첫째 줄에 이 효과가 적용되었다는 것이 표시되며, 다른 문서의 한 문단으로도 넘겨주기를 적용할 수 있다. 예를 들어 '#넘겨주기[[위키문법]]' 로 해당 문서로 넘겨주기가 가능하며, '#넘겨주기[[위키문법:링크]]' 로 특정 문단으로 넘겨주기가 가능하다.[1]

다른 이름공간으로 링크하기

'#넘겨주기[[도움말:위키문법]]' 로 다른 이름공간에 있는 다른 문서로 넘겨주기가 가능하다.[1]

외부 링크

대괄호는 외부 링크를 가리키는데, 링크에 이름을 붙일 때 그 URL과 이름을 하나의 빈 칸으로 구분한다. 이 대괄호는 링크가 아닌 단순한 문구에도 쓰일 수 있기는 하다. 만일, 제목이 있는 외부 링크의 경우 그 제목에 대괄호가 포함된다면, 꼭 직접 입력하지 말고 HTML 특수문주 구문인 &#93을 사용하는 것이 좋고, 그렇지 않을 경우 미디어위키 소프트웨어가 제목에 쓰인 대괄호를 외부 링크의 끝으로 인식할 것이다. '[https://ko.wikipedia.org/wiki/%EC%9C%84%ED%82%A4%EB%B0%B1%EA%B3%BC:%EB%8C%80%EB%AC%B8 위키백과]' 로 제목이 부여된 링크는 제목만 보이게 되며, 제목이 없는 링크의 경우 '[https://ko.wikipedia.org/wiki/%EC%9C%84%ED%82%A4%EB%B0%B1%EA%B3%BC:%EB%8C%80%EB%AC%B8]' 가 되고, 이 경우엔 [1]로 보여진다. 이 외에도 URL을 노출해서 대괄호 없이 링크를 걸 수도 있고, '<span class="plainlinks">[https://ko.wikipedia.org/wiki/%EC%9C%84%ED%82%A4%EB%B0%B1%EA%B3%BC:%EB%8C%80%EB%AC%B8 위키백과]</span>' 를 사용하여 외부 링크 기호를 숨길 수도 있다.[1]

기타

그림

각주와 인용 출처

틀과 문서 끼워 넣기

토론과 프로젝트 문서

형식 제한하기/위키 마크업 무시하기

주석

더 시드와의 차이

더 시드는 미디어위키와 비슷하지만 다른 위키엔진으로, 대표적으로 나무위키가 이 위키엔진을 사용한다.[2]

공통문법

  • '== (문단 이름) ==' 으로 문단을 나누는 법, 또한 세부 문단을 나누는 법도 같다.[2]
  • '[[(문서 이름)]]' 으로 다른 문서와 링크 시키는 법도 동일하며, 문서 이름과 다른 이름으로 링크시키고 싶을 때 쓰는 '[[(실제 문서 이름)|(표시하고자 하는 이름)]]'도 동일하다.[2]
  • '[[파일:파일 이름.확장자]]'로 그림과 사진을 불러오는 법도 공통된다.[2]
  • '[[분류:(분류명)]]'으로 문서를 분류시키는 것도 같으며, 여러 개를 이어 쓸 수 있다는 점도 같다.[2]

차이문법

  • 더 시드 문법 '[[http://example.org|예제]]' 과 미디어위키 문법 '[http://example.org 예제]'

더 시드에서 외부 링크를 걸려면 대괄호를 두 개 써야하며, 다른 이름으로 바꾸려면 | 기호를 넣어야 하지만, 미디어위키에서 외부 링크를 걸려면 대괄호는 하나에, 다른 이름으로 바꾸려면 | 대신 한칸을 띄어 써넣으면 된다. 이때 URL만 집어넣으면 더 시드에서의 결과와는 달리 [1], [2]... 하는 식으로 번호가 표시되므로 URL 주소를 그대로 표시하며 링크를 걸고 싶다면 대괄호를 빼고 URL 주소만 입력하면 자동으로 링크가 걸린다.[2]

  • 더 시드 문법 '[* 주석]' 과 미디어위키 문법 '<ref>주석<ref>'

더 시드와는 달리 미디어위키는 화살괄호로 된 코드를 써야 한다. 주석 끝쪽의 코드에는 슬래시 기호를 꼭 앞에 붙여서, 코드를 마쳐줘야 한다.[2]

  • 더 시드 문법 '[각주]' 과 미디어위키 문법 '<references/>, {{각주}}'

더 시드에서와는 달리 화살괄호로 된 코드나 각주 틀을 써야 하며 각주 표시 문법을 쓰지 않아도 문서 맨 밑에 자동으로 각주들을 모아 보여줄 수는 있다. 하지만 더 시드와는 달리 문법을 쓰지 않든 문법을 쓰뜬 각주 문단이 자동으로 나뉘지는 않으므로, 꼭 == 각주 ==로 단락을 나눈 다음 각주 표시 문법을 추가하는 것이 좋다.[2]

  • 더 시드 문법 '~~취소선~~, --취소선--' 과 미디어위키 문법 '<s>취소선</s>, <del>취소선</del>'

더 시드에서와는 달리 화살괄호로 된 코드를 써야 한다.[2]

  • 더 시드 문법 '{{{+1 한단계 커진 글자}}}' 과 미디어위키 문법 '<span style="font-size:larger">한단계 커진 글자</span>, {{글꼴|size=120%|글자}}'

더 시드에서와는 달리 화살표로 된 코드를 써야 하며, font-size에는 larger 외에도 x-large, xx-large,% 등을 사용할 수 있다.[2]

  • 더 시드 문법 '#넘겨주기 넘겨주기, #redirect 넘겨주기' 과 미디어위키 문법 '#넘겨주기[[넘겨주기]], #redirect[[넘겨주기]]'

더 시드와는 달리 미디어위키는 넘겨주고자 하는 문서에 일반 링크처럼 대괄호를 두 개 붙여줘야 한다.[2]

  • 더 시드 문법 '[include(틀:XXX)]' 과 미디어위키 문법 '{{XXX}}'

중괄호는 각종 위키 중 자주 쓰이는 기호로 특히 틀을 사용할 때 중괄호 두 개 사이에 틀 이름을 적어넣으면 더 시드에서의 include 효과와 같은 효과를 주는데, 더 시드와 달리 미디어위키는 이름공간 틀:은 생략해도 된다.[2]

  • 더 시드 문법 '{{{#색코드 색}}}' 과 미디어위키 문법 '<span style="color:색코드">색</span>, {{글씨 색|green|초록색 글씨}}'

글자에 색을 넣으려면 더 시드에서 쓰이는 중괄호 3개가 아닌, HTML 요소나 별도의 틀을 이용해야 한다.[2]

  • 더 시드 문법 '^^위 첨자^^, ,,아래 첨자,,' 과 미디어위키 문법 '<sub>위 첨자</sub>, <sub>아래 첨자</sub>'

화살괄호로 된 코드를 사용해야한다.[2]

  • 더 시드 문법 '[공백] 들여쓰기' 과 미디어위키 문법 ':들여쓰기'

더 시드와는 달리 별도의 공백 코드는 없으며, 쌍점으로 그 기능을 대신한다. 토론에 답변을 남길 때 유용하게 쓰이는 기호이다.[2]

  • 더 시드 문법 '[공백]* 별표 목록 1단계, [공백][공백]* 별표 목록 2단계' 과 미디어위키 문법 '* 별표 목록 1단계, ** 별표 목록 2단계'

더 시드와는 달리 공백 코드를 입력할 필요가 없으며, 별 기호를 원하는 횟수만큼 추가하면 그 횟수에 따라 단계가 늘어난다.[2]

  • 더 시드 문법 '[공백]1. 순서 목록 1단계, [공백][공백]1. 순서 목록 2단계' 과 미디어위키 문법 '# 순서 목록 1단계, ##순서 목록 2단계'

더 시드와는 달리 공백 코드와 숫자를 입력할 필요가 없으며, 샵 기호를 원하는 횟수만큼 추가하면 그 횟수에 따라 단계가 늘어나며, 숫자기호도 자동으로 붙는다.[2]

  • 더 시드 문법 '[목차]' 과 미디어위키 문법 '사용하지 않음'

미디어위키에서는 기본적으로 문단이 4개 이상이면 자동으로 목차가 표시되지만, 문단이 3개 이하인 상태에서 목차를 굳이 표기하고 싶다면 _TOC_, _목차_ 코드로 표시할 수 있으나, 자주 쓰이지는 않는다.[2]

  • 더 시드 문법 '[youtube(영상 ID)], [[youtube(영상 ID)]]' 과 미디어위키 문법 '사용하지 않음'

미디어위키에서는 유튜브 영상을 올리는 법은 딱히 없고, {{유튜브}} 등을 사용하여 외부 링크로 유튜브 영상 링크를 제공하는 법을 사용하거나 파일을 직접 업로드하여 제시하는 법을 사용한다.[2]

  • 더 시드 문법 '{{{(문법)}}}' 과 미디어위키 문법 '<nowiki></nowiki>'

더 시드에서 텍스트 서식을 적용할 때 쓰는 중괄호 세개를 아무 표시 없이 사용하면 위키 문법을 적용하지 않는 효과가 있는데, 미디어위키에서는 nowiki 태그로 해당 기능을 수행한다. 더 시드의 그것과는 달리 특수한 시식은 적용되지 않고 그냥 일반 텍스트로 뜬다.[2]

  • 더 시드 문법 '[br]' 과 미디어위키 문법 '<br />'

개행을 나타내는 코드는 HTML 요소와 비슷하게 사용해야 한다.[2]

  • 더 시드 문법 '[include(틀:예제)]' 과 미디어위키 문법 '{{예제}}'

틀을 표시할 때 더 시드에서는 include 매크로를 사용하지만, 미디어위키에서는 {{ }}를 사용해야 한다.[2]

각주

참고자료

같이 보기


  검수요청.png검수요청.png 이 위키문법 문서는 인터넷에 관한 글로서 검토가 필요합니다. 위키 문서는 누구든지 자유롭게 편집할 수 있습니다. [편집]을 눌러 문서 내용을 검토·수정해 주세요.