====== 포맷팅 문법 ====== [[DokuWiki]]는 가능한 한 데이타 파일들을 쉽게 읽어들이기위해 간단한 markup언어를 지원하고 있습니다. 이 페이지는 페이지들을 편집할 때 사용가능한 모든 문법들을 설명하고 있습니다. 간단하게 이 페이지 상단과 하단에 있는 //페이지 편집// 버튼을 클릭하면, 페이지의 소스를 볼 수 있습니다. 시험 삼아 편집을 해보고 싶다면 [[playground:playground|낙서장]] 페이지를 사용해 보시기 바랍니다. 더 쉽게 문법을 익히려면 [[http://wiki.splitbrain.org/wiki:ko:quickbuttons|퀵버튼]]을 이용해 보시기 바랍니다. ===== 기본적인 텍스트 포맷 ===== [[Dokuwiki]]는 **굵은 글씨**、 //이탤릭//、 __밑줄__ 、''고정폭''을 지원하며, 물론 **__//''조합''//__** 과 같이 여러 서식들의 조합도 가능합니다. [[Dokuwiki]]는 **굵은 글씨**、 //이탤릭//、 __밑줄__ 、''고정폭''을 지원하며, 물론 **__//''조합''//__** 과 같이 여러 서식들의 조합도 가능합니다. 아랫 첨자 와 윗 첨자 역시 사용할 수 있습니다. 아랫 첨자 와 윗 첨자 역시 사용할 수 있습니다. 더 나아가 취소선를 이용할 수 있습니다. 더 나아가 취소선를 이용할 수 있습니다. 중간에 빈 행을 만들면,**단락(절)** 구분이 됩니다. 단락(절) 구분을 않고 **강제로 새 행을 만들기**를 원한다면, 2개의 backslash(한국어 환경에서는 역슬레시 기호\) 문자 다음에 공백 문자(tab이나 space)를 사용하거나 새로운 행을 만듭니다. 이 텍스트는 여러 행으로 이루어져 있습니다.\\ 2개의 backslash는 단지 뒤에 공백문자가 오거나 새로운 행을 만든 경우에만\\ 처리되는 것을 \\주의하시기 바랍니다. 이 텍스트는 여러 행으로 이루어져 있습니다.\\ 2개의 backslash는 단지 뒤에 공백문자가 오거나 새로운 행을 만든 경우에만\\ 처리되는 것을 \\주의하시기 바랍니다. 정말 필요한 경우에만 강제로 새 행 만들기를 사용하기 바랍니다. ===== 링크 ===== [[Dokuwiki]]는 링크를 생성하는 여러가지 방법을 지원합니다. ==== 외부 링크 ==== http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 인식됩니다. [[http://www.google.com|google에 연결]]처럼 연결 이름을 설정할 수도 있으며, 형식의 email 주소 역시 자동으로 인식됩니다. http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 인식됩니다. [[http://www.google.com|google에 연결]]처럼 연결 이름을 설정할 수도 있으며, 형식의 email 주소 역시 자동으로 인식됩니다. ==== 내부 링크 ==== 내부 링크는 중첩된 대괄호 문자들을 사용해서 만들수 있습니다. [[pagename]]처럼 페이지 이름을 그대로 사용하거나 [[pagename| 페이지 이름]] 처럼 페이지 이름을 직접 설정할 수도 있습니다. [[doku>wiki:pagename]]처럼 페이지 이름을 그대로 사용하거나 [[doku>wiki:pagename| 페이지 이름]] 처럼 페이지 이름을 직접 설정할 수도 있습니다. 페이지 이름에 콜론 문자를 사용하여 [[namespaces|네임스페이스(이름 공간)]]를 사용할 수 있습니다. 페이지 이름에 콜론 문자를 사용하여 [[wiki:namespaces]](이름 공간)를 사용할 수 있습니다. 자세한 부분들은 [[namespaces]]를 보기 바랍니다. 페이지 내의 특정 섹션에 링크하는 하려면 해쉬 기호(#)에 이어 섹션명을 기술합니다. [[syntax#내부 링크|이 섹션]]로 연결됬습니다. [[syntax#내부 링크|이 섹션]]로 연결됬습니다. 주석: * [[syntax|기존 페이지]]와 링크하는 것과 [[wiki:존재하지 않는 페이지]]와 링크하는 것은 표시되는 모습이 다릅니다.. * 기본적으로 자동적으로 링크를 만들기 위한 [[wp>CamelCase]]를 사용하지 않지만, [[wiki:config]]파일에서 변경할 수 있습니다. 만일 DokuWiki가 링크가 되어 있으면 사용이 가능한 상태입니다. * 섹션의 이름이 바뀐다면, 링크 이름 역시 바뀌게 됩니다. 섹션으로의 링크는 너무 많이 사용하지 않도록 하기 바랍니다. ==== Interwiki ==== Dokuwiki는 [[interwiki|Interwiki]]링크를 사용할 수 있습니다. InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 예를 들어 [[wp>Wiki]]는 Wikipedia 페이지에 대한 링크입니다. Dokuwiki는 [[doku>wiki:interwiki|Interwiki]]링크를 사용할 수 있습니다. InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 예를 들어 [[wp>Wiki]]는 Wikipedia 페이지에 대한 링크입니다. ==== Windows 공유 폴더 ==== Windows 공유 폴더도 [[servershare|this]]처럼 사용할 수 있습니다. 다만,[[wp>Intranet|인트라넷]]환경 같은 단일 사용자 그룹에서만 적용되는 것에 주의하기 바랍니다. Windows 공유 폴더도 [[servershare|this]]처럼 사용할 수 있습니다. 주석: * 보안상의 이유로, Windows 공유 폴더를 직접 브라우즈 할 수 있는 것은, 기본적으로 Microsoft Internet Explorer(의 "로컬 영역")에서만 Windows 공유 폴더에 직접 접근 가능합니다. * 추천되지는 않지만, Mozilla나 Firefox에서 설정 옵션의 [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]]을 변경해서 직접 접근이 가능합니다. * 자세한 사항은 [[bug>151]]을 보기 바랍니다. ==== 그림 링크 ==== 다음과 같이 링크에 관련된 문법과 [[#그림과 그 외의 파일들|그림]] (아래 참조)을 조합하면, 내부링크와 외부 링크에 대해 이미지를 이용할 수 있습니다. [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] 주의: 링크 이름에서만 문법 서식이 사용가능 합니다. [[#그림과 그 외의 파일들|그림]]과 [[#링크|링크]] 문법은 모두 사용 가능합니다. (그림 크기 변경,내부 그림, 외부 그림, URL, interwiki 링크 포함) ===== 각주 ===== 중첩된 소괄호를 이용하여 각주((이 것이 각주))를 추가할 수 있습니다. 중첩된 소괄호를 이용하여 각주((이 것이 각주))를 추가할 수 있습니다. ===== 섹션 설정 ===== 문서 내용을 구조적으로 만들기 위해 최대 5개 레벨까지의 섹션를 사용 가능합니다. 3개 이상의 섹션 이름들을 가지고 있는 경우 목차가 자동적으로 생성됩니다. 문서내에 ''~~NOTOC~~''문자열이 있는 경우 자동적으로 목차가 생성되지 않습니다. ==== 3레벨 섹션 이름 ==== === 4레벨 섹션 이름 === == 5레벨 섹션 이름 == ==== 3레벨 섹션 이름 ==== === 4레벨 섹션 이름 === == 5레벨 섹션 이름 == 데쉬 (-)를 네 개 이상 연속해서 사용한다면, 수평선을 만들수 있습니다. ---- ===== 그림과 그 외의 파일들 ===== 중괄호를 사용하여 위키 외부[[doku>images|그림]]과 위키 내의[[doku>images|그림]]을 포함할 수 있습니다. 옵션으로 그림 크기를 지정할 수 있습니다. 실제 크기: {{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?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 }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} 물론 그림 이름 역시 추가할 수 있습니다.(대부분의 브라우저에서 툴 팁으로 보여집니다) ===== 목록 ===== Dokuwiki는 번호 목록과 번호없는 목록들을 지원합니다. 스페이스2개로 들여쓰기 후에 번호없는 목록은 ''*''을 사용하거나 번호 목록은 ''-''을 사용합니다. * 목록입니다. * 2번째 항목 * 다른 레벨이 있을 수도 있습니다. * 또 다른 항목 - 번호 목록입니다. - 또 다른 항목 - 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다. - 이상 끝 * 목록입니다. * 2번째 항목 * 다른 레벨이 있을 수도 있습니다. * 또 다른 항목 - 번호 목록입니다. - 또 다른 항목 - 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다. - 이상 끝 ===== smiley ===== DokuWiki는 일반적으로 사용되는 [[wp>emoticon|emoticon]]을 그림으로 쓸 수 있게 지원합니다. 더 많은 smiley들이 ''smiley''디렉토리에 있으며 ''conf/smileys.conf''파일을 이용해 설정을 바꿀 수 있습니다. DokuWiki에서 사용할 수 있는 기본 smiley들입니다. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ===== 기호 ===== DokuWiki는 간단한 문자들을 대응하는 기호로 바꿀 수 있습니다. 자동으로 처리되는 문자들의 예들입니다. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." 주의： [[config#typography|설정 옵션]]과 [[entities|패턴 파일]]의 설정을 바꾸면, 자동 변환을 막을 수 있습니다. ===== 인용 ===== 때때로 댓글이거나 코멘트임을 표현하고 싶은 경우에 다음의 문법을 사용합니다. 내 생각에는 우리가 해야 할 것 같은데. > 아니, 하면 안돼 >> 음, 우리가 해야 돼. > 정말로? >> 그래! >>> 그러면 하지 뭐! 내 생각에는 우리가 해야 할 것 같은데. > 아니, 하면 안돼 >> 음, 우리가 해야 돼. > 정말로? >> 그래! >>> 그러면 하지 뭐! ===== 표 ===== 간단한 문법으로 표(테이블)을 작성할 수 있습니다. ^ 이름 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는 일반적인 구문강조기 [[http://qbnz.com/highlighter/|GeSHi]]를 사용하고 있습니다. -GeSHi가 지원하는 어떤 언어라도 지원 가능합니다. 문법은 전의 섹션내의 코드 블록과 같지만 사용되는 언어 이름을 ''''와 같이 태그 내에 집어 넣습니다. /** * 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''태그를 사용하여 문서 내에 집어 넣을 수 있습니다. This is some HTML This is some HTML echo 'A logo generated by PHP:'; echo 'PHP Logo !'; echo 'A logo generated by PHP:'; echo 'PHP Logo !'; **주의**: HTML과 PHP은 기본 설정에서는 동작하지 않도록 되어 있습니다. 만일 동작하지 않도록 되어 있는 경우에는 코드는 실행되는 대신에 그대로 표시됩니다. ===== 문법 플러그인 ===== DokuWiki 문법은, [[plugins|플러그인]]을 사용해 확장 가능합니다. 설치된 플러그인의 사용 방법은 각 플러그인의 설명 페이지에 있습니다. 이 DokuWiki에서는 다음의 문법 플러그인이 사용 가능합니다. ~~INFO:syntaxplugins~~ ===== 번역 ===== //english version: dokuwiki-2006-03-09. // //Add your email here if you created translated or modified whole or part of this page.// * //[[dandy35@gmail.com|Seungnam YANG]] 2006-1-25 created// * 번역시 일본어 문서를 참고 했습니다. * // modified 2007-2-4 updated // * // english version dokuwiki-2006-12-02 // * 매끄럽지 못한 일본식 표기 부분을 수정했습니다. * [[bootmeta@zoo.com|jk Lee]] - real mail domain is gmail, not zoo.com for spam filtering