Các tệp và dữ liệu của bạn
Biết những gì đi cùng một dự án và cách sao lưu mã nguồn, lịch sử và dữ liệu ứng dụng.
Bản thảo của bạn là một thư mục gồm các tệp nguồn thông thường. Bạn có thể mở những tệp đó bằng một trình soạn thảo khác, sao lưu chúng, hoặc đưa chúng ra khỏi Oleafly.
Các tệp dự án
Phần tiêu đề “Các tệp dự án”Các dự án trong thư viện thường nằm dưới ~/.oleafly/projects/. Một dự án có thể chứa một tài liệu chính LaTeX, Typst hoặc Markdown, một tài liệu tham khảo, hình vẽ và tư liệu nghiên cứu.
project.json ghi danh tính và cài đặt của dự án, gồm tài liệu chính, engine và phiên bản Typst được ghim. Thư mục .git giữ lịch sử Git. Một dự án do Oleafly tạo hoặc nhập vào thường bắt đầu với một commit các tệp của nó, gọi là “Create project” (xem Git và quản lý mã nguồn). Thư mục .oleafly/build/ chứa kết quả dựng được tạo ra và có thể tạo lại bằng cách biên dịch.
Một dự án Typst có thể giữ các bản sao của những gói nó nhập trong một thư mục typst-packages, nhờ vậy nó biên dịch được khi ngoại tuyến và trên các máy tính khác. Typst cũng dùng các phông chữ trong thư mục fonts của dự án. Cả hai thư mục đi cùng dự án.
Một thư mục bạn mở tại chỗ giữ nguyên vị trí của nó. Oleafly giữ các bản dựng, cài đặt, điểm khôi phục và hội thoại trò chuyện của thư mục đó trong thư mục dữ liệu riêng của mình, nên không có gì được thêm vào thư mục của bạn.
Dữ liệu nằm ngoài dự án
Phần tiêu đề “Dữ liệu nằm ngoài dự án”Tùy chọn ứng dụng, thông tin xác thực provider đã mã hóa, bản ghi trò chuyện và mức dùng, các công cụ tải về như các phiên bản Typst thêm, và các điểm khôi phục đã lưu thuộc về lưu trữ ứng dụng cục bộ. Các bản sao của một dự án mà Oleafly giữ từ trước mỗi lượt trợ lý hoặc tác nhân cũng vậy, chúng cho phép bạn hoàn tác các tệp mà lượt đó đã thay đổi. Bản sao thư viện Zotero mà tìm kiếm @ đọc cũng nằm ở đó, chứ không nằm trong dự án. Sao chép một thư mục bản thảo không sao chép toàn bộ dữ liệu ứng dụng đó.
Các thư mục được liên kết vẫn nằm ở vị trí gốc của chúng. Một tệp nén mã nguồn không bao gồm nội dung của chúng chỉ vì bạn đã liên kết chúng.
Ghi chú nằm ở đâu
Phần tiêu đề “Ghi chú nằm ở đâu”Notes là các tệp Markdown trên máy tính của bạn. Mỗi ghi chú cá nhân là một thư mục trong thư mục dự án, cạnh các dự án thư viện của bạn. Một ghi chú dự án là một tệp .md trong thư mục notes của dự án, nên nó đi cùng dự án. Xem Nơi lưu ghi chú để biết thư mục trên Windows, macOS và Linux, và để biết một thư mục ghi chú chứa gì.
TinyTeX nằm ở đâu
Phần tiêu đề “TinyTeX nằm ở đâu”Khi bạn cài TinyTeX từ Settings → Engines → LaTeX, Oleafly đặt nó trong ~/.oleafly/tinytex. Windows là ngoại lệ khi tên thư mục người dùng của bạn có chữ có dấu hoặc chữ không phải Latin, chẳng hạn tên tiếng Hàn hay tiếng Trung, vì TeX Live không chạy được từ một thư mục như vậy. Khi đó TinyTeX nằm trong một thư mục tên Oleafly- cộng thêm một mã ngắn bên trong ProgramData, thường là C:\ProgramData. Không cần quyền quản trị. Nếu Oleafly cũng không thiết lập được thư mục đó, nó sẽ báo cho bạn. Bạn có thể tiếp tục biên dịch bằng Tectonic, hoặc tự cài TeX Live vào C:\texlive.
Dòng TinyTeX dưới Manage TeX distributions hiển thị thư mục; hãy di chuột lên đường dẫn bị làm mờ để đọc nó. Gỡ TinyTeX từ dòng đó thay vì tự xóa thư mục.
Sao lưu công việc của bạn
Phần tiêu đề “Sao lưu công việc của bạn”| Những gì bạn muốn giữ | Cách giữ |
|---|---|
| Mã nguồn bản thảo và tài nguyên dự án | Sao chép thư mục dự án hoặc xuất một tệp ZIP mã nguồn |
| Các commit Git | Sao lưu kho hoặc đẩy lên remote bạn đã cấu hình |
| Các điểm khôi phục đã lưu | Xuất một kho lưu lịch sử mã hóa từ Versioning |
| Tùy chọn ứng dụng và bản ghi cục bộ | Đưa thư mục dữ liệu Oleafly vào bản sao lưu máy tính thường lệ của bạn |
| Dữ liệu và tài liệu tham khảo được liên kết | Sao lưu các thư mục gốc của chúng |
| Các dự án và cài đặt thư viện, ngoài máy tính này | Bật đồng bộ đám mây để giữ một bản sao trong Dropbox của bạn |
Một tệp ZIP mã nguồn loại trừ bộ nhớ đệm dựng và Git. Dùng Đồng bộ GitHub cho một kho từ xa và kho điểm khôi phục cho lịch sử điểm khôi phục.
Chuyển sang máy tính khác
Phần tiêu đề “Chuyển sang máy tính khác”Cài Oleafly và sao chép hoặc clone dự án bản thảo. Kết nối lại các thư mục được liên kết và các model provider trên máy đó. Dự án mang theo lựa chọn trình biên dịch và siêu dữ liệu của nó; các công cụ hoặc gói bổ sung có thể cần cài đặt. Một dự án Typst ghim một phiên bản mà máy này không có sẽ đề nghị tải nó về trước khi biên dịch.
Đường dẫn trên màn hình
Phần tiêu đề “Đường dẫn trên màn hình”Các đường dẫn nằm trong thư mục home của bạn xuất hiện dưới dạng ~/… trong Settings, lịch sử phiên bản, chi tiết engine và tác nhân, và phần trò chuyện. Trong Settings, các đường dẫn tệp và thư mục cũng được làm mờ cho đến khi bạn rê chuột lên hoặc đến chúng bằng Tab, nhờ vậy một ảnh chụp màn hình không cho thấy tệp của bạn nằm ở đâu.
Truy cập mạng
Phần tiêu đề “Truy cập mạng”Việc viết và soát lỗi cục bộ diễn ra trên máy của bạn. AI lưu trữ nhận ngữ cảnh được cung cấp cho provider đã chọn. Các công cụ đọc ảnh và PDF quét dùng một mô hình Ollama cục bộ, trừ khi bạn chọn một mô hình đặt trên máy chủ hoặc Mathpix cho chúng; khi đó tệp sẽ được gửi đến dịch vụ đó. Trích dẫn Zotero nói chuyện với ứng dụng Zotero trên máy của bạn, hoặc với zotero.org khi bạn kết nối một tài khoản. Tìm kiếm trích dẫn, nhập Zotero, các công cụ alphaXiv, đồng bộ GitHub, tải gói và phiên bản Typst, các lần tải khác và kiểm tra bản cập nhật liên hệ dịch vụ tương ứng của chúng. Cộng tác trực tiếp gửi mỗi dự án được chia sẻ đến máy chủ cộng tác mà nó được chia sẻ trên. Đồng bộ đám mây gửi các dự án thư viện và cài đặt của bạn đến Dropbox của riêng bạn. Mở Settings → Help & About lấy các con số công khai: số star và fork GitHub của dự án và bao nhiêu thành viên đang trực tuyến trong cộng đồng Discord. Các yêu cầu không mang thông tin tài khoản, dự án hay mức dùng, và chế độ offline bỏ qua con số Discord. Tectonic và Typst đều hỗ trợ biên dịch qua bộ nhớ đệm với chế độ offline.