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

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

텍스트 단락 유형
단락 유형	줄바꿈 허용	Textile 문법 사용
보통	아니오¹	아니오
제목 1~5	아니오	아니오
헤드라인	아니오	아니오
코드	예	아니오
명령어	예	아니오
줄바꿈 유지	예	아니오
블럭 인용구	예	아니오
권두 명구	예	아니오
순서 목록	예	예
비순서 목록	예	예
정의 목록	예	아니오
콜아웃 목록	예	아니오
단계	아니오	아니오
노트	예	아니오
팁	예	아니오
주의	예	아니오
교정	예	아니오

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

텍스트 단락 유형을 선택하는 방법은 다음과 같습니다.

텍스트 단락 유형은 편집 화면 오른쪽 아래에 있는 드롭다운 목록에서 선택하거나 Ctrl + / 단축키와 방향키로 선택합니다.

텍스트 단락 유형 선택하기

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

보통, 줄 바꿈 유지

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

줄 바꿈 유지 단락에서는 줄을 바꿔도 여러 단락으로 나뉘지 않고 한 단락으로 유지합니다. 줄을 바꿔도 단락을 구분하지 않아야 하는 시와 같은 내용을 작성할 때 줄 바꿈 유지 단락을 사용합니다.

풀 —김수영, 1968. 5. 29

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

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

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

제목과 헤드라인

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

제목 1 다음에 제목 2가 아닌 제목 3이 오는 식으로 구조가 어긋나면 중간에 제목 2에 해당하는 빈 제목을 추가합니다.

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

코드와 명령어

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

코드와 명령어 단락에 고정 폭(모노스페이스) 글꼴을 사용하면 가독성을 높일 수 있습니다. 고정 폭 글꼴은 모든 글자의 너비가 동일해서 여러 줄에 걸친 글자를 열을 맞추어 정렬한 것처럼 표시합니다.

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

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

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

ps -ef | grep java

코드 단락 하이라이트와 줄 번호

다음과 같이 코드 하이라이트와 번호 매기기를 할 수 있습니다.

코드 하이라이트와 줄 번호

코드 단락 <옵션>에서 코드 하이라이트와 줄 번호 매기기를 설정합니다.

코드 하이라이트와 줄 번호 옵션

코드 단락은 기본으로 번호 매기기를 선택하여 줄 번호를 보여줍니다. 줄 번호 매기지 않는 것을 기본 옵션으로 설정하려면 콘솔에서 다음 명령어를 입력합니다.

set-preference -name CODE_NUMBERING -value false

지원하는 언어는 다음과 같습니다. 사용자 언어와 상관없이 영어로만 표시합니다.

XML
HTML
CSS
JAVASCRIPT
JSP
C
C++
C#
JAVA
OBJECTIVE-C
RUBY
PYTHON
SQL
Swift
Kotlin
YAML

웹 뷰어와 PDF에서 지원합니다.

코드 하이라이트 끄기

일괄적으로 코드 하이라이트를 적용하지 않도록 설정할 수 있습니다. 콘솔에서 다음 명령어를 입력합니다.

set-preference -name IGNORE_CODE_HIGHLIGHT -value true

코드 단락 제목 달기

1처럼 코드를 작성하면 코드 단락에 제목이 설정됩니다.

결과는 다음과 같습니다.

$r_title(기본 템플릿)
<!DOCTYPE html>
<html lang="ko">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <title>고객 지원</title>
</head>

그림과 표 제목처럼 테마에서 번호 매기기를 포함한 서식을 설정할 수 있고 코드 차례 장을 만들 수 있습니다.

블록 인용구, 권두 명구(Epigraph)

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

블록 인용구

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

권두 명구

순서, 비순서 목록

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

순서 목록

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

# 축구
# 농구
# 야구

다음과 같이 표시합니다.

축구
농구
야구

