위키 페이지를 읽기 좋게 쓰는 방법(토쿠위키 팁 페이지)

이런 피가 되고 살이 되는 정보가 다 있나. 도쿠위키(dokuwiki)홈페이지에 위키 페이지를 읽기 좋게 쓰는 귀띔 페이지가 있다. 쏙쏙 읽히는 글을 쓰는 건 다른 글쓰기와 그리 다르지 않은데, 트리 형식 글 구조와 페이지 간 링크가 특징인 위키 페이지에 맞춰진 권장 사항이 있으니 굳이 도쿠위키 뿐만 아니라 스프링 노트, 미디어 위키 같은 위키 서비스를 사용한다면 읽어볼 만하다.

간결하게 써라. 문단이 너무 길면 쉣. 뭐, 이런 건 다른 간결하게 글 쓰는 방법을 가르치는 책에서도 강조하는 것이니 넘어가고 이렇게 하면 괜찮겠는데, 하는 항목만 뽑는다면 다음과 같다.

• 제일 상위 단락(Hints on good style)을 페이지 이름(good_style)보다 조금 더 자세히 기록한다. 그리고 간단하게 이 페이지에 대한 힌트를 기록한다.
• 2~3 페이지를 넘어가면 페이지를 쪼개는 게 좋다.
• 페이지 마지막에 연관된 항목을 ’See also’ 단락에 적어라.
• 참고만 하고 내게 맞는 스타일을 개발해라. 좋은 스타일이라고 불편한데 억지로 맞추지마라. 그럼 읽는 사람도 불편해.