텍스트 단락

책이 장(Chapter)들로 구성된다면 장은 단락들로 구성됩니다. 단락은 텍스트, 이미지, 테이블, 객체 등으로 분류되고 개별 텍스트 단락들은 고유한 유형을 지닙니다. 어떤 유형의 텍스트 단락을 어떤 상황에서 사용할 것인가를 정확히 판단해야 글쓰기를 효율적으로 할 수 있습니다. 텍스트 단락에서는 이를 판단하는데 도움이 될 내용들을 정리했습니다.

텍스트 단락 유형은 다음과 같습니다.

작성하는 책의 성격에 따라서 사용하는 단락 유형이 달라집니다. 소설이나 수필은 보통, 헤드라인, 블럭 인용구 등의 단락 유형만으로 대부분의 내용을 작성할 수 있습니다. 반면에 기술 서적이나 제품 매뉴얼을 작성할 때는 이보다 많은 단락 유형들을 사용해야 합니다.

각 단락 유형의 용도, 특징, 사용 방법은 다음과 같습니다.

보통, 줄바꿈 유지 단락

일반적인 텍스트 단락 유형은 보통입니다. 보통 단락에서 줄바꿈을 하고 저장하면 줄바꿈을 기준으로 해서 여러 단락으로 나눠집니다.

줄바꿈 유지 단락에서는 줄바꿈을 해도 여러 단락으로 분리되지 않고 동일한 단락으로 유지됩니다. 줄이 바뀌어도 단락이 구분되지 않아야 하는 시와 같은 내용을 작성할 때 줄바꿈 유지 단락을 사용합니다.

풀 —김수영, 1968. 5. 29

풀이 눕는다 
비를 몰아오는 동풍에 나부껴 
풀은 눕고 
드디어 울었다 
날이 흐려서 더 울다가 
다시 누웠다 

풀이 눕는다 
바람보다도 더 빨리 눕는다 
바람보다도 더 빨리 울고 
바람보다 먼저 일어난다 

날이 흐리고 풀이 눕는다 
발목까지 
발밑까지 눕는다 
바람보다 늦게 누워도 
바람보다 먼저 일어나고 
바람보다 늦게 울어도 
바람보다 먼저 웃는다 
날이 흐리고 풀뿌리가 눕는다

제목과 헤드라인

제목은 내용을 절(Section)로 나누고 단락을 강조합니다. 제목 1에서 제목 5까지를 사용하여 절을 계층적으로 구성하면 이에 맞추어 목차가 자동으로 생성됩니다.

헤드라인은 내용을 강조한다는 측면에서는 제목과 유사하지만 절을 구분하지 않고 목차에 포함되지 않는다는 차이점이 있습니다.

블럭 인용구, 에피그라프

블럭 인용구는 설명이나 주장에 도움이 되는 다른 저자의 책이나 논문, 논구, 자료 또는 구술을 차용하는 데 사용하는 단락 유형입니다.

에피그라프는 각 장의 시작에 붙이는 취지 및 이념 등을 나타내는 인용문을 말합니다. 일반적으로 에피그라프는 맨 처음 단락이 됩니다. 그래서 에피그라프를 권두 명구(卷頭 銘句)라고도 합니다.

코드와 명령어

소프트웨어 프로그래밍이나 시스템 관리 등과 관련된 기술 서적이나 매뉴얼을 작성할 때 사용하는 단락 유형입니다.

코드 단락은 다음과 같습니다.

public static void main(String[] args) {
  System.out.println("Hello, World!");
}

명령어 단락은 다음과 같습니다.

ps -ef | grep java

순서, 비순서 목록

순서, 비순서 목록을 작성하는데 위키에서 사용하는 Textile 문법을 일부 사용합니다.

순서 목록은 다음과 같이 작성합니다.

# 축구
# 농구
# 야구

다음과 같이 표시됩니다.

1. 축구

2. 농구

3. 야구

• 순서 목록에서 각 항목은 <# >²로 시작해야 합니다.

• 문서 유형을 순서 목록으로 지정한 경우에는 <# >를 생략할 수 있습니다. 저장하면 자동으로 <# >이 붙습니다.