순서 목록에서 각 항목은 “# ”²로 시작해야 합니다.
문서 유형을 순서 목록으로 설정한 경우에는 “# ”를 생략할 수 있습니다. 저장하면 자동으로 “# ”이 붙습니다.
보통 단락에서 내용이 “# ”로 시작하면 순서 목록 유형으로 자동 저장합니다.

3 단계까지 지원합니다.

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

다음과 같이 표시합니다.

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

순서를 매기지 않고 줄 바꿈만 하려면 마지막 “# ” 대신에 “+ ”를 사용합니다.

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

“+ ”를 사용하는 것은 Textile 문법이 아닙니다.

다음과 같이 표시합니다.

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

순서 목록 이어 매기기

“순서 목록” 단락은 기본적으로 단락을 만들 때마다 번호를 새로 매기게 설정되어 있습니다. 순서 목록의 “번호”를 앞의 순서 목록 단락과 이어서 매기려면 단락 <옵션>에서 “1번호 새로 매기기” 옵션을 해제합니다.

순서 목록 단락을 추가할 때 2순서 목록(번호 계속 매기기) 단락 유형을 선택해도 번호를 이어서 매깁니다. 순서 목록(번호 계속 매기기) 단락 유형을 선택하면 단락 <옵션>에서 “번호 새로 매기기” 옵션을 해제하지 않아도 이어서 번호를 매깁니다.

순서 목록(번호 계속 매기기) 단락 유형은 텍스트 단락을 처음 만들 때만 드롭다운 목록에서 보입니다. 단락을 만든 후에는 기존과 동일하게 단락 <옵션>에서 설정합니다.

비순서 목록

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

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

다음과 같이 표시합니다.

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

순서 목록을 비순서 목록으로 변경할 때 “# ”을 “* ”로 일일이 변경할 필요가 없습니다. 단락 유형을 변경하면 자동으로 바뀝니다. 비순서 목록을 순서 목록으로 바꾸는 경우도 마찬가지입니다.

순서 목록과 비순서 목록을 같이 사용할 수도 있습니다.

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

다음과 같이 표시합니다.

서울
- 양천구
  1. 목동
  2. 신월동
  3. 신정동
- 영등포구
  1. 대림동
  2. 신길동
  3. 여의도동
부산

순서 목록과 비순서 목록 다음에 오는 단락 들여쓰기

순서 목록과 비순서 목록 다음에 오는 일부 단락들을 들여 쓸 수 있습니다. 들여쓰기를 지원하는 단락은 다음과 같습니다.

그림
표
보통
코드
명령어
줄 바꿈 유지 단락
노트
팁
주의
콜아웃 목록

Tab 단축키를 누르면 들여 쓰고, Shift + Tab 단축키를 누르면 들여쓰기를 취소합니다.

에디터에서는 들여쓰기를 하지 않고 1다음과 같이 표시합니다.

정의 목록

정의 목록은 정의(또는 용어, 메뉴 이름 등)를 설명과 짝을 이루게 하여 반복적으로 표시하는 단락 유형입니다.

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

제목
책 제목을 입력합니다.

부제목
책 제목에 덧붙이는 부제목을 입력합니다. 

에디션
작성하고 있는 책의 편집 버전을 입력합니다.

다음과 같이 표시합니다.

제목: 책 제목을 입력합니다.
부제목: 책 제목에 덧붙이는 부제목을 입력합니다.
에디션: 작성하고 있는 책의 편집 버전을 입력합니다.

줄 바꿈하여 설명 부분을 추가할 때는 “+ ”를 사용합니다.

제목
책 제목을 입력합니다.
+ 책 제목은 생략할 수 없습니다.

부제목
책 제목에 덧붙이는 부제목을 입력합니다.

다음과 같이 표시합니다.

제목

책 제목을 입력합니다.

책 제목은 생략할 수 없습니다.

부제목

책 제목에 덧붙이는 부제목을 입력합니다.

정의 목록 레이아웃 설정하기

정의 목록 단락 <옵션>에서 정의 목록의 1레이아웃을 설정할 수 있습니다.

선택한 레이아웃에 따라 다음과 같이 표시합니다.

