Đưa công việc sẵn có vào Oleafly

Chọn New project → Import a project, hoặc dùng Import trong thư viện. Oleafly tạo một dự án cục bộ mới và giữ nguyên tệp hoặc kho chứa gốc. Trừ khi bản nhập mang theo kho Git riêng của nó, các tệp được nhập sẽ trở thành lần commit Git đầu tiên của dự án, Create project.

Chọn Import project từ hộp thoại dự án mới để bắt đầu với công việc sẵn có. Mở ảnh chụp màn hình đầy đủ

Chọn lộ trình phù hợp với nguồn của bạn

Bạn có gì	Lộ trình nhập	Dự án bạn có thể tạo
Một thư mục dự án hoàn chỉnh	Existing project (.zip)	Mã nguồn trong kho lưu, hình vẽ, tài liệu tham khảo, và các tệp style cục bộ
Một tài liệu Word	Word document (.docx)	LaTeX, Markdown hoặc Typst
Một tài liệu Markdown	Markdown document (.md, .markdown)	LaTeX hoặc Typst
Một tài liệu HTML	HTML page (.html, .htm)	LaTeX, Markdown hoặc Typst
Một tài liệu Typst	Typst document (.typ)	LaTeX hoặc Markdown
Một bài báo arXiv	arXiv paper với ID hoặc URL	Gói mã nguồn LaTeX của bài báo
Một kho chứa GitHub	GitHub	Một dự án cục bộ kết nối với kho chứa đó
Một PDF không có mã nguồn chỉnh sửa được	Oleafly Tools → PDF converters	LaTeX, Markdown hoặc Typst được tái tạo, tùy công cụ bạn chọn
Một dự án LaTeX đã có trong Oleafly	Convert to a Typst project trong bảng lệnh	Một dự án Typst mới, dự án LaTeX được giữ nguyên

Chỉ chọn cùng định dạng soạn thảo khi Oleafly cung cấp nó. Để giữ một tệp Markdown hoặc Typst ở định dạng gốc, hãy tạo một dự án trống cho định dạng đó và thêm tệp nguồn qua cây tệp.

Nhập một kho lưu trữ dự án hoàn chỉnh

Dùng tệp ZIP khi bạn đã có một cây mã nguồn hoạt động được.

1. Đặt tài liệu chính, hình vẽ, tài liệu tham khảo, và các tệp class hoặc style cục bộ vào một thư mục. Giữ nguyên các đường dẫn tương đối mà mã nguồn sử dụng.
2. Nén thư mục thành tệp .zip.
3. Chọn Import → Existing project và chọn tệp ZIP.
4. Kiểm tra tài liệu chính được đánh dấu sao trong cây tệp đã nhập.
5. Biên dịch. Nếu dự án cần một chuỗi công cụ LaTeX khác, hãy chọn nó trong trình đơn trình biên dịch.

Ví dụ, hãy giữ main.tex, references.bib, sections/method.tex, và figures/plot.pdf cùng nhau. Một tệp ZIP mã nguồn giữ nguyên các mối quan hệ đó. Một PDF không chứa cấu trúc dự án chỉnh sửa được như vậy.

Nếu kho lưu chứa nhiều hơn một tài liệu chính khả dĩ, hãy xác nhận tài liệu đúng qua trình đơn tệp trước khi biên dịch.

Trình biên dịch LaTeX nào được dùng khi nhập

Một dự án LaTeX được nhập hoặc chuyển đổi bắt đầu với trình biên dịch mặc định từ Settings → Engines → LaTeX, là Tectonic trừ khi bạn đã thay đổi. Khi mặc định đó là latexmk và dự án nêu tên pdfLaTeX, XeLaTeX, hoặc LuaLaTeX, trình biên dịch đó được giữ lại. Nếu quá trình nhập thấy các tính năng Tectonic không xử lý được, hộp thoại trình biên dịch sẽ mở để bạn chọn trình khác. Xem Đặt mặc định cho dự án mới và Khi Tectonic chưa đủ dùng.

Chuyển đổi Word, Markdown, HTML, hoặc Typst

1. Chọn loại tài liệu tương ứng trong Import.
2. Chọn tệp.
3. Nếu Oleafly cung cấp nhiều hơn một đích đến, hãy chọn định dạng bạn muốn chỉnh sửa tiếp. LaTeX được đánh dấu là lộ trình khuyến nghị.
4. Hoàn tất thiết lập Pandoc nếu được nhắc. Oleafly có thể dùng một bản cài đặt tương thích hoặc tải phiên bản do nó quản lý.
5. Mở dự án mới, biên dịch, và so sánh với bản gốc.

Quá trình chuyển đổi chạy cục bộ qua Pandoc. Việc nhập Word hoặc HTML còn trích xuất các phương tiện nhúng vào dự án để mã nguồn sau chuyển đổi có thể tham chiếu đến chúng. Một tài liệu Markdown được nhập vào dự án LaTeX giữ nguyên các trích dẫn của nó: [@key] trở thành \citep hoặc \citet, và tệp tài liệu tham khảo cũng đi kèm, nên bảng References có các nguồn của bạn ngay từ đầu.

