> 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/pt/configuracao/overleaf-toolkit/templates.md).
# Modelos
{% hint style="info" %}
Esta funcionalidade foi inicialmente desenvolvida por [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), e modificada e otimizada por [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}
{% columns %}
{% column %}
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
### Configuração
A funcionalidade da 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 em branco, de zero ou mais chaves de categoria de modelo. As chaves válidas incluem:
* *`academic-journal`*
* *`book`*
* *`presentation`*
* *`poster`*
* *`cv`*
* *`homework`*
* *`bibliography`*
* *`calendar`*
* *`formal-letter`*
* *`report`*
* *`thesis`*
* *`newsletter`*
A chave especial *`all`* é automaticamente acrescentada. 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 apresentado da categoria do modelo.
* `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`: Deve 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 um utilizador não administrador para gerir os modelos selecionados mostrados na sua galeria local em `/templates`.
Para isso, terá de definir a variável de ambiente `OVERLEAF_TEMPLATES_USER_ID` em `toolkit/config/variables.env` para o `ID` do utilizador que será responsável pela gestão dos modelos na sua instância, por exemplo:
```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```
### Publicar Modelos
Para cada modelo que pretende carregar:
1. Crie um projeto que contenha o código-fonte do modelo e certifique-se de que compila.
2. No menu do lado esquerdo 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 a submissão, 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é-publicação.
TEMPLATE_BIBLIOGRAPHY_NAME=Bibliografias
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Estilos para criar e gerir bibliografias com BibTeX ou BibLaTeX. Adequados para uso em artigos académicos, teses e relatórios.
TEMPLATE_BOOK_NAME=Livros
TEMPLATE_BOOK_DESCRIPTION=Modelos para escrever livros ou documentos extensos, incluindo estruturação de capítulos, páginas iniciais e indexação.
TEMPLATE_CALENDAR_NAME=Calendários
TEMPLATE_CALENDAR_DESCRIPTION=Modelos para criar calendários anuais, mensais ou semanais. Úteis para planeadores 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 funçõ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 limpos e bem estruturados para estudantes e educadores.
TEMPLATE_NEWSLETTER_NAME=Boletins informativos
TEMPLATE_NEWSLETTER_DESCRIPTION=Modelos para criar boletins informativos com formatos para comunicações académicas, empresariais ou comunitárias.
TEMPLATE_POSTER_NAME=Posters
TEMPLATE_POSTER_DESCRIPTION=Modelos para posters científicos e académicos, normalmente utilizados 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 para palestras e aulas académicas.
TEMPLATE_REPORT_NAME=Relatórios
TEMPLATE_REPORT_DESCRIPTION=Modelos para relatórios técnicos, de laboratório ou de projeto. Incluem secções para figuras, tabelas e referências.
TEMPLATE_THESIS_NAME=Teses
TEMPLATE_THESIS_DESCRIPTION=Modelos para escrever teses e dissertações, seguindo as diretrizes institucionais de formatação e citação.
TEMPLATE_ALL_NAME=Todos os modelos
TEMPLATE_ALL_DESCRIPTION=Explore uma coleção de todos os modelos LaTeX disponíveis, categorizados por tipo de documento, estilo e finalidade.
```
{% endcode %}
### Transferir modelos de overleaf.com
Como o Overleaf Pro foi arquitetado 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, no entanto é possível fazê-lo manualmente, modelo a modelo.
Por defeito, o Overleaf Pro está configurado para usar uma versão básica do TeXLive para 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 os 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 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 Server Pro on-premise, recomendamos vivamente que ative [Compilações 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 existente em [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ções adicionais sobre como configurar as versões do TeX Live que os utilizadores podem escolher dentro do respetivo projeto, juntamente com a definição da versão predefinida da imagem 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 necessário, por exemplo [IEEE Photonics Journal Paper Template - Example Submission](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 **Descarregar Código-Fonte**
4. Em seguida, inicie sessão na conta Server Pro on-premise
5. Clique no **Novo Projeto** botão no painel de projetos e escolha **Carregar Projeto**
6. Clique no **Selecione um ficheiro .zip** 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 dos modelos, pode publicá-lo para que outros utilizadores o usem.
### Perguntas e Respostas
Posso eliminar o projeto depois de publicar o modelo correspondente?
**Resposta:** Sim, mas não o recomendamos. Quando publica um modelo, tiramos uma captura 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 sua atualização futura.
Se eliminar o projeto correspondente, não verá o botão "Admin: Source Project" na página de detalhes do modelo (ver imagem abaixo).
Em alguns projetos, por que é que publicar 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 das miniaturas depende normalmente do conteúdo da primeira página do seu PDF. Para equilibrar a qualidade de apresentaçã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; tenha paciência. Aqui está um exemplo de um poster grande, vai demorar mais tempo.
Um poster 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://ayakaleaf-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.