포맷팅 문법

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

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

Dokuwiki는 굵은 글씨、 이탤릭、 밑줄 、고정폭을 지원하며, 물론 조합 과 같이 여러 서식들의 조합도 가능합니다.

[[Dokuwiki]]는 **굵은 글씨**、 //이탤릭//、 __밑줄__ 、''고정폭''을 지원하며, 
물론 **__//''조합''//__** 과 같이 여러 서식들의 조합도 가능합니다.

_{아랫 첨자} 와 ^{윗 첨자} 역시 사용할 수 있습니다.

<sub>아랫 첨자</sub> 와 <sup>윗 첨자</sup> 역시 사용할 수 있습니다.

더 나아가 취소선를 이용할 수 있습니다.

더 나아가 <del>취소선</del>를 이용할 수 있습니다.

중간에 빈 행을 만들면,단락(절) 구분이 됩니다. 단락(절) 구분을 않고 강제로 새 행을 만들기를 원한다면, 2개의 backslash(한국어 환경에서는 역슬레시 기호\) 문자 다음에 공백 문자(tab이나 space)를 사용하거나 새로운 행을 만듭니다.

이 텍스트는 여러 행으로 이루어져 있습니다.
2개의 backslash는 단지 뒤에 공백문자가 오거나 새로운 행을 만든 경우에만
처리되는 것을 \\주의하시기 바랍니다.

이 텍스트는 여러 행으로 이루어져 있습니다.\\ 2개의 backslash는 
단지 뒤에 공백문자가 오거나 새로운 행을 만든 경우에만\\
처리되는 것을 \\주의하시기 바랍니다. 

정말 필요한 경우에만 강제로 새 행 만들기를 사용하기 바랍니다.

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

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

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

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

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

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

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

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

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

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

주석:

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

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

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

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레벨 섹션 이름 ==

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

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

실제 크기:

폭 변경:

폭과 높이 변경:

외부 그림 크기 변경:

실제 크기:          {{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. 또 다른 항목
   1. 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
3. 이상 끝

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

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

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 열 2            | 행 1 열 3       |
^ 이름 4    | 열 결합은 없음        |                |
^ 이름 5    | 행 2 열 2            | 행 2 열 3       |

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

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

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

^                  정렬된 표                ^^^
|         오른쪽|    가운데    |왼쪽           |
|왼쪽           |        오른쪽|    가운데     |
| 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>
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 2008-09-12 by Andreas Gohr
  Displays information about various DokuWiki internals
• Structured Data Plugin 2009-01-05 by Andreas Gohr
  Add and query structured data in your wiki
• Gallery Plugin 2008-05-19 by Andreas Gohr
  Creates a gallery of images from a namespace
• S5 Slideshow Plugin 2008-06-20 by Andreas Gohr
  Display a Wiki page as S5 slideshow presentation
• Translation Plugin 2008-08-12 by Andreas Gohr
  Simple multilanguage plugin
• Plugin Repository 2007-10-06 by Andreas Gohr
  Helps organizing the plugin repository
• PHPXref Plugin 2008-10-03 by Andreas Gohr
  Makes linking to a PHPXref generated API doc easy.
• Groupusers Syntax plugin 2008-10-06 by Dominik Eckelmann
  Displays the users from one or more groups.

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