Open Library là một danh mục thư viện mở, có thể được chỉnh sửa, hướng tới việc tạo ra một trang web cho mỗi cuốn sách từng được xuất bản.
Bạn đang muốn bắt đầu? Đây là hướng dẫn mà bạn đang tìm. Bạn có thể muốn tìm hiểu về Google Summer of Code (GSoC)? hoặc Hacktoberfest.
- Giới thiệu
- Cài đặt
- Tổ chức code
- Kiến trúc
- Hướng dẫn dành cho nhà phát triển
- Chạy tests
- Đóng góp
- Các API công khai
- Các câu hỏi thường gặp
Open Library là một nỗ lực bắt đầu từ năm 2006 nhằm tạo ra "một trang web cho mỗi cuốn sách từng được xuất bản". Nền tảng này cung cấp quyền truy cập vào nhiều sách thuộc phạm vi công cộng và sách không còn in nữa và có thể được đọc trực tuyến. Dưới đây là một chuyến tham quan nhanh về Open Library để giúp bạn làm quen với dịch vụ và những gì nó cung cấp (10 phút).
Chạy docker compose up và truy cập http://localhost:8080
Cần thêm chi tiết? Xem thử Docker instructions hoặc video hướng dẫn.
Ngoài ra, nếu bạn không muốn thiết lập Open Library trên máy tính cá nhân của mình, hãy thử sử dụng Gitpod! Điều này cho phép bạn làm việc với Open Library hoàn toàn trong trình duyệt mà không cần cài đặt bất kỳ thứ gì trên máy tính cá nhân.
Cảnh báo: Sự tích hợp này vẫn đang trong giai đoạn thử nghiệm..
Bạn cũng có thể tìm thêm thông tin về Tài liệu dành cho nhà phát triển của Open Library trong chính Open Library. Wiki.
- openlibrary/core - chức năng cốt lõi của openlibrary, được nhập và sử dụng bởi www
- openlibrary/plugins - các mô hình, các bộ điều khiển và trình trợ giúp hiển thị khác.
- openlibrary/views - các chế độ xem để hiển thị trang web
- openlibrary/templates - tất cả những templates được dùng trên trang web.
- openlibrary/macros - các macro tương tự như mẫu, nhưng có thể được gọi từ wikitext.
Open Library được phát triển dựa trên hệ thống wiki Infogami, hệ thống này lại được xây dựng trên nền tảng web.py, một framework web viết bằng Python, và framework cơ sở dữ liệu Infobase.
Sau khi bạn đã đọc tổng quan về các công nghệ Backend của Open Library, rất khuyến khích bạn đọc tài liệu hướng dẫn dành cho nhà phát triển, giải thích cách sử dụng Infogami (và cơ sở dữ liệu của nó, Infobase).
Nếu bạn muốn bắt đầu tìm hiểu thêm về mã nguồn cho Infogami, xem Infogami repo.
Các test cho Open Library có thể được chạy bằng docker. Xin vui lòng đọc trên Testing Document để biết thêm chi tiết.
docker compose run --rm home make test
Có nhiều cách để tình nguyện viên đóng góp cho dự án Open Library, từ phát triển và thiết kế đến quản lý dữ liệu và gắn kết cộng đồng. Đây là cách bạn có thể tham gia:
- Bắt đầu: Xem thử Contributing Guide để biết thêm về các hướng dẫn về việc thiết lập môi trường development, tìm vấn đề để giải quyết, và nộp những đóng góp của bạn.
- Những vấn đề tốt để bắt đầu (Good First Issues): Lướt Good First Issues để tìm những vấn đề phù hợp cho người mới bắt đầu (beginners).
- Đóng góp thiết kế: Chúng tôi hoan nghênh những nhà thiết kế giúp đỡ cải thiện trải nghiệm người dùng. Bạn có thể bắt đầu bằng cách xem thử design-related issues.
- Đóng góp về dữ liệu: Tìm hiểu cách đóng góp vào danh mục của chúng tôi và cải thiện dữ liệu sách trên Open Library!. Thăm trang volunteer page để biết thêm thông tin.
- Tham gia Community Calls: Open Library tổ chức các cuộc gọi cộng đồng và thiết kế hàng tuần. Xemcommunity call schedule để biết về giờ giấc và chi tiết.
- Hỏi câu hỏi: Nếu bạn có câu hỏi, tham gia gitter chat hoặc yêu cầu một lời mời đến với trang Slack qua volunteers page.
Để biết thêm thông tin chi tiết, xin mời xem qua Contributing Guide.
Tất cả mã nguồn được xuất bản ở đây đều được cung cấp theo các điều khoản của giấy phép GNU Affero General Public License, version 3.