Creole

Creole: 위키의 표준화

Wikipedia의 성공과 더불어 시작한 위키 광풍에 의해 많은 종류의 위키가 만들어 졌다.
http://www.wikimatrix.org 를 보면 100여개의 서로 다른 위키가 있는 것을 알 수있다.
문제는 각각 문법이 달라 서로 호환이 되지 않는다는 것.. Mediawiki, wikispaces, Dokuwiki 세개의 엔진을 거쳐 온 사용자의 입장에서 표준적 위키 문법이 지원되는 환경이 아쉽다.
변환기가 있으나 Mediawiki를 비롯한 몇몇 인기있는 위키에만 집중되어 있다.

http://www.wikicreole.org 에서는 위키문법의 표준화를 위해 노력하고 있으며, 그 결실로 Creole 1.0을 제정하였다.
모든 위키가 사라지고 모두 한 곳으로만 뛰어 갈 수는 없겠지만, 표준화를 위한 노력은 칭찬해 주고 싶다.
현재 Creole 2.0을 준비중이다.
여러 위키의 제작자들이 Creole지원을 약속하였으며, dokuwiki도 이를 위한 plugin이 있으나, 아직 1.0을 완전히 지원하지는 못한다.

Dokuwiki Creole Plugin

description: Creole is an initiative to bring a common basic set of wiki markup to different wiki engines. (previous author: Esther Brunner)
author : Gina Häußge, Michael Klier
email : dokuwiki@chimeric.de
type : syntax
lastupdate : 2008-02-12
compatible : 2006-11-06
depends :
conflicts :
similar :
tags : Creole, wiki syntax

WM creole

Description

The Creole 0.3 Specs (2006-12-19) are very close to the 위키 사용법 used by DokuWiki. Only those elements differ:

This Plugin will interpret Creole elements that are not understood by DokuWiki. If the markup collides (as with the header level order), by default DokuWiki's standard markup takes precedence.1) With the exception of the changed behaviour for linebreaks, all your existing wiki pages will look the same.

If you use this plugin to support the Creole syntax, you might want to list your wiki at http://www.wikicreole.org/wiki/WikisSupportingCreole

Components

Listblock

Creole style ordered and unordered lists use a slightly different markup:

Creole (and DokuWiki):

* Item 1          (  * Item 1     )
** Item 1.1       (    * Item 1.1 )
* Item 2          (  * Item 2     )

Output:

  • Item 1
    • Item 1.1
  • Item 2

Creole (and DokuWiki):

# Item 1          (  - Item 1     )
## Item 1.1       (    - Item 1.1 )
# Item 2          (  - Item 2     )

Output:

  1. Item 1
    1. Item 1.1
  2. Item 2

Headings

In Creole, the header ordering is just the other way round. If you have set the markup precedence option to DokuWiki (default), this plugin will assume headers are DokuWiki style if there are equal signs after the title. In Creole, closing (right-side) equal signs are optional. So if omit them, headers are interpreted as Creole.

Creole (and DokuWiki):

= Level 1        (====== Level 1 ======)
== Level 2       (===== Level 2 =====  )
=== Level 3      (==== Level 3 ====    )
==== Level 4     (=== Level 4 ===      )
===== Level 5    (== Level 5 ==        )

Level 1

Level 2

Level 3

Level 4

Level 5

Linebreaks

DokuWiki does not care about (single) line breaks. Creole, however, does treat line breaks in the source as line breaks in the output.

This component is mainly the same as Chris Smith's linebreak plugin. Thanks!

Preformatted

Creole:

{{{
//This// does **not** get [[wiki:formatted]]
}}}

Some examples of markup are: {{{** <i>this</i> ** }}}

Output:

//This// does **not** get [[wiki:formatted]]

Some examples of markup are: ** <i>this</i> **

Tables

Creole (and DokuWiki):

|Heading Col 1  |Heading Col 2 |   (^Heading Col 1  ^Heading Col 2 ^)
|Cell 1.1       |Cell 1.2      |   (|Cell 1.1       |Cell 1.2      |)
|Cell 2.1       |Cell 2.2      |   (|Cell 2.1       |Cell 2.2      |)

Output:

Heading Col 1 Heading Col 2
Cell 1.1 Cell 1.2
Cell 2.1 Cell 2.2

The difference to DokuWiki is that in Creole there's no special markup for header cells and no cell alignment. In turn, in Creole the ending pipe is optional.

DokuWiki

DokuWiki는 사용자들에게 보다 다양한 문서 저장소를 구성할 수 있게 도와주는 위키로서, 표준을 준수하며 사용하기 쉽습니다.
DokuWiki는 데이터 자료가 위키 외부에서 구조화되고, 읽을 수 있는 형태로 나타나도록 보장하며 간단하고도 강력한 문법을 사용해 개인이나 팀 구성원, 회사 등이
해당 자료를 쉽게 이용할 수 있는 환경을 제공합니다.

무제한적인 페이지 생성은 페이지 초기 혹은 특정 버전으로의 복원를 허락하며, 이때 데이터베이스가 필요하지 않는 텍스트 파일에 저장된 데이터도 함께 복원됩니다.
강력한 plugins을 활용하면 DokuWiki의 코어 시스템을 확장하거나 강화시킬 수 있습니다.
DokuWiki가 제공해야 하는 것에 대한 전체적인 설명은 기능 부분을 참고하십시오.

