Mẫu

Tính năng này ban đầu được phát triển bởi yu-i-i/overleaf-cep, sau đó được chỉnh sửa và tối ưu hóa bởi ayaka-notes/ayakaleaf-pro.

Theo mặc định, chỉ người dùng đã đăng nhập mới có thể duyệt thư viện mẫu và mở các liên kết mẫu. Để chia sẻ mẫu với người truy cập chưa đăng nhập, hãy đặt thêm OVERLEAF_ALLOW_PUBLIC_ACCESS=true, xem Truy cập trang. Việc tạo dự án từ mẫu luôn yêu cầu đăng nhập.

​

Cấu hình

Kể từ phiên bản 6.3.0, thư viện mẫu thực hiện phân trang, tìm kiếm và sắp xếp ở phía máy chủ. Không cần di chuyển dữ liệu. Đối với các thư viện mẫu lớn, hãy xem các chỉ mục MongoDB tùy chọn trong ghi chú phát hành.

Tính năng Thư viện mẫu (Template Gallery) được kiểm soát bằng các biến môi trường sau:

• OVERLEAF_TEMPLATE_GALLERY: Đặt thành true để bật Thư viện mẫu.

• OVERLEAF_TEMPLATE_CATEGORIES: Danh sách tùy chọn gồm không hoặc nhiều khóa danh mục mẫu, phân tách bằng khoảng trắng. Các khóa hợp lệ bao gồm:

  • academic-journal
  • book
  • presentation
  • poster
  • cv
  • homework
  • bibliography
  • calendar
  • formal-letter
  • report
  • thesis
  • newsletter

  Khóa đặc biệt all được tự động thêm vào. Khóa này đại diện cho một danh mục bao gồm tất cả các mẫu.

  Với mỗi khóa danh mục, có thể đặt các biến môi trường tùy chọn sau:

  • TEMPLATE_<KEY>_NAME: Tên hiển thị của danh mục mẫu.
  • TEMPLATE_<KEY>_DESCRIPTION: Mô tả ngắn về danh mục.

  Nếu khóa danh mục chứa dấu gạch ngang (-), hãy thay nó bằng dấu gạch dưới (_) trong tên biến môi trường.

• ENABLE_CONVERSIONS: Phải được đặt thành true để bật việc tạo ảnh thu nhỏ và bản xem trước cho các mẫu.

​

Quyền xuất bản

Quản trị viên có thể xuất bản mẫu. Bạn cũng có thể chỉ định một người dùng không phải quản trị viên để quản lý các mẫu được tuyển chọn hiển thị trong thư viện cục bộ tại /templates.

Để làm điều này, bạn cần đặt biến môi trường OVERLEAF_TEMPLATES_USER_ID trong toolkit/config/variables.env thành ID của người dùng sẽ chịu trách nhiệm quản lý mẫu trong phiên bản của bạn, ví dụ:

OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959

​

Xuất bản mẫu

Với mỗi mẫu bạn muốn tải lên:

1. Tạo một dự án chứa mã nguồn của mẫu và đảm bảo nó biên dịch được.
2. Trong trình soạn thảo, chọn File > Manage Template.
3. Trong biểu mẫu hiện ra, nhập thông tin chi tiết của mẫu:
   • Title (tiêu đề) phải là duy nhất.
   • Trường Description (mô tả) hỗ trợ định dạng Markdown.
   • Trường Author (tác giả) chấp nhận các liên kết định dạng Markdown.

Sau khi gửi, thông tin chi tiết của mẫu có thể được chỉnh sửa, hoặc mẫu có thể bị xóa thông qua trang Thư viện mẫu. Quản trị viên và người dùng quản lý mẫu (OVERLEAF_TEMPLATES_USER_ID) có thể quản lý bất kỳ mẫu nào.

Dưới đây là một ví dụ:

#################
#   TEMPLATES   #
#################

ENABLE_CONVERSIONS=true

OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter

TEMPLATE_ACADEMIC_JOURNAL_NAME=Journal articles
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Templates for academic journal submissions, including formats for major publishers and preprint servers.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Styles for creating and managing bibliographies with BibTeX or BibLaTeX. Suitable for use in academic papers, theses, and reports.

TEMPLATE_BOOK_NAME=Books
TEMPLATE_BOOK_DESCRIPTION=Templates for writing books or long-form documents, including chapter structuring, front matter, and indexing.

TEMPLATE_CALENDAR_NAME=Calendars
TEMPLATE_CALENDAR_DESCRIPTION=Templates to create yearly, monthly, or weekly calendars. Useful for personal planners or event scheduling.

TEMPLATE_CV_NAME=CVs and résumés
TEMPLATE_CV_DESCRIPTION=Templates for CVs and résumés with various formats for academic, industry, and creative positions.

TEMPLATE_FORMAL_LETTER_NAME=Formal letters
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Templates for professional letters, such as cover letters, recommendation letters, and official correspondence.

TEMPLATE_HOMEWORK_NAME=Assignments
TEMPLATE_HOMEWORK_DESCRIPTION=Templates for homework, coursework, and problem sets. Designed to be clean and well-structured for students and educators.

TEMPLATE_NEWSLETTER_NAME=Newsletters
TEMPLATE_NEWSLETTER_DESCRIPTION=Templates for creating newsletters with formats for academic, corporate, or community communications.

TEMPLATE_POSTER_NAME=Posters
TEMPLATE_POSTER_DESCRIPTION=Templates for scientific and academic posters, typically used in conferences and research presentations.

