Cài đặt TAGUETTE
Taguette được tung ra dưới Giấy phép BSD . Bạn có thể đọc về đội ngũ đằng sau Taguette trên trang About.
Bạn có thể sử dụng Taguette miễn phí trên máy chủ của chúng tôi tại https://app.taguette.org và cũng có thể cài đặt Taguette trên máy cục bộ hoặc server (nếu bạn thích!). Sử dụng Taguette trên máy chủ của chúng tôi (hoặc của riêng bạn) có nghĩa là bạn sẽ có thể cộng tác với những người khác trong khi sử dụng Taguette trên máy tính của riêng bạn, nghĩa là bạn có thể sử dụng nó ngoại tuyến và một mình.
Bộ cài đặt
Taguette hoạt động trên HĐH macOS, Windows và Linux. Trình cài đặt cho macOS và Windows bao gồm Python, Taguette và Calibre, vì vậy bạn không cần phải cài đặt bất kỳ thứ gì khác. Đối với Linux, cách dễ nhất để cài đặt Taguette là sử dụng pip
, và các hướng đẫn ở below.
-
Trong Windows...
Tải tệp EXE xuống từ Trang chứa phiên bản mới nhất.
Mở ra. Trên một số phiên bản của Windows, bạn sẽ thấy thông báo rằng Taguette đến từ "Nhà phát triển không rõ", trong trường hợp đó, nhấp vào "more info" và chọn tiếp "run anyway".
Nhấp qua các bước cài đặt. . Một biểu tượng "Taguette" sẽ xuất hiện trên Start Menu và trên Desktop máy tính của bạn, nếu bạn đã chọn các tùy chọn đó trong khi cài đặt.
-
Trên macOS...
Tải file DMG từ trang có phiên bản mới nhất.
Khi mở ra, bạn sẽ thấy một cửa sổ Finder. Bạn hãy rê tệp "Taguette.app" vào Folder "Applications".
Kích đúp vào "Applications", kích chuột phải vào "Taguette.app" và chọn "Open".
Bạn sẽ chỉ phải làm điều này lần đầu tiên. Sau này, bạn sẽ có thể bắt đầu Taguette từ Launchpad hoặc Spotlight.
Khi bạn khởi động ứng dụng, bạn sẽ thấy một cửa sổ đầu cuối xuất hiện. Điều này là bình thường! Bạn hoàn toàn có thể bỏ qua nó và sử dụng Taguette từ trình duyệt web của mình (localhost:7465
để mở tự động). Duy trì việc mở cửa sổ đầu cuối cho đến khi bạn sử dụng xong Taguette, sau đó bạn có thể đóng cửa sổ đầu cuối đó để dừng Taguette.
Cài dặt đùng PIP
Trước tiên cần cài đặt Python 3 vàCalibre, phần mềm quản lý sách điện tử mã nguồn mở. Taguette sử dụng một phần của Calibre để chuyển đổi tài liệu thành HTML, cho phép bạn đánh dấu và gắn thẻ các phần của chúng.
Đối với Debian hay Ubuntu, bạn cần chạy app sudo apt install python3 calibre
Sau khi đã cài xong Python, bạn cần tạo môi trường Python 3 ảo rồi cài đặt Taguette với các tham số của nó từ dòng lệnh như sau:
python3 -m venv taguette.virtualenv . taguette.virtualenv/bin/activate pip install taguette
Sau đó, bạn chỉ cần chạy taguette.virtualenv/bin/taguette
trong cửa số đầu cuối. Bạn sẽ thấy các dòng lệnh chạy. Đó là điều bình thường. Đừng lo lắng, đừng tắt cửa số đó đi. Một cửa sổ trình duyệt sẽ xuất hiện, trỏ bạn đến localhost:7465
, và bạn đã có thể bắt đầu dự án của mình được rồi!
Thiết lập cho nhà phát triển
Bạn cũng có thể cài đặt từ một bản sao cục bộ của kho lưu trữ này, điều này sẽ cho phép bạn dễ dàng thay đổi các nguồn cho phù hợp với nhu cầu của mình:
- Sao chép kho lưu trữ git này từ thiết bị đầu cuối:
git clone https://gitlab.com/remram44/taguette.git
- điều hướng trên dòng lệnh đến kho lưu trữ mà bạn vừa sao chép cục bộ, bằng cách sử dụng lệnh
cd
. Để nhận trợ giúp, dùng lệnhcd
, lệnhthis tutorial. - Taguette sử dụng Poetry cho việc đóng gói và quản lý các tham số. Bạn sẽ cần cài Poetry.
- Cài đặt Taguette và các tham số phụ thuộc của nó bằng cách chạy
poetry install
. Poetry sẽ mặc định tạo một môi trường ảo cho bạn, hãy kích hoạt nó bằng cách chạypoetry shell
. - Xây dựng tệp dịch bằng cách sử dụng
scripts/update_translations.sh
. - Bạn có thể bắt đầu taguette ở chế độ phát triển bằng cách sử dụng
taguette --debug
(haytaguette --debug server <config_file>
). Thao tác này sẽ khởi động Tornado ở chế độ gỡ lỗi, có nghĩa là nó sẽ tự động khởi động lại mỗi khi bạn thực hiện thay đổi. - Điều hướng đến
localhost:7465
để sử dụng Taguette!
Học cách sử dụng Taguette tại trang getting started của chúng tôi!