만일 [[시 (문학)|시]], [[가사]] 등의 인용구와 같이 원문의 강제 개행을 반영해야 하는 상황에서 <code><nowiki><br/></nowiki></code> 사용이 잦을 경우 <code><nowiki><poem></nowiki></code><code><nowiki></poem></nowiki></code>을 앞뒤에 배치하면 해당 영역 내에서는 강제 개행을 그대로 반영합니다.
만일 [[시 (문학)|시]], [[가사]] 등의 인용구와 같이 원문의 강제 개행을 반영해야 하는 상황에서 <code><nowiki><br/></nowiki></code> 사용이 잦을 경우 <code><nowiki><poem></nowiki></code><code><nowiki></poem></nowiki></code>을 앞뒤에 배치하면 해당 영역 내에서는 강제 개행을 그대로 반영합니다.
:* 엔터 한 번으로는 개행이 되지 않습니다. 문단을 나누기 위해서는 엔터를 두 번 눌러야 합니다.
:* 엔터 한 번으로는 개행이 되지 않습니다. 문단을 나누기 위해서는 엔터를 두 번 눌러야 합니다.
:* 표나 틀에서 개행할 경우 '''<nowiki><br /></nowiki>''' 사용을 권장합니다.
:* 표나 틀에서 개행할 경우 '''<nowiki><br /></nowiki>''' 사용을 권장합니다.
:* 환경 설정 소도구에서 위키 문법강조 기능을 활성화해 사용할 경우 슬래시를(/) 넣어 '''<nowiki><br /></nowiki>'''과 같이 사용해야 색상으로 구분됩니다.
:* 환경 설정-소도구에서 위키 문법강조 기능을 활성화해 사용할 경우 슬래시를(/) 넣어 '''<nowiki><br /></nowiki>'''과 같이 사용해야 색상으로 구분됩니다.
:* <code><nowiki>{{ }}</nowiki></code>([[틀: ]])는 일반적인 경우 문단을 강제로 띄어 쓸 때 사용하는 것이 아닙니다. 글의 한 켠에 내용과 관련된 이미지와 같은 콘텐츠를 함께 넣었을 때, 본문의 분량과 콘텐츠가 차지하는 높이가 달라 밀리며 다른 콘텐츠의 내용과 오인을 유발하는 것을 막기 위해 사용합니다. [[도움말:좋은 글 쓰기]]의 이미지와 목록 정렬 예시를 참고할 수 있습니다.
:* <code><nowiki>{{-}}</nowiki></code>([[틀:-]])는 일반적인 경우 문단을 강제로 띄어 쓸 때 사용하는 것이 아닙니다. 글의 한 켠에 내용과 관련된 이미지와 같은 콘텐츠를 함께 넣었을 때, 본문의 분량과 콘텐츠가 차지하는 높이가 달라 밀리며 다른 콘텐츠의 내용과 오인을 유발하는 것을 막기 위해 사용합니다. [[도움말:좋은 글 쓰기]]의 이미지와 목록 정렬 예시를 참고할 수 있습니다.
==== 들여쓰기 ====
==== 들여쓰기 ====
2025년 9월 9일 (화) 11:27 판
문서를 편집할 때 사용하는 KDMW문법을 알려주는 사용자 메뉴얼입니다.
미디어위키에는 문법있습니다. 따라서 익숙하지 않은 방식으로 초기에는 약간 힘들수 있으나 수정및 편집시에 큰 문제 없음을 느끼시리라 생각합니다.
엔터 한 번으로는 개행이 되지 않습니다. 문단을 나누기 위해서는 엔터를 두 번 눌러야 합니다.
표나 틀에서 개행할 경우 <br /> 사용을 권장합니다.
환경 설정-소도구에서 위키 문법강조 기능을 활성화해 사용할 경우 슬래시를(/) 넣어 <br />과 같이 사용해야 색상으로 구분됩니다.
{{-}}(틀:-)는 일반적인 경우 문단을 강제로 띄어 쓸 때 사용하는 것이 아닙니다. 글의 한 켠에 내용과 관련된 이미지와 같은 콘텐츠를 함께 넣었을 때, 본문의 분량과 콘텐츠가 차지하는 높이가 달라 밀리며 다른 콘텐츠의 내용과 오인을 유발하는 것을 막기 위해 사용합니다. 도움말:좋은 글 쓰기의 이미지와 목록 정렬 예시를 참고할 수 있습니다.
들여쓰기
들여쓰기는 일정 간격 옆으로 문장이 이동하는 것으로, 콜론(:)을 사용하여 들여쓰기를 입력할 수 있습니다.
콜론의 개수가 늘어날수록 문장이 오른쪽으로 이동합니다. 콜론의 개수가 같으면, 같은 간격만큼 들여쓰기가 됩니다.
입력
결과
본 문장
: 들여쓰기를 해봅시다.
:: 이렇게 '''':''''이 늘어날수록
::: 문장이 점점 더
:::: 오른쪽으로 이동합니다.
:: 같은 개수의 콜론을 사용하면
:: 같은 간격만큼 들여쓰기가 되지요.
일반 문서가 아닌 다른 이름공간의 문서, 제목의 뒷부분에 동음이의어 구분자 등의 괄호로 된 부분이 들어간 문서의 링크를 이름공간의 이름, 괄호로 된 부분이 나오지 않게 간편하게 넣을 수 있습니다. 현재 각주 안에서 작동하지 않고 위에서 설명한 특정 문단으로 링크하는 문법과 같이 쓸 수 없는 버그가 있습니다.
인터위키 링크
인터위키를 사용하여 다른 위키(또는 사이트)에 있는 문서로 링크할 수 있습니다. 지원되는 사이트는 특수:인터위키에서 볼 수 있습니다.
분류는 문서의 주제를 보여주는 꼬리표 역할을 합니다. 분류는 문서 제일 아래쪽에 넣습니다.
입력
결과
설명
[[분류:분류 이름]]
내부링크를 하듯이 입력하면, 해당 문서가 해당 분류 문서에 분류됩니다.
[[분류:분류 이름|정렬 키]]
정렬 키를 입력하면, 해당 문서가 정렬 키에 맞는 순서로 분류됩니다. 예를 들어 '리브레 위키' 문서에 [[분류:위키|간]]을 넣으면, 정렬 키가 ㄱ이므로 문서가 ㄹ이 아닌 ㄱ에 분류됩니다. 또한 분류는 ㄱㄴㄷ순으로 배열되기 때문에, 리브레 위키 문서가 '각'과 '갇' 사이에 분류됩니다.
분류 문서도 일반 문서와 마찬가지로 분류할 수 있습니다. 어떤 분류에 상위 분류를 지정하려면, 그 분류 문서에 상위 분류를 넣습니다. 예를 들어 분류:일본의 만화의 상위 분류로 분류:일본과 분류:만화를 지정하고 싶다면 분류:일본의 만화에다 [[분류:일본]], [[분류:만화]]를 넣으면 됩니다.
정렬 키
장점
하위 문서들을 정렬할 때, 일괄적으로 붙은 상위 문서의 이름이 아닌 하위 문서의 이름에 따라 정렬할 수 있습니다.
대표 문서에서의 사용법
해당 분류를 직접 설명하는 문서에는 [[분류:(분류 이름)| ]]와 같이 정렬 키로 공백 하나를 입력합니다.
예를 들어 '미국' 문서에 [[분류:미국| ]]을 입력하면, '미국' 문서는 [[분류:미국]]의 맨 처음에 출력됩니다.
정렬 키 한 번에 입력하기
여러 분류에 일괄적으로 똑같은 정렬 키를 지정하고 싶다면, 해당 문서에 {{DEFAULTSORT:(정렬 키)}}를 입력합니다.
[[분류:가나다]]를 [[분류:가나다|(정렬 키)]]로 입력하지 않아도, 자동으로 문서에 지정된 모든 분류가 DEFAULTSORT에 입력된 정렬 키를 기준으로 정렬됩니다.
제목이 일본어인 문서의 정렬 키
문서 제목이 일본어인 경우, 정렬 키를 따로 지정해 주어야만 정렬이 제대로 됩니다. 문서 제목의 히라가나 표기를 사용하는데, 이 히라가나 표기에서 탁점과 반탁점을 떼고, 작은 글자는 큰 글자로 바꾸고, 장음 기호(ー)는 앞 모음에 따라 あ, い, う, え, お로 바꾸고, 기타 문장 부호는 뺀 형태를 사용해야 합니다.
리브레 위키는 수식 입력을 위해 틀:TeX문법을 지원합니다. 자세한 내용은 도움말:TeX 문법을 참고하시기 바랍니다.
코드 입력(syntaxhighlight)
C나 파이썬처럼 프로그래밍 언어의 코드를 보여줄 때에는 div, pre나 code 태그 등을 사용하여 설명할 수 있습니다. 하지만 syntaxhighlight를 사용하면 에디터처럼 자동으로 구문에 강조나 색이 입혀집니다.
총 사용방법은 <syntaxhighlight lang="{언어}" line="(line)" start="시작번호" highlight="줄번호" (inline)>코드</syntaxhighlight>입니다. 편집기상에서 키보드로 직접 탭 문자()를 입력할 수는 없어, 대신 띄어쓰기(스페이스 바) 4개를 입력하거나 이를 복사해 붙여넣어야 합니다.
이미지를 글의 한쪽에 글과 함께 표시되는 섬네일로 넣으면 여백과 테두리가 자동으로 추가됩니다. 컴퓨터 화면에서는 기본적으로 글의 오른쪽에 정해진 크기로 배치되며, 모바일에서는 화면에 따라 알맞은 형태로 표시됩니다. 원할 경우 크기나 정렬을 변경할 수 있습니다.
이미지를 섬네일로 넣을 경우, 함께 나열하는 글의 길이가 짧거나 다른 콘텐츠와 위치에 간섭이 발생하면 컴퓨터 화면에서 이어지는 이미지와 글의 위치가 맞지 않을 수 있습니다. 이 경우 글에서 구분이 필요한 내용 다음에 틀:틀을 입력하여 (이 문단과 같이) 해결할 수 있습니다. (참고: 도움말:좋은 글 쓰기#이미지와 목록 정렬)
{{ }}
리브레 위키를 포함한 미디어위키와 디지털 환경에서는 미디어에 보이지 않는 설명인 대체 텍스트를 추가할 수 있습니다. 대체 텍스트는 검색 엔진이 자료를 찾아 정리하고 시각 장애인이 화면의 내용을 읽어주는 소프트웨어로 문서를 이해하는 데 도움을 줍니다. [[파일:File.jpg|섬네일|보이는 설명|alt=보이지 않는 설명]]과 같이 입력이 가능합니다. 가능한 상세하게 이해가 가능하도록 적는 것이 좋으며, 장식적 요소 등 설명의 의미를 갖지 못할 경우에는 적지 않는 것이 적합한 경우도 있습니다.
이미지의 가로, 세로 길이를 조절하고 싶으면 [[파일:File.jpg|너비x높이px]]를 쓰면 됩니다! (svg 파일만 가능하며, 나미저 파일은 가로/세로 비율에 따라 자동으로 조절됨) 너비는 자동으로 조절되고 높이만 고정하고 싶으면 너비를 입력하지 마세요([[파일:File.jpg|x높이px]]).
갤러리(여러 이미지 넣기)
갤러리는 여러 이미지를 섬네일로 함께 넣는 기능입니다. 총 사용방법은 <gallery {변수}>파일|설명|alt=대체 텍스트</gallery>입니다.
기본
갤러리로 입력할 때에는 대괄호를 사용하지 않으며, 나머지는 앞서 설명한 사진 넣기 문단과 동일합니다. 또한, '파일:'은 생략할 수 있습니다.
링크 없음: 'link=' 다음에 아무것도 입력하지 않으면, 파일에 링크가 걸리지 않아 클릭할 수 없습니다.
대체 텍스트(alt)
대체 텍스트는 시각 장애인이 화면의 내용을 읽어주는 소프트웨어로 문서를 이해하거나 검색 엔진이 자료를 찾아 정리하는 데 도움을 주는 텍스트로, 일반적으로는 보이지 않습니다. 따라서 이해가 가능하도록 적는 것이 좋으며, 장식적 요소 등 설명의 의미를 갖지 못할 경우에는 적지 않는 것이 적합한 경우도 있습니다.
입력
결과
설명
[[파일:Aggropteryx 1.gif|150px|alt=앉은 채 부리로 무언가를 씹는 깃털공룡 형태의 리브레 위키 공인 캐릭터.]]
<imagemap>
Image:NY 6.png|thumb|center|400px|alt=(이미지가 나오지 않을 때 보여주는 대체 문구입니다.) |[[마스코트]] 모음
poly 80 50 80 230 246 234 236 50 [[리브렌]]
poly 0 240 190 240 196 319 207 450 0 450 [[리브라]]
poly 442 36 361 108 372 282 500 313 500 35 [[리디버그]]
rect 200 300 265 360 [[리디버그 볶음밥]]
</imagemap>
위 링크는 이렇게 구성되어 있습니다. 이 구조를 설명하자면
<imagemap>
Image:(이미지)|섬네일(선택)|(정렬)|(크기)|alt=(이미지가 나오지 않을 때 보여주는 대체 문구입니다.) |(설명)
poly 좌표1(x) 좌표1(y) 좌표2(x) 좌표2(y) 좌표3(x) 좌표3(y) ...... [[문서]]
rect 좌표1(x) 좌표1(y) 좌표2(x) 좌표2(y) [[문서]]
</imagemap>
이미지 : 파일:xxx.jpg 라는 파일에서 xxx.jpg를 의미합니다.
섬네일 : 섬네일 형식으로 표현하려면 입력합니다.
정렬 : 필요하다면, 이미지의 정렬을 선택합니다. 왼쪽, 가운데, 오른쪽이 있습니다.
크기 : 이미지가 표시될 크기를 선택합니다. 픽셀 단위로 500px 처럼 표현합니다.
alt= 뒤의 내용 : 이미지가 표시되지 않으면 대신 나오는 문구입니다. 일반적으로 잘 뜨지 않습니다.
설명 : 이 그림을 설명하는 내용을 적으면 됩니다. 이 문구 전체를 [[어떤 문서]]로 감싸면 안됩니다. 만약 전체를 감쌀 경우, 다음 링크 이전까지의 텍스트가 "전부 이미지의 링크"로 처리되는 문제가 발생합니다.
poly (좌표1, 좌표2, .... 좌표n)문서 : polygon(다각형) 형태로 표현되는 링크 입니다. 입력한 값들을 픽셀형태의 좌표로 인식한 뒤, 그것들을 선으로 이어서, 그 안쪽을 클릭하면 문서로 넘어갈수 있게 해줍니다.
rect (좌표1, 좌표2) 문서 : rectangle(직사각형) 형태로 표현됩니다. 두 점을 좌표로 입력받아서 한점은 왼쪽 위, 한점은 오른쪽 아래의 좌표로 인식해서, 그 안쪽을 클릭하면 문서로 넘어갈수 있게 해줍니다.
circle (좌표, 반지름) 문서 : circle (원) 형태로 형태로 표현됩니다. 세 값을 입력 받아서 앞의 두값은 x y 좌표, 마지막 값은 반지름 입니다. poly, rect, circle에서의 단위는 픽셀이며, 좌표 기준은 좌측 상단입니다.
default 문서 : "위에서 설정하지 않은 나머지 영역"에 대한 문서 링크를 설정합니다.
여기에 필요한 좌표값은 다음과 같은 방법으로 확인 가능합니다.
우선 그림판을 이용해서 좌표를 확인할 수 있습니다. 링크를 달고자 하는 해당 이미지 파일을 받아서 그림판으로 여시고, 선택이나 그리기 툴로 그림위에 갖다대면, 그림판 왼쪽아래에 ╋ 123, 45 px 라고 뜨게됩니다. 그 값이 좌표(x,y)이므로, 편집할때 사용하시면 됩니다.
그보다 더 간단한 방법은 map.net/ Image map 웹페이지를 이용해서 이미지를 올린 다음에 poly, rect, circ 속성 중 하나를 고르고 이미지 위에 마우스로 표시할 수 있습니다. 이후에 Show me the codes 버튼을 누르면 픽셀값이 정확하게 출력되는 것을 알 수 있습니다.
문서를 읽은 때는 보이지 않고 편집 시에만 보이는 주석을 달려면, 주석을 넣을 곳에 <! 주석내용 >를 입력합니다. HTML에서 사용하는 주석과 문법이 같지만 HTML에서 사용하는 주석과는 달리, 브라우저에서 소스 보기를 해도 표시되지 않으며 오로지 편집 창에<! no >서만 보인다는 특징이 있습니다.
입력
결과
<! 보이지 않는 주석 >보이는 내용
<! 보이지 않는 주석 >보이는 내용
위키 문법 무시하기
내용의 문자가 위키 문법과 겹쳐 원하는 내용이 제대로 표시되지 않는다면 <nowiki>위키 문법이 무시될 부분</nowiki>으로 일부분에서 위키 문법을 무시하도록 할 수 있습니다.
입력
결과
* 위에 있는 건 목록으로 표시되지만,
<nowiki>*</nowiki> 아래에 있는 건 별표(아스테리스크)로 나타남.
미디어위키에서는 html과 CSS 문법을 상당수 지원합니다. 이하는 html, CSS의 태그를 활용하는 방법의 예시를 설명합니다.
펼치기/접기 (태그 이용)
예시
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
<syntaxhighlight lang=html>
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
</syntaxhighlight>
박스가 쳐져 있는 것을 원치 않으실 경우에는 class에서 toccolours 값을 제거해주시면 됩니다.
예시
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
<syntaxhighlight lang=html>
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
</syntaxhighlight>
박스의 가로 크기를 조정하고 싶으신 경우에는 style에 width 값을 넣어주시면 됩니다.
예시
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
<syntaxhighlight lang=html>
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
</syntaxhighlight>
테두리를 없애도 가로 크기 조절이 가능합니다.
예시
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
<syntaxhighlight lang=html>
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
</syntaxhighlight>
위의 모든 예시 공통으로 class에서 mw collapsed을 제거하면 처음부터 펼쳐진 상태가 됩니다.
예시
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
<syntaxhighlight lang=html>
스포일러 주의
사실 그녀의 정체는 위키 페어리인 척하는 위키모이였다.
</syntaxhighlight>
문서 내부에 책갈피(anchor) 만들기
문서 내부에 <span id="(책갈피 이름)">(책갈피를 만들 곳)</span>를 삽입하면 해당 위치로 스크롤되어 이동할 수 있는 책갈피(anchor)가 만들어집니다. 해당 책갈피가 있는 곳으로 이동하는 링크는 [[(문서명)#(책갈피 이름)]] 형태를 이용해서 작성할 수 있습니다.
문단을 다른 이름으로도 접근 가능하게 하려면(문단 별칭) === <span id="(다른 이름)"/> 문단 이름 ===처럼 입력해도 됩니다. === <span id="(다른 이름)"> 문단 이름 </span> ===과 일치합니다.
입력
<syntaxhighlight lang=html style="width: 400px;">
세 번째부터 시작하는 순서가 있는 목록
이어지는 목록
항목의 설명
이어지는 목록
이어지는 목록
이어지는 목록
</syntaxhighlight>
결과
세 번째부터 시작하는 순서가 있는 목록
이어지는 목록
항목의 설명
이어지는 목록
이어지는 목록
이어지는 목록
<ol start="시작할 순서">에 시작을 원하는 숫자를 넣어 사용합니다.
다음과 같이 중첩된 목록에서의 순서를 지정할 수도 있습니다.
입력
<syntaxhighlight lang=html style="width: 400px;">
세 번째부터 시작하는 순서가 있는 목록
세 번째부터 시작하는 중첩된 목록
이어지는 목록
</syntaxhighlight>
결과
세 번째부터 시작하는 순서가 있는 목록
세 번째부터 시작하는 중첩된 목록
이어지는 목록
테두리 그레디언트
테두리 그레디언트는 웹 디자인에서도 자주 쓰입니다.
<syntaxhighlight lang=html style="">
테두리 그레디언트
</syntaxhighlight>
테두리 그레디언트
border image에 그레디언트 속성을 작성해도 테두리 그레디언트가 적용이 되는데 그러면 border radius가 먹히지 않으니 위의 예시대로 작성해주셔야 됩니다. 배경을 두 부분으로 나누어 주어 테두리 안쪽을 기준으로 한 배경(padding box)을 흰색 흰색, 그레디언트 테두리를 기준으로 한 배경(border box)에 그레디언트를 적용해주고 테두리 색을 투명으로 지정해 주면 border box의 그레디언트가 테두리에만 노출되게 됩니다. 반드시 padding box 먼저 그 다음 border box 순서로 작성해야 됩니다. 반대로 적으면 border box 속성이 padding box를 씹어먹기 때문에 정상적으로 출력이 안됩니다.
시를 쓸 때 유용합니다. 이 태그 안의 내용은 줄바꿈이나 띄어쓰기를 그대로 반영하지만 위키 문법을 무시하지 않습니다.
<pre>
회색 상자를 생성하며, 줄바꿈이나 띄어쓰기 등을 그대로 반영한 채로 입력합니다. 리브레 위키에서는 pre 태그 안에 있는 내용은 위키 문법을 자동으로 무시하고 텍스트로 입력한 내용 그대로 출력합니다.
<syntaxhighlight>
각종 프로그래밍 언어에서 특정 키워드에 강조 효과를 주는 소스 코드를 출력합니다. lang 입력 없으면 css가 기본적으로 출력됩니다. 이 상자 안의 내용은 줄바꿈이나 띄어쓰기는 그대로 반영하며, style 태그 등으로 효과를 줄 수는 없습니다. 위의 코드 입력(syntaxhighlight) 문단을 참고하세요.
<poem style="background:#eee;
border:1px solid black;
width:85%;">
<big style="color:blue;
text align:center">'''호수'''</big>
''정지용''
얼골 하나야
손바닥 둘로
폭 가리지만,
보고 싶은 맘
湖水만 하니
눈 감을 밖에
</poem>
<pre style="background:#eee;
border:1px solid black;
width:85%;">
<big style="color:blue;
text align:center">'''호수'''</big>
''정지용''
얼골 하나야
손바닥 둘로
폭 가리지만,
보고 싶은 맘
湖水만 하니
눈 감을 밖에
</pre>
결과
호수 정지용
얼골 하나야
손바닥 둘로
폭 가리지만,
보고 싶은 맘
湖水만 하니
눈 감을 밖에
<big style="color:blue;
text align:center">'''호수'''</big>
''정지용''
얼골 하나야
손바닥 둘로
폭 가리지만,
보고 싶은 맘
湖水만 하니
눈 감을 밖에