WikiEditSimpleHowto

깊이있는 삽질 Ubuntu Korea Community Wiki
이동: 둘러보기, 검색

개요

이 페이지는 괴물같은 위키를 좀 더 친숙한 시각에서 바라볼 수 있도록 예제 중심으로 작성 방법을 설명하는 페이지입니다.

스크롤을 보니 분량이 *-ㅅ-*깜찍 해요

영문 페이지 여부 관계 없이 그래도 보시겠다는 분들을 위해 정말로 친절하게 :D ! 링크를 준비했습니다.

스타일링

기본적으로 HTML 태그를 인식합니다. 예를 들자면 ...

  • 굵게
<b>굵게</b>
  • 밑줄
<u>밑줄</u>
  • 기울이기
<i>기울이기</i>

물론 이런 전통적인 방식의 포매팅을 쓰지 않고도 위키에서 더 단순하게 표현하는 방법이 있습니다.

  • 기울이기
''기울이기''
  • 굵게
 '''굵게'''
  • 기울이기+굵게
'''''기울이기+굵게'''''

...적고 보니 단순해 보이지가 않군요 ㄱ- (돌 던지시면 곤란합니다) 어쨌든 이야기는 계속 진행합니다. <font> 태그를 인식하므로 당연히 색상도 설정[1]할 수 있습니다. 심지어는 글자 크기도 설정할 수 있고 글꼴도 지정할 수 있습니다[2].

참고: 모든 시스템에 지정 글꼴이 설치됐다는 보장이 없으므로 글꼴 임의 설정은 지양하셨으면 좋겠습니다.

문서 포매팅

위키를 쓰는 목적은 물론 아무나 접근해서 자유롭게 문서를 작성하고 다듬는것에 있다. 이게 핵심 포인트입니다. 하지만 그 무엇보다 중요한 기능 언급 하나가 빠져 있습니다. 그것은 바로 문서 포매팅입니다. 문서 포매팅의 요소를 몇가지 언급하자면,

  • 눈에 띄는 제목
  • 긴 문장을 단순한 문장으로 끊어 일목요연하게 정리하는 항목 매기기
  • 주석

입니다. 이 중에서 우분투 위키에서 기본적으로 제공하는 요소는 위 세가지 기능이며 제일 아래의 기능은 옵션입니다. 기본적으로 제공한다는 말의 의미는 그만큼 위키에서 중요하게 취급을 한다는 이야기와 같습니다.

제목 적기

뭐니뭐니해도 문서를 작성할 때 제일 중요한건 내용별로 문단을 나누고 문단의 내용을 알기 쉽게 문단 위에 소제목을 달고, 이러한 작은 문단들이 모여서 어떤 내용을 이루고 있는지 정리하는 큰 제목을 다는 것입니다. 위키에서 제목을 적는 방법은 매우 간단합니다.

= 대 제목 =
== 1단계 소제목 ==
=== 2단계 소제목 ===
==== 3단계 소제목 ====
===== 4단계 소제목 =====
====== 5단계 소제목 ======

실제로는 아래와 같이 나타납니다.

대 제목

1단계 소제목

2단계 소제목

3단계 소제목

4단계 소제목
5단계 소제목

예제를 보여주느라 이 페이지의 문단은 깨졌겠지만, 사실 이 문서는 잘못된 것이 아닙니다 :P

항목 매기기

뭐니뭐니해도 우분투 위키에서 제공하는 강력한 기능 중 하나는 항목을 매기는 것입니다. 절차를 설명하거나 일목요연하게 내용 정리가 필요할 경우 항목 매기기의 활용은 가히 필수적이라 할 수 있습니다. 그런데, 이 문법이 생각보다 직관적이지 않기 때문에 잘못 사용하면 문단이 깨질 수가 있습니다.

구슬 항목 표시

  • 참고: 원어상 표기로는 bullet 이기에 총알이라 번역하는 것이 맞겠지만, 모양새는 구슬입니다. 오히려 더 가까운 의미의 단어로 탄환이라는 용어가 있지만, 독자 입장에서 친숙한 느낌이 들지 않기 때문에 편의상 "구슬"이라 표기하였음을 양해바랍니다.

구슬 항목 표시는 단순합니다. 그냥 문단 앞에 *을 찍어주시고 공백 문자키를 한번 탘! 하고 쳐주신 다음에 적을 내용을 입력하면 됩니다.

* 첫번째 항목
** 1-1
*** 1-1-1
*** 1-1-2
** 1-2
* 두번째 항목
* 세번째 항목

은 다음과 같이 나타납니다.

  • 첫번째 항목
    • 1-1
      • 1-1-1
      • 1-1-2
    • 1-2
  • 두번째 항목
  • 세번째 항목

숫자 항목 표시

역시 이것도 간단합니다. 구슬 항목 표시와 다른 점이 있다면, 구슬 항목 표시에서는 * 표시를 사용하지만 숫자 항목을 표시할 때는 number 대신 표기하는 특수문자 # 기호를 사용합니다.

# 첫번째 항목
## 1-1
### 1-1-1
### 1-1-2
## 1-2
# 두번째 항목
# 세번째 항목

은 다음과 같이 나타납니다.

  1. 첫번째 항목
    1. 1-1
      1. 1-1-1
      2. 1-1-2
    2. 1-2
  2. 두번째 항목
  3. 세번째 항목

혼용하기

한가지 방법만 쓰면 재미도 없고 감동도 없고 뽀대도 없으니 두가지 방법을 다 써보시려는 분들이 더 많으실겁니다. 그런 분들을 위해 예제를 준비했습니다.

