[도쿠위키] 문자처리 및 리스트 사용

사용환경

  • 운영체제 : CentOS 5.5 Final
  • 커널버전 : Linux 2.6.18-194.26.1.el5 i686 GNU/Linux
  • 아파치버전 : httpd-2.2.3-43.el5.centos.3
  • PHP버전 : php-5.1.6-27.el5_5.3
  • 도쿠위키버전 : dokuwiki-2010-11-07 “Anteater

연관포스트

  1. [도쿠위키] 도쿠위키 설치
  2. [도쿠위키] 문서생성
  3. [도쿠위키] 연습용 위키생성 및 템플릿 변경
  4. [도쿠위키] 단계별 헤드라인

01. 시작하기 전에…

이제 지난 포스트에서는 문서들의 뼈대를 만드는 작업에 대해서 포스팅을 했으니 이제는 내용을 채우는 법을 포스팅을 하려고 합니다.

도쿠위키에도 두껍게(Bold), 밑줄(Underline), 기울림(Italic), 취소선(del)과 같은 문자를 처리하는 것과 리스트를 처리하는 문법이 있습니다. 이제 아래에서 예를 들어가면서 하나씩 설명하도록 하겠습니다.

02. 문자처리

일단, 두껍게 문자를 처리하는 방법은 **을 문자 양쪽에 넣어주는 것입니다.

<strong>입력</strong> : 안녕하세요 **심플리즘**입니다.

위와 같이 입력을 하고 저장 또는 미리보기를 하면, 결과는 아래처럼 나옵니다.

결과 : 안녕하세요 심플리즘입니다.

HTML처럼 특정 기호를 양쪽에 넣어줌으로써 원하는 처리를 하도록 하는 것입니다. 그리고 다음은 밑줄을 그어봅니다. 밑줄은 _(Under-dash)문자를 두 개씩 앞 뒤로 붙여주는 것입니다.

입력 : 안녕하세요 __심플리즘__입니다.

결과 : 안녕하세요 심플리즘입니다.

그리고 기울임체는 //(슬래쉬 두개)를 앞 뒤로 붙여주면 됩니다.

입력 : 안녕하세요 //심플리즘//입니다.

결과 : 안녕하세요 심플리즘입니다.

코드화된 문자는 ‘(작은 따옴표)를 두 개씩 앞 뒤로 붙여줍니다.

<strong>입력</strong> : 안녕하세요 ''심플리즘''입니다.
<strong>결과</strong> : <a href="http://blog.simplism.kr/uploads/2011/01/dokuwiki_character_01.png"><span style="color: #000000;"><img style="border: 1px solid black; margin-top: 1px; margin-bottom: 1px;" title="dokuwiki_character_01" alt="" src="http://blog.simplism.kr/uploads/2011/01/dokuwiki_character_01.png" /></span></a>

코드화된 문자의 경우는 워드프레스에서 처리할 방법이 없어서;; 캡쳐로 넣었습니다. 취소선의 경우는 html 처럼 앞에는 <del> 문자의 뒤에는 </del>처럼 종료ㅌ태그를 붙여주면 됩니다.

입력 : 안녕하세요 <del>심플리즘</del>입니다.

결과 : 안녕하세요 심플리즘입니다.

대충 이런정도 입니다.

03. 중복으로 효과적용

위에서 두껍게, 밑줄, 기울임, 코드화, 취소선과 같은 문자에 강조효과를 주는 것들은 중복으로 효과를 주는 것이 가능합니다.

예를 들자면 아래와 같습니다.

위는 도쿠위키에서 작성한 내용을 캡쳐해서 가져온 것입니다. 위에서 나열한 모든 처리를 한꺼번에 적용해봤습니다. 전부 빠짐없이 적용된 하니 중복으로 적용된 것을 확인할 수 있습니다.

단, 주의할 점은 쌍을 맞춰줘야 한다는 것입니다. 양파의 껍질을 하나씩 까듯이 앞 뒤로 쌍을 맞춰줘야 합니다. 그렇지 않으면 정상적으로 적용이 되질 않습니다. 아래의 그림을 보시면 쉽게 이해할 수 있습니다.

위 처럼 각 효과를 주는 문자들이 HTML 태그처럼 다른 효과의 문자들을 감싸는 형태로 작성을 해야 중복으로 효과가 적용이 됩니다. 만약에 잘 못 감싸게 되면, 원하는 결과가 출력이 되질 않습니다. 이와 관련된 샘플은 http://server.simplism.kr/test/doku.php?id=sample:character_sample에 샘플로 작성해뒀습니다. 해당 샘플을 보면서 직접 하나씩 해보시면 금세 익숙해질 것입니다.

04. 리스트 작성

이제는 리스트 작성을 해보도록 하겠습니다. 리스트를 구성하는 문법은 기본적으로 space바와 -(dash), *(asterisk) 문자입니다. -(dash)문자는 숫자가 있는 리스트를 만들어주고, *(asterisk)는 숫자가 없는 리스트를 만들어주는 역할을 합니다.

