Công cụ tài liệu
Gói
Tìm kiếm CTAN cho các gói LaTeX và Typst Universe cho các gói Typst, rồi thêm một gói vào tài liệu từ thanh công cụ trình soạn thảo.
Các tài liệu LaTeX và Typst nhận phần lớn tính năng bổ sung từ các gói. Nút gói ở đầu bên phải của thanh công cụ trình soạn thảo mở một danh sách có thể tìm kiếm cho ngôn ngữ của dự án và ghi giúp bạn dòng nạp một gói. Dự án Markdown không có nút gói.
Bạn cũng có thể mở danh sách này từ bảng lệnh ⌘K với Browse LaTeX packages hoặc Browse Typst packages.
Gói LaTeX
Phần tiêu đề “Gói LaTeX”Trong một dự án LaTeX, chọn LaTeX packages. Tìm kiếm CTAN theo tên gói hoặc mô tả. Nếu không truy cập được CTAN, hoặc bạn đang offline, hộp thoại sẽ nói rõ điều đó và hiển thị danh sách tích hợp sẵn của Oleafly thay thế. Một danh sách không làm mới được hiển thị ngày nó được tải về.
Mỗi dòng có thể hiển thị các nhãn sau:
- In document: tệp chính đã nạp gói này.
- Document class: mục này là một lớp tài liệu, không phải một gói. Lớp được đặt bằng
\documentclass, nên dòng chỉ cho phép sao chép dòng đó chứ không thêm vào. - Installed: bản phân phối TeX của bạn đã có gói này.
Mỗi dòng còn có các điều khiển sau:
- Options, một trường cho các tùy chọn gói chẳng hạn
margin=2cm. Các dấu ngoặc nhọn phải khớp nhau, và không dùng được]hoặc%. - Add to preamble, ghi
\usepackage[options]{name}vào preamble của tệp chính. Nếu tệp đã nạp gói rồi thì không có gì thay đổi, và hộp thoại sẽ cho bạn biết. - Copy line, sao chép cùng một dòng
\usepackagenhư vậy, hoặc dòng\documentclasscho một lớp. - CTAN, mở trang của gói trên CTAN.
- Install, dành cho một gói mà bản phân phối TeX của bạn còn thiếu. Xem bên dưới.
Cài đặt gói LaTeX
Phần tiêu đề “Cài đặt gói LaTeX”“Đã cài” có nghĩa gì tùy thuộc vào cách dự án biên dịch:
- Tectonic, trình biên dịch tích hợp sẵn, tải về một gói lần đầu tiên tài liệu của bạn dùng đến nó. Không có gì phải cài, và hộp thoại nói rõ điều đó ở phần đầu.
- latexmk với TeX Live hoặc TinyTeX: khi bản phân phối TeX của bạn có
tlmgr, Oleafly kiểm tra bạn có những gói nào, đánh dấu chúng là Installed, và đề xuất Install cho phần còn lại. Install chạytlmgrcho riêng gói đó. - TeX Live từ Debian, Ubuntu hoặc Fedora: trình quản lý gói của hệ thống sở hữu nó, nên hộp thoại bảo bạn cài gói bằng
apthoặcdnfvà không có nút Install. - Các thiết lập TeX khác, chẳng hạn MiKTeX: Oleafly không thể biết những gói nào có mặt, nên các dòng không hiển thị trạng thái cài đặt. Dùng MiKTeX Console cho MiKTeX.
Với TeX Live hoặc TinyTeX, một lần biên dịch không tìm thấy tệp sẽ đề xuất Find and install trong thông báo lỗi, nút này tìm ra gói mà tệp thuộc về. Xem Khôi phục khi thiếu tệp.
Chọn trình biên dịch từ mũi tên bên cạnh Recompile. Xem Các engine LaTeX.
Gói Typst
Phần tiêu đề “Gói Typst”Trong một dự án Typst, chọn Typst packages để duyệt Typst Universe. Tìm kiếm theo tên, từ khóa hoặc danh mục, hoặc thu hẹp danh sách bằng một chip danh mục. Hộp thoại hiển thị tối đa 100 gói mỗi lần, nên khi danh sách dài hãy dùng tìm kiếm.
Mỗi dòng hiển thị tên gói, phiên bản mới nhất của nó, một huy hiệu Template cho các gói là mẫu, và một mô tả ngắn. Khi một gói cần phiên bản Typst mới hơn phiên bản dự án đang dùng, dòng sẽ cho biết nó cần phiên bản nào.
- Insert import thêm
#import "@preview/name:version": *vào sau các câu lệnh import ở đầu tệp.typđang mở. Nếu tệp đã nhập gói đó rồi, chỉ số phiên bản thay đổi. Một tệp Typst phải đang được mở trong trình soạn thảo. - Copy import sao chép cùng dòng đó.
Gợi ý cập nhật
Phần tiêu đề “Gợi ý cập nhật”Khi một lệnh import @preview trong tệp của bạn cũ hơn bản phát hành mới nhất trên Typst Universe, trình soạn thảo đánh dấu phiên bản đó với một gợi ý chẳng hạn “cetz 0.4.2 is available. This import uses 0.3.4.” Hành động Update to 0.4.2 của gợi ý đổi con số ngay tại chỗ.
Giữ gói cùng dự án
Phần tiêu đề “Giữ gói cùng dự án”Typst tải các gói vào một bộ nhớ đệm dùng chung lần đầu tiên một dự án nhập chúng. Để dự án tự mang các bản sao của riêng mình, dùng Project packages ở cuối hộp thoại:
- Use packages from the project folder khiến Typst nhìn vào thư mục
typst-packagescủa dự án trước. Một dự án thiết lập theo cách này biên dịch được khi offline và trên các máy tính khác. - Vendor packages into project sao chép mọi gói mà dự án nhập từ bộ nhớ đệm vào
typst-packages. Nếu một gói chưa có trong bộ nhớ đệm, hãy biên dịch một lần khi trực tuyến, rồi vendor lại.
Cả hai đều cần Typst 0.12 trở lên. Trên một dự án ghim Typst 0.11, phần này cho biết điều đó.
Phần này cũng cho biết dự án đang giữ bao nhiêu gói.
Offline
Phần tiêu đề “Offline”Khi bật chế độ offline, hộp thoại dùng danh sách gói nó tải về lần gần nhất và hiển thị ngày của danh sách đó. Nếu chưa từng có danh sách nào được tải về, nó không thể hiển thị danh sách cho đến khi bạn trực tuyến.
Các trang liên quan
Phần tiêu đề “Các trang liên quan”- Trình soạn thảo: phần còn lại của thanh công cụ trình soạn thảo
- Biên dịch: các gói được lấy như thế nào trong một lượt dựng
- Cài đặt tài liệu: khổ giấy, lề và phông chữ mà không cần viết mã gói