# 첫번째 항목
#* 1-1
#*# 1-1-1
#*# 1-1-2
#* 1-2
# 두번째 항목
# 세번째 항목

결과는 다음과 같습니다.

  1. 첫번째 항목
    • 1-1
      1. 1-1-1
      2. 1-1-2
    • 1-2
  2. 두번째 항목
  3. 세번째 항목

표 만들기

이 부분에서 설명할 내용은 미디어 위키측에서 정리해준 도움말 이상으로 단순화 할 수 없습니다. 쉽게 단순히 설명을 해도 문법 구조가 복잡하기 때문에 이해하기 쉽지 않다는 의미입니다. 제시해드린 도움말 링크를 직접 참고해서 보시는 것이 가장 좋습니다.

주석

미디어 위키에서 제공하는 주석 기능은 페이지 하단에 주석을 제공하는 특성 때문에 "각주"로 오해하기 쉽지만, 사실은 본문에서 인용하는 모든 주석을 가장 마지막에 모아서 출력하기 때문에 "미주"에 가깝습니다[3]. 일반적으로 주석은 내용 증명을 위해 사용하기도 하지만, 오해하기 쉬운 내용을 부연 설명할 때도 활용합니다.

소스코드 강조

현재 우분투 한국 위키에서 사용중인 미디어위키는 1.21 버전 즈음부터 기본적으로 SyntaxHighlight_GeSHi 모듈이 들어있습니다[4]. 현재 미디어위키 상태는 다음과 같으며, 필요한 경우 문법 강조는 아래와 같이 사용할 수 있습니다. 지원하는 언어 문법 목록은 공식 페이지에 있습니다.

  • C
<SyntaxHighlight lang="C">
#include <stdio.h>
#include <stdlib.h>

int main ( int argc, char *argv[] )
{
    printf("Hello world\n");
    return EXIT_SUCCESS;
}
</SyntaxHighlight>
#include <stdio.h>
#include <stdlib.h>

int main ( int argc, char *argv[] )
{
    printf("Hello world\n");
    return EXIT_SUCCESS;
}


  • PHP
<SyntaxHighlight lang="PHP">
<?php
    for (  $i = 0 ; $i < 5 ; $i++ )
    {
        for ( $j = 0 ; $j < $i ; $j++ )
        {
            print "*";
        }
        print "\n";
    }
?>
</SyntaxHighlight>
<?php
    for (  $i = 0 ; $i < 5 ; $i++ )
    {
        for ( $j = 0 ; $j < $i ; $j++ )
        {
            print "*";
        }
        print "\n";
    }
?>

공동 문서 작성

여럿이서 문서를 작성할 때는 각 구성원 별로(필요에 따라) 작성한 부분에 서명을 다는 등 여러가지 처리를 할 수 있습니다. 때로는 다수의 사람이 한 문단의 문장을 놓고 이리저리 고치는 경우도 있습니다.

서명

어떤 위치에 표시를 하든 유효합니다. 주로 본문 보다는 토론 페이지에서 자신이 언급했음을 명시적으로 표시할 때 사용합니다.

~~~~

이 표시는

Darkcircle (토론) 2014년 4월 25일 (금) 13:47 (KST)

위와 같이 눈에 보이지 않는 마술과 같은 과정을 거쳐서 서명을 보여줍니다.

토론 페이지

문서의 문제를 발견했을 경우 버그질라 대신 사용하는 부분입니다. 문서를 읽다 의문점이 있다면 작성자에게 문의하기 위해 활용하기도 합니다. 문서에 문제가 있든 없든 내 자신이 이상하다고 생각하는 점이 단 한 개라도 있다면, 모두 버그입니다. 주저하지 마시고 바로 질문을 해주시는 것이 모두의 문서를 키워나가는데 도움을 주는 방법입니다. 문서상 잘못된 내용이 있다면, 해당 문서를 고친 후에 주석을 달고 토론방에 언급하거나, ... 토론방에 우선 언급하고 답변을 들은 후 해당 문서를 고칩니다. 자신이 직접 관리하고 편집하는 페이지가 아니라면, 후자의 방법을 따르는 것이 상대방을 배려하는 좋은 방법입니다. 문제점을 언급했을 때, 그냥 문장을 넣고 저장하면 누가 작성했는지 알 수 없으므로 문장 마지막에 위 문단에서 언급한대로 ~~~~ (서명) 표시를 해주시는 것이 좋겠습니다. :D

틀 표시 활용하기

미디어 위키의 가장 강력한 기능으로 틀이 있습니다. 문서의 편집 상태를 표시하기 위해 몇가지 틀을 "자체적으로" 도입했습니다. 한국 우분투 위키에서의 용도는 크게 두가지이며, 하나는 문서 전체의 상태를 나타내는 알림 상자이고, 다른 하나는 문서 내의 설명 과정에서 단락이나 문장을 특별한 목적과 용도로 강조하려고 할 때 사용합니다. 각각의 용도에 따른 틀의 목록은 다음 페이지에 별도로 정리해두었습니다.


  1. HTML 색상 이름 : http://www.w3schools.com/html/html_colornames.asp
  2. HTML 4.01 Specification : http://www.w3.org/TR/html401/present/graphics.html#h-15.2.2
  3. 각주와 미주의 차이 : http://blog.daum.net/mjustudy/39
  4. Bundled extensions list of the MediaWiki 1.21