커뮤니티에서 편집한 DokuWiki manual은 강력한 wiki 시스템의 사용방법을 설명해 줄 것입니다.
질문이나 공헌을 하고 싶다면, the forum으로 방문해 주세요.

다운로드

http://www.splitbrain.org/go/dokuwiki 에서 다운로드 가능합니다.

더 읽어 볼 것

문법 설명를 비롯한 모든 문서와 추가적인 정보들은 www.dokuwiki.org의 DokuWiki에서 유지관리됩니다.

스킨이 예쁜 참고 사이트

한국 도쿠 위키

Plugins

dokuwiki는 기본 레이아웃이 상당히 보기도 편할 뿐더러 위키문법도 쉽고, 입력하기도 편하다.
여기에 다양한 플러그인이 있고, 플러그인을 설치, 제거하기가 매우 쉽다는 장점도 있다.
http://dokuwiki.org/plugin

  • 플러그인의 관리 - dokuwiki에서 관리자로 로그인을 하면 [관리]메뉴가 나타난다. [관리]메뉴 중 [플러그인 관리자]를 클릭하면 새로운 플러그인을 설치할 수 있는 URL입력창과 현재 설치된 플러그인 목록을 볼 수 있다.
  • 플러그인 설치 - 플러그인은 관리자 메뉴의 [플러그인 관리하기]를 통해 할 수 있다. 설치할 수 있는 플러그인의 목록은 dokuwki의 plugin 페이지에 있다. 플러그인 목록에서 원하는 플러그인을 클릭하면 해당 플러그인에 대한 안내와 *.zip이나 *.tar.gz 또는 *.tgz 등의 압축된 플러그인 파일을 볼 수 있다. 압축파일의 인터넷 경로(바로가기) 를 복사한 후 관리자의 url 입력창에 넣고 설치! 를 누르면 된다.

Tips

??

이 DokuWiki에서는 다음의 문법 플러그인이 사용

addnewpage fix

/*USE : UTF8*/
function setName() {
	document.getElementById("editform").setAttribute("action","/wiki/"+document.getElementById('np_cat').value+':'+document.getElementById('addnewpage_title').value);
}
/*  	document.getElementById("editform").setAttribute("action","?id="+document.getElementById('np_cat').value+':'+document.getElementById('addnewpage_title').value);
 */

세팅

.htaccess

Plugin:tag

http://vaslor.net/wiki/tag/windows 와 같은 깔끔한 Url을 만들어 줍니다.

RewriteRule ^tag/(.*)$     doku.php?id=$1&do=showtag [QSA,L]

ISAPI_Rewrite

[ISAPI_Rewrite]
# Defend your computer from some worm attacks
RewriteRule .*(?:global.asa|default\.ida|root\.exe|\.\.).* . [F,I,O]

# Dokuwiki rules
# Fix RSS Feeds
RewriteRule ^(/wiki/)feed.php $1/feed.php [I,L]
RewriteRule ^(/wiki/)feed.php\?(.*) $1/feed.php\?mode=$2&$3 [I,L]
RewriteRule ^(/wiki/)_media/(.*)\?(.*) $1lib/exe/fetch.php\?media=$2&$3 [I,L]
RewriteRule ^(/wiki/)_media/(.*) $1lib/exe/fetch.php\?media=$2 [I,L]
RewriteRule ^(/wiki/)_detail/(.*)\?(.*) $1lib/exe/detail.php\?media=$2&$3 [I,L]
RewriteRule ^(/wiki/)_detail/(.*) $1lib/exe/detail.php\?media=$2 [I,L]
RewriteRule ^(/wiki/)_export/([^/]+)/(.*) $1doku.php?do=export_$2&id=$3 [I,L]
 
RewriteRule (/wiki/) $1doku.php [I,L]
 
RewriteRule ^(/wiki/)\?idx=(.*) $1doku.php\?idx=$2 [I,L]
RewriteRule ^(/wiki/)lib/(.*) $1lib/$2 [I,L]
RewriteRule ^(/wiki/)(.*)\?do=(.*) $1doku.php\?id=$2&do=$3 [I,L]

RewriteRule ^(/wiki/)doku.php\?id=(.*) $1doku.php\?id=$2 [I,L]

RewriteRule ^(/wiki/)(.*) $1doku.php\?id=$2 [I,L]
 
# this rule fixes a problem to see the old revisions
RewriteRule ^(/wiki/)(.*)\?(.*) $1doku.php\?id=$2&$3 [I,L]
 
# Diff still broken unless none is selected under 'use nice URL' options. You can still enter and link to nice URLs but the 

DokuWiki program will use normal naming.



# Rules to ensure that normal content gets through
RewriteRule /blog/software-files/(.*) /blog/software-files/$1 [L]
RewriteRule /blog/images/(.*) /blog/images/$1 [L]
RewriteRule /blog/favicon.ico /blog/favicon.ico [L]

# For file-based wordpress content (i.e. theme), admin, etc.
RewriteRule /blog/wp-(.*) /blog/wp-$1 [L]

# For normal wordpress content, via index.php
RewriteRule ^/blog/$ /blog/index.php [L]
RewriteRule /blog/(.*) /blog/index.php/$1 [L]
1) You can change the markup precedence to Creole with the config manager, if you want full Creole support.

3.352 seconds in processing this page.