> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/zh-tw/she-ding/overleaf-toolkit/templates.md). # 範本 {% hint style="info" %} 此功能最初由 [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep)，並由 [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro). {% endhint %} {% columns %} {% column %}
{% endcolumn %} {% column %}
{% endcolumn %} {% endcolumns %} ### 設定 模板圖庫功能由下列環境變數控制： * `OVERLEAF_TEMPLATE_GALLERY`：設為 `true` 即可啟用模板圖庫。 * `OVERLEAF_TEMPLATE_CATEGORIES`：可選的空白分隔清單，內容為零個或多個模板分類鍵。有效鍵包括： * *`學術期刊`* * *`書籍`* * *`簡報`* * *`海報`* * *`履歷`* * *`作業`* * *`參考書目`* * *`行事曆`* * *`正式信函`* * *`報告`* * *`論文`* * *`電子報`* 特殊鍵 *`全部`* 會自動附加。此鍵代表包含所有模板的分類。 針對每個分類鍵，可設定下列可選的環境變數： * `TEMPLATE__NAME`：模板分類的顯示名稱。 * `TEMPLATE__DESCRIPTION`：分類的簡短描述。 如果分類鍵包含連字號（`-`），請在環境變數名稱中將其替換為底線（`_`）。 * `ENABLE_CONVERSIONS`：必須設為 `true` ，才能為模板啟用縮圖與預覽產生。 ### 發布權限 管理員可以發布模板。你也可以指派一位非管理員使用者來管理在你的本機圖庫中顯示的精選模板，位於 `/templates`. 若要這麼做，你需要將環境變數 `OVERLEAF_TEMPLATES_USER_ID` 在 `toolkit/config/variables.env` 中設為 `ID` ，也就是在你的執行個體中負責模板管理的使用者，例如： ```dotenv OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959 ``` ### 發布模板 對於每個你要上傳的模板： 1. 建立一個包含模板原始碼的專案，並確認它可以成功編譯。 2. 在編輯器左側選單中，選擇 **發佈為範本**. 3. 在出現的表單中，輸入模板詳細資料： * 該 *標題* 必須是唯一的。 * 該 *描述* 欄位支援 Markdown 格式。 * 該 *作者* 欄位可接受 Markdown 格式的連結。 提交後，可在模板圖庫頁面編輯模板詳細資料，或刪除模板。使用者可以管理自己的模板；管理員可以管理任何模板。 以下是一個範例： {% code overflow="wrap" expandable="true" %} ```dotenv ################# # 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=期刊文章 TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=學術期刊投稿用模板，包含主要出版社與預印本伺服器的格式。 TEMPLATE_BIBLIOGRAPHY_NAME=參考書目 TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=使用 BibTeX 或 BibLaTeX 建立與管理參考書目的樣式。適合用於學術論文、學位論文與報告。 TEMPLATE_BOOK_NAME=書籍 TEMPLATE_BOOK_DESCRIPTION=用於撰寫書籍或長篇文件的模板，包含章節結構、前置內容與索引。 TEMPLATE_CALENDAR_NAME=行事曆 TEMPLATE_CALENDAR_DESCRIPTION=用於建立年度、月度或週度行事曆的模板。適合個人規劃或活動排程。 TEMPLATE_CV_NAME=CV 與履歷 TEMPLATE_CV_DESCRIPTION=提供學術、業界與創意職位等各種格式的 CV 與履歷模板。 TEMPLATE_FORMAL_LETTER_NAME=正式信函 TEMPLATE_FORMAL_LETTER_DESCRIPTION=用於專業信件的模板，例如求職信、推薦信與正式往來函件。 TEMPLATE_HOMEWORK_NAME=作業 TEMPLATE_HOMEWORK_DESCRIPTION=用於作業、課程作業與習題集的模板。設計得簡潔且結構清楚，適合學生與教育者使用。 TEMPLATE_NEWSLETTER_NAME=電子報 TEMPLATE_NEWSLETTER_DESCRIPTION=用於製作電子報的模板，適合學術、企業或社群溝通格式。 TEMPLATE_POSTER_NAME=海報 TEMPLATE_POSTER_DESCRIPTION=用於科學與學術海報的模板，通常用於研討會與研究簡報。 TEMPLATE_PRESENTATION_NAME=簡報 TEMPLATE_PRESENTATION_DESCRIPTION=用於 Beamer 與其他簡報格式的模板，針對學術演講與授課情境設計。 TEMPLATE_REPORT_NAME=報告 TEMPLATE_REPORT_DESCRIPTION=用於技術報告、實驗報告或專案報告的模板。包含圖表與參考資料等區段。 TEMPLATE_THESIS_NAME=論文 TEMPLATE_THESIS_DESCRIPTION=用於撰寫學位論文與博士論文的模板，遵循機構格式與引用指引。 TEMPLATE_ALL_NAME=所有模板 TEMPLATE_ALL_DESCRIPTION=瀏覽所有可用 LaTeX 模板的集合，並依文件類型、風格與用途分類。 ``` {% endcode %} ### 從 overleaf.com 轉移模板 由於 Overleaf Pro 的架構是為離線運作而設計，因此沒有自動化方式可以整合 [overleaf.com](https://www.overleaf.com/) 圖庫模板到你的內部部署安裝中，不過可以針對每個模板手動進行。 預設情況下，Overleaf Pro 會設定使用基本版的 TeX Live 方案來進行編譯。此基本版本相當輕量，且只包含極少數的 LaTeX 套件子集，因此當使用者嘗試使用來自 [overleaf.com](https://www.overleaf.com/) 在你本機內部部署執行個體中的模板時，很可能會出現缺少套件的錯誤。 很遺憾，雖然沒有自動安裝缺少套件的方法，但 Server Pro 中有一項可設定的選項，能讓使用者在更安全的方式下編譯專案，並存取更多套件。這項功能稱為 [沙箱編譯](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) （亦稱為同層容器）。 為了確保下載的模板與你的內部部署 Server Pro 執行個體相容，我們強烈建議你啟用 [沙箱編譯](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) ，因為此功能將讓你的使用者能存取與 [overleaf.com](https://www.overleaf.com/)相同的 TeX Live 環境。這些映像檔包含最常用的套件與字型，並且已針對我們的圖庫模板進行測試。 如需更多關於設定使用者可在專案中選擇哪些 TeX Live 版本，以及為新專案設定預設 TeX Live 映像版本的資訊，請參閱我們文件中的 [變更 TeX Live 映像](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) 章節。 1. 前往 [模板圖庫](https://www.overleaf.com/latex/templates) 中的 [overleaf.com](https://www.overleaf.com/) 並找到所需的模板，例如 [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds) 2. 點擊 **以範本開啟** 按鈕 3. 點擊專案選單並選擇 **下載原始碼** 4. 接著，登入內部部署的 Server Pro 帳號 5. 點擊 **新增專案** 按鈕，然後選擇 **上傳專案** 6. 點擊 **.zip 檔案選擇** 按鈕，並選擇已下載的模板 zip 檔 接著，使用者就可以在自己的帳號中使用這個新上傳的模板；或者，身為模板使用者，你也可以將其發布給其他使用者使用。 ### 問答
在發布對應模板之後，我可以刪除專案嗎？ **答案：** 可以，但我們不建議這麼做。當你發布模板時，我們會擷取專案快照，並將發布當下的專案儲存為 zip 檔。這可確保即使你刪除了對應模板的專案，模板也不會受到影響。 不過，我們也會記錄與此模板相關聯的 ProjectID，這可讓你日後更容易更新模板。 如果你刪除了對應的專案，在模板詳細資料頁面上就不會看到「Admin: Source Project」按鈕（請見下圖）。
為什麼有些專案發布模板需要這麼久？ **答案：** 當你發布模板時，我們會將專案儲存為 zip 與 pdf 檔，通常這很快。不過，我們也需要為 PDF 產生縮圖，才能在模板詳細資料中顯示。 縮圖產生時間通常取決於 PDF 第一頁的內容。為了在顯示品質與轉換時間之間取得平衡，我們會選擇中等寬度。 不過，如果 PDF 的第一頁包含大量文字，轉換縮圖可能需要 40 秒甚至更久，請耐心等候。以下是一個大型海報的範例，會花更久時間。

大型海報

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/zh-tw/she-ding/overleaf-toolkit/templates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.