사용자 도구

사이트 도구


사이드바

newbie:manual

사용자 설명서

Introduction

웹페이지를 쓰는데 설명서가 필요하다는 것은 매우 웃긴 일입니다. 그만큼 직관적인 인터페이스를 만들지 못했다는 이야기가 되지요. 하지만 Moniwiki와 Dokuwiki의 구조가 많이 다르기 때문에 짤막한 설명을 읽는 것이 도움이 될 것 같아 작성하게 되었습니다.

앞으로 시스템을 좀더 바꾸어서 좀더 자연스럽게 쓰실수 있도록 하겠습니다.

Difference

Syntax

많은 문법이 달라서 차차 알려드리겠습니다. wiki:syntax 참조

Convention

  • Dokuwiki에서는 문서이름에 소문자 영문만을 사용합니다. CamelCase도 사용하지 않습니다. 물론 한글도 사용하지 않습니다.
  • Namespace 구분에는 표준적으로는 “:“을 사용하지만 UPnL.org에서는 ”/“를 사용해 왔으므로 이를 허용합니다. 되도록 :를 사용해 주세요
upnlweb:start
upnlweb:manual

Version Control

밑에 보시면 이전버전들 버튼이 있습니다. 그리고 나오는 곳에서 색안경 아이콘을 누르면 Diff도 바로 확인할 수 있습니다. 편집하신후 저장하실때 편집 요약을 써 놓으시면 나중에 훨씬 쉽게 확인할 수 있습니다.

Namespace

Dokuwiki는 Moniwiki와는 다르게 Namespace라는 구조를 사용합니다.

간단히 말하자면 그냥 디렉토리에요. Moniwiki(기존 위키) 에서는 모든 문서가 평평한 구조로 되어있습니다. 레벨이 없지요. 대신 UPnL.org 에서는 분류의 불편함을 어느 정도 해소하기 위해서 이름에 ”/“를 사용해서 구분했습니다.

이를테면 “Project/ABC” 이 것 자체가 문서의 이름이였습니다.

하지만 Dokuwiki에서는 Namespace를 사용합니다.

문서를 분류하는 디렉토리가 생긴 건데요, 실제로 project라는 디렉토리가 생깁니다. 그리고 그 Namespace의 대표페이지는 start가 됩니다. project/start가 project Namespace의 대표페이지가 되는거구요.

[[:start|제일 첫 페이지]]
[[introduction:start|소개 첫 페이지]]
[[introduction:history| 소개 - 역사]]

무엇이 달라질까요?

  1. 링크주소
  2. 분류의 편리성
  3. 접근제어

페이지의 링크들은 마치 상대주소를 사용하는 것처럼 자동적으로 현재 Namespace안의 페이지를 찾습니다.

project:start 페이지에

[[abc]]

라는 링크가 있다고 생각해봅시다. 그럼 이 링크는 실제로는 project/abc 페이지를 링크하게 됩니다.

Examples:
example
.example
.:example
refers to the page “example” in the current namespace.
:examplerefers to the page “example” in the root namespace.
..example
..:example
.:..:example
refers to the page “example” in the parent namespace
wiki:examplerefers to the page “example” in the namespace “wiki”. The namespace “wiki” is located beneath the root namespace.
ns1:ns2:example
:ns1:ns2:example
refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the root namespace.
.ns1:ns2:example
.:ns1:ns2:example
refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the current namespace.
..ns1:ns2:example
..:ns1:ns2:example
refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located besides the current namespace (i.e. both ns1 and the current namespace are beneath the same parent namespace, wherever according to the root namespace this parent may be located itself).
.ns1:ns2:refers to the page “start” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the current namespace.

(The default page can be named something other than “start” by adjusting the start configuration setting.)

좀더 자세한 설명은 wiki:namespaces

Access Control

접근 제어입니다. 사용자별로 group을 만들고 각 페이지, 혹은 네임스페이스 별로 접근제어 가능합니다.

Tip

페이지 이름?

링크 이름 대신 페이지의 제일 큰 제목, 즉 Heading1이 링크주소시 표시되게 수정했습니다!

페이지 삭제방법

내용을 싹 지우고 저장하면 삭제됩니다.

코멘트 필드 삽입 방법

  • 일반적인 추가
~~DISSCUSION |제목 ~~
  • 숨기기
~~DISSCUSION:off|제목 ~~
  • 더이상 의견을 남길수 없으나 기존에 단 것을 표시
~~DISSCUSION:closed|제목 ~~

트랙백(Linkback) 필드 삽입 방법

위의 코멘트 필드와 비슷합니다.

  • 일반적인 추가 Receive and display linkbacks.
~~LINKBACK~~
  • 더이상 불가하나 기존에 단것 표시
~~LINKBACK:closed~~
  • 끄기
~~LINKBACK:off~~
/home/wiki/wiki/data/pages/newbie/manual.txt · 마지막으로 수정됨: 2014/03/17 21:34 (바깥 편집)