Chọn một document engine

Một engine biến mã nguồn của bạn thành tài liệu mà người đọc xem. Hãy chọn ngôn ngữ tài liệu khi bạn tạo dự án. Với dự án LaTeX, bạn còn có thể chọn trình biên dịch LaTeX nào chạy bản dựng.

LaTeX biên dịch bằng Tectonic hoặc latexmk, còn Typst bằng phiên bản dự án ghim. Markdown đi qua Pandoc trước, rồi Tectonic.

Chọn ngôn ngữ

Công việc của bạn	Bắt đầu với	Cách nó trở thành PDF
Một bản nộp tạp chí, một lớp luận văn sẵn có, hoặc một dự án .tex đã tồn tại	LaTeX	Tectonic, hoặc một trình biên dịch chạy qua latexmk
Một bài báo, báo cáo hoặc CV mới với cú pháp dàn trang gọn gàng	Typst	Typst 0.15.1 dựng sẵn, hoặc một phiên bản Typst khác mà dự án ghim
Một bản nháp văn xuôi, ghi chú, hoặc một tài liệu bạn muốn xuất sang nhiều định dạng	Markdown	Pandoc chuyển mã nguồn sang LaTeX; Tectonic tạo tệp PDF
Một báo cáo phân tích, bài viết hoặc bộ slide có kết quả do mã R, Python hoặc Julia tạo ra	Quarto	Quarto render các tệp .qmd hoặc .Rmd ra PDF, trang web hoặc slide
Một tài liệu Typst có các khối mã	Calepin	Calepin chạy mã, rồi Typst tích hợp sẵn dựng PDF

Lựa chọn này quyết định thanh công cụ của trình soạn thảo, cú pháp nguồn và các định dạng xuất khả dụng. Việc đổi trình biên dịch LaTeX không dịch tài liệu sang Typst hay Markdown. Để chuyển một dự án LaTeX sang Typst, hãy chuyển nó thành một dự án Typst mới.

Tectonic

Dùng Tectonic cho một thiết lập LaTeX đơn giản. Nó đi kèm Oleafly, tải các gói TeX mà một lần dựng cần, và lưu vào bộ nhớ đệm cho các lần dựng sau. Hãy bắt đầu ở đây khi mẫu của bạn không đòi hỏi một trình biên dịch cụ thể.

Hãy biên dịch một lần khi đang trực tuyến trước khi đi xa. Một dự án đã có bộ nhớ đệm có thể biên dịch ngoại tuyến; một gói mới có thể vẫn cần tải về. Bật Settings → General → Offline mode để yêu cầu Tectonic dùng bộ nhớ đệm của nó.

pdfLaTeX

Chọn pdfLaTeX khi nhà xuất bản hoặc dự án sẵn có chỉ định nó. Nó theo quy trình LaTeX truyền thống và phù hợp với các lớp cũ cùng các tổ hợp gói cũ. Nó cần một bản phân phối TeX có cài latexmk.

XeLaTeX

Chọn XeLaTeX cho một dự án yêu cầu nó, đặc biệt là dự án dùng fontspec, phông chữ OpenType hoặc văn bản đa ngôn ngữ. Hãy chắc chắn các phông chữ mà mã nguồn nêu tên đã được cài hoặc đi kèm dự án. Nó cũng chạy qua latexmk.

LuaLaTeX

Chọn LuaLaTeX cho một mẫu bắt buộc nó, cho việc dàn trang dựa trên Lua, hoặc cho quy trình tagged-PDF của Oleafly. Tagged PDF mang cấu trúc tài liệu mà công nghệ hỗ trợ tiếp cận có thể dùng. Chạy các kiểm tra preflight để xem xét kết quả; riêng lựa chọn trình biên dịch không quyết định chất lượng của các thẻ.

Typst

Oleafly mang theo Typst 0.15.1. Tạo một dự án Typst, viết trong các tệp .typ, rồi bấm Recompile. Không có bản cài TeX nào phải thiết lập.

Settings → Engines → Typst còn có thể cài Typst 0.11 đến 0.15 và dùng một Typst đã cài sẵn trên máy của bạn. Mỗi dự án ghim phiên bản riêng, nên một bài báo giữ nguyên bố cục khi Oleafly chuyển sang Typst mới hơn. Typst tải các gói từ Typst Universe ở lần đầu một tài liệu nhập chúng, và Offline mode giới hạn nó ở các gói đã có trong bộ nhớ đệm hoặc được giữ trong dự án.