TEMPLATE_PRESENTATION_NAME=Presentations
TEMPLATE_PRESENTATION_DESCRIPTION=Templates for Beamer and other presentation formats, tailored for academic talks and lectures.

TEMPLATE_REPORT_NAME=Reports
TEMPLATE_REPORT_DESCRIPTION=Templates for technical, lab, or project reports. Includes sections for figures, tables, and references.

TEMPLATE_THESIS_NAME=Theses
TEMPLATE_THESIS_DESCRIPTION=Templates for writing theses and dissertations, following institutional formatting and citation guidelines.

TEMPLATE_ALL_NAME=All templates
TEMPLATE_ALL_DESCRIPTION=Browse a collection of all available LaTeX templates, categorized by document type, style, and purpose.

​

Chuyển mẫu từ overleaf.com

Vì Overleaf Pro được thiết kế để hoạt động ngoại tuyến, không có cách tự động nào để tích hợp các mẫu trong thư viện của overleaf.com vào bản cài đặt tại chỗ của bạn, tuy nhiên có thể thực hiện thủ công cho từng mẫu.

Theo mặc định, Overleaf Pro được cấu hình để dùng phiên bản TeXLive với scheme cơ bản cho việc biên dịch. Phiên bản cơ bản này nhẹ và chỉ chứa một tập hợp rất hạn chế các gói LaTeX, điều này rất có thể sẽ dẫn đến lỗi thiếu gói cho người dùng khi họ cố gắng dùng các mẫu từ overleaf.com trên phiên bản tại chỗ của bạn.

Đáng tiếc là không có cách tự động để cài đặt các gói còn thiếu, nhưng chúng tôi có một thiết lập có thể cấu hình trong Server Pro cho phép người dùng biên dịch dự án với quyền truy cập vào nhiều gói hơn và theo cách an toàn hơn. Tính năng này được gọi là Sandbox Compiles (còn được gọi là Sibling Containers).

Để đảm bảo các mẫu đã tải xuống tương thích với phiên bản Server Pro tại chỗ của bạn, chúng tôi đặc biệt khuyến nghị bạn bật Sandbox Compiles, vì tính năng này sẽ cung cấp cho người dùng quyền truy cập vào cùng môi trường TeX Live như trên overleaf.com. Các image này chứa những gói và phông chữ phổ biến nhất và đã được kiểm thử với các mẫu trong thư viện của chúng tôi.

Bạn có thể tìm thêm thông tin về cách cấu hình các phiên bản TeX Live mà người dùng có thể chọn trong dự án của họ, cũng như cách đặt phiên bản image TeX Live mặc định cho các dự án mới, trong phần Changing the TeX Live Image của tài liệu.

1. Truy cập Template Gallery trên overleaf.com và tìm mẫu cần dùng, ví dụ IEEE Photonics Journal Paper Template - Example Submission
2. Nhấp vào nút Open as Template
3. Nhấp vào menu dự án và chọn Download Source
4. Tiếp theo, đăng nhập vào tài khoản Server Pro tại chỗ
5. Nhấp vào nút New Project trên bảng điều khiển dự án và chọn Upload Project
6. Nhấp vào nút Select a .zip file và chọn tệp zip mẫu đã tải xuống

Sau đó, người dùng có thể sử dụng mẫu vừa tải lên này trong tài khoản của riêng mình, hoặc với tư cách người dùng quản lý mẫu, bạn có thể xuất bản nó để người dùng khác sử dụng.

​

Hỏi & Đáp

Tôi có thể xóa dự án sau khi đã xuất bản mẫu tương ứng không?

Trả lời: Có, nhưng chúng tôi không khuyến khích làm vậy. Khi bạn xuất bản một mẫu, chúng tôi chụp một bản snapshot của dự án và lưu dự án dưới dạng tệp zip tại thời điểm xuất bản. Điều này đảm bảo rằng ngay cả khi bạn xóa dự án tương ứng với mẫu, mẫu cũng sẽ không bị ảnh hưởng.

Tuy nhiên, chúng tôi cũng ghi lại ProjectID liên kết với mẫu này, giúp bạn dễ dàng cập nhật mẫu trong tương lai.

Nếu bạn xóa dự án tương ứng, bạn sẽ không thấy nút “Admin: Source Project” trên trang chi tiết mẫu (xem hình dưới đây).

Với một số dự án, tại sao việc phát hành mẫu lại mất nhiều thời gian như vậy?

Trả lời: Khi bạn xuất bản mẫu, chúng tôi lưu dự án dưới dạng tệp zip và tệp pdf, việc này thường diễn ra nhanh. Tuy nhiên, chúng tôi cũng cần tạo ảnh thu nhỏ cho PDF để có thể hiển thị trong trang chi tiết mẫu.

Thời gian tạo ảnh thu nhỏ thường phụ thuộc vào nội dung trang đầu tiên của PDF. Để cân bằng giữa chất lượng hiển thị và thời gian chuyển đổi, chúng tôi chọn một độ rộng ở mức trung bình.

Tuy nhiên, nếu trang đầu tiên của PDF chứa nhiều văn bản, việc chuyển đổi ảnh thu nhỏ có thể mất 40 giây hoặc thậm chí lâu hơn, vui lòng kiên nhẫn. Dưới đây là ví dụ về một poster lớn, nó sẽ mất nhiều thời gian hơn.

Một poster lớn