Chọn đích đến cho công việc phía trước:

• LaTeX phù hợp với mẫu tạp chí, trình bày chi tiết, và quy trình PDF có gắn thẻ.
• Markdown phù hợp với định dạng nguồn gọn nhẹ và chuyển đổi tài liệu ở phạm vi rộng.
• Typst phù hợp với biên dịch nhanh và các mẫu Typst gốc.

Quá trình chuyển đổi giữ nguyên cấu trúc tài liệu ở nơi định dạng nguồn thể hiện được nó. Bố cục trang đặc thù của Word, kiểu dáng HTML tùy chỉnh, bảng tinh chỉnh thủ công, trích dẫn, và phương trình phức tạp vẫn có thể cần một lượt dọn dẹp. Hãy so sánh các đề mục, danh sách, bảng, phương trình, liên kết, trích dẫn, và vị trí hình ảnh trước khi xóa bản gốc.

Nhập gói mã nguồn arXiv

Chọn arXiv paper, rồi dán một định danh như 2401.01234 hoặc URL dạng arxiv.org/abs/.... Oleafly tải xuống gói mã nguồn đã nộp và mở nó như một dự án LaTeX.

Dùng lộ trình này khi bạn cần mã nguồn chỉnh sửa được của tác giả. Dùng arXiv sang LaTeX khi bạn muốn xem hoặc lưu một kho mã nguồn mà không bắt đầu từ hộp thoại nhập, và arXiv sang Typst khi bạn muốn bài báo được chuyển sang Typst. Một định danh arXiv cần kết nối mạng; một kho mã nguồn đã có trên đĩa thì không.

Luôn kiểm tra giấy phép và điều khoản của tác giả trước khi tái sử dụng mã nguồn hoặc hình vẽ.

Nhập từ GitHub

Chọn GitHub trong hộp thoại nhập. Nếu cần, hãy kết nối tài khoản của bạn qua Settings → Integrations → GitHub, rồi chọn một kho chứa bạn có quyền truy cập.

Oleafly tạo một bản sao cục bộ trong thư viện. Kiểm tra tài liệu chính của nó và chạy một lần biên dịch trước khi chỉnh sửa. Đồng bộ GitHub giải thích cách pull, commit, và xuất bản thay đổi sau khi nhập.

Chuyển đổi một dự án LaTeX sang Typst

Oleafly có thể tạo một bản sao Typst từ một dự án LaTeX bạn đã có. Dự án LaTeX không bị thay đổi.

1. Mở dự án LaTeX.
2. Mở bảng lệnh ⌘K (Ctrl+K) và chạy Convert to a Typst project.
3. Kiểm tra New project name. Giá trị mặc định là tên dự án nối thêm (Typst).
4. Chọn Convert. Oleafly chuyển đổi dự án bằng Pandoc, tạo dự án Typst, và biên dịch một lần để kiểm tra.
5. Đọc báo cáo, rồi chọn Open the Typst project.

Báo cáo cho biết dự án mới có biên dịch được không, đếm những gì đã chuyển đổi, và liệt kê những gì cần sửa thủ công, kèm liên kết đến từng lỗi biên dịch. Dự án Typst giải thích chi tiết về quá trình chuyển đổi và báo cáo.

Tái tạo một PDF

Bật LaTeX tools trong Settings → Experimentation, rồi chọn công cụ phù hợp với đầu ra bạn cần:

• PDF sang LaTeX cho một dự án LaTeX hoặc kho mã nguồn
• PDF sang Markdown cho Markdown chỉnh sửa được
• PDF sang Typst cho Typst chỉnh sửa được

Quy trình PDF cục bộ đọc lớp văn bản, khôi phục thứ tự đọc, và trích xuất hình vẽ. Trong PDF to LaTeX, hãy chuyển sang chế độ tài liệu quét khi PDF gồm các hình ảnh trang. Lộ trình đó dùng mô hình cho Tools, là một mô hình Ollama cục bộ trừ khi bạn chọn mô hình khác, và hỗ trợ tài liệu tối đa 50 trang.

Hãy so sánh kết quả với PDF từng trang một. Các cột, phương trình, bảng, chân chú, và thứ tự đọc là những vấn đề của việc tái tạo, nên không bản chuyển đổi PDF nào nên được xem như mã nguồn gốc.

Thêm tài liệu tham khảo mà không cần nhập bản thảo

Nhập BibTeX, RIS, EndNote XML, hoặc Zotero RDF qua Tài liệu tham khảo & trích dẫn. Liên kết một thư mục bài báo hoặc dữ liệu như ngữ cảnh nghiên cứu chỉ đọc khi nó cần nằm ngoài dự án.