Typst có cú pháp, gói và cách xử lý phông chữ riêng. Dự án Typst trình bày phiên bản, gói, phông chữ và các biến thể dựng. Hướng dẫn viết Typst có một tài liệu khởi đầu đầy đủ và các điều khiển trên thanh công cụ.

Markdown

Markdown dùng Pandoc để chuẩn bị một tài liệu đã dàn trang và Tectonic để dựng PDF của nó. Mở Settings → Engines → Markdown để cài Pandoc khi nó còn thiếu. Sau đó mở dự án Markdown của bạn và biên dịch.

Tham khảo Viết Markdown cho đề mục, danh sách, công thức toán và trình soạn thảo trực quan. Hướng dẫn xuất giải thích dự án cung cấp những định dạng xuất nào.

Quarto

Quarto biến các tài liệu .qmd và .Rmd thành PDF, trang web hoặc slide. Oleafly dùng Quarto trên máy tính của bạn khi tìm thấy. Nếu chưa có, hãy mở Settings → Engines → Quarto và chọn Download Quarto 1.10.19. Nút này cũng hiển thị kích thước bản tải về. Oleafly kiểm tra bản tải về trước khi giải nén và giữ bản sao trong thư mục ứng dụng của riêng nó. Nếu bạn biên dịch khi chưa có Quarto, bản xem trước đề nghị cài nó ngay tại chỗ, hoặc đưa ra Open engine settings.

Định dạng đầu tiên mà tài liệu khai báo quyết định bạn nhận được gì:

• pdf, typst và beamer dựng ra PDF. format: typst không cần bản cài TeX. pdf và beamer đi qua LaTeX, nên hãy cài TinyTeX từ Settings → Engines → LaTeX nếu bạn chưa có TeX.
• html, revealjs và dashboard dựng ra trang web. Chọn Open in browser trong bản xem trước để xem nó.

Khi tài liệu không khai báo định dạng nào, Oleafly tìm định dạng trong _quarto.yml hoặc _metadata.yml, trong thư mục của tài liệu và các thư mục phía trên cho đến thư mục gốc của dự án. Nếu không có định dạng ở đâu cả, Quarto dựng ra trang web. Một tệp .Rmd nêu tên một output: của R Markdown, chẳng hạn pdf_document, sẽ nhận định dạng Quarto tương ứng.

Mã chạy bằng R, Python hoặc Julia đã có sẵn trên máy tính của bạn. Oleafly không bao giờ cài chúng, và Languages trong cùng tab cài đặt đó hiển thị những ngôn ngữ nó tìm thấy. Mã Python còn cần Jupyter trong Python đó. Xuất cung cấp DOCX và HTML, cả hai đều do Quarto render. Hộp thoại New project có hai mẫu Quarto: Quarto article, một PDF dựng qua Typst, và Quarto slides, một bộ slide reveal.js.

Calepin

Calepin chạy mã trong một tài liệu Typst và đưa kết quả vào PDF. Một tài liệu Calepin là một tệp .typ nhập /.calepin/calepin.typ. Hãy bắt đầu một tài liệu từ mẫu Calepin report, hoặc mở mũi tên bên cạnh Recompile trong một dự án Typst và chọn Calepin dưới Engine (this project).

Cài nó từ Settings → Engines → Calepin giống như Quarto, bằng Download Calepin 0.0.61. Calepin dựng bằng Typst đi kèm Oleafly. Một khối mã có ngôn ngữ chưa được cài sẽ hiển thị một ghi chú ngắn, và phần còn lại của tài liệu vẫn được dựng. Xuất cung cấp HTML, do Calepin render.

Cho phép mã trong một dự án

Mã trong một tài liệu Quarto hoặc Calepin chạy với quyền của bạn, nên nó bị tắt trong mỗi dự án cho đến khi bạn cho phép. Sau một lần biên dịch cần đến mã, một dải thông báo phía trên trình soạn thảo cho biết mã đang tắt và đưa ra Allow code in this project. Bạn cũng có thể mở mũi tên bên cạnh Recompile và chọn Run code on this computer dưới Code (this computer). Off tắt nó trở lại. Chỉ cho phép mã nếu bạn tin tưởng mọi tệp trong dự án.

Lựa chọn này chỉ áp dụng cho máy tính này. Nó không được lưu trong dự án, và việc đổi engine của dự án sẽ tắt mã trở lại. Trong một dự án dùng chung, Oleafly hỏi thêm một lần nữa, vì bất kỳ ai có thể chỉnh sửa dự án đều có thể thay đổi mã của nó.

