2. Làm quen với Toolkit

​

Xem qua một lượt

Bây giờ bạn đã có bản sao cục bộ của Toolkit, hãy xem cấu trúc của kho mã bằng lệnh ls.

Run this

ls -l

Lệnh ls -l hiển thị danh sách chi tiết nội dung của một thư mục, cung cấp thêm thông tin về tệp như quyền truy cập, chủ sở hữu và kích thước.

Nếu mọi thứ được clone thành công, bạn sẽ thấy kết quả tương tự như sau:

drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 bin
-rw-r--r-- 1 fry fry  6465 Aug 30 14:16 CHANGELOG.md
drwxr-xr-x 2 fry fry  4096 Sep  6 12:43 config
drwxr-xr-x 5 fry fry  4096 Aug 30 14:22 data
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 doc
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 lib
-rw-r--r-- 1 fry fry 34520 Aug 30 14:16 LICENSE
-rw-r--r-- 1 fry fry  1178 Aug 30 14:16 README.md

Tất cả các tệp cấu hình do người dùng sở hữu đều nằm trong thư mục config/. Thư mục này được loại trừ khỏi hệ thống quản lý phiên bản git, vì vậy nó sẽ không bị thay đổi khi cập nhật Toolkit.

​

Bố cục kho mã

Tên	Mô tả
bin	Thư mục này chứa một tập hợp các script giúp bạn quản lý phiên bản máy chủ Overleaf của mình. Bạn có thể đọc thêm về các script này trong phần Lệnh bên dưới.
config	Thư mục này chứa các tệp cấu hình cục bộ của riêng bạn.
lib	Thư mục này chứa các tệp cấu hình cơ sở được Toolkit sử dụng.
data	Theo mặc định, thư mục này là nơi lưu trữ dữ liệu của MongoDb, Redis và Overleaf. Để biết thêm thông tin, hãy xem phần Dữ liệu lưu trữ bền vững bên dưới.

Chúng tôi khuyến nghị không thay đổi trực tiếp các tệp nằm ngoài thư mục /config. Thay vào đó, nếu cần thay đổi, bạn có thể thực hiện thông qua các biến môi trường được đặt trong config/variables.env hoặc config/overleaf.rc.
Ví dụ, để đặt image cho dịch vụ mongo, thay vì chỉnh sửa trực tiếp lib/docker-compose.mongo.yml, hãy đặt image bằng biến môi trường MONGO_IMAGE trong config/overleaf.rc. Để biết thêm thông tin, hãy xem trang Thiết lập Toolkit.

Toolkit sẽ không thay đổi bất kỳ dữ liệu nào trong thư mục config/ nếu không có sự cho phép của bạn.