Cách cài đặt và thiết lập Manifold Scholar
Manifold là một ứng dụng web open-souce cho phép bạn xuất bản các ấn bản dựa trên web của sách và các phương tiện dựa trên văn bản khác để user có thể tự do đọc và chú thích các văn bản này. Đặc biệt thích hợp để sử dụng với tài liệu truy cập mở (OA) và tài nguyên giáo dục mở (OER), Manifold có thể được kết hợp vào lớp học, chương trình đào tạo mã hóa, hội thảo, thư viện và các địa điểm khác mà bạn có thể cần trao đổi kiến thức thông qua việc đọc cộng tác.Được tài trợ bởi Quỹ Mellon, Manifold ban đầu được thực hiện với mục đích chuyên khảo học thuật, nhưng nhiều hình thức xuất bản (tạp chí, sách nhỏ, tuyển tập) có thể được thu thập, sắp xếp, đọc và chú thích trên nền tảng. Để xem ví dụ về sách Manifold, bạn có thể xem version Manifold của ebook miễn phí Cách viết mã bằng Python 3 .
Trong hướng dẫn này, ta sẽ cài đặt Manifold trên server và thêm văn bản vào cài đặt của bạn.
Yêu cầu
Để bắt đầu, bạn nên có những điều sau:
- Server Ubuntu 18.04 với ít nhất 1 CPU và tốt nhất là 8 GB RAM (tối thiểu 6 GB).
- User không phải root có quyền sudo mà bạn có thể đạt được theo hướng dẫn cài đặt server ban đầu Ubuntu 18.04 .
Để Manifold chạy trên trang web có URL, bạn phải cài đặt một domain đủ điều kiện. Để được hướng dẫn về cách cài đặt này, bạn nên đọc tài liệu từ nhà cung cấp dịch vụ lưu trữ của bạn . Nếu bạn đang sử dụng DigitalOcean, bạn có thể tìm thấy hướng dẫn trong hướng dẫn của ta về Cách trỏ đến server tên DigitalOcean từ các công ty đăng ký domain phổ biến .
Lưu ý : Các nhà phát triển của Manifold khuyên bạn không nên cố gắng cài đặt Manifold trong môi trường lưu trữ được chia sẻ vì lý do bảo mật và ổn định. Manifold bao gồm một số dịch vụ riêng biệt, mỗi dịch vụ yêu cầu RAM hoạt động chính xác. Trên một máy ảo nhỏ có RAM dưới 6GB, bạn có thể cần kích hoạt bộ nhớ swap hoặc có nguy cơ tiêu tốn tất cả bộ nhớ có sẵn.
Nếu hiện tại bạn chưa cài đặt domain của bạn , bạn có thể đặt tên máy theo cách thủ công trong /etc/manifold/manifold.rb và cấu hình lại ứng dụng. Cấu hình lại được thảo luận dưới đây.
Với những yêu cầu này, bạn có thể bắt đầu hướng dẫn.
Bước 1 - Download và cài đặt Gói Manifold
Ta sẽ download Manifold cho Ubuntu 18.04.
Đầu tiên, chuyển vào folder tạm thời để download gói, vì gói là thứ ta có thể xóa sau này.
- cd /tmp
Tiếp theo, sử dụng lệnh curl với cờ -O để ghi kết quả vào một file local . Thao tác này sẽ tải gói xuống server của ta .
- curl -O https://storage.googleapis.com/manifold-dist/ubuntu18/manifold_2.0.0~rc.1-1_amd64.deb
Tiếp theo, ta sẽ cài đặt gói.
- sudo dpkg -i manifold_2.0.0~rc.1-1_amd64.deb
Khi bạn chạy lệnh này, bạn sẽ nhận được kết quả bao gồm các dòng sau:
Output... Manifold Scholarship manifold: Thank you for installing Manifold! ... Khi bạn đã nhận được những dòng đó, bạn có thể tiếp tục bước tiếp theo.
Bước 2 - Cập nhật firewall
Nếu bạn đã làm theo cài đặt server ban đầu, bạn nên có một firewall ufw tại chỗ trên server của bạn . Nếu chưa có firewall , bạn nên triển khai firewall theo bước Cài đặt Tường lửa Cơ bản của hướng dẫn cài đặt server ban đầu.
Để cho phép lưu lượng truy cập qua http trên web, bạn nên mở cổng 80.
- sudo ufw allow 80
Bạn sẽ nhận được kết quả rằng luật này đã được thêm vào. Bạn có thể kiểm tra trạng thái firewall của bạn bằng lệnh sudo ufw status để xem các luật hiện tại trên server của bạn.
Bước 3 - Cấu hình Manifold
Nếu bạn đã cài đặt một domain đủ điều kiện trên server này, bạn có thể không cần phải cấu hình thêm. Điều này sẽ đúng nếu bạn nhận được kết quả sau phù hợp với domain của bạn:
Output... manifold: Manifold should be reachable at http://your-manifold-url ... Tuy nhiên, nếu hiện tại bạn đang sử dụng địa chỉ IP của server hoặc nếu kết quả ở trên không trùng với URL của bạn, bạn có thể cấu hình Manifold để trỏ đến đúng nơi.
Một file đã được tạo tại /etc/manifold/manifold.rb mà bạn sẽ sử dụng để cấu hình và quản lý các dịch vụ khác nhau bao gồm Manifold.
Mở file này trong editor bạn muốn ( ta sẽ sử dụng nano).
- sudo nano /etc/manifold/manifold.rb
Trong file này, hãy tìm cài đặt external_url ở gần đầu file . Đặt điều này thành địa chỉ IP của server của bạn hoặc thành domain của cài đặt Manifold của bạn.
... ## Manifold URL ##! URL on which Manifold will be reachable. ##! For more details on configuring external_url see: external_url 'http://your-IP-or-your-URL' Nếu trang web là example.com , dòng của bạn sẽ giống như sau:
external_url 'http://example.com' Nếu IP của bạn là 192.0.2.0 , dòng của bạn sẽ như thế này:
external_url 'http://192.0.2.0' Bây giờ, hãy lưu và thoát khỏi file . Thực hiện việc này bằng cách nhấn CTRL + X , rồi nhấn y để xác nhận bạn muốn lưu nó, sau đó ENTER .
Đến đây, bạn có thể cấu hình lại Manifold bằng lệnh sau.
- sudo /usr/local/bin/manifold-ctl reconfigure
Ứng dụng Manifold bây giờ sẽ áp dụng các thay đổi được thực hiện trong file này để tạo lại các file cấu hình và cài đặt mới. Quá trình này sẽ hoàn tất khi bạn nhận được kết quả tương tự như sau:
OutputChef Client finished, 262/347 resources updated in 51 seconds manifold Reconfigured! Đến đây bạn có thể truy cập URL hoặc địa chỉ IP của server của bạn. Bạn sẽ thấy một trang chủ Manifold trống.
Với ứng dụng Manifold đang được cung cấp, bạn có thể tiếp tục bước tiếp theo.
Bước 4 - Truy cập chương trình backend
Tất cả nội dung được lưu trữ trong Manifold (bao gồm văn bản, dự án, tác giả, tài nguyên và user ) được quản lý thông qua giao diện web backend của Manifold thông qua đường dẫn /backend .
Để truy cập chương trình backend , bạn cần tạo admin-user trên server của bạn . Bạn sẽ gọi một lệnh để tạo admin-user này thông qua file thực thi file manifold-api .
Để sử dụng lệnh này, bạn cần phải nhập các chi tiết của riêng mình, bao gồm địa chỉ email, password , tên và họ của bạn, theo định dạng sau:
- sudo manifold-api manifold:user:create:admin["your_email@domain.com","password","first_name","lastName"]
Thay thế thông tin của bạn trong lệnh trên, như trong ví dụ sau:
- sudo manifold-api manifold:user:create:admin["virginia@woolf.com","l1ghth0us3","Virginia","Woolf"]
Khi bạn chạy lệnh, bạn sẽ nhận được kết quả tương tự như sau:
OutputINFO: A User has been created. Its ID is 4a38dbb4-212b-4387-ad32-5e014459cd11 Khi bạn đã tạo xong user này, hãy quay lại trình duyệt của bạn và nhấp vào biểu tượng hình đại diện ở góc trên cùng bên phải của Manifold để đăng nhập.
Sau khi nhập thông tin xác thực và đăng nhập thành công, bạn sẽ thấy nút NHẬP CHẾ ĐỘ QUẢN TRỊ trong tiêu đề.
Nhấp vào nút này để truy cập chương trình backend của Manifold.
Bước 5 - Tạo dự án
Từ chương trình backend , bạn sẽ được đưa đến nơi các dự án tương lai của bạn sẽ hoạt động.
Để tạo một dự án mới, hãy nhấp vào Projects trên thanh menu trên cùng, sau đó nhấp vào nút Add a New Project . Bạn sẽ được yêu cầu nhập tiêu đề, phụ đề tùy chọn và mô tả. Với mục đích demo , bạn có thể tải lên ebook Cách viết mã trong Python 3 miễn phí, vì vậy bạn có thể nhập How To Code in Python 3 làm tiêu đề.
Với thông tin đã nhập, bạn có thể lưu dự án và nhấn Tiếp tục .
Khi bạn tạo một dự án mới, nó sẽ tự động được lưu ở chế độ nháp . Các dự án là bản nháp chỉ hiển thị cho admin-user đã đăng nhập. Sử dụng các tab ở bên trái của chế độ xem chi tiết về dự án của bạn, bạn có thể thêm hình thu nhỏ, tải lên hình ảnh chính hoặc biểu ngữ cho trang dự án hiển thị công khai, như cũng như thêm metadata và tài nguyên bổ sung.
Vì Manifold cung cấp cho bạn một repository văn bản, nên điều đầu tiên bạn có thể cần làm là thêm văn bản. Để nhập file văn bản vào dự án của bạn, hãy nhấp vào tab văn bản .
Bạn có thể tải file EPUB, Markdown và HTML hoặc Google Tài liệu lên Manifold. Nếu sắp làm việc với Google Documents, bạn cần thực hiện một số cấu hình bổ sung . Với mục đích demo , ta sẽ tải EPUB Cách viết mã bằng Python 3 lên bản cài đặt Manifold của ta . Bạn có thể liên kết trực tiếp tới EPUB của Ebook bằng liên kết này:
https://assets.digitalocean.com/books/python/how-to-code-in-python.epub Để đưa văn bản vào, hãy nhấp vào nút Thêm văn bản mới để bắt đầu quá trình nhập.
Trong phần trình diễn của ta , ta sẽ sử dụng liên kết ở trên, nhưng bạn có thể tải lên hoặc kéo file lên biểu tượng cloud để tải file lên từ ổ cứng local của bạn . Khi bạn đã sắp xếp file , bạn có thể nhấn Tiếp tục . Ứng dụng sẽ kết nối với websocket Manifold và bây giờ bạn có thể nhấp vào Ingest để bắt đầu quá trình tải lên.
Tùy thuộc vào môi trường lưu trữ và kích thước của file bạn đang tải lên, có thể mất vài phút để Manifold nhập văn bản. Bạn sẽ thấy log hiển thị kết quả trạng thái của quá trình nhập. Khi quá trình này hoàn tất, bạn sẽ thấy nút Hoàn thành ở cuối hộp thoại.
Khi bạn nhấn nút Hoàn thành , bạn sẽ được quay lại dự án của bạn .
Bạn sẽ thấy văn bản của bạn được thêm vào dưới KHÔNG ĐƯỢC PHÂN LOẠI . Sử dụng mũi tên lên để chuyển file sang trạng thái ĐÃ XUẤT BẢN .
Nhấp vào liên kết XEM TRƯỚC bên dưới tiêu đề dự án bên cạnh biểu tượng con mắt để xem dự án hiện tại của bạn. Ở phía xem trước, bạn sẽ thấy nút BẮT ĐẦU ĐỌC bên dưới tiêu đề.
Khi bạn nhấn nút này, văn bản sẽ mở trong trình đọc Manifold.
Khi thấy ổn với dự án của bạn , từ tab Chung của giao diện quản trị, bạn có thể chuyển đổi chế độ hiển thị để tắt Chế độ nháp .
Bây giờ, dự án sẽ có sẵn trên trang chính của bạn.
Đến đây, bạn có thể tiếp tục làm việc với dự án của bạn để thêm metadata , hình ảnh, v.v.
Lưu ý nếu bạn có domain được liên kết với trang Manifold của bạn và đang mong đợi user đóng góp file , thì cách tốt nhất là bảo mật trang web và truy cập nó thông qua giao thức HTTPS. Để tìm hiểu về cách bảo mật Manifold với tổ chức phát hành certificate miễn phí Let's Encrypt, hãy đọc hướng dẫn của ta , " Giới thiệu về Let's Encrypt "
Kết luận
Xin chúc mừng, bạn đã hoàn thành cài đặt Manifold và tạo dự án đầu tiên của bạn ! Đến đây bạn đã cài đặt Manifold trên server Ubuntu 18.04 của bạn . Nếu tất cả diễn ra theo đúng kế hoạch, bạn đang trên đường xây dựng các dự án của riêng mình và xuất bản các văn bản của bạn trên Manifold.
Để tìm hiểu thêm về dự án Manifold, sự phát triển của nó và các trường đại học sử dụng nó, hãy xem các liên kết sau:
- Kho lưu trữ GitHub của Manifold
- Theo dõi Manifold trên Twitter
- Đọc Blog về Xây dựng Manifold Development
- Tham gia kênh Manifold Community Slack
- Truy cập trang web Manifold để biết tài liệu chính thức
Nếu bạn gặp sự cố nào khi sử dụng phần mềm này, group Manifold hoan nghênh phản hồi; bạn có thể liên hệ với họ bằng cách tham khảo phần nhận hỗ trợ trong tài liệu của họ.
Các tin liên quan