없음: 기존의 정의 목록 단락 모습으로 보여줍니다.

열 2: 2개의 열로 나눠서 보여줍니다.

열 3: 3개의 열로 나눠서 보여줍니다.

웹 뷰어와 HTML에만 적용합니다. PDF 등과는 상관이 없습니다.

콜아웃 목록

콜아웃 목록은 그림 단락과 함께 사용하는 단락 유형입니다. 그림에 콜아웃 번호를 붙이고 텍스트 단락에 이를 설명합니다. 다음 순서로 콜아웃 목록 단락을 만듭니다.

그림에서 설명하고 싶은 부분에 콜아웃 번호를 붙입니다.
그림에 매긴 콜아웃 순서대로 텍스트 단락에 내용을 입력합니다.
텍스트 단락 유형을 콜아웃 목록으로 설정한 후 합니다.
텍스트 단락에 콜아웃 번호가 표시됩니다.

수박
포도
참외

다음과 같이 표시합니다.

1수박

2포도

3참외

콜아웃 번호 임의로 설정하기

콜아웃 번호는 임의로 설정할 수 있습니다.

두 자리 이하로, 영어와 숫자로만 설정할 수 있습니다. 콜아웃 번호를 임의로 설정할 때는 번호를 내용과 띄어쓰기합니다.

#3 수박
#A 포도
#b1 참외

다음과 같이 표시합니다.

3수박

A포도

b1참외

MS 워드는 원 문자 처리에 한계가 있습니다. 따라서 MS 워드 파일 만들기가 중요할 때는 콜아웃 번호를 1에서 10까지만 사용합니다. 원 숫자를 지원하는 Wingdings 글꼴이 1부터 10까지만 지원하기 때문입니다.

콜아웃 목록 단락에서 줄바꿈하기

새로운 항목을 만들지 않고 줄 바꿈 하려면 “+ ”를 사용합니다.

수박
+ 수박은 남아프리카 원산의 한해살이 덩굴식물, 또는 그 열매를 말한다.
포도
참외

다음과 같이 표시합니다.

1수박
수박은 남아프리카 원산의 한해살이 덩굴식물, 또는 그 열매를 말한다.

2포도

3참외

“+ ”를 사용하는 것은 Textile 문법이 아닙니다.

단계

단계는 단계별 절차를 설명하는 단락 유형입니다. 자세한 사항은 다음 예제를 참고하세요.

https://www.3rabbitz.com/book_installation_guide_4_0_ko#f840f552f450641a

제목 단락 유형이 나오면 단계 번호를 “1”로 초기화합니다.

웹 뷰어와 PDF에서는 단계 단락 다음에 나오는 단락을 자동 들여쓰기 합니다. 단계 단락 다음에 오는 단락들을 들여쓰고 싶지 않을 때는 다음 순서로 설정합니다.

들여쓰지 않을 단락을 선택합니다.
단락 <옵션>에서 “단계 단락 들여쓰기 무시하기” 옵션을 선택합니다.
버튼을 클릭합니다.
1. 에디터에서 “단계 단락 들여쓰기 무시하기” 옵션을 선택한 단락에는 ignore_step-indent라는 문구가 나타납니다.

노트, 팁, 주의

본문 흐름과는 별개로 정보, 팁, 경고 등을 제공하는 것을 Admonition이라고 합니다. Admonition 용도로 노트, 팁, 주의 등의 단락 유형을 제공합니다.

노트: 본문에 간단하게 추가할 짧은 설명이나 참조, 논평을 제공합니다.
팁: 도움말 등의 팁을 제공합니다.
주의: 독자 또는 사용자의 주의를 환기하는 문장을 제공합니다.

교정

교정 단락은 내용 교정에 필요한 정보나 작업 목록을 정리하기 위한 단락입니다. 웹 뷰어, PDF, EPUB 등에는 나타나지 않습니다.

문서 상세 화면 <1진척 관리>에서 문서에 있는 전체 교정 단락을 확인합니다.

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