GNOME 앱을 만들다가 GTK나 다른 라이브러리의 항목을 다시 찾으려면 Biblioteca를 사용할 수 있습니다. GNOME 공식 앱 카탈로그는 이 프로그램을 개발 문서를 오프라인으로 읽는 도구로 소개하며, 설치 경로로 Flathub를 안내합니다.
Linux용 Biblioteca는 Flathub에서 무료로 받을 수 있습니다. 설치할 환경과 파일을 확인한 뒤, 문서 목록에서 GTK 항목을 열고 필요한 페이지를 검색하는 흐름을 살펴보겠습니다.
Biblioteca로 무엇을 볼 수 있나요?
Biblioteca는 GNOME 개발 문서를 탐색하는 독립 앱입니다. GNOME 공식 설명에는 오프라인 문서, 웹 탐색, 탭, 다크 모드, 퍼지 검색이 기능으로 나옵니다. 개발 중 API 이름이 떠오르지 않거나 특정 라이브러리의 설명을 확인할 때 문서 목록과 검색을 함께 사용할 수 있습니다.
공식 실행 화면 왼쪽에는 Adw-1, Gdk-4.0, Gtk-4.0 같은 문서 묶음과 Search Biblioteca 입력란이 보입니다. Gtk-4.0을 선택한 화면의 오른쪽에는 해당 네임스페이스 설명과 Build, Dependencies, Related libraries 항목이 있습니다. 화면 안의 4.12.3은 예시로 열린 GTK 문서의 버전이며 Biblioteca 앱 버전은 아닙니다.
GNOME 카탈로그는 Biblioteca 최신 릴리스를 1.8로 표시합니다. Flathub 목록은 Free, Linux x86_64·aarch64를 표시하고, 프로젝트 README는 Flathub의 Biblioteca 빌드만 지원한다고 명시합니다. 다른 이름의 패키지나 임의 재배포 파일을 고를 이유가 없습니다.
공식 화면에서 문서 목록과 본문 확인
GNOME 공식 화면 한 장에는 왼쪽 문서 목록에서 Gtk-4.0을 펼친 상태와 오른쪽 네임스페이스 문서가 보입니다. 오른쪽의 4.12.3은 GTK 문서 정보이며 Biblioteca 1.8의 버전 표시는 아닙니다.
| 프로그램 | Biblioteca |
| 유지관리자 | Akshay Warrier·Sonny Piers |
| 공식 표시 버전 | 1.8 |
| 지원 운영체제 | Linux |
| 공식 앱 ID | app.drey.Biblioteca |
| 배포 경로 | Flathub stable Flatpak |
| 주요 용도 | GNOME 개발 문서 오프라인 탐색 |
Linux에 Biblioteca 설치하기
GNOME 공식 Biblioteca 페이지에서 Get the app을 선택하면 Flathub 항목으로 이동합니다. Flathub에서 이름 Biblioteca, 앱 ID app.drey.Biblioteca, Free 표시와 Linux 지원 아키텍처를 확인하세요. 프로젝트는 이 Flathub 빌드만 지원한다고 안내합니다.
Linux에 Flatpak과 Flathub 저장소가 준비돼 있다면 소프트웨어 센터에서 Biblioteca를 찾아 설치할 수 있습니다. stable .flatpakref를 받아 소프트웨어 센터에서 여는 방법도 있습니다. 이 파일은 앱 전체를 담은 오프라인 설치 파일이 아니라 Flathub 앱을 가리키는 참조 파일입니다.
설치 화면에는 앱 ID와 실제 설치 버전, 요청 권한이 나타납니다. 확인 후 설치를 마치고 앱 목록에서 Biblioteca를 열어 왼쪽 문서 목록과 검색 입력란이 보이는지 살펴보세요. 앱을 처음 설치하는 단계에서는 문서를 읽기 전에도 네트워크 연결이 필요할 수 있습니다. 문서 목록이 표시되면 필요한 라이브러리 항목을 한 번 열어 실제 내용이 보이는지 확인해 두세요.
- Linux의 Flatpak·Flathub 설정을 확인합니다.
- Biblioteca와 app.drey.Biblioteca ID를 대조해 설치합니다.
- 앱을 열어 왼쪽 문서 목록과 검색 입력란이 나타나는지 확인합니다.
GTK 문서 한 페이지 찾아 읽기
Biblioteca를 열고 왼쪽 목록에서 Gtk-4.0을 찾으세요. 공식 화면에서는 Gtk-4.0을 펼쳐 Additional Documentation, Aliases, Classes 같은 하위 항목을 볼 수 있습니다. 문서 묶음을 선택하면 오른쪽에 해당 설명이 나타납니다.
예를 들어 GTK의 클래스 정보를 확인하려면 Gtk-4.0 아래 Classes를 펼쳐 찾는 항목을 선택합니다. 오른쪽 문서에서 설명, 관련 항목, 링크를 읽고 필요한 이름이나 사용 조건을 확인하세요. 왼쪽 목록에서 다른 문서를 선택해도 되고, 뒤로 가기 버튼으로 방금 읽은 페이지로 돌아올 수도 있습니다.
목록이 길면 왼쪽 위 Search Biblioteca에서 이름을 검색하세요. 프로젝트의 단축키 목록에는 Ctrl+K가 전체 검색 입력란에 포커스를 주고 Ctrl+F가 현재 페이지 안에서 문구를 찾는 기능으로 적혀 있습니다. 문서 이름을 찾는 검색과 이미 열린 긴 페이지의 문장을 찾는 검색을 구분하면 빠릅니다.
찾은 내용을 비교하려면 Ctrl+T로 새 탭을 열 수 있습니다. 탭을 닫을 때는 Ctrl+W를 사용합니다. 다른 라이브러리를 살펴본 뒤 원래 페이지로 돌아가야 한다면 탭을 닫거나 뒤로 가기를 이용하세요. 읽으려는 문서가 현재 목록에 실제로 있는지 먼저 확인하는 편이 좋습니다.
- 왼쪽에서 Gtk-4.0을 펼치고 필요한 문서 항목을 선택합니다.
- 오른쪽 설명에서 항목 이름과 관련 정보를 확인합니다.
- 다른 문서를 찾을 때는 Ctrl+K, 현재 페이지의 문구는 Ctrl+F로 찾습니다.
오프라인 문서와 웹 페이지 구분하기
Biblioteca의 핵심은 포함된 GNOME 문서를 네트워크가 없어도 열어 볼 수 있다는 점입니다. 프로젝트 설명에는 별도로 웹 탐색도 포함됩니다. 이미 앱 안에 들어 있는 문서를 보는 일과 외부 웹 주소를 여는 일은 네트워크 조건이 다릅니다.
인터넷 연결이 없는 곳에서 쓰려면 미리 앱을 설치하고 필요한 문서가 목록에 있는지 확인하세요. 공식 화면처럼 왼쪽에 보이는 라이브러리를 선택해 오른쪽 내용이 열리는지 살펴보면 준비가 됐는지 판단하기 쉽습니다. 외부 링크나 웹 주소의 내용까지 오프라인으로 보장되는 것은 아닙니다.
프로젝트 단축키 목록은 Ctrl+L을 URL 입력란으로 이동하는 기능으로 표시합니다. 주소를 직접 열어야 한다면 그 입력란을 사용할 수 있지만, 네트워크가 없는 상태라면 외부 사이트의 새 내용이 열리지 않을 수 있습니다. 문서 자체가 목록에 있다면 먼저 그 항목에서 필요한 정보를 찾으세요.
탭과 사이드바로 여러 문서 비교하기
라이브러리의 설명과 관련 항목을 함께 볼 때는 탭을 나눠 두는 편이 편합니다. 공식 단축키 목록에는 Ctrl+T 새 탭, Ctrl+W 탭 닫기, Ctrl+Tab 다음 탭, Ctrl+Page Up 이전 탭이 있습니다. 탭의 내용이 바뀌었다고 문서가 삭제되는 것은 아니므로 필요한 페이지만 남겨 두세요.
화면 폭이 좁아 왼쪽 문서 목록이 보이지 않으면 F9로 사이드바를 표시할 수 있습니다. 프로젝트의 창 정의는 좁은 폭에서 목록을 접고 사이드바 버튼을 표시하도록 구성돼 있습니다. 문서가 사라진 것처럼 보일 때는 현재 탭과 사이드바 상태를 먼저 확인하세요.
여러 페이지를 오가다 어느 문서를 읽는지 헷갈린다면 탭 제목과 오른쪽 문서 상단의 네임스페이스 이름을 읽어 보세요. 공식 예시에서는 상단에 Gtk-4.0이라고 표시됩니다. API 이름을 옮겨 적기 전에는 해당 문서의 버전과 라이브러리 이름을 함께 확인하는 것이 좋습니다.
긴 문서를 읽다가 이전에 본 설명으로 돌아가려면 Alt+왼쪽 화살표로 뒤로 가고 Alt+오른쪽 화살표로 앞으로 이동할 수 있습니다. 프로젝트 단축키 목록에 있는 기능입니다. 문서 안에서 같은 단어가 여러 번 나오면 Ctrl+F로 먼저 찾고 Ctrl+G로 다음 일치 항목, Ctrl+Shift+G로 이전 일치 항목을 확인하세요. 목차를 훑는 것보다 같은 용어가 사용된 위치를 빠르게 비교할 수 있습니다.
코드 예시나 표가 작게 보여 읽기 어렵다면 Ctrl+더하기로 확대하고 Ctrl+빼기로 축소할 수 있습니다. Ctrl+0은 확대 비율을 초기화합니다. 화면 확대는 문서의 내용이나 실제 라이브러리 버전을 바꾸지 않으므로, 글자 크기를 조정한 다음에도 상단의 문서 이름을 기준으로 읽고 있는 자료를 확인하세요. 탭마다 다른 항목을 열어 두었다면 현재 선택된 탭을 먼저 확인한 뒤 단축키를 사용합니다.
문서를 찾지 못하거나 설치가 진행되지 않을 때
원하는 이름이 보이지 않으면 Ctrl+K로 전체 검색 입력란에 포커스를 두고 정확한 라이브러리명이나 항목명을 입력해 보세요. 이미 연 문서 안의 문구라면 Ctrl+F가 맞습니다. 검색 대상이 다른데 같은 칸만 쓰면 결과가 없는 것처럼 보일 수 있습니다.
왼쪽 목록 자체가 안 보이면 F9로 사이드바를 열거나 창의 사이드바 버튼을 확인하세요. 공식 화면에는 왼쪽 목록과 오른쪽 문서가 나뉘어 있으며, 좁은 창에서는 목록이 접히도록 설계돼 있습니다. 읽는 내용만 남은 화면이라면 이 점부터 확인하면 됩니다.
.flatpakref를 열 수 없다면 Linux에 Flatpak을 지원하는 소프트웨어 센터와 Flathub 저장소가 설정됐는지 살펴보세요. 참조 파일을 저장한 단계와 실제 앱 설치는 다릅니다. 설치가 끝났는데 앱 목록에 없다면 소프트웨어 센터에서 app.drey.Biblioteca의 설치 완료 여부를 확인합니다.
자주 묻는 질문
Biblioteca는 무료인가요?
네. Flathub의 Biblioteca 항목에 Free로 표시됩니다.
Windows용 설치 파일도 있나요?
여기에서 확인한 공식 Flathub 배포의 지원 환경은 Linux x86_64·aarch64입니다. Windows 파일로 안내하지 않습니다.
인터넷이 끊겨도 문서를 볼 수 있나요?
GNOME 공식 설명은 오프라인 문서를 기능으로 명시합니다. 외부 웹 페이지의 새 내용은 별도 네트워크가 필요할 수 있습니다.
문서 전체 검색과 현재 페이지 검색은 어떻게 다르나요?
Ctrl+K는 전체 검색 입력란에 포커스를 주고 Ctrl+F는 지금 열린 페이지 안의 문구를 찾습니다.
화면에 보이는 4.12.3이 Biblioteca 버전인가요?
아니요. 공식 화면에서 열린 GTK 문서의 버전입니다. GNOME 카탈로그의 Biblioteca 최신 표시 버전은 1.8입니다.
필요한 GNOME 문서를 열고 항목을 찾아보세요
Biblioteca는 Linux에서 GNOME 개발 문서를 찾아 읽는 무료 앱입니다. GNOME 공식 카탈로그가 안내하는 Flathub 배포에서 앱 ID와 지원 환경을 확인하고 설치한 뒤, 왼쪽 문서 목록에서 필요한 라이브러리를 선택하세요.
목록에서 원하는 항목을 펼쳐 오른쪽 내용을 읽고, 이름을 빠르게 찾을 때는 전체 검색을 사용하면 됩니다. 오프라인에서 쓸 계획이라면 미리 설치하고 필요한 문서가 실제 목록에 있는지 확인해 두세요.
공식 자료와 확인일
Biblioteca 공식 GNOME 앱 설명·화면·버전 · Biblioteca Flathub 무료 배포·지원 아키텍처 · Biblioteca 공식 프로젝트 README · Biblioteca 공식 단축키 정의 · Biblioteca 공식 창·사이드바 정의 · Flatpak 공식 배포판별 설정 | 2026-10-29T20:26:00+00:00
