도쿠위키 편집하기 (부분)

== 특징 ==
=== 데이터베이스가 필요 없는 구조 ===
도쿠위키의 가장 대표적인 특징은 데이터베이스가 필요 없다는 점이다. 문서 내용은 일반 텍스트 파일로 저장되며, 미디어 파일은 파일 시스템에 저장된다. 설정 파일, 사용자 정보, 접근 제어 규칙 역시 파일 기반으로 관리되는 경우가 많다. 이 구조 덕분에 서버 이전이나 백업을 할 때 DB 덤프와 복원 절차를 별도로 거치지 않아도 되는 경우가 많다.

예를 들어 일반적인 DB 기반 CMS에서는 백업 시 웹 루트 파일과 데이터베이스를 모두 백업해야 한다. 반면 도쿠위키는 설치 디렉터리와 데이터 디렉터리, 설정 디렉터리, 플러그인 및 템플릿 디렉터리를 적절히 백업하면 대부분의 운영 데이터를 보존할 수 있다. 물론 실제 운영 환경에서는 캐시, 세션, 임시 파일, 서버 설정, 웹 서버 가상 호스트 설정, SSL 인증서, 백업 제외 대상 등을 구분해야 하므로 단순히 전체 폴더를 복사하는 것만으로 항상 최선의 백업이 되는 것은 아니다.

=== 쉬운 설치 ===
도쿠위키는 웹 인스톨러를 제공하기 때문에 설치 난도가 낮은 편이다. 설치 파일을 서버에 업로드한 뒤 웹 브라우저에서 설치 페이지에 접근하여 위키 이름, 관리자 계정, 권한 정책 등을 설정하면 기본 설치가 가능하다. [[미디어위키]]처럼 DB 연결 정보, DB 사용자, DB 이름, 테이블 접두사 등을 입력해야 하는 절차가 없기 때문에 초보자에게 더 단순하게 느껴질 수 있다.

