포맷팅 문법

DokuWiki는 가능한 한 데이타 파일들을 쉽게 읽어들이기위해 간단한 markup언어를 지원하고 있습니다. 이 페이지는 페이지들을 편집할 때 사용가능한 모든 문법들을 설명하고 있습니다.

간단하게 이 페이지 상단과 하단에 있는 페이지 편집 버튼을 클릭하면, 페이지의 소스를 볼 수 있습니다. 시험 삼아 편집을 해보고 싶다면 낙서장 페이지를 사용해 보시기 바랍니다. 더 쉽게 문법을 익히려면 퀵버튼을 이용해 보시기 바랍니다.

링크

Dokuwiki는 링크를 생성하는 여러가지 방법을 지원합니다.

외부 링크

http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 인식됩니다. google에 연결처럼 연결 이름을 설정할 수도 있으며, test [at] splitbrain [dot] org 형식의 email 주소 역시 자동으로 인식됩니다.

http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 인식됩니다. 
[[http://www.google.com|google에 연결]]처럼 연결 이름을 설정할 수도 있으며,
<test@splitbrain.org> 형식의 email 주소 역시 자동으로 인식됩니다.

내부 링크

내부 링크는 중첩된 대괄호 문자들을 사용해서 만들수 있습니다. pagename처럼 페이지 이름을 그대로 사용하거나 페이지 이름 처럼 페이지 이름을 직접 설정할 수도 있습니다.

[[doku>wiki:pagename]]처럼 페이지 이름을 그대로 사용하거나 
[[doku>wiki:pagename| 페이지 이름]] 처럼 페이지 이름을 직접 설정할 수도 있습니다.

페이지 이름에 콜론 문자를 사용하여 네임스페이스(이름 공간)를 사용할 수 있습니다.

페이지 이름에 콜론 문자를 사용하여 [[wiki:namespaces]](이름 공간)를 사용할 수 있습니다.

자세한 부분들은 namespaces를 보기 바랍니다.

페이지 내의 특정 섹션에 링크하는 하려면 해쉬 기호(#)에 이어 섹션명을 기술합니다. 이 섹션로 연결됬습니다.

[[syntax#내부 링크|이 섹션]]로 연결됬습니다.

주석:

기존 페이지와 링크하는 것과 존재하지 않는 페이지와 링크하는 것은 표시되는 모습이 다릅니다..
기본적으로 자동적으로 링크를 만들기 위한 CamelCase를 사용하지 않지만, config파일에서 변경할 수 있습니다. 만일 DokuWiki가 링크가 되어 있으면 사용이 가능한 상태입니다.
섹션의 이름이 바뀐다면, 링크 이름 역시 바뀌게 됩니다. 섹션으로의 링크는 너무 많이 사용하지 않도록 하기 바랍니다.

Interwiki

Dokuwiki는 Interwiki링크를 사용할 수 있습니다. InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 예를 들어 Wiki는 Wikipedia 페이지에 대한 링크입니다.

Dokuwiki는 [[doku>wiki:interwiki|Interwiki]]링크를 사용할 수 있습니다.
InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 
예를 들어 [[wp>Wiki]]는 Wikipedia 페이지에 대한 링크입니다.

Windows 공유 폴더

Windows 공유 폴더도 this처럼 사용할 수 있습니다. 다만,인트라넷환경 같은 단일 사용자 그룹에서만 적용되는 것에 주의하기 바랍니다.

Windows 공유 폴더도 [[servershare|this]]처럼 사용할 수 있습니다.

주석:

보안상의 이유로, Windows 공유 폴더를 직접 브라우즈 할 수 있는 것은, 기본적으로 Microsoft Internet Explorer(의 “로컬 영역”)에서만 Windows 공유 폴더에 직접 접근 가능합니다.
추천되지는 않지만, Mozilla나 Firefox에서 설정 옵션의 security.checkloaduri을 변경해서 직접 접근이 가능합니다.
자세한 사항은 151을 보기 바랍니다.

그림 링크

다음과 같이 링크에 관련된 문법과 그림 (아래 참조)을 조합하면, 내부링크와 외부 링크에 대해 이미지를 이용할 수 있습니다.

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

주의: 링크 이름에서만 문법 서식이 사용가능 합니다. 그림과 링크 문법은 모두 사용 가능합니다. (그림 크기 변경,내부 그림, 외부 그림, URL, interwiki 링크 포함)

각주

중첩된 소괄호를 이용하여 각주¹⁾를 추가할 수 있습니다.

중첩된 소괄호를 이용하여 각주((이 것이 각주))를 추가할 수 있습니다.

섹션 설정

문서 내용을 구조적으로 만들기 위해 최대 5개 레벨까지의 섹션를 사용 가능합니다.

3개 이상의 섹션 이름들을 가지고 있는 경우 목차가 자동적으로 생성됩니다. 문서내에 ~~NOTOC~~문자열이 있는 경우 자동적으로 목차가 생성되지 않습니다.

3레벨 섹션 이름

4레벨 섹션 이름

5레벨 섹션 이름

==== 3레벨 섹션 이름 ====
=== 4레벨 섹션 이름 ===
== 5레벨 섹션 이름 ==

데쉬 (-)를 네 개 이상 연속해서 사용한다면, 수평선을 만들수 있습니다.

그림과 그 외의 파일들

중괄호를 사용하여 위키 외부그림과 위키 내의그림을 포함할 수 있습니다. 옵션으로 그림 크기를 지정할 수 있습니다.

실제 크기:

폭 변경:

폭과 높이 변경:

외부 그림 크기 변경:

실제 크기:          {{wiki:dokuwiki-128.png}}
폭 변경:            {{wiki:dokuwiki-128.png?50}}
폭과 높이 변경:      {{wiki:dokuwiki-128.png?200x50}}
외부 그림 크기 변경:  {{http://de3.php.net/images/php.gif?200x50}}

좌,우측에 공백 문자를 사용하여 정렬 위치를 선택할 수 있습니다.

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

물론 그림 이름 역시 추가할 수 있습니다.(대부분의 브라우저에서 툴 팁으로 보여집니다)

목록

Dokuwiki는 번호 목록과 번호없는 목록들을 지원합니다. 스페이스2개로 들여쓰기 후에 번호없는 목록은 *을 사용하거나 번호 목록은 -을 사용합니다.

목록입니다.
2번째 항목
- 다른 레벨이 있을 수도 있습니다.
또 다른 항목

번호 목록입니다.
또 다른 항목
1. 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
이상 끝

  * 목록입니다.
  * 2번째 항목
    * 다른 레벨이 있을 수도 있습니다.
  * 또 다른 항목

  - 번호 목록입니다.
  - 또 다른 항목
    - 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
  - 이상 끝

smiley

DokuWiki는 일반적으로 사용되는 emoticon을 그림으로 쓸 수 있게 지원합니다. 더 많은 smiley들이 smiley디렉토리에 있으며 conf/smileys.conf파일을 이용해 설정을 바꿀 수 있습니다.

DokuWiki에서 사용할 수 있는 기본 smiley들입니다.

8-)
8-O
:-(
:-)
=)
:-/
$:-\$ :-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME

기호

DokuWiki는 간단한 문자들을 대응하는 기호로 바꿀 수 있습니다. 자동으로 처리되는 문자들의 예들입니다.

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

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

주의： 설정 옵션과 패턴 파일의 설정을 바꾸면, 자동 변환을 막을 수 있습니다.

인용

때때로 댓글이거나 코멘트임을 표현하고 싶은 경우에 다음의 문법을 사용합니다.

내 생각에는 우리가 해야 할 것 같은데.

> 아니, 하면 안돼

>> 음, 우리가 해야 돼.

> 정말로?

>> 그래!

>>> 그러면 하지 뭐!

내 생각에는 우리가 해야 할 것 같은데.

아니, 하면 안돼

음, 우리가 해야 돼.

정말로?

그래!

그러면 하지 뭐!

표

간단한 문법으로 표(테이블)을 작성할 수 있습니다.

이름 1	이름 2	이름 3
행 1 열 1	행 1 열 2	행 1 열 3
행 2 열 1	열의 결합 (주의: 파이프 문자가 2개 연속)
행 3 열 1	행 2 열 2	행 2 열 3

표의 일반적인 행들은 시작과 끝에 | (파이프 문자)로 있어야 하고 이름 항목은 ^ (꺽쇠 기호)를 사용합니다.

^ 이름 1       ^ 이름 2        ^ 이름 3                 ^
| 행 1 열 1    | 행 1 열 2     | 행 1 열 3              |
| 행 2 열 1    | 열 결합 (주의: 파이프 문자가 2개 연속)   ||
| 행 3 열 1    | 행 2 열 2     | 행 2 열 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       |

주석: 세로 방향 결합(행 결합)은 할 수 없습니다.

항목 내용 역시 정렬방법을 설정할 수 있습니다. 최소한 2개의 공백문자를 텍스트의 반대쪽에 추가하면 됩니다. 오른쪽으로 정렬하려면 왼쪽으로 스페이스 2개를, 왼쪽으로 정렬하려면 오른쪽으로 스페이스 2개를 추가합니다. 가운데로 정렬하려면 텍스트의 양쪽 끝에 스페이스 2개를 둡니다.

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

소스에서는 다음과 같이 보입니다.

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

파싱하지 않는 블록

최소한 2개 이상의 스페이스로 들여쓰기를 하거나 code태그, file태그를 사용하여 문서 안에 처리되지 않는 블록을 포함시킬 수 있습니다.

스페이스의 수가 다음처럼 유지되는 파싱을 하지않는 코드입니다. 예,　　　　　　　　　　　　<- 여기

같지만 파일의 인용 했음을 보여주기 위해 사용할 수 있습니다.

특정 영역을 파서(parser)가 건너뛰게 하기위해서는, 그 영역를 nowiki태그로 감싸거나 더 간단하게 중첩된 퍼센트 기호%%로 감싸면 됩니다.

예를 들어, 주소를 http://www.splitbrain.org같은 주소나 **포맷팅** 부분이 있더라도, 어떤 것도 처리가 되지 않습니다.

이런 블록의 사용방법은 보려면 이 페이지의 소스를 보기 바랍니다.

구문 강조

DokuWiki는 소스 코드에 구문 강조를 사용하여, 읽기 쉽게 할 수 있습니다. DokuWiki는 일반적인 구문강조기 GeSHi를 사용하고 있습니다. -GeSHi가 지원하는 어떤 언어라도 지원 가능합니다. 문법은 전의 섹션내의 코드 블록과 같지만 사용되는 언어 이름을 <code java>와 같이 태그 내에 집어 넣습니다.

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

현재 다음과 같은 언어들이 지원됩니다.actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml

HTML과 PHP의 삽입

HTML 과 PHP 코드를 다음처럼 html와 php태그를 사용하여 문서 내에 집어 넣을 수 있습니다.

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

This is some <font color="red" size="+1">HTML</font>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

주의: HTML과 PHP은 기본 설정에서는 동작하지 않도록 되어 있습니다. 만일 동작하지 않도록 되어 있는 경우에는 코드는 실행되는 대신에 그대로 표시됩니다.

문법 플러그인

DokuWiki 문법은, 플러그인을 사용해 확장 가능합니다. 설치된 플러그인의 사용 방법은 각 플러그인의 설명 페이지에 있습니다. 이 DokuWiki에서는 다음의 문법 플러그인이 사용 가능합니다.

Info Plugin 2006-12-09 by Andreas Gohr
Displays information about various DokuWiki internals
S5 Slideshow Plugin 2007-01-20 by Andreas Gohr
Display a Wiki page as S5 slideshow presentation
Translation Plugin 2008-04-01 by Andreas Gohr
Simple multilanguage plugin
Plugin Repository 2007-10-06 by Andreas Gohr
Helps organizing the plugin repository

번역

english version: dokuwiki-2006-03-09.

Add your email here if you created translated or modified whole or part of this page.

Seungnam YANG 2006-1-25 created
번역시 일본어 문서를 참고 했습니다.

modified 2007-2-4 updated
- english version dokuwiki-2006-12-02
- 매끄럽지 못한 일본식 표기 부분을 수정했습니다.
- jk Lee - real mail domain is gmail, not zoo.com for spam filtering

¹⁾ 이 것이 각주