리스트의 시작은 두 개의 공백입니다. 편의 상 공백을 ⁄ 으로 처리하도록 하겠습니다.

간단한 리스트를 작성하면 아래와 같습니다.

⁄⁄* 리스트 시작
⁄⁄⁄⁄* 하위 리스트
⁄⁄⁄⁄* 하위 리스트
⁄⁄* 리스트 다시 시작
⁄⁄⁄⁄* 하위 리스트
⁄⁄⁄⁄* 하위 리스트

공백 2개가 리스트의 시작입니다. 그리고 *(asterisk)와 -(dash)를 입력하면 리스트가 시작됩니다. 공백이 4개면 해당 리스트의 하위 리스트로 추가됩니다. 공백이 2개씩 추가될 때마다 하위의 리스트로 추가가 되는 것입니다.

위 처럼 입력하면 아래처럼 결과나 출력됩니다.

  • 리스트 시작
    • 하위 리스트
    • 하위 리스트
  • 리스트 다시 시작
    • 하위 리스트
    • 하위 리스트

기본적으로 도쿠위키의 입력폼은 리스트를 추가하기 시작하면, 하위 리스트를 추가할 때는 자동으로 위의 리스트와 같이 공백2개와 -(dash)또는 *(asterisk)를 추가해줍니다. 보다 편리하게 입력을 할 수 있게 어느정도 자동으로 입력을 해주는 것입니다. 이 부분은 설명보다는 직접 사용을 해보는 것이 편할 것 같습니다.

하지만, 웹브라우저에 따라서 자동으로 입력되지 않을 수 있습니다.(특히 IE6) 그러한 경우에는 문법에 맞도록 수동으로 공백두개와 -(dash)나 *(asterisk)를 입력해줘야 합니다.

*(asterisk)는 숫자가 없는 리스트를 출력해주고, -(dash)를 입력하면 숫자가 있는 리스트를 출력해줍니다.

⁄⁄- 숫자 리스트
⁄⁄⁄⁄- 하위 리스트
⁄⁄⁄⁄- 하위 리스트
⁄⁄- 숫자 리스트
⁄⁄⁄⁄- 하위 리스트
⁄⁄⁄⁄- 하위 리스트

위 처럼 입력한 경우는 아래처럼 출력이 됩니다. 숫자의 경우에는 단계가 내려갈 수록 모양이 바뀝니다. 지금은 워드프레스라서 결과가 조금 다를 수 있습니다.

  1. 숫자 리스트
    1. 하위 리스트
    2. 하위 리스트
  2. 숫자 리스트
    1. 하위 리스트
    2. 하위 리스트

또는 숫자가 있는 리스트와 없는 리스트를 혼용해서 사용이 가능합니다.

⁄⁄- 숫자 리스트
⁄⁄⁄⁄* 하위 리스트
⁄⁄⁄⁄* 하위 리스트
⁄⁄- 숫자 리스트
⁄⁄⁄⁄* 하위 리스트
⁄⁄⁄⁄* 하위 리스트

위 처럼 입력한 경우에는 아래와 같이 결과가 나옵니다.(모양은 역시 조금 다릅니다.)

위 처럼 공백(space)과 -(dash), *(asterisk)를 적절히 조합하면, 원하는 리스트를 쉽게 작성할 수 있습니다. 리스트를 작성한 샘플은 http://server.simplism.kr/test/doku.php?id=sample:list_sample에서 확인이 가능합니다. 물론 새로운 문서를 만들어서 직접 연습을 해보실 수 있습니다.

05. 마치면서…

문자에 효과를 주는 것은 간단한 편이지만, 리스트의 경우에는 공백을 입력해야하는 것이기에 조금 헷갈릴 수 있습니다. 하지만 익숙해지시면, 기존에 많이 사용하는 한글, MS Word나 오픈오피스같은 워드프로세서 프로그램보다 오히려 편하게 문서 작성이 가능합니다.

숫자 리스트의 경우는 알아서 숫자를 증가해서 넣어주므로, 리스트의 내용이 중간에 들어가거나 바뀌더라도 숫자에 대해서는 신경쓰지 않으셔도 됩니다. 처음에 워드프로세서 프로그램을 배우는 것과 마찬가지로 새롭게 배워야하는 것이 큰 장벽이긴 하지만, 웹 기반으로 문서를 작성할 수 있다면 여러 개의 장비(심지어는 스마트폰에서도…) 같은 문서를 동시에 열람하거나 편집이 가능하다는 큰 장점이 있습니다.

문제는 숙달이 될 때까지의 과정인데… 이 부분은 계속 사용을 해보는 방법밖에는 없습니다. http://server.simplism.kr/test/에 공개용 도쿠위키를 설치해뒀으므로… 직접 연습을 해볼 수 있습니다.

저의 경우에도 개인용으로 사용하는 위키를 아이팟으로도 같이 열람 및 편집을 하고 있습니다.(이거… 매번 도쿠위키에 대한 장점만 광고를 하고 있다는 생각이 들기도 합니다;;;;)

06. 참고문서

  1. http://www.dokuwiki.org/ko:syntax