다만 “쉽게 설치된다”는 말은 “보안까지 자동으로 완벽하게 설정된다”는 뜻은 아니다. 도쿠위키는 파일 기반 구조이므로 웹 서버가 쓰기 권한을 가져야 하는 디렉터리와 외부에서 직접 접근되면 안 되는 디렉터리를 구분해야 한다. 공식 문서에서도 파일 권한 설정은 중요한 설치 단계로 다룬다.<ref name="permissions">[https://www.dokuwiki.org/install:permissions DokuWiki 파일 권한 설정 문서]</ref>

=== 문서화에 적합한 문법 ===
도쿠위키는 자체 위키 문법을 사용한다. 굵게, 기울임, 밑줄, 취소선, 제목, 목록, 표, 코드 블록, 내부 링크, 외부 링크, 이미지 삽입, 각주 등을 지원한다. 문법은 단순하면서도 문서 파일 자체의 가독성을 유지하는 방향으로 설계되어 있다.<ref name="syntax">[https://www.dokuwiki.org/wiki:syntax DokuWiki 문법 문서]</ref>

도쿠위키 문법은 [[마크다운]]과 완전히 같지는 않다. 따라서 마크다운 기반 지식 베이스에 익숙한 사용자는 처음에 약간의 학습이 필요하다. 그러나 기본 문법이 크게 어렵지는 않으며, 툴바와 플러그인을 통해 편집 편의성을 높일 수 있다. 또한 플러그인을 이용하면 일부 마크다운 문법을 지원하게 구성할 수도 있다.

=== 네임스페이스 기반 문서 구조 ===
도쿠위키는 문서를 네임스페이스 단위로 정리할 수 있다. 네임스페이스는 파일 시스템의 폴더 구조와 비슷하게 이해할 수 있다. 예를 들어 `project:alpha:install` 같은 문서 이름은 `project` 아래 `alpha` 범주에 속한 `install` 문서처럼 다룰 수 있다.

이 구조는 프로젝트별 문서, 팀별 문서, 제품별 매뉴얼, 버전별 문서 등을 정리할 때 유용하다. 또한 접근 제어 규칙도 네임스페이스 단위로 적용할 수 있어, 특정 팀만 특정 문서 묶음을 볼 수 있게 하거나, 일부 사용자는 읽기만 가능하게 하는 식의 구성이 가능하다.

=== 변경 기록과 차이 보기 ===
도쿠위키는 위키 엔진답게 문서의 변경 기록을 저장하고, 이전 판과 현재 판의 차이를 확인할 수 있다. 문서가 잘못 수정되었거나 삭제되었을 때 이전 판을 확인하고 복구할 수 있으므로 협업 문서 작성에 유리하다.

다만 변경 기록 역시 파일 기반으로 저장되므로, 문서와 변경 이력이 많아질수록 저장 공간 사용량이 늘어난다. 장기간 운영하는 위키라면 변경 기록 보존 정책, 백업 정책, 캐시 정리, 로그 정리 등을 함께 고려하는 것이 좋다.

=== 접근 제어 목록 ===
도쿠위키는 접근 제어 목록, 즉 ACL 기능을 제공한다. 관리자는 사용자 또는 그룹별로 문서나 네임스페이스에 대한 읽기, 편집, 생성, 업로드, 삭제, 관리자 권한 등을 설정할 수 있다.<ref name="acl">[https://www.dokuwiki.org/acl DokuWiki ACL 문서]</ref>

ACL은 도쿠위키를 개인 메모장이 아니라 팀 문서 시스템이나 사내 위키로 사용할 때 매우 중요하다. 예를 들어 전체 사용자는 공지 문서를 읽을 수 있지만, 편집은 관리자만 가능하게 할 수 있다. 개발팀 네임스페이스는 개발팀 사용자 그룹만 편집 가능하게 하고, 외부 공개 문서는 로그인하지 않은 사용자에게도 읽기 권한을 줄 수 있다.

=== 인증 백엔드 ===
도쿠위키는 자체 사용자 관리뿐 아니라 다양한 인증 방식과 연동할 수 있다. 공식 문서에서는 인증 플러그인 구조를 통해 사용자 정보와 비밀번호 저장, 외부 인증 연동 등을 다룬다.<ref name="auth">[https://www.dokuwiki.org/auth DokuWiki 인증 문서]</ref>

운영 환경에 따라 LDAP, Active Directory, OAuth 계열 인증, 외부 CMS 인증, 포럼 계정 연동 등을 플러그인으로 구성할 수 있다. 다만 인증 플러그인의 유지보수 상태와 도쿠위키 최신 버전 호환성은 반드시 확인해야 한다. 인증은 보안과 직결되므로 오래된 플러그인을 그대로 사용하는 것은 위험할 수 있다.

=== 다양한 플러그인 ===
도쿠위키는 플러그인으로 기능을 확장할 수 있다. 플러그인은 [[XpressEngine|XE]]의 모듈 및 애드온, [[미디어위키]]의 확장 기능, [[워드프레스]]의 플러그인과 비슷한 역할을 한다. 공식 확장 기능 저장소에는 문법 확장, 인증 연동, 편집기 개선, 검색 개선, 표 기능 보강, 태그, 목차, 데이터 관리, 양식 생성, 내보내기, 다이어그램, 수식, 코드 하이라이트 등 다양한 플러그인이 등록되어 있다.<ref name="extensions">[https://www.dokuwiki.org/extensions DokuWiki 확장 기능 문서]</ref>

플러그인은 도쿠위키의 강점이지만 동시에 관리 부담이 되기도 한다. 오래된 플러그인은 최신 PHP 버전에서 경고나 오류를 일으킬 수 있고, 보안 취약점이 생길 수도 있다. 따라서 플러그인을 설치할 때에는 최근 업데이트 여부, 호환 버전, 사용자 평가, 공식 저장소의 상태, GitHub 저장소의 이슈 현황 등을 확인하는 것이 좋다.

=== 다양한 템플릿 ===
도쿠위키의 외형은 템플릿으로 변경할 수 있다. 템플릿은 일반적으로 다른 CMS의 테마와 비슷한 개념이다. 기본 템플릿만 사용해도 문서 위키로는 충분하지만, 사이드바, 반응형 디자인, 문서형 레이아웃, 기업 인트라넷 스타일, 블로그형 스타일 등을 원할 경우 별도 템플릿을 설치할 수 있다.

템플릿은 단순히 색상과 모양만 바꾸는 요소가 아니다. 일부 템플릿은 사이드바 구성, 상단 메뉴, 문서 탐색, 목차 표시, 모바일 대응, 검색창 배치, 로그인 메뉴, 도구 버튼 배치까지 사용자 경험에 큰 영향을 준다. 따라서 장기 운영을 계획한다면 템플릿 선택도 중요하다.

=== 가벼운 운영 구조 ===
도쿠위키는 일반적인 PHP 웹 호스팅 환경에서도 구동할 수 있다. 별도의 DBMS가 필요 없기 때문에 VPS나 공유 호스팅에서 부담이 적으며, 개인 서버나 사내 서버에서도 운영하기 쉽다. 문서량이 적거나 중간 규모인 환경에서는 매우 간단하고 안정적인 구성을 만들 수 있다.

다만 문서 수가 매우 많고, 검색 요청이 많고, 첨부 파일과 변경 기록이 방대해지는 환경에서는 파일 기반 구조가 항상 유리하지는 않다. 파일 수가 지나치게 많아지면 백업, 동기화, 검색 색인, 권한 검사, 파일 시스템 I/O 측면에서 부담이 생길 수 있다.