• 보통 단락에서 내용이 <# >로 시작하면 순서 목록 유형으로 자동 저장됩니다.

3 단계까지 지원합니다.

# 서울
## 양천구
### 목동
### 신월동
### 신정동
## 영등포구
### 대림동
### 신길동
### 여의도동
# 부산

다음과 같이 표시됩니다.

1. 서울

   1. 양천구

      1. 목동

      2. 신월동

      3. 신정동

   2. 영등포구

      1. 대림동

      2. 신길동

      3. 여의도동

2. 부산

새로운 항목을 만들지 않고 단락 구분만을 하려면 마지막 # 대신에 +를 사용합니다.

# 서울
+ 대한민국 수도
## 양천구
#+ 서울 서부에 있는 구
### 목동
##+ 조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
### 신월동
##+ 조선시대에는 경기도 양천현에 속하였다. 
### 신정동
##+ 조선시대에는 경기도 양천현에 속하였다.

다음과 같이 표시됩니다.

1. 서울

   대한민국 수도

   1. 양천구

      서울 서부에 있는 구

      1. 목동

         조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다

      2. 신월동

         조선시대에는 경기도 양천현에 속하였다.

      3. 신정동

         조선시대에는 경기도 양천현에 속하였다.

비순서 목록도 순서 목록과 동일하게 작성하는데 # 대신에 *를 사용합니다.

* 서울
+ 대한민국 수도
** 양천구
*+ 서울 서부에 있는 구
*** 목동
**+ 조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
*** 신월동
**+ 조선시대에는 경기도 양천현에 속하였다. 
*** 신정동
**+ 조선시대에는 경기도 양천현에 속하였다.

다음과 같이 표시됩니다.

• 서울

  대한민국 수도

  • 양천구

    서울 서부에 있는 구

    • 목동

      조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다

    • 신월동

      조선시대에는 경기도 양천현에 속하였다.

    • 신정동

      조선시대에는 경기도 양천현에 속하였다.

정의 목록

정의 목록은 정의(또는 용어, 메뉴 이름 등)와 설명이 연속적으로 표시되는 단락 유형입니다.

줄바꿈으로 정의와 설명을 구분합니다.

편집 시간

화면상에 보이는 내용으로 편집한 과거 시점의 시간을 나타냅니다.

현재 버전으로 복원

현재 화면상에 제시된 편집 내용으로 챕터를 복원합니다.

오래된 이력

현재 화면상에 나타난 편집 시간을 기준으로 이전에 수행된 편집 내용을 보여줍니다.

최근 이력

현재 화면상에 제시된 편집 시간을 기준으로 이후에 수행된 편집 내용을 보여줍니다.

다음과 같이 표시됩니다.

편집 시간

화면상에 보이는 내용으로 편집한 과거 시점의 시간을 나타냅니다.

현재 버전으로 복원

현재 화면상에 제시된 편집 내용으로 챕터를 복원합니다.

오래된 이력

현재 화면상에 나타난 편집 시간을 기준으로 이전에 수행된 편집 내용을 보여줍니다.

최근 이력

현재 화면상에 제시된 편집 시간을 기준으로 이후에 수행된 편집 내용을 보여줍니다.

노트, 팁, 주의

본문 흐름과는 별개로 정보, 팁, 경고 등을 제공하는 것을 Admonition이라고 합니다. Admonition은 우리말로 훈계, 질책, 경고, 충고 등으로 번역됩니다.

Admonition의 용도로 노트, 팁, 주의 등의 단락 유형을 제공하는데 어떤 내용에 어떤 단락 유형을 사용해야한다는 명확한 지침은 없습니다.

노트

본문에 간단하게 추가할 짧은 설명이나 참조, 논평을 제공하기 위해 사용합니다.

팁

도움말 등의 팁을 제공하기 위해 사용합니다.

주의

독자 또는 사용자의 주의를 환기시키는 문장을 제공하기 위해 사용합니다.

1. 보통 단락에서 줄바꿈을 하고 저장하면 여러 단락으로 자동 분리됩니다.
2. '#' 다음에 띄어쓰기를 해야 합니다.