Computer >> Hướng Dẫn Máy Tính >  >> Hệ Thống >> Linux

Cách xem tài liệu code offline với Zeal

Nếu bạn đã từng viết code, bạn chắc chắn đồng ý rằng lập trình liên quan đến việc đọc tài liệu, rất nhiều tài liệu. Trong nhiều trường hợp, thời gian dành cho việc đọc tài liệu và code khác vượt quá thời gian viết code thực tế. Và vì tài liệu đó thường được truy cập trên Web, một phần lớn thời gian bị lãng phí cho việc tìm kiếm thông tin bạn cần và chờ đợi tải. Những độ trễ nhỏ này có thể令人沮丧, đặc biệt với kết nối chậm, và có thể nhanh chóng tích tụ thành nhiều phút, thậm chí giờ làm việc bị mất. Ngoài ra, cần kết nối Internet liên tục, mà không phải lúc nào cũng có sẵn, để truy cập thông tin đó.

May mắn thay, bạn có thể dùng Zeal, một trình duyệt tài liệu offline, để lưu trữ tài liệu ngôn ngữ lập trình và phần mềm trên máy tính và truy cập nó nhanh chóng và hiệu quả. Zeal sử dụng các bộ tài liệu (docsets) do Dash cung cấp. Chúng bao gồm tài liệu cho nhiều ngôn ngữ lập trình và scripting cũng như thư viện, cũng như nhiều phần mềm khác nhau như Docker, Nginx, WordPress và ElasticSearch, chỉ để nêu vài ví dụ.

Dưới đây là cách cài đặt, sử dụng và tùy chỉnh Zeal trên Linux.

Cài đặt Zeal

Zeal có sẵn trong kho phần mềm của nhiều bản phân phối Linux, vì vậy bạn nên cài đặt nó bằng trình quản lý gói gốc nếu có thể.

Trên Ubuntu, Linux Mint và Debian:

sudo apt install zeal

Trên Arch Linux:

sudo pacman -S zeal

Trên Gentoo:

sudo emerge app-doc/zeal

Trên Fedora:

sudo dnf install zeal

Sử dụng Zeal

Bạn có thể khởi chạy Zeal từ menu/launcher ứng dụng hoặc từ terminal dòng lệnh bằng cách gõ zeal.

Cách xem tài liệu code offline với Zeal

Zeal không bao gồm bất kỳ tài liệu nào mặc định. Để xem các docset có sẵn, vào "Tools -> Docsets" và mở tab "Available".

Cách xem tài liệu code offline với Zeal

Chọn docset bạn muốn lưu trữ và nhấp "Download". Sau khi tải xong, các bộ tài liệu được hiển thị trong khung trên bên trái trong cấu trúc phân cấp có thể điều hướng. Khi áp dụng, khung dưới bên trái hiển thị các phím tắt đến các yếu tố của trang tài liệu hiện tại.

Cách xem tài liệu code offline với Zeal

Bạn có thể tìm kiếm tất cả docset bằng cách nhập truy vấn hoặc một docset cụ thể với cú pháp docset:truy vấn. Ví dụ, để tìm hàm re.match của Python, bạn sẽ nhập python:re.match.

Lưu ý: với cú pháp tìm kiếm phức hợp (tức là docset:truy vấn), phần docset phân biệt chữ hoa/thường, và phần truy vấn không phân biệt chữ hoa/thường.

Cách xem tài liệu code offline với Zeal

Tùy chỉnh Zeal

Font

Bạn có thể cấu hình giao diện Zeal theo ý thích với font và cỡ font.

Để làm vậy, vào "Edit -> Preferences -> Content" rồi chọn họ font mặc định và font cụ thể cho từng họ font.

Cách xem tài liệu code offline với Zeal

Chế độ tối

Zeal cũng cung cấp chế độ tối (trong "Edit -> Preferences -> Content"), tuy nhiên nó chỉ áp dụng cho nội dung tài liệu chứ không phải giao diện đồ họa xung quanh như bạn có thể thấy trong ảnh chụp màn hình sau.

Cách xem tài liệu code offline với Zeal

CSS do người dùng định nghĩa

Nếu bạn định sử dụng Zeal thường xuyên, thì đáng để dành thời gian tinh chỉnh nó theo sở thích riêng. Bạn có thể dùng stylesheet tùy chỉnh để kiểm soát tốt hơn và chi tiết hơn giao diện tài liệu.

Tạo file CSS mới bằng trình soạn thảo văn bản:

vim ~/.local/share/Zeal/custom.css

Nhập các quy tắc CSS mong muốn, ví dụ:

code { border-style: dashed; border-width: 1px; color: red; }

Vào "Edit -> Preferences -> Content -> Custom CSS" file để chọn file CSS mới tạo. Sau khi lưu cài đặt, thay đổi sẽ hiển thị ngay lập tức. Ảnh chụp màn hình sau hiển thị Zeal sau khi áp dụng CSS trên.

Cách xem tài liệu code offline với Zeal

Kết luận

Zeal là công cụ tuyệt vời cho lập trình viên và quản trị viên hệ thống thường xuyên truy cập tài liệu. Vì nó lưu trữ tài liệu cục bộ, nó có thể tiết kiệm thời gian và cho phép bạn tập trung tốt hơn vào công việc. Ngoài ra, khác với tài liệu Web, nó hỗ trợ stylesheet do người dùng định nghĩa để kiểm soát mहीन giao diện tài liệu.