> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ja/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 %}

<figure><img src="/files/949aa3cbd803a97f451ab584e48618925404192e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/479b32a159a80631f7fd31b124e93d58eaccd5f1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### 設定

Template Gallery 機能は、以下の環境変数で制御されます:

* `OVERLEAF_TEMPLATE_GALLERY`: 次のように設定します `true` Template Gallery を有効にします。
* `OVERLEAF_TEMPLATE_CATEGORIES`: 0 個以上のテンプレートカテゴリキーを、空白区切りで任意に指定したリストです。有効なキーには以下が含まれます:

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

  特別なキー *`all`* は自動的に追加されます。このキーは、すべてのテンプレートを含むカテゴリを表します。

  各カテゴリキーに対して、以下の任意の環境変数を設定できます:

  * `TEMPLATE_<KEY>_NAME`: テンプレートカテゴリの表示名。
  * `TEMPLATE_<KEY>_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 形式のリンクを受け付けます。

送信後、テンプレートの詳細は編集でき、または Template Gallery ページからテンプレートを削除できます。ユーザーは自分のテンプレートを管理でき、管理者は任意のテンプレートを管理できます。

例を示します:

{% 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 からテンプレートを移行する <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

Overleaf Pro はオフラインで動作するよう設計されているため、 [overleaf.com](https://www.overleaf.com/) ギャラリーテンプレートをオンプレミス環境に統合する自動的な方法はありませんが、テンプレートごとに手動で行うことは可能です。

既定では、Overleaf Pro はコンパイル用に TeXLive の基本スキーム版を使用するよう設定されています。この基本版は軽量で、LaTeX パッケージのごく限られた一部しか含まれていないため、 [overleaf.com](https://www.overleaf.com/) ローカルのオンプレミスインスタンス上で

残念ながら、不足しているパッケージを自動的にインストールする方法はありませんが、Server Pro には、ユーザーがより多くのパッケージにアクセスしながら、より安全な方法でプロジェクトをコンパイルできるようにする設定可能な機能があります。この機能は [サンドボックスコンパイル](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) （Sibling Containers とも呼ばれます）。

ダウンロードしたテンプレートがオンプレミスの Server Pro インスタンスと互換性があるようにするため、 [サンドボックスコンパイル](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) この機能により、ユーザーは同じ TeX Live 環境を利用できるようになるため、 [overleaf.com](https://www.overleaf.com/)。これらのイメージには最も一般的なパッケージとフォントが含まれており、すでに当社のギャラリーテンプレートでテスト済みです。

ユーザーがプロジェクト内で選択できる 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. 次に移動します [Template Gallery](https://www.overleaf.com/latex/templates) の [overleaf.com](https://www.overleaf.com/) 必要なテンプレートを探します。たとえば [IEEE Photonics Journal 論文テンプレート - 例の提出](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. クリックしてください **テンプレートとして開く** ボタン
3. プロジェクトメニューをクリックし、次を選択します **ソースをダウンロード**
4. 次に、オンプレミスの Server Pro アカウントにログインします
5. クリックしてください **新規プロジェクト** プロジェクトダッシュボードのボタンをクリックし、次を選択します **プロジェクトをアップロード**
6. クリックしてください **.zip ファイルを選択** ボタンをクリックし、ダウンロードしたテンプレートの zip ファイルを選択します

その後、ユーザーはこの新しくアップロードされたテンプレートを自分のアカウント内で使用できますし、テンプレート担当ユーザーとして、他のユーザーが使用できるよう公開することもできます。

### Q\&A

<details>

<summary>対応するテンプレートを公開した後、そのプロジェクトを削除できますか？</summary>

**回答:** はい、ただし推奨しません。テンプレートを公開すると、プロジェクトのスナップショットを取得し、公開時点のプロジェクトを zip ファイルとして保存します。これにより、テンプレートに対応するプロジェクトを削除しても、テンプレートには影響しません。

ただし、このテンプレートに関連付けられた ProjectID も記録されるため、将来テンプレートを更新しやすくなります。

対応するプロジェクトを削除すると、テンプレート詳細ページで「Admin: Source Project」ボタンが表示されなくなります（下の画像を参照）。

<figure><img src="/files/5ac2f2b35f20c80304af8f2be48393c421d52cc2" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>いくつかのプロジェクトでは、なぜテンプレートの公開にこれほど時間がかかるのですか？</summary>

**回答:** テンプレートを公開すると、プロジェクトを zip と pdf ファイルとして保存します。通常これはすぐに完了します。ただし、テンプレート詳細に表示するために PDF のサムネイルも生成する必要があります。

サムネイルの生成時間は通常、PDF の 1 ページ目の内容に左右されます。表示品質と変換時間のバランスを取るため、幅として中間の値を選択します。

ただし、PDF の1ページ目に大量のテキストが含まれている場合、サムネイルの変換に 40 秒、あるいはそれ以上かかることがあります。しばらくお待ちください。大きなポスターの例では、さらに時間がかかります。

<figure><img src="/files/7dc8b5b5fcc15ab2a982c8639a47c1d7cb8bcc0a" alt="" width="188"><figcaption><p>大きなポスター</p></figcaption></figure>

</details>


---

# 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://ayakaleaf-pro.ayaka.space/on-premises/ja/she-ding/overleaf-toolkit/templates.md?ask=<question>&goal=<endgoal>
```

`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.
