목차

서식 문법

도쿠위키는 데이터 파일을 최대한 읽기 쉽게 유지하기 위해 간단한 마크업 언어를 지원합니다. 이 페이지는 페이지 편집 시 사용할 수 있는 모든 가능한 문법을 포함하고 있습니다. “이 페이지 편집하기” 버튼을 눌러 이 페이지의 소스를 직접 확인해 보세요. 무언가 테스트해보고 싶다면 연습장 페이지를 이용하세요. 간단한 마크업은 퀵버튼 툴바를 통해서도 쉽게 사용할 수 있습니다.

기본 텍스트 서식

도쿠위키는 굵게(bold), 기울임(italic), 밑줄(underlined) 및 타이핑체(monospaced) 텍스트를 지원합니다. 물론 이 모든 서식들을 혼합해서 사용할 수도 있습니다. 

도쿠위키는 **굵게(bold)**, //기울임(italic)//, __밑줄(underlined)__ 및 ''타이핑체(monospaced)'' 텍스트를 지원합니다.
물론 이 모든 서식들을 **__//''혼합''//__**해서 사용할 수도 있습니다.

아래 첨자(subscript)와 위 첨자(superscript)도 사용 가능합니다. 

<sub>아래 첨자</sub>와 <sup>위 첨자</sup>도 사용할 수 있습니다.

무언가를 삭제(deleted)된 것으로 표시할 수도 있습니다. 

무언가를 <del>삭제(deleted)</del>된 것으로 표시할 수도 있습니다.

단락(Paragraphs)은 빈 줄을 통해 생성됩니다. 만약 단락 없이 강제로 줄바꿈을 하려면 백슬래시 두 개(`\\`) 뒤에 공백을 넣거나 줄의 끝에서 줄을 바꾸면 됩니다.

이것은 줄바꿈이 포함된 텍스트입니다
주의할 점은 두 개의 백슬래시는 오직 줄의 끝에서만 인식되거나
혹은 뒤에
공백이 올 때만 인식됩니다 \\이것은 공백이 없어서 그대로 표시됩니다. 

이것은 줄바꿈이 포함된 텍스트입니다\\ 주의할 점은
두 개의 백슬래시는 오직 줄의 끝에서만 인식되거나\\
혹은 뒤에\\ 공백이 올 때만 인식됩니다 \\이것은 공백이 없어서 그대로 표시됩니다.

강제 줄바꿈은 정말 필요한 경우에만 사용해야 합니다.

링크

도쿠위키는 링크를 만드는 다양한 방법을 지원합니다.

외부

외부 링크는 자동으로 인식됩니다: http://www.google.com 또는 단순히 www.google.com - 링크 텍스트를 직접 설정할 수도 있습니다: 이 링크는 구글을 가리킵니다. andi@splitbrain.org와 같은 이메일 주소도 마찬가지로 인식됩니다. 

