코드를 작성해 본 경험이 있다면 프로그래밍 작업의 상당 부분이 문서 읽기로 이루어진다는 사실에 공감할 것입니다. 실제로 문서와 다른 사람의 코드를 읽는 데 드는 시간이 직접 코드를 작성하는 시간보다 많은 경우가 흔합니다. 그런데 이러한 문서는 대부분 웹에서 접근하기 때문에 원하는 정보를 검색하고 페이지가 로드되기를 기다리는 데 상당한 시간이 낭비됩니다. 이런 사소한 지연은 특히 인터넷 연결 속도가 느릴 때 더욱 짜증나게 느껴지며, 모두 합치면 몇 분, 어쩌면 몇 시간에 달하는 생산성 손실로 이어질 수 있습니다. 게다가 웹 문서에 접근하려면 언제든 보장되기 어려운 지속적인 인터넷 연결이 필요합니다.
다행히 Zeal이라는 오프라인 문서 브라우저를 사용하면 프로그래밍 언어 및 소프트웨어 문서를 자신의 컴퓨터에 저장하고 빠르고 효율적으로 열람할 수 있습니다. Zeal은 Dash에서 제공하는 문서 세트(docset)를 활용하며, 다양한 프로그래밍·스크립팅 언어와 라이브러리는 물론 Docker, Nginx, WordPress, ElasticSearch 같은 소프트웨어 문서도 함께 제공합니다.
이 글에서는 리눅스에서 Zeal을 설치하고, 사용하며, 자신에게 맞게 꾸미는 방법까지 차례대로 살펴봅니다.
Zeal 설치하기
Zeal은 많은 리눅스 배포판의 소프트웨어 저장소에 포함되어 있으므로, 가능하다면 배포판의 기본 패키지 관리자를 통해 설치하는 것이 가장 간편합니다.
Ubuntu, Linux Mint, Debian에서:
sudo apt install zeal
Arch Linux에서:
sudo pacman -S zeal
Gentoo에서:
sudo emerge app-doc/zeal
Fedora에서:
sudo dnf install zeal
Zeal 사용하기
애플리케이션 메뉴나 런처에서 Zeal을 실행하거나, 터미널에서 zeal 명령을 입력해 실행할 수도 있습니다.
Zeal은 기본적으로 어떤 문서도 포함하고 있지 않습니다. 사용 가능한 docset을 확인하려면 “Tools → Docsets” 메뉴로 이동한 뒤 “Available” 탭을 엽니다.
저장하고 싶은 docset을 선택한 후 “Download” 버튼을 클릭합니다. 다운로드가 완료되면 문서 세트가 왼쪽 위 창에 탐색하기 쉬운 계층 구조로 표시됩니다. 해당하는 경우 왼쪽 아래 창에는 현재 문서 페이지의 요소들로 바로 이동할 수 있는 바로가기 목록이 나타납니다.
검색창에 키워드를 입력하면 모든 docset을 대상으로 검색할 수 있고, docset:query 형식의 문법을 사용하면 특정 docset만 지정해 검색할 수 있습니다. 예를 들어 Python의 re.match 함수를 찾으려면 python:re.match라고 입력하면 됩니다.
참고: 복합 검색 문법(docset:query)에서 docset 부분은 대소문자를 구분하지만, query 부분은 대소문자를 구분하지 않습니다.
Zeal 커스터마이징하기
글꼴 설정
Zeal의 화면 모습은 글꼴과 글꼴 크기를 조정해 취향대로 바꿀 수 있습니다. “Edit → Preferences → Content”로 이동한 다음 기본 글꼴 계열과 각 계열별 세부 글꼴을 선택하세요.
다크 모드
Zeal은 다크 모드(“Edit → Preferences → Content”)도 제공합니다. 다만 아래 스크린샷에서 볼 수 있듯이 다크 모드는 주변 그래픽 인터페이스가 아니라 문서 내용에만 적용된다는 점에 유의하세요.
사용자 정의 CSS
Zeal을 자주 사용할 계획이라면 자신의 취향에 맞게 다듬어 두는 것이 좋습니다. 사용자 정의 스타일시트를 활용하면 문서 외관을 더욱 폭넓고 세밀하게 제어할 수 있습니다.
텍스트 편집기로 새 CSS 파일을 만듭니다:
vim ~/.local/share/Zeal/custom.css
원하는 CSS 규칙을 입력합니다. 예를 들어:
code {
border-style: dashed;
border-width: 1px;
color: red;
}
“Edit → Preferences → Content → Custom CSS”에서 새로 만든 CSS 파일을 선택합니다. 설정을 저장하면 변경 사항이 즉시 반영됩니다. 아래 스크린샷은 위 CSS를 적용한 후의 Zeal 모습입니다.
맺음말
Zeal은 문서를 자주 찾아보는 프로그래머와 시스템 관리자에게 매우 유용한 도구입니다. 문서를 로컬에 저장하기 때문에 불필요한 시간 낭비를 줄이고 현재 작업에 더 집중할 수 있습니다. 또한 웹 문서와 달리 사용자 정의 스타일시트를 지원해 문서 외관까지 세밀하게 제어할 수 있다는 점도 큰 장점입니다.