CONSCHOOL

건설 전문 위키 - 콘스쿨

사용자 도구

사이트 도구


wiki:위키문법

위키문법

기본적인 텍스트 포맷

구분 위키 문법 실제 표시 단축키
굵게(BOLD) **굵은 글씨** 굵은 글씨 Alt + B
기울임(Italic) //이탤릭// 이탤릭 Alt + I
밑줄(Underline) __밑줄__ 밑줄 Alt + U
배경색(글강조) ''배경색'' 배경색 Alt + M
아래첨자 <sub>아래첨자</sub> 기준아래첨자
윗첨자 <sup>윗첨자</sup> 기준윗첨자
취소선(Strike) <del>취소선</del>로 닫음 취소선 Alt + D
행바꾸기(BR) 행1\\행2 행1
행2

제목

제목은 5단계까지 사용할 수 있다. 1단계는 문서들의 통일성을 위해 반드시 한번만 문서의 제목을 표시하는데 사용해 주길 바라며, 2~3단계는 문서상단에 목차 표시에 사용된다. 문서의 편집은 1, 2단계에서 할 수 있다.

====== 1단계 ======
===== 2단계 =====
==== 3단계 ====
=== 4단계 ===
== 5단계 ==  

단락

중간에 빈 행을 두개 만들면,단락(절) 구분이 된다.1) 단락(절)을 나누지 않고 새 행을 만들기를 원한다면, 2개의 역슬레시(\)를 연속으로 사용하면 된다. 단 마지막 문자 다음에 공백 문자(tab이나 space)를 넣고 입력하는게 좋다.

단, 위키는 여러 화면사이즈에서 글을 볼 경우를 상정해야하기 때문에 특정 길이에서 텍스트를 끊는 것은 적절하지 않다. 정말 필요한 경우에만 강제로 새 행 만들기를 사용하기 바란다.

링크

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

외부 링크

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처럼 페이지 이름을 그대로 사용하거나 페이지 이름 처럼 페이지 이름을 직접 설정할 수도 있다.

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

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

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

자세한 부분들은 이름공간을 보기 바란다.

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

