> 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/pt/configuracao/overleaf-toolkit/templates.md).
# Modelos
{% hint style="info" %}
Este recurso é inicialmente desenvolvido por [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), e modificado e otimizado por [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}
{% columns %}
{% column %}
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
### Configuração
A funcionalidade Galeria de Modelos é controlada através das seguintes variáveis de ambiente:
* `OVERLEAF_TEMPLATE_GALLERY`: Defina como `true` para ativar a Galeria de Modelos.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Uma lista opcional separada por espaços de zero ou mais chaves de categorias de modelos. As chaves válidas incluem:
* *`academic-journal`*
* *`book`*
* *`presentation`*
* *`poster`*
* *`cv`*
* *`homework`*
* *`bibliography`*
* *`calendar`*
* *`formal-letter`*
* *`report`*
* *`thesis`*
* *`newsletter`*
A chave especial *`all`* é anexada automaticamente. Esta chave representa uma categoria que inclui todos os modelos.
Para cada chave de categoria, podem ser definidas as seguintes variáveis de ambiente opcionais:
* `TEMPLATE__NAME`: O nome de exibição da categoria de modelos.
* `TEMPLATE__DESCRIPTION`: Uma breve descrição da categoria.
Se uma chave de categoria contiver um hífen (`-`), substitua-o por um sublinhado (`_`) nos nomes das variáveis de ambiente.
* `ENABLE_CONVERSIONS`: Tem de ser definido como `true` para ativar a geração de miniaturas e pré-visualizações para os modelos.
### Permissões para Publicação
Os administradores podem publicar modelos. Também pode atribuir a um utilizador não administrador a gestão dos modelos selecionados mostrados na sua galeria local em `/templates`.
Para isso, precisará de definir a variável de ambiente `OVERLEAF_TEMPLATES_USER_ID` em `toolkit/config/variables.env` com o `ID` do utilizador que será responsável pela gestão de modelos na sua instância, por exemplo:
```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```
### Publicar Modelos
Para cada modelo que pretende enviar:
1. Crie um projeto que contenha o código-fonte do modelo e certifique-se de que compila.
2. No menu à esquerda do editor, escolha **Publicar como Modelo**.
3. No formulário que aparece, introduza os detalhes do modelo:
* O *Título* tem de ser único.
* O *Descrição* campo suporta formatação Markdown.
* O *Autor* campo aceita ligações formatadas em Markdown.
Após o envio, os detalhes do modelo podem ser editados, ou o modelo pode ser eliminado através da página da Galeria de Modelos. Os utilizadores podem gerir os seus próprios modelos; os administradores podem gerir qualquer modelo.
Aqui está um exemplo:
{% code overflow="wrap" expandable="true" %}
```dotenv
#################
# MODELOS #
#################
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=Artigos de revista
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Modelos para submissões a revistas académicas, incluindo formatos para grandes editoras e servidores de pré-impressão.
TEMPLATE_BIBLIOGRAPHY_NAME=Bibliografias
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Estilos para criar e gerir bibliografias com BibTeX ou BibLaTeX. Adequado para uso em artigos académicos, teses e relatórios.
TEMPLATE_BOOK_NAME=Livros
TEMPLATE_BOOK_DESCRIPTION=Modelos para escrever livros ou documentos longos, incluindo estruturação de capítulos, elementos pré-textuais e indexação.
TEMPLATE_CALENDAR_NAME=Calendários
TEMPLATE_CALENDAR_DESCRIPTION=Modelos para criar calendários anuais, mensais ou semanais. Úteis para planificadores pessoais ou agendamento de eventos.
TEMPLATE_CV_NAME=CVs e currículos
TEMPLATE_CV_DESCRIPTION=Modelos para CVs e currículos com vários formatos para posições académicas, industriais e criativas.
TEMPLATE_FORMAL_LETTER_NAME=Cartas formais
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Modelos para cartas profissionais, como cartas de apresentação, cartas de recomendação e correspondência oficial.
TEMPLATE_HOMEWORK_NAME=Trabalhos
TEMPLATE_HOMEWORK_DESCRIPTION=Modelos para trabalhos de casa, trabalhos curriculares e conjuntos de problemas. Concebidos para serem claros e bem estruturados para estudantes e educadores.
TEMPLATE_NEWSLETTER_NAME=Newsletters
TEMPLATE_NEWSLETTER_DESCRIPTION=Modelos para criar newsletters com formatos para comunicações académicas, empresariais ou comunitárias.
TEMPLATE_POSTER_NAME=Cartazes
TEMPLATE_POSTER_DESCRIPTION=Modelos para cartazes científicos e académicos, normalmente usados em conferências e apresentações de investigação.
TEMPLATE_PRESENTATION_NAME=Apresentações
TEMPLATE_PRESENTATION_DESCRIPTION=Modelos para Beamer e outros formatos de apresentação, adaptados a palestras e aulas académicas.
TEMPLATE_REPORT_NAME=Relatórios
TEMPLATE_REPORT_DESCRIPTION=Modelos para relatórios técnicos, laboratoriais ou de projetos. Inclui secções para figuras, tabelas e referências.
TEMPLATE_THESIS_NAME=Teses
TEMPLATE_THESIS_DESCRIPTION=Modelos para escrever teses e dissertações, seguindo as normas institucionais de formatação e citação.
TEMPLATE_ALL_NAME=Todos os modelos
TEMPLATE_ALL_DESCRIPTION=Navegue por uma coleção de todos os modelos LaTeX disponíveis, categorizados por tipo de documento, estilo e finalidade.
```
{% endcode %}
### Transferência de modelos de overleaf.com
Como o Overleaf Pro foi concebido para funcionar offline, não existe uma forma automatizada de integrar [overleaf.com](https://www.overleaf.com/) os modelos da galeria na sua instalação local; contudo, é possível fazê-lo manualmente, modelo a modelo.
Por predefinição, o Overleaf Pro está configurado para usar uma versão básica do esquema do TeX Live para as compilações. Esta versão básica é leve e contém apenas um subconjunto muito limitado de pacotes LaTeX, o que muito provavelmente resultará em erros de pacotes em falta para os seus utilizadores ao tentarem usar modelos de [overleaf.com](https://www.overleaf.com/) na sua instância local on-premise.
Infelizmente, embora não exista uma forma automática de instalar pacotes em falta, temos uma definição configurável no Server Pro que permitirá aos seus utilizadores compilar projetos com acesso a mais pacotes, e de uma forma mais segura. Esta funcionalidade chama-se [Compilações em Sandbox](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (também conhecidas como Contentores Irmãos).
Para garantir que os modelos transferidos são compatíveis com a sua instância local do Server Pro, recomendamos vivamente que ative [Compilações em Sandbox](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) uma vez que esta funcionalidade dará aos seus utilizadores acesso ao mesmo ambiente TeX Live que o do [overleaf.com](https://www.overleaf.com/). Estas imagens contêm os pacotes e tipos de letra mais populares e já foram testadas com os nossos modelos da galeria.
Pode encontrar informação adicional sobre como configurar as versões do TeX Live que os utilizadores podem escolher dentro do seu projeto, bem como definir a versão padrão da imagem do TeX Live para novos projetos na [Alterar a imagem do TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) secção da nossa documentação.
1. Navegue até à [Galeria de Modelos](https://www.overleaf.com/latex/templates) em [overleaf.com](https://www.overleaf.com/) e localize o modelo pretendido, por exemplo [Modelo de Artigo da IEEE Photonics Journal - Submissão de Exemplo](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Clique no **Abrir como Modelo** botão
3. Clique no menu do projeto e escolha **Transferir Código-Fonte**
4. De seguida, inicie sessão na conta Server Pro local
5. Clique no **Novo Projeto** botão no painel de projetos e escolha **Carregar Projeto**
6. Clique no **Selecione um ficheiro .zip** botão e escolha o ficheiro zip do modelo transferido
O utilizador pode então usar este modelo recém-carregado na sua própria conta ou, como utilizador de modelos, pode publicá-lo para que outros utilizadores o usem.
### Perguntas e Respostas
Posso eliminar o projeto após publicar o modelo correspondente?
**Resposta:** Sim, mas não recomendamos fazê-lo. Quando publica um modelo, tiramos uma instantânea do projeto e guardamos o projeto como um ficheiro zip no momento da publicação. Isto garante que, mesmo que elimine o projeto correspondente ao modelo, o modelo não será afetado.
No entanto, também registaremos o ProjectID associado a este modelo, o que facilita a atualização do modelo no futuro.
Se eliminar o projeto correspondente, não verá o botão "Admin: Projeto-fonte" na página de detalhes do modelo (veja a imagem abaixo).
Em alguns projetos, por que motivo a publicação de um modelo demora tanto tempo?
**Resposta:** Quando publica o modelo, guardamos o projeto como um ficheiro zip e um ficheiro pdf, o que normalmente é rápido. No entanto, também precisamos de gerar miniaturas para o PDF para que possam ser apresentadas nos detalhes do modelo.
O tempo de geração de miniaturas depende normalmente do conteúdo da primeira página do seu PDF. Para equilibrar a qualidade de exibição e o tempo de conversão, escolhemos um valor intermédio para a largura.
No entanto, se a primeira página do PDF contiver muito texto, a conversão das miniaturas pode demorar 40 segundos ou até mais; por favor, tenha paciência. Aqui está um exemplo de um cartaz grande, que demorará mais tempo.
Um cartaz grande
---
# 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/pt/configuracao/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.