사용자 도구

사이트 도구


wiki:syntax

차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판이전 판
다음 판
이전 판
wiki:syntax [2013/06/07 18:15] – [Formatting Syntax] kieunswiki:syntax [2024/04/23 22:43] (현재) – 바깥 편집 127.0.0.1
줄 1: 줄 1:
 + ====== 포맷팅 문법 ======
  
 +[[doku>DokuWiki]]는 가능한 한 데이타 파일들을 쉽게 읽어들이기 위해 사용하기 쉬운 markup 언어를 지원하고 있습니다.
 +이 페이지는 문서들을 편집할 때 사용가능한 모든 문법들을 설명하고 있습니다.
 +
 +더 쉽게 문법을 익히려면 [[doku>ko:toolbar|퀵버튼]]을 이용해 보시기 바랍니다.
 +
 +===== 기본적인 텍스트 형식 =====
 +[[doku>DokuWiki]]는 **굵은 글씨**、 //기울임//、 __밑줄__ 、''고정폭''을 지원하며, 
 +물론 **__//''조합''//__**처럼 여러 서식들의 조합도 가능합니다.
 +
 +  [[doku>DokuWiki]]는 **굵은 글씨**、 //기울임//、 __밑줄__ 、''고정폭''을 지원하며, 
 +  물론 **__//''조합''//__**처럼 여러 서식들의 조합도 가능합니다.
 +
 +
 +<sub>아랫 첨자</sub> 와 <sup>윗 첨자</sup> 역시 사용할 수 있습니다.
 +  <sub>아랫 첨자</sub> 와 <sup>윗 첨자</sup> 역시 사용할 수 있습니다.
 +
 +
 +더 나아가 <del>취소선</del>을 이용할 수 있습니다.
 +
 +  더 나아가 <del>취소선</del>을 이용할 수 있습니다.
 +
 +중간에 빈 행을 만들면,**단락(절)** 구분이 됩니다.
 +단락(절) 구분을 않고 **강제로 새 행을 만들기**를 원한다면, 2개의 backslash(한국어 환경에서는 역 슬래시 기호 \)
 +문자 다음에 공백 문자(tab이나 space)를 사용하거나 새로운 행을 만듭니다.
 +
 +이 텍스트는 여러 행으로 이루어져 있습니다.\\ 2개의 backslash는 
 +뒤에 공백문자가 오거나 새로운 행을 만든 경우에만\\
 +처리되는 것을 \\주의하시기 바랍니다. 
 +
 +  이 텍스트는 여러 행으로 이루어져 있습니다.\\ 2개의 backslash는 
 +  뒤에 공백문자가 오거나 새로운 행을 만든 경우에만\\
 +  처리되는 것을 \\주의하시기 바랍니다. 
 +
 +정말 필요한 경우에만 강제로 새 행 만들기를 사용하기 바랍니다.
 +
 +===== 연결 =====
 +
 +[[doku>DokuWiki]]는 링크를 만드는 여러가지 방법을 지원합니다.
 +
 +==== 외부 연결 ====
 +
 +http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 인식됩니다. 
 +[[http://www.google.com|google에 연결]]처럼 연결 이름을 설정할 수도 있으며,
 +<test@splitbrain.org> 형식의 email 주소 역시 자동으로 인식됩니다.
 +
 +  http://www.google.com 나, 더 간단한 www.google.com 같은 외부 링크는 자동으로 
 +  인식됩니다. [[http://www.google.com|google에 연결]]처럼 연결 이름을 설정할 수도 
 +  있으며, <test@splitbrain.org> 형식의 email 주소 역시 자동으로 인식됩니다.
 +
 +==== 내부 연결 ====
 +
 +내부 링크는 중첩된 대괄호 문자들을 사용해서 만들수 있습니다.
 +[[doku>ko:pagename]]처럼 페이지 이름을 그대로 사용하거나 
 +[[doku>ko:pagename|표시할 이름]] 처럼 페이지 이름을 직접 설정할 수도 있습니다.
 +
 +  [[doku>ko:pagename]]처럼 페이지 이름을 그대로 사용하거나 
 +  [[doku>ko:pagename|표시할 이름]] 처럼 페이지 이름을 직접 설정할 수도 있습니다.
 +
 +[[doku>pagename|Wiki 페이지 이름들]]은 자동으로 소문자로 변환되며, 특수문자는 사용할 수 없습니다.
 +
 +페이지 이름에 그침표(:)를 사용하여 [[어떤:이름공간]]을 사용할 수 있습니다.
 +
 +  페이지 이름에 그침표(:)를 사용하여 [[어떤:이름공간]](이름공간;네임스페이스)을 사용할 수 
 +  있습니다.
 +
 +자세한 부분들은 [[https://www.dokuwiki.org/namespaces|NameSpace]]를 보기 바랍니다.
 +
 +페이지 내의 특정 섹션에 링크하는 하려면 해쉬 기호(#)에 이어 섹션명을 기술합니다.
 +[[syntax#내부 연결|이 섹션]]로 연결됬습니다.
 +
 +  [[syntax#내부 연결|이 섹션]]로 연결됩니다.
 +  
 +페이지 이름에 공백이 있을 경우, 공백이 '_'로 변환됩니다. 
 +
 +주석:
 +
 +  * [[syntax|기존 페이지]]와 링크하는 것과 [[존재하지 않는 페이지]]와 링크하는 것은 표시되는 모습이 다릅니다..
 +  * 기본적으로 자동적으로 링크를 만들기 위한 [[wp>CamelCase]]를 사용하지 않지만, [[doku>config]]파일에서 변경할 수 있습니다. 만일 DokuWiki가 링크가 되어 있으면 사용이 가능한 상태입니다.
 +  * 섹션의 이름이 바뀐다면, 링크 이름 역시 바뀌게 됩니다. 섹션으로의 링크는 너무 많이 사용하지 않도록 하기 바랍니다.
 +
 +
 +==== Interwiki ====
 +
 +Dokuwiki는 [[doku>ko:interwiki|Interwiki]]링크를 사용할 수 있습니다.
 +InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 
 +예를 들어 [[wp>Wiki]]는 Wikipedia 페이지에 대한 링크입니다.
 +
 +  Dokuwiki는 [[doku>ko:interwiki|Interwiki]]링크를 사용할 수 있습니다.
 +  InterWiki는 다른 Wiki에 대한 간편한 링크 방법입니다. 
 +  예를 들어 [[wp>Wiki]]는 Wikipedia 페이지에 대한 링크입니다.
 +
 +==== Windows 공유 폴더 ====
 +
 +Windows 공유 폴더도 [[\\server\share|this]]처럼 사용할 수 있습니다.
 +다만, [[wp>Intranet|인트라넷]]환경 같은 단일 사용자 그룹에서만  적용되는 것에 주의하기 바랍니다.
 +
 +  Windows 공유 폴더도 [[\\server\share|this]]처럼 사용할 수 있습니다.
 +
 +주석:
 +
 +  * 보안상의 이유로, Windows 공유 폴더를 직접 둘러볼 수 있는 것은, 기본적으로 Microsoft Internet Explorer(의 "로컬 영역")에서만 Windows 공유 폴더에 직접 접근 가능합니다.
 +  * Mozilla나 Firefox에서는 [[http://kb.mozillazine.org/Links_to_local_pages_don't_work|MozillaZine Knowledge Base]] 에 있는 것과 같은 대처방법을 통해 직접 접근할 수 있습니다.
 +
 +==== 그림 연결 ====
 +
 +다음과 같이 링크에 관련된 문법과 [[#그림과 그 외의 파일들|그림]] (아래 참조)을 조합하면,  
 +내부링크와 외부 링크에 대해 이미지를 이용할 수 있습니다.
 +
 +  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +주의: 링크 이름에서만 문법 서식이 사용 가능합니다.
 +[[#그림과 그 외의 파일들|그림]]과 [[#링크|링크]] 문법은 모두 사용 가능합니다.
 +(그림 크기 변경,내부 그림, 외부 그림, URL, interwiki 링크 포함)
 +
 +
 +===== 각주 =====
 +
 +중첩된 소괄호를 이용하여 각주((이것이 각주))를 추가할 수 있습니다.
 +  중첩된 소괄호를 이용하여 각주((이것이 각주))를 추가할 수 있습니다.
 +
 +
 +===== 구간 설정 =====
 +
 +문서 내용을 구조적으로 만들기 위한 구간을 최대 5단계까지 사용 가능합니다.
 +
 +구간 이름들을 3개 이상 가지고 있는 경우 목차가 자동적으로 생성됩니다.
 +문서 내에 ''<nowiki>~~NOTOC~~</nowiki>''문자열이 있는 경우 자동적으로 목차가 생성되지 않습니다.
 +==== 3단계 구간 이름 ====
 +=== 4단계 구간 이름 ===
 +== 5단계 구간 이름 ==
 +
 +  ==== 3단계 구간 이름 ====
 +  === 4단계 구간 이름 ===
 +  == 5단계 구간 이름 ==
 +
 +대쉬 (-)를 네 개 이상 연속해서 사용한다면, 수평선을 만들수 있습니다
 +
 +----
 +
 +
 +===== 그림과 다른 파일들 =====
 +
 +중괄호를 사용하여 [[doku>ko:images|그림]]을 표시할 수 있습니다(그림 파일이 wiki 내부든 외부든 상관 없습니다). 옵션에서 그림 크기도 지정할 수 있습니다.
 +
 +실제 크기:          {{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 }}
 +
 +물론 그림 이름 역시 추가할 수 있습니다.(대부분의 브라우저에서 툴 팁으로 보여집니다)
 +
 +{{ wiki:dokuwiki-128.png |캡션}}
 +
 +  {{ wiki:dokuwiki-128.png |캡션}}
 +
 +지정된 그림파일명이 ("gif, jpeg, png")가 아니면 (파일 내부든 외부든) 그 파일에 해당하는 링크가 표시되지 않습니다.
 +
 +그림파일을 다른 문서로 링크하기 위해서는 위 [[#그림 연결]]을 참조해 주십시오.
 +
 +===== 목록 =====
 +
 +Dokuwiki는 번호 목록과 번호없는 목록들을 지원합니다.
 +스페이스2개로 들여쓰기 후에 번호없는 목록은 ''*''을 사용하거나 번호 목록은 ''-''을 사용합니다.
 +
 +  * 목록입니다.
 +  * 2번째 항목
 +    * 다른 레벨이 있을 수도 있습니다.
 +  * 또 다른 항목
 +
 +  - 번호 목록입니다.
 +  - 또 다른 항목
 +    - 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
 +  - 이상 끝
 +
 +<code>
 +  * 목록입니다.
 +  * 2번째 항목
 +    * 다른 레벨이 있을 수도 있습니다.
 +  * 또 다른 항목
 +
 +  - 번호 목록입니다.
 +  - 또 다른 항목
 +    - 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
 +  - 이상 끝
 +</code>
 +
 +[[doku>ko:faq:lists|목록에 관한 FAQ]]도 참조 해 주십시오.
 +
 +
 +===== 문자 변환 =====
 +
 +DokuWiki는 특정 문자나 문자열을 그림이나 다른 문자, HTML 등으로 변환할 수 있습니다.
 +
 +문자에서 그림으로의 변환 기능은 주로 스마일리를 통해 사용됩니다. 문자에서 HTML로의 변환기능은 기호의 변환에 사용되지만 다른 HTML로 변환하기 위해 설정할 수도 있습니다.
 +
 +==== 문자에서 그림으로 바꾸기 ====
 +
 +Dokuwiki 는 일반적으로 사용되는 [[wp>emoticon|이모티콘]]을 그림으로 쓸 수 있게 지원합니다.
 +이와 같은 [[doku>Smileys|스마일리]]나 다른 그림은 독자적인 설정으로 확장할 수 있습니다. 표준적으로 사용할 수 있는 스마일리는 아래와 같습니다.
 +
 +  * 8-) %%  8-)  %%
 +  * 8-O %%  8-O  %%
 +  * :-( %%  :-(  %%
 +  * :-) %%  :-)  %%
 +  * =)  %%  =)   %%
 +  * :-/ %%  :-/  %%
 +  * :-\ %%  :-\  %%
 +  * :-? %%  :-?  %%
 +  * :-D %%  :-D  %%
 +  * :-P %%  :-P  %%
 +  * :-O %%  :-O  %%
 +  * :-X %%  :-X  %%
 +  * :-| %%  :-|  %%
 +  * ;-) %%  ;-)  %%
 +  * ^_^ %%  ^_^  %%
 +  * :?: %%  :?:  %%
 +  * :!: %%  :!:  %%
 +  * LOL %%  LOL  %%
 +  * FIXME %%  FIXME %%
 +  * DELETEME %% DELETEME %%
 +
 +==== 문자에서 HTML로의 변환 ====
 +
 +기호: [[https://www.dokuwiki.org/dokuwiki|dokuwik]]는 특정 문자열을 활자표기에 대응하는 문자로 변환할 수 있습니다. 이하는 인식가능한 문자열의 예를 표시합니다.
 +
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..."
 +
 +<code>
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..."
 +</code>
 +
 +마찬가지로 어떤 HTML 에서도 [[doku>:ko:entities|패턴 파일]]을 설정해두면 생성할 수 있게 됩니다.
 +
 +패턴 파일 설정에 의해 변환하는 것 이외에 3가지의 예외가 있습니다. 곱하기 기호 (640x480), '싱글 쿼트' 및 "더블 쿼트"입니다. 이것들의 변환은 [[doku>config:typography|설정 옵션]]에서 설정을 끌 수 있습니다.
 +
 +===== 인용 =====
 +
 +때때로 댓글이거나 코멘트임을 표현하고 싶은 경우에 다음의 문법을 사용합니다.
 +
 +  내 생각에는 우리가 해야 할 것 같은데.
 +  
 +  > 아니, 하면 안돼
 +  
 +  >> 음, 우리가 해야 돼.
 +  
 +  > 정말로?
 +  
 +  >> 그래!
 +  
 +  >>> 그러면 하지 뭐!
 +
 +내 생각에는 우리가 해야 할 것 같은데.
 +
 +> 아니, 하면 안돼 
 +
 +>> 음, 우리가 해야 돼.
 +
 +> 정말로?
 +
 +>> 그래!
 +
 +>>> 그러면 하지 뭐!
 +
 +
 +===== 표 =====
 +
 +간단한 문법으로 표(테이블)을 작성할 수 있습니다.
 +
 +^ 이름 1       ^ 이름 2        ^ 이름 3                   ^
 +| 행 1 열 1    | 행 1 열 2     | 행 1 열 3                |
 +| 행 2 열 1    | 열 병합 (주의: 파이프 문자가 2개 연속)  ||
 +| 행 3 열 1    | 행 2 열 2     | 행 2 열 3                |
 +
 +표의 일반적인 행들은 시작과 끝에 ''|'' (파이프 문자, shift + \)로 있어야 하고 이름 항목은 ''^'' (꺽쇠 기호)를 사용합니다.
 +
 +  ^ 이름 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       |
 +
 +행을 병합할 수도 있습니다. 행 병합을 할 경우에는 병합 대상 셀의 아래 셀 안에 ":::"라는 문자열을 입력하십시오.
 +
 +^ 이름 1       ^ 이름 2       ^ 이름 3       ^
 +| 행 1 열 1    | 행 병합      | 행 1 열 3    |
 +| 행 2 열 1    | :::          | 행 2 열 3    |
 +| 행 3 열 1    | :::          | 행 2 열 3    |
 +
 +이 셀들에 ":::" 이외의 문자열을 입력할 수 없습니다.
 +
 +  ^ 이름 1       ^ 이름 2       ^ 이름 3       ^
 +  | 행 1 열 1    | 행 병합      | 행 1 열 3    |
 +  | 행 2 열 1    | :::          | 행 2 열 3    |
 +  | 행 3 열 1    | :::          | 행 2 열 3    |
 +
 +표의 내용을 정렬할 수 있습니다. 2개 이상의 공백문자를 텍스트의 반대쪽에 추가하면 됩니다.
 +즉, 오른쪽으로 정렬하려면 왼쪽으로 스페이스 2개를, 왼쪽으로 정렬하려면 오른쪽으로 스페이스 2개를 추가합니다.
 +가운데로 정렬하려면 텍스트의 양쪽 끝에 스페이스 2개를 추가합니다.
 +
 +^                  정렬된 표               ^^^
 +|        오른쪽|    가운데    |왼쪽          |
 +|왼쪽                오른쪽|    가운데     |
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +소스에서는 다음과 같이 보입니다.
 +
 +  ^                 정렬된 표                ^^^
 +  |        오른쪽|    가운데    |왼쪽          |
 +  |왼쪽          |        오른쪽|    가운데    |
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +
 +===== 자동 변형하지 않는 블록 =====
 +
 +만약 입력한 대로 (아무것도 변형되지 않고) 표시되어야 할 필요가 있는 경우에는 ''%%<nowiki>%%'' 태그나 보다 심플하게 2가지의 연속한 퍼센트 기호 ''<nowiki>%%</nowiki>'' 로 감싸 줍니다.
 +
 +<nowiki>
 +이 텍스트에는 http://www.splitbrain.org 과 같은 인터넷 주소나 **자동 변형 기법**을 포함하지만, 실제로는 아무것도 자동 변형 하지 않습니다.
 +</nowiki>
 +마찬가지로 %%//__이__ 스마일리 첨부// 문자 ;-)%% 도 자동 변형 되지 않습니다.
 +
 +  <nowiki>
 +  이 텍스트에는 http://www.splitbrain.org 과 같은 인터넷 주소나 **자동 변형 기법**을 포함하지만, 실제로는 아무것도 자동 변형 하지 않습니다.
 +  </nowiki>
 +  마찬가지로 %%//__이__ 스마일리 첨부// 문자 ;-)%% 도 자동 변형 되지 않습니다.
 +
 +===== 코드 블럭 =====
 +
 +최소한 2개 이상의 스페이스로 들여쓰기를 하거나 ''%%<code>%%''태그, 또는 ''%%<file>%%''태그를 사용하여 코드 블럭을 표시할 수 있습니다.
 +
 +  두 칸을 띄어쓰기한 문장입니다.
 +
 +<code>
 +자동 변형이 끝난 코드입니다. 스페이스 수가 다음과 같이 유지됩니다. 예,     <- 여기
 +</code>
 +
 +<file>
 +위와 같지만, 파일 내용을 표시할 때에 사용합니다.
 +</file>
 +
 +위의 블럭은 아래와 같은 소스로부터 작성되었습니다.
 +
 +    두 칸을 띄어쓰기한 문장입니다.
 +
 +  <code>
 +  자동 변형이 끝난 코드입니다. 스페이스 수가 다음과 같이 유지됩니다. 예,    <- 여기
 +  </code>
 +
 +  <file>
 +  위와 같지만, 파일 내용을 표시할 때에 사용합니다.
 +  </file>
 +
 +==== 구문 강조 ====
 +
 +DokuWiki는 소스 코드에 구문 강조를 사용하여, 읽기 쉽게 할 수 있습니다. 
 +DokuWiki는 일반적인 구문강조기 [[http://qbnz.com/highlighter/|GeSHi]]를 사용하고 있습니다. -GeSHi가 지원하는 어떤 언어라도 지원 가능합니다. 문법은 전의 섹션내의 코드 블록과 같지만 사용되는 언어 이름을 ''<nowiki><code java></nowiki>''나 ''<nowiki><file java></nowiki>''와 같이 태그 내에 집어 넣습니다.
 +
 +
 +<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.
 +    }
 +}
 +</code>
 +
 +현재 다음과 같은 언어들을 지원합니다. //abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, glsl, gml, gnuplot, groovy, gettext, haskell, hq9plus, html, idl, ini, inno, intercal, io, java5, java, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, pascal, perl, per, php-brief, php, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xml, xorg_conf, xpp, z80//
 +
 +==== 내려받을 수 있는 코드 블럭 ====
 +
 +앞서 말한 "%%<code>%%"나 "%%<file>%%" 태그를 사용한 경우 표시되고 있는 코드를 다운로드할 수 있게 만들고 싶을 수도 있습니다. 다음과 같이 언어명 뒤에 파일명을 입력하면 그 코드를 다운로드할 수 있게 만들 수 있습니다.
 +
 +<code>
 +<file php myexample.php>
 +<?php echo "hello world!"; ?>
 +</file>
 +</code>
 +
 +<file php myexample.php>
 +<?php echo "hello world!"; ?>
 +</file>
 +
 +구문 강조를 하고 싶지는 않지만 다운로드할 수 있는 경우에는 ''%%<code - myfile.foo>%%''와 같이 언어의 명칭으로서 하이픈 (''-'') 을 사용해 주십시오.
 +
 +
 +===== HTML과 PHP 삽입  =====
 +
 +''%%<html>%%'' 태그 및 ''%%<php>%%'' 태그를 사용하여 HTML 이나 PHP 의 코드를 문서내에 포함할 수 있습니다. 블럭 레벨의 코드를 포함하는 경우에는 대문자 태그 (''%%<HTML>%%'' 및 ''%%<PHP>%%'') 를 사용하여 주시기 바랍니다.。
 +
 +HTML의 예:
 +
 +<code>
 +<html>
 +이것은 <span style="color:red;font-size:150%;">HTML 인라인 요소</span>입니다.
 +</html>
 +<HTML>
 +<p style="border:2px dashed red;">이것은 HTML 블럭 레벨 요소입니다.</p>
 +</HTML>
 +</code>
 +
 +<html>
 +이것은 <span style="color:red;font-size:150%;">HTML 인라인 요소</span>입니다.
 +</html>
 +<HTML>
 +<p style="border:2px dashed red;">이것은 HTML 블럭 레벨 요소입니다.</p>
 +</HTML>
 +
 +PHP의 예:
 +
 +<code>
 +<php>
 +echo 'PHP 에 의해 생성된 로고:';
 +echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP 로고" />';
 +echo '(HTML 인라인 요소를 생성)';
 +</php>
 +<PHP>
 +echo '<table class="inline"><tr><td>마찬가지지만 블럭 레벨 요소 속에 있습니다:</td>';
 +echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP 로고" /></td>';
 +echo '</tr></table>';
 +</PHP>
 +</code>
 +
 +<php>
 +echo 'PHP 에 의해 생성된 로고:';
 +echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP 로고" />';
 +echo '(HTML 인라인 요소를 생성)';
 +</php>
 +<PHP>
 +echo '<table class="inline"><tr><td>마찬가지지만 블럭 레벨 요소 속에 있습니다:</td>';
 +echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP 로고" /></td>';
 +echo '</tr></table>';
 +</PHP>
 +
 +**주의**: HTML과 PHP은 기본 설정에서는 동작하지 않도록 되어 있습니다. 만일 동작하지 않도록 되어 있는 경우에는 코드는 실행되는 대신에 그대로 표시됩니다.
 +
 +===== RSS/ATOM 피드 읽기 =====
 +[[https://www.dokuwiki.org/dokuwiki|dokuwik]]는 외부 XML 피드에서 데이터를 얻어올 수 있습니다. XML 피드 해석에는 [[http://simplepie.org/|SimplePie]] 를 사용하고 있습니다. DokuWiki에서는 SimplePie가 해석 가능한 모든 포맷을 이용할 수 있습니다. 스페이스로 구분된 복수의 인수 표시를 커스터마이즈 할 수 있습니다: 
 +^  파라미터  ^    의 미    ^
 +| 숫자         | 최대표시수. 기본은 8 |
 +| reverse     | 표시순을 역순으로 한다. |
 +| author      | 작성자를 표시한다 |
 +| date        | 날짜를 표시한다. |
 +| description | 개요를 표시한다. 포함되어 있는 모든 HTML 태그는 무시됩니다. |
 +| 숫자[dhm]   | 업데이트 간격. 숫자 뒤 문자의 뜻은 d=날, h=시간, m=분. (예 12h = 12시간) |
 +
 +업데이트 간격의 기본값은 4시간 입니다. 10분 미만으로 설정하면 10분으로 취급됩니다. 통상[[https://www.dokuwiki.org/dokuwiki|dokuwik]]는 페이지의 캐쉬된 버전을 제공하려 하기 때문에 동적인 외부의 내용을 포함하는 데에는 명확하게 적당하지 않습니다. 페이지가 최후에 다시 쓰여지고 나서 //업데이트 간격//이상이 지났다면 [[https://www.dokuwiki.org/dokuwiki|dokuwik]]는 캐쉬를 파기하고 다시 쓰게 됩니다.
 +
 +**예: **
 +
 +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
 +{{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
 +===== 제어용 매크로 =====
 +
 +어떤 구문은 그 자신은 출력되지 않지만 DokuWiki 의 동작에 영향을 미칩니다. 아래와 같은 제어용 매크로를 이용할 수 있습니다.
 +
 +^ 매크로          ^ 설명 |
 +| %%~~NOTOC~~%%   | 이 매크로가 페이지 위에 있는 경우, 목차가 생성되지 않습니다. |
 +| %%~~NOCACHE~~%% | 기본값은 DokuWiki 는 모든 출력을 캐쉬합니다. 이 동작은 경우에 따라 바라지 않는 행동일 수 있습니다. (%%<php>%% 태그가 사용되고 있는 경우 등). 이 매크로를 추가하면 DokuWiki는 매회 강제적으로 페이지를 다시 쓰게 됩니다. |
 +
 +===== 문법 플러그인 =====
 +
 +DokuWiki 문법은, [[doku>ko: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
 +
 +  * // modified  2010-03-01 updated //
 +    * // english version dokuwiki-2010-01-15 //
 +    * 번역시 일본어 문서를 참고했습니다.
 +    * [[elofwind@gmail.com|Yu-Tak Kim]]