[[wiki:위키사용법#기본 용어|이 섹션]]로 연결되었다.

주석:

  • 기존 페이지와 링크하는 것과 존재하지 않는 페이지와 링크하는 것은 표시되는 모습이 다르다.
  • 섹션의 이름이 바뀐다면, 링크 이름 역시 바뀌게 된다. 섹션으로의 링크는 너무 많이 사용하지 않도록 하기 바란다.

Interwiki

Dokuwiki는 Interwiki링크를 사용할 수 있다. InterWiki는 다른 Wiki나 검색엔진에 대한 간편한 링크 방법이다. 예를 들어 Wiki는 Wikipedia 페이지에 대한 링크이다.

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

그림 링크

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

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

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

그림과 그 외의 파일들

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

실제 크기:

폭 변경:

폭과 높이 변경:

외부 그림 크기 변경:

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

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

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

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

위키피디아 형식으로 그림 보이기

위키피디아처럼 설명을 글 아래에 보여줄 수 있다. 정렬 등의 요소는 위와 같은 방법으로 사용할 수 있으며, 중괄호를 그림 입력 명령어 앞뒤에 씌워주기만 하면 적용된다.

설명을 써준다.
[{{ wiki:dokuwiki-128.png|설명을 써준다.}}]

기호

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

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

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

목록 표시

리스트를 표시하는 기능. 주의할 점은 이 기능은 앞에 두 칸을 띄우고 쓰는 기능이라서 앞줄 두칸 띄우고 쓰는 걸로는 주석처리가 되지 않는다. 코드 명령으로 주석처리를 하도록 하자.

점목록

html태그에서 UL에 해당하는 기능. 앞에 두 칸의 빈 칸을 넣고 '*(곱셈기호)'를 넣으면 적용된다. 서브 목록은 1차 목록보다 빈칸을 두 번 넣으면 자동으로 2차 목록으로 들어가진다.

  * 1차 목록
    * 2차 목록
  • 1차 목록
    • 2차 목록

순번목록

html태그에서 OL에 해당하는 기능. 앞에 두 칸의 빈 칸을 넣고 '-(뺄셈기호)'를 넣으면 적용된다. 서브 목록은 1차 목록보다 빈칸을 두 번 넣으면 자동으로 2차 목록으로 들어가진다.

  - 1차 목록
    - 2차 목록
  1. 1차 목록
    1. 2차 목록

간략한 표

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

이름 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       |

세로 방향 결합(행 결합)은 ::: 를 사용하여 결합한다.

이름 1 이름 2
이름 행 1 열 2 행 1 열 3
열 결합은 없음
행 2 열 2 행 2 열 3
|      ^ 이름 1             ^ 이름 2         ^
^ 이름  | 행 1 열 2            | 행 1 열 3       |
^  ::  | 열 결합은 없음        |                |
^  ::  | 행 2 열 2            | 행 2 열 3       |

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

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

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

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

Sortable, 정렬가능한 표

자바스크립트로 구현된 기능으로, 표의 가장 위 쪽의 항목을 누르면 자동 정렬이 된다.

Col1Col3Col3
1one25/12/2008
2two10/12/2008
<sortable>
^Col1^Col3^Col3^
|1|one|25/12/2008|
|2|two|10/12/2008|
</sortable>

Searchtable, 표 내부 검색

<searchtable>

Col1Col3Col3
1one25/12/2008
2two10/12/2008

</searchtable>

<searchtable>
^Col1^Col3^Col3^
|1|one|25/12/2008|
|2|two|10/12/2008|
</searchtable>

Searchtable과 Sortable은 함께 쓸 수 있다.

<sortable>
<searchtable>
^Col1^Col3^Col3^
|1|one|25/12/2008|
|2|two|10/12/2008|
</searchtable>
</sortable>

표 너비 지정

표 전체 너비나 열 너비를 지정할 수 있다. 표 최상위에

|< 표너비 열1너비 열2너비 >|

식으로 입력을 해주면 된다. 너비값은 퍼센테이지(%), em, px 모두 사용가능하며, 공란으로 남길 경우 - 표시를 넣으면 된다.

|< 100% 50px - 5em 10em 10% >|
^ A  ^  B  ^  C  ^  D  ^  E  ^
| 1  |  2  |  3  |  4  |  5  |

위 표는 표 너비를 100%로 표시하고, 1열을 50px로, 2열을 자동사이즈로, 3열을 5em으로, 4열을 10em으로, 6열을 10%로 표시하라는 뜻이다. 실제 표시는 아래와 같이 된다.

A B C D E
1 2 3 4 5

복잡한 표

미디어위키에서 사용하는 형식으로 표를 표현할 수 있다. 미디어위키의 표는 html태그를 아래와 같은 형식으로 전환해 표현한다. 표 관련 태그 이외에는 도쿠위키 문법을 그대로 사용된다.

{| 표 시작 <html> 태그에 해당. 필수사항
|+ 표 캡션 기능. 테이블 위쪽에 표의 설명이나 표 명칭 등을 추가함.
표 시작과 테이블 본문 사이에만 들어가야함.
선택사항
|- 새 행의 시작. 첫번째열은 생략 가능하다. <tr> 태그에 해당.
단독으로 사용되며 스타일 추가가능함
선택사항
! 테이블 헤더셀. 헤드셀을 추가할 때는 같은열에 !!를 사용하거나 다른 열에서 !로 시작한다. 속성을 추가할 경우는 ! style="background-color:white;" | 형식으로 입력한다 . 선택사항
| 표의 열을 시작. <td> 태그에 해당. 선택사항
|} 표 끝. </html> 태그에 해당. 필수사항
{|
|+//확장 표 예제//
! style="width: 12em;"| A1 헤드 공간
! style="width: 10em;"| B1 헤드 공간
|- style="background-color: MistyRose;"
| {{ wiki:dokuwiki-128.png?50&nolink}}
표의 A1 셀 공간. 표 내에서 다양한 도쿠위키 문법을 그대로 사용이 가능하다는 점이 장점. \\ \\

단, 표내에서 줄바꿈은 %%\\%%코드를 추가해서 줄바꿈 형식으로 표현해야함. 

| 표의 B2 셀 공간.
  * //이탤릭 형식//
  * ''모노스페이스''
  * [[:start|링크페이지]]

**주의:** \\
테이블 마지막에는 줄바꿈을 한 다음 테이블을 닫아야 함
|}
확장 표 예제
A1 헤드 공간 B1 헤드 공간
표의 A1 셀 공간. 표 내에서 다양한 도쿠위키 문법을 그대로 사용이 가능하다는 점이 장점.

단, 표내에서 줄바꿈은 \\코드를 추가해서 줄바꿈 형식으로 표현해야함.

표의 B2 셀 공간.

주의:
테이블 마지막에는 줄바꿈을 한 다음 테이블을 닫아야 함

Blockquote, 인용 상자

인용문을 표현할 때 사용하는 박스. 표와 달리 내부에 목록을 비롯한 다른 명령어 사용이 가능하다.

  • 예를 들면 목록이나 글자속성 같은 것들이 가능하다
<blockquote>
인용문을 표현할 때 사용하는 박스. 표와 달리 내부에 목록을 비롯한 다른 명령어 사용이 가능하다. 
  * 예를 들면 목록이나 **글자속성** 같은 것들이 //가능하다//
</blockquote>

Include, 타 부문 섹션 불러넣기

타 페이지의 페이지나 섹션을 불러서 문서에 삽입할 수 있다. 단, 캐쉬에서 불러오는 방식이므로 원문이 변경된다고 실시간으로 반영되지는 않는다.

{{page>[id]#[section]&[flags]}}
{{section>[id]#[section]&[flags]}}
{{namespace>[namespace]&[flags]}}
[id] 불러올 페이지 이름. 정확한 페이지 위치와 명칭(용어:고기 식으로)이 들어가야한다 필수사항
[section] 지정한 페이지 안의 특정 섹션을 지정해서 불러온다. 섹션은 H1, H2 등의 속성으로 구분한 것만 가능하다 선택사항, 없으면 페이지 전체를 불러옴
[flags] 플래그 분야는 안써도된다. 사용하려면 http://www.dokuwiki.org/plugin:include#flags를 참조 선택사항

내용 접기

폴딩

내용을 접어서 클릭해야 보이게 만든다. 내용 누설 등의 우려가 있을 때 사용하면 편리하다. 표나 include 등의 다양한 기능을 안쪽에 넣을 수 있으므로 확장성이 매우매우 우수하다. 엔터 등도 허용된다.

++++ 접혀있을 때 보일 문장 | 여기서 부터는 접힌 것을 풀어야만 보인다. ++++

++++ 접혀있을 때 보일 문장 | 여기서 부터는 접힌 것을 풀어야만 보인다. ++++

히든

div 명령어로 접힌 박스를 만든다. 집어넣을 내용이 복잡할 경우에 사용한다.

숨긴상태에서 보일글

숨긴상태에서 보일글

여기서 부터는 접힌 것을 풀어야만 보인다.


<hidden 숨긴상태에서 보일글> 여기서 부터는 접힌 것을 풀어야만 보인다. </hidden>

다른 페이지로 넘기기(Page Redirect)

특정 페이지를 특정한 위치에 만든 다음, 비슷한, 혹은 헛갈리기 쉬운 단어를 한개의 페이지로 연결하는 기능. 관리자용의 404매니저 기능은 일반 사용자가 사용할 수 없으며, 해당 플러그인에 이상이 생길 시 사용하기 힘들기 때문에 아래와 같은 구문을 각 페이지 생성 후 입력해서 연결해주는 일을 하게 한다.

#redirect namespace:page 

즉 'PC엔진' 과 'PC 엔진'은 같은 것이지만 띄어쓰기 하나로 완전 다른 문장이 되므로 해당 페이지를 각각 제작하여 'PC엔진'은 본문을 작성하고, 'PC 엔진'은 위의 문장을 집어넣어 'PC엔진' 문서로 넘기기(리다이렉트)를 시켜준다.

넘기기 문서의 경우에도 제목이 없으면 넘겨진 문서에대한 확인이 어려우므로

====== 제목 ====== 

의 형태로 첫줄에 제목 넣는 것은 잊어서는 안된다.

넘기기 문서의 경우 독자적인 문서가 아닌 넘기기용 문서이기 때문에 이에대한 갯수 확인을 위해 태그 기능을 이용하고 있으므로 아래의 태그를 추가시켜주면 확인이 가능하다. 리다이렉트 문서를 작성할 때는 필수적으로 아래 내용을 리다이렉트 문서에 포함시키도록 하자.

{{tag>넘기기 리다이렉트}}

구문 강조

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

기타 플러그인 사용법

FIXME

  • WRAP
  • TAG
  • Video
1)
한줄만 넘기는 경우에는 표시되지 않는다는 것에 주의한다.
wiki/위키문법.txt · 마지막으로 수정됨: 2016/06/05 20:29 저자 bluetree