Khi mã đang tắt:

• Quarto hiển thị mã của từng khối mà không chạy nó. Bộ lọc, shortcode, _extensions, các script pre-render và post-render, và mã R nội dòng vẫn chạy mã ngay cả khi đó, nên một tài liệu dùng chúng sẽ không biên dịch cho đến khi bạn cho phép mã.
• Calepin không thể bỏ qua mã. Oleafly dựng PDF bằng Typst thuần từ các kết quả mà Calepin đã lưu ở lần chạy gần nhất. Nếu không có kết quả nào, việc biên dịch dừng lại và yêu cầu bạn cho phép mã.

Một thư mục bạn mở tại chỗ cũng phải được tin tưởng trước khi Quarto hoặc Calepin có thể biên dịch nó. Đồng bộ giữa mã nguồn và PDF không khả dụng với cả hai engine này.

Đặt mặc định cho dự án mới

Mở Settings → Engines → LaTeX và chọn Default compile engine: Tectonic (built in) hoặc latexmk (system TeX). Mọi dự án LaTeX bạn tạo sau đó đều bắt đầu với nó:

• Một dự án trống hoặc một mẫu từ hộp thoại New project, và một dự án nghiên cứu.
• Một tệp ZIP, thư mục, bài báo arXiv hoặc kho GitHub được nhập vào.
• Một tài liệu bạn chuyển thành dự án LaTeX, chẳng hạn tệp Word hoặc tệp PDF.

Engine được ghi vào project.json của dự án, nên đồng tác giả mở dự án sẽ biên dịch nó theo cùng cách. Một dự án nhập vào có nêu pdfLaTeX, XeLaTeX hoặc LuaLaTeX giữ trình biên dịch đó khi nó về latexmk. Trình biên dịch đã lưu của một dự án sẵn có vẫn là lựa chọn riêng của dự án đó.

Một thư mục bạn mở tại chỗ mà không có engine riêng sẽ theo mặc định sau khi bạn tin tưởng nó. Trước đó nó hiển thị và biên dịch trên Tectonic. Dù thế nào, Oleafly cũng không ghi gì vào thư mục.

Với Typst, mở Settings → Engines → Typst và chọn phiên bản mặc định. Các dự án Typst mới ghim phiên bản là mặc định tại thời điểm bạn tạo chúng. Đổi mặc định sau đó không di chuyển các dự án đã có.

Đổi trình biên dịch của dự án hiện tại

Mở mũi tên bên cạnh Recompile trên thanh công cụ dự án. Trong một dự án LaTeX, chọn Tectonic, Auto, pdfLaTeX, XeLaTeX hoặc LuaLaTeX dưới Compiler (this project), rồi biên dịch. Hãy đọc nhật ký nếu một mẫu cần gói hoặc phông chữ mà bản cài được chọn không có.

Trong một dự án Typst, cùng menu đó có Typst version (this project) thay vào đó. Chọn một phiên bản đã cài, hoặc Default để theo Settings. Nhóm Engine (this project) của menu đó chuyển tài liệu giữa Typst và Calepin.

Dò một bản phân phối TeX sẵn có

Mở Settings → Engines → LaTeX và xem chuỗi công cụ được dò ra. Oleafly kiểm tra một bộ trình biên dịch hoàn chỉnh, bao gồm latexmk và các công cụ hỗ trợ. Một bản cài hệ thống dở dang không được ưu tiên hơn một bản cài do Oleafly quản lý đang hoạt động.

Cài TinyTeX do Oleafly quản lý

Dùng nút cài trong cài đặt engine LaTeX nếu bạn cần một trình biên dịch truyền thống mà chưa có. Oleafly tải bản TinyTeX riêng của nó vào ~/.oleafly/tinytex; không cần quyền quản trị. Hãy chừa khoảng 250 MB cho lần tải ban đầu và thêm dung lượng cho các gói.

Quản lý gói

Danh sách gói trong cài đặt engine LaTeX cho phép bạn lọc gói, xem mô tả, và thêm hoặc gỡ chúng. Các huy hiệu tagging nhận diện các gói cần chú ý thêm khi tạo tagged PDF. Các điều khiển này quản lý bản phân phối TeX mà latexmk dùng; Tectonic có một bộ nhớ đệm riêng.

Đọc hướng dẫn gói LaTeX và tagged-PDF →