* 목록입니다.
* 2번째 항목
* 다른 레벨이 있을 수도 있습니다.
* 또 다른 항목
- 번호 목록입니다.
- 또 다른 항목
- 더 깊은 레벨을 사용하려면 단지 들여쓰기를 하면 됩니다.
- 이상 끝
[[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'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
마찬가지로 어떤 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 |
===== 자동 변형하지 않는 블록 =====
만약 입력한 대로 (아무것도 변형되지 않고) 표시되어야 할 필요가 있는 경우에는 ''%%%%''태그, 또는 ''%%%%''태그를 사용하여 코드 블럭을 표시할 수 있습니다.
두 칸을 띄어쓰기한 문장입니다.
자동 변형이 끝난 코드입니다. 스페이스 수가 다음과 같이 유지됩니다. 예, <- 여기
위와 같지만, 파일 내용을 표시할 때에 사용합니다.
위의 블럭은 아래와 같은 소스로부터 작성되었습니다.
두 칸을 띄어쓰기한 문장입니다.
자동 변형이 끝난 코드입니다. 스페이스 수가 다음과 같이 유지됩니다. 예, <- 여기
위와 같지만, 파일 내용을 표시할 때에 사용합니다.
==== 구문 강조 ====
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.
}
}
현재 다음과 같은 언어들을 지원합니다. //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//
==== 내려받을 수 있는 코드 블럭 ====
앞서 말한 "%%%%"나 "%%%%" 태그를 사용한 경우 표시되고 있는 코드를 다운로드할 수 있게 만들고 싶을 수도 있습니다. 다음과 같이 언어명 뒤에 파일명을 입력하면 그 코드를 다운로드할 수 있게 만들 수 있습니다.
구문 강조를 하고 싶지는 않지만 다운로드할 수 있는 경우에는 ''%%%%''와 같이 언어의 명칭으로서 하이픈 (''-'') 을 사용해 주십시오.
===== HTML과 PHP 삽입 =====
''%%%%'' 태그 및 ''%%%%'' 태그를 사용하여 HTML 이나 PHP 의 코드를 문서내에 포함할 수 있습니다. 블럭 레벨의 코드를 포함하는 경우에는 대문자 태그 (''%%%%'' 및 ''%%%%'') 를 사용하여 주시기 바랍니다.。
HTML의 예:
이것은 HTML 인라인 요소입니다.
이것은 HTML 블럭 레벨 요소입니다.
이것은 HTML 인라인 요소입니다.
이것은 HTML 블럭 레벨 요소입니다.
PHP의 예:
echo 'PHP 에 의해 생성된 로고:';
echo '';
echo '(HTML 인라인 요소를 생성)';
echo '마찬가지지만 블럭 레벨 요소 속에 있습니다: ';
echo ' ';
echo '
';
echo 'PHP 에 의해 생성된 로고:';
echo '';
echo '(HTML 인라인 요소를 생성)';
echo '마찬가지지만 블럭 레벨 요소 속에 있습니다: ';
echo ' ';
echo '
';
**주의**: 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 는 모든 출력을 캐쉬합니다. 이 동작은 경우에 따라 바라지 않는 행동일 수 있습니다. (%%%% 태그가 사용되고 있는 경우 등). 이 매크로를 추가하면 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]]