GitBook, viết tài liệu cho các dự án của bạn từ Ubuntu

Trong phần tiếp theo, chúng ta sẽ xem xét về GitBook. Đây là một ứng dụng GUI đa nền tảng, có chức năng chính là mang quy trình làm việc GitBook đến màn hình của chúng tôi trong Ubuntu. Nhìn vào giao diện của nó, bạn có thể thấy rằng nó được thiết kế tốt để chỉnh sửa văn bản và làm việc với bản xem trước trực tiếp của dự án.

GitBook được tạo ra vào giữa năm 2014. Nó được sinh ra nhằm mục đích tạo ra một Giải pháp hiện đại và đơn giản để tạo tài liệu, viết kỹ thuật số và xuất bản nội dung. Triết lý của dự án là đơn giản nhưng không làm mất đi điểm sang trọng. Những phiền nhiễu và lo lắng cho người sáng tạo nội dung bị loại bỏ, vì vậy họ có thể viết tự do.

Hàng trăm nghìn người dùng sử dụng GitBook để viết tài liệu (thư viện, API, công cụ, v.v.) hoặc cơ sở kiến ​​thức (chẳng hạn như Câu hỏi thường gặp). Mọi người cũng sử dụng chương trình này để xuất bản sách kỹ thuật, tài liệu giảng dạy và nhiều thứ khác.

Các tính năng chung của GitBook

Đây là một nền tảng trực tuyến để viết và lưu trữ tài liệu. Nó cung cấp một định dạng sách mã nguồn mở và các công cụ.

Chương trình này sẽ cung cấp cho chúng tôi điều khiển Git tích hợp. Chúng tôi cũng sẽ có sẵn bảng mục lục, bảng cây tệp và các nút định dạng nhanh để tạo điều kiện thuận lợi cho việc cấu trúc tài liệu của chúng tôi.

Ngoài ra, GitBook cung cấp cho chúng tôi khả năng hiển thị nội dung của chúng tôi dưới dạng một trang web (có thể tùy chỉnh và có thể mở rộng) hoặc giống như một cuốn sách điện tử (PDF, ePub hoặc Mobi).

GitBook.com là nền tảng trực tuyến để tạo và lưu trữ sách được tạo ở định dạng ứng dụng. Cung cấp tính năng lưu trữ, cộng tác và trình chỉnh sửa dễ sử dụng. Chương trình này cho phép chúng tôi sử dụng nhóm của mình để tạo sách địa phương, trên GitHub hoặc trên nền tảng để lưu trữ chúng.

Để bắt đầu sử dụng chương trình này, người sáng tạo cung cấp cho người dùng khả năng tư vấn hướng dẫn cài đặt trong tài liệu. Nếu bất kỳ người dùng nào muốn hoặc cần, họ có thể tham khảo mã nguồn của ứng dụng này trên trang của GitHub của ứng dụng này.

Cài đặt GitBook

Nếu bạn muốn tải xuống gói chương trình, bạn có thể tải xuống từ Trang web chính thức. Ở đó chúng ta có thể tải xuống bằng trình duyệt. Chúng tôi cũng có thể lấy gói bằng cách sử dụng lệnh wget mở một thiết bị đầu cuối (Ctrl + Alt + T) và nhập vào đó như sau:

wget http://downloads.editor.gitbook.com/download/linux-64-bit

Sau khi tải xuống gói, chúng tôi có thể cài đặt nó bằng cách thực hiện lệnh sau trong cùng một thiết bị đầu cuối:

dpkg -i linux-64-bit

Sau khi kết thúc quá trình cài đặt, bạn sẽ có thể sử dụng trường tìm kiếm Ubuntu Dash và nhập gitbook. Biểu tượng ứng dụng sẽ được hiển thị trên màn hình.

Khi chúng tôi đã đăng nhập, với Tài khoản GitBook hoặc với tài khoản mạng xã hội của chúng tôi, bây giờ chúng tôi có thể tạo một Sách mới. Chúng ta có thể thực hiện việc này bằng cách nhấp vào tùy chọn Sách mới có sẵn trên màn hình.

Bây giờ bạn có thể bắt đầu viết Sách của riêng bạn trong Trình chỉnh sửa. Đừng quên chọn trong trình chỉnh sửa kho lưu trữ mà chúng tôi muốn tải lên các thay đổi.

Làm thế nào để đồng bộ hóa Gitbook với Github?

Một điều rất thú vị về chương trình này là nó cung cấp cho chúng tôi khả năng làm việc với GitHub. Tôi đã đọc rằng đối với một số người, đây là một vấn đề đối với đồng bộ hóa kho lưu trữ Github với nền tảng GitBook.

Điều đầu tiên chúng ta sẽ phải làm là tạo một kho lưu trữ công khai trên Github. Chúng tôi cũng sẽ cần tạo sách trên web Gitbook. Nó được khuyến khích, mặc dù tôi nghĩ rằng không nhất thiết là cả hai kho có cùng tên.

Khi sách được tạo, điều quan trọng là phải truy cập vào Công cụ thiết lập sách và chuyển đến phần Github. Khi vào bên trong, bạn sẽ tiếp tục chọn tích hợp với kho lưu trữ GitHub mà bạn muốn đồng bộ hóa. Khi kho lưu trữ đã được chọn, chúng tôi sẽ tiếp tục chấp nhận và lưu toàn bộ quá trình.

Khi thao tác này được thực hiện, nếu mọi thứ diễn ra tốt đẹp, một thông báo màu xanh lá cây sẽ xuất hiện cho biết rằng tích hợp với Github nó đang hoạt động.

Để kiểm tra xem mọi thứ đều hoạt động. Bây giờ chúng ta sẽ bắt đầu phiên với ứng dụng khách GitBook mà chúng ta đã cài đặt trong Ubuntu của mình. Khi nó bắt đầu, chúng tôi có thể thực hiện những thay đổi mà chúng tôi cho là thích hợp. Bây giờ chúng tôi có thể tải chúng lên Kho lưu trữ GitHub.