도쿠위키는 링크를 만드는 다양한 방법을 지원합니다. 외부 링크는 자동으로
인식됩니다: http://www.google.com 또는 단순히 www.google.com - 링크 텍스트를
직접 설정할 수도 있습니다: [[http://www.google.com|이 링크는 구글을 가리킵니다]].
<[email protected]>와 같은 이메일 주소도 마찬가지로 인식됩니다.

내부

내부 링크는 대괄호를 사용하여 만듭니다. 단순히 페이지이름만 적거나 추가적인 링크 텍스트를 사용할 수 있습니다. 

내부 링크는 대괄호를 사용하여 만듭니다. 단순히 [[페이지이름]]만 적거나
추가적인 [[페이지이름|링크 텍스트]]를 사용할 수 있습니다.

위키 페이지 이름은 자동으로 소문자로 변환되며, 특수 문자는 허용되지 않습니다.

페이지 이름에 콜론을 사용하여 네임스페이스를 사용할 수 있습니다. 

페이지 이름에 콜론을 사용하여 [[어떤:네임스페이스]]를 사용할 수 있습니다.

네임스페이스에 대한 자세한 내용은 namespaces를 참조하십시오.

특정 섹션으로 링크하는 것도 가능합니다. HTML에서 알려진 것처럼 섹션 이름 뒤에 해시(#) 기호를 추가하면 됩니다. 이 링크는 이 섹션으로 연결됩니다. 

이 링크는 [[syntax#내부|이 섹션]]으로 연결됩니다.

참고:

인터위키

도쿠위키는 Interwiki 링크를 지원합니다. 이는 다른 위키로 연결되는 빠른 링크입니다. 예를 들어, 다음은 위키에 대한 위키백과 페이지로 연결되는 링크입니다: Wiki. 

도쿠위키는 [[doku>Interwiki]] 링크를 지원합니다. 이는 다른 위키로 연결되는 빠른 링크입니다.
예를 들어, 다음은 위키에 대한 위키백과 페이지로 연결되는 링크입니다: [[wp>Wiki]].

Windows 공유

이것과 같은 Windows 공유도 인식됩니다. 이는 기업의 인트라넷과 같이 동질적인 사용자 그룹에서만 의미가 있다는 점에 유의하십시오. 

[[\\server\share|이것]]과 같은 Windows 공유도 인식됩니다.

참고:

이미지 링크

링크 문법과 이미지 문법(아래 참조)을 결합하여 내부 또는 외부 페이지로 연결되는 이미지를 사용할 수도 있습니다: 

[[http://php.net|{{wiki:dokuwiki-128.png}}]]

참고: 이미지 서식은 링크 이름에서 허용되는 유일한 서식 문법입니다.

전체 이미지 및 링크 문법이 지원됩니다 (이미지 크기 조정, 내부 및 외부 이미지와 URL, 인터위키 링크 포함).

각주

이중 괄호를 사용하여 각주1)를 추가할 수 있습니다. 

이중 괄호를 사용하여 각주((이것은 각주입니다))를 추가할 수 있습니다.

섹션 구분

콘텐츠의 구조를 짜기 위해 최대 5단계의 제목을 사용할 수 있습니다. 제목이 3개 이상이면 목차가 자동으로 생성됩니다. 문서 안에 ~~NOTOC~~라는 문자열을 넣으면 목차 생성을 비활성화할 수 있습니다.

제목 레벨 3

제목 레벨 4

제목 레벨 5
==== 제목 레벨 3 ====
=== 제목 레벨 4 ===
== 제목 레벨 5 ==

4개 이상의 대시(-)를 사용하면 가로 구분선을 만들 수 있습니다:

미디어 파일

중괄호를 사용하여 외부 및 내부 이미지, 비디오 및 오디오 파일을 포함할 수 있습니다. 선택적으로 크기를 지정할 수 있습니다.

실제 크기:

지정한 너비로 크기 조정:

지정한 너비와 높이로 크기 조정2):

크기가 조정된 외부 이미지: 

실제 크기:                        {{wiki:dokuwiki-128.png}}
지정한 너비로 크기 조정:            {{wiki:dokuwiki-128.png?50}}
지정한 너비와 높이로 크기 조정:      {{wiki:dokuwiki-128.png?200x50}}
크기가 조정된 외부 이미지:           {{https://www.php.net/images/php.gif?200x50}}

왼쪽이나 오른쪽에 공백을 사용하여 정렬을 선택할 수 있습니다. 

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

물론 제목(대부분의 브라우저에서 툴팁으로 표시됨)을 추가할 수도 있습니다.

이것은 캡션입니다 

{{ wiki:dokuwiki-128.png |이것은 캡션입니다}}

이미지를 다른 페이지로 연결하려면 위의 이미지 링크를 참조하십시오.

지원되는 미디어 형식

도쿠위키는 다음 미디어 형식을 직접 삽입할 수 있습니다.

이미지 gif, jpg, png
비디오 webm, ogv, mp4
오디오 ogg, mp3, wav
Flash swf

지원되지 않는 미디어 형식의 파일 이름을 지정하면, 대신 링크로 표시됩니다.

?linkonly를 추가하면 미디어를 인라인으로 표시하지 않고 해당 미디어로 연결되는 링크를 제공합니다. 

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.png 이것은 단지 이미지로 연결되는 링크입니다.

대체 형식

안타깝게도 모든 브라우저가 모든 비디오 및 오디오 형식을 지원하는 것은 아닙니다. 이 문제를 완화하기 위해 브라우저 호환성을 극대화할 수 있도록 파일을 다양한 형식으로 업로드할 수 있습니다.

예를 들어, 삽입된 mp4 비디오를 생각해 보십시오: 

{{video.mp4|재미있는 비디오}}

참조된 video.mp4와 함께 video.webm 및 video.ogv를 업로드하면, 도쿠위키는 브라우저가 세 파일 중 하나를 인식할 수 있도록 자동으로 대체 파일로 추가합니다.

또한 도쿠위키는 비디오가 시작되기 전에 표시될 “포스터” 이미지를 지원합니다. 이 이미지는 비디오와 파일 이름이 같아야 하며 jpg 또는 png 파일이어야 합니다. 위의 예시에서는 video.jpg 파일이 작동할 것입니다.

목록

도쿠위키는 순서 없는 목록과 순서 있는 목록을 지원합니다. 목록 항목을 만들려면 텍스트를 두 개의 공백으로 들여쓰고, 순서 없는 목록은 *를, 순서 있는 목록은 -를 사용하십시오.

  1. 동일한 목록이지만 순서가 있습니다
  2. 또 다른 항목
    1. 더 깊은 레벨을 위해 들여쓰기를 사용하십시오
  3. 그게 전부입니다
  * 이것은 목록입니다
  * 두 번째 항목
    * 다른 레벨을 가질 수 있습니다
  * 또 다른 항목

  - 동일한 목록이지만 순서가 있습니다
  - 또 다른 항목
    - 더 깊은 레벨을 위해 들여쓰기를 사용하십시오
  - 그게 전부입니다

또한 목록 항목에 대한 FAQ를 확인해 보십시오.

텍스트 변환

도쿠위키는 사전 정의된 특정 문자나 문자열을 이미지, 다른 텍스트 또는 HTML로 변환할 수 있습니다.

텍스트를 이미지로 변환하는 기능은 주로 스마일리(이모티콘)에 사용됩니다. 텍스트를 HTML로 변환하는 기능은 타이포그래피 치환에 사용되지만, 다른 HTML을 사용하도록 설정할 수도 있습니다.

텍스트를 이미지로 변환

도쿠위키는 흔히 사용되는 이모티콘을 그에 해당하는 그래픽 이미지로 변환합니다. 이러한 스마일리와 기타 이미지들은 설정하거나 확장할 수 있습니다. 다음은 도쿠위키에 포함된 스마일리 개요입니다:

텍스트를 HTML로 변환

타이포그래피: DokuWiki는 단순한 텍스트 문자를 타이포그래피적으로 올바른 엔티티로 변환할 수 있습니다. 다음은 인식되는 문자들의 예시입니다.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…” 

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

모든 종류의 HTML을 생성하도록 동일한 설정을 할 수 있으며, 패턴 파일에 추가하기만 하면 됩니다.

해당 패턴 파일에서 가져오지 않는 세 가지 예외가 있습니다: 곱셈 기호(640×480), '단일 인용구' 및 “이중 인용구”. 이들은 설정 옵션을 통해 끌 수 있습니다.

인용

때로는 어떤 텍스트가 답변이나 의견임을 나타내기 위해 표시하고 싶을 때가 있습니다. 다음 문법을 사용할 수 있습니다: 

내 생각엔 우리가 이걸 해야 해

> 아니, 하면 안 돼

>> 글쎄, 난 해야 한다고 봐

> 정말로?

>> 응!

>>> 그럼 하자!

내 생각엔 우리가 이걸 해야 해

아니, 하면 안 돼
글쎄, 난 해야 한다고 봐
정말로?
응!
그럼 하자!

표

도쿠위키는 표를 만들기 위한 간단한 문법을 지원합니다.

제목 1 제목 2 제목 3
1행 1열 1행 2열 1행 3열
2행 1열 가로 병합 (이중 파이프 기호에 주목)
3행 1열 3행 2열 3행 3열

표의 행은 일반 행의 경우 |, 제목 행의 경우 ^로 시작하고 끝나야 합니다. 

^ 제목 1          ^ 제목 2           ^ 제목 3             ^
| 1행 1열        | 1행 2열          | 1행 3열            |
| 2행 1열        | 가로 병합 (이중 파이프 기호에 주목) ||
| 3행 1열        | 3행 2열          | 3행 3열            |

셀을 가로로 연결하려면 위의 예시처럼 다음 셀을 완전히 비워두면 됩니다. 셀 구분자의 개수가 항상 일정하도록 확인하십시오!

세로형 표 제목도 가능합니다.

제목 1 제목 2
제목 3 1행 2열 1행 3열
제목 4 이번엔 가로 병합 없음
제목 5 2행 2열 2행 3열

보시다시피, 서식을 결정하는 것은 셀 앞의 구분자입니다: 

|              ^ 제목 1                ^ 제목 2             ^
^ 제목 3        | 1행 2열              | 1행 3열            |
^ 제목 4        | 이번엔 가로 병합 없음   |                    |
^ 제목 5        | 2행 2열              | 2행 3열            |

연결하려는 셀 아래의 셀에 :::를 추가하여 세로 병합(rowspan)을 할 수 있습니다.

제목 1 제목 2 제목 3
1행 1열 이 셀은 세로로 병합됩니다 1행 3열
2행 1열 2행 3열
3행 1열 3행 3열

세로 병합 문법을 사용하는 셀에는 해당 기호 외에 다른 내용을 포함해서는 안 됩니다. 

^ 제목 1          ^ 제목 2                    ^ 제목 3             ^
| 1행 1열        | 이 셀은 세로로 병합됩니다     | 1행 3열            |
| 2행 1열        | :::                        | 2행 3열            |
| 3행 1열        | :::                        | 3행 3열            |

표 내용의 정렬도 가능합니다. 텍스트의 반대쪽 끝에 최소 두 개의 공백을 추가하면 됩니다: 오른쪽에 맞추려면 왼쪽에 두 개의 공백을, 왼쪽에 맞추려면 오른쪽에 두 개의 공백을, 가운데 정렬은 양쪽 끝에 최소 두 개의 공백을 추가하십시오.

정렬이 적용된 표
오른쪽 가운데 왼쪽
왼쪽 오른쪽 가운데
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

소스 코드에서는 다음과 같이 보입니다: 

^           정렬이 적용된 표           ^^^
|            오른쪽|    가운데    |왼쪽          |
|왼쪽          |            오른쪽|    가운데    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

참고: 수직 정렬은 지원되지 않습니다.

서식 미적용

입력한 그대로의 텍스트를 서식 없이 표시해야 할 경우(어떤 서식도 없이), 해당 영역을 <nowiki> 태그로 감싸거나 더 간단하게 이중 퍼센트 기호인 %%를 사용하십시오.

이것은 http://www.splitbrain.org 와 같은 주소와 **서식**을 포함하고 있는 텍스트이지만, 아무런 처리도 되지 않습니다. 스마일리 ;-)가 포함된 //__이__ 텍스트//의 경우도 마찬가지입니다. 

<nowiki>
이것은 http://www.splitbrain.org 와 같은 주소와 **서식**을 포함하고 있는 텍스트이지만, 아무런 처리도 되지 않습니다.
</nowiki>
스마일리 ;-)가 포함된 %%//__이__ 텍스트//%%의 경우도 마찬가지입니다.

코드 블록

최소 두 개의 공백으로 들여쓰거나(이전 예시들에서 사용된 방식), <code> 또는 <file> 태그를 사용하여 문서에 코드 블록을 포함할 수 있습니다. 

이 텍스트는 두 개의 공백으로 들여쓰기 되었습니다.
이것은 서식이 지정된 코드이며 모든 공백이 유지됩니다: 예시              <-이렇게
이것도 거의 동일하지만, 파일을 인용했음을 나타낼 때 사용할 수 있습니다.

위의 블록들은 다음과 같은 소스로 생성되었습니다: 

  이 텍스트는 두 개의 공백으로 들여쓰기 되었습니다.
<code>
이것은 서식이 지정된 코드이며 모든 공백이 유지됩니다: 예시              <-이렇게
</code>
<file>
이것도 거의 동일하지만, 파일을 인용했음을 나타낼 때 사용할 수 있습니다.
</file>

구문 강조

DokuWiki는 소스코드를 읽기 쉽게 강조(Highlighting)할 수 있습니다. 이는 GeSHi Generic Syntax Highlighter를 사용하므로, GeSHi가 지원하는 모든 언어를 지원합니다. 이전 섹션에서 설명한 코드 및 파일 블록과 동일한 문법을 사용하지만, 이번에는 강조할 언어 이름을 태그 안에 포함합니다. 예: <code java> 또는 <file java>. 

/**
 * HelloWorldApp 클래스는 표준 출력에
 * "Hello World!"를 표시하는 애플리케이션을 구현합니다.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); // 문자열을 표시합니다.
    }
}

현재 다음 언어들이 인식됩니다: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

특정 줄을 강조하거나 줄 번호를 추가하는 것과 같은 추가적인 고급 옵션들을 구문 강조에 사용할 수 있습니다.

다운로드 가능한 코드 블록

위에서 설명한 <code> 또는 <file> 문법을 사용할 때, 표시된 코드를 다운로드할 수 있도록 만들고 싶을 수 있습니다. 다음과 같이 언어 코드 뒤에 파일 이름을 지정하면 됩니다: 

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

구문 강조를 원하지 않지만 다운로드 가능한 파일을 만들고 싶다면, 언어 코드 자리에 대시(-)를 넣으십시오: <code - myfile.foo>.

RSS/ATOM 피드 통합

DokuWiki는 외부 XML 피드의 데이터를 통합할 수 있습니다. XML 피드 분석에는 SimplePie가 사용됩니다. SimplePie가 인식하는 모든 형식은 도쿠위키에서도 사용할 수 있습니다. 공백으로 구분된 여러 추가 매개변수를 통해 렌더링 방식을 조정할 수 있습니다:

매개변수 설명
숫자 표시할 항목의 최대 개수이며, 기본값은 8입니다
reverse 피드의 마지막 항목을 먼저 표시합니다
author 항목 작성자 이름을 표시합니다
date 항목 날짜를 표시합니다
description 항목 설명을 표시합니다. 모든 HTML 태그는 제거됩니다
nosort 피드의 항목을 정렬하지 않습니다
n[dhm] 새로고침 주기이며 d=일, h=시간, m=분입니다. (예: 12h = 12시간).

새로고침 주기의 기본값은 4시간입니다. 10분 미만의 값은 모두 10분으로 취급됩니다. DokuWiki는 일반적으로 페이지의 캐시된 버전을 제공하려고 하지만, 페이지에 동적인 외부 콘텐츠가 포함된 경우에는 적절하지 않습니다. 이 매개변수는 페이지가 마지막으로 렌더링된 후 새로고침 주기보다 더 많은 시간이 지났을 경우 페이지를 다시 렌더링하도록 DokuWiki에 지시합니다.

기본적으로 피드는 날짜별로 정렬되어 최신 항목이 먼저 표시됩니다. reverse 매개변수를 사용하여 오래된 항목을 먼저 정렬하거나, nosort를 사용하여 피드 그대로 표시할 수 있습니다.

예시: 

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

제어 매크로

일부 문법은 스스로 출력을 생성하지 않으면서 도쿠위키가 페이지를 렌더링하는 방식에 영향을 줍니다. 다음과 같은 제어 매크로를 사용할 수 있습니다:

매개변수 설명
~~NOTOC~~ 페이지 내에 이 매크로가 있으면 목차를 생성하지 않습니다
~~NOCACHE~~ 도쿠위키는 기본적으로 모든 출력을 캐시합니다. 때때로 이를 원하지 않을 경우(예: 위에서 설명한 <php> 문법을 사용한 경우), 이 매크로를 추가하여 호출할 때마다 도쿠위키가 페이지를 다시 렌더링하도록 강제할 수 있습니다

문법 플러그인

도쿠위키의 문법은 플러그인을 통해 확장될 수 있습니다. 설치된 플러그인의 사용법은 해당 플러그인의 설명 페이지에 기술되어 있습니다. 현재 이 도쿠위키 설치본에서 사용할 수 있는 문법 플러그인은 다음과 같습니다:

1)
이것은 각주입니다
2)
지정한 너비와 높이의 가로세로 비율이 이미지와 일치하지 않는 경우, 크기를 조정하기 전에 새로운 비율에 맞춰 이미지가 잘립니다