> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar ajuda de LaTeX para usuários

> Disponibilize páginas de ajuda de LaTeX de um site MediaWiki em /learn em uma implantação Kubernetes.

As páginas de `/learn` são servidas pelo serviço **web** (o módulo `learn`) de cada pod do Ayakaleaf Pro, a partir de um cache da wiki definida em `WIKI_URL`. O que o módulo faz e quais wikis funcionam está descrito em [Adicionar ajuda de LaTeX para usuários](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/adding-latex-user-help.md).

| | |
| - | - |
| Serviço | web (módulo `learn`), em cada pod do Ayakaleaf Pro |
| Pod → exterior | `WIKI_URL` (padrão `https://learnwiki.overleaf.com`): todas as páginas na primeira inicialização e, depois, uma página novamente quando um usuário a abre após `WIKI_MAX_CACHE_AGE` |
| Navegador → exterior | imagens das páginas, diretamente de `WIKI_URL` |
| Dados armazenados | o cache de páginas em `/var/lib/overleaf/data/learnPages` no volume de dados |
| Tarefas periódicas | nenhuma: as páginas são atualizadas quando os usuários as abrem |

### Configuração

```yaml title="30-config.yaml (additions)" theme={null}
  OVERLEAF_PROXY_LEARN: "true"
  # optional: your own MediaWiki
  # WIKI_URL: https://wiki.example.com
```

```bash theme={null}
kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
kubectl -n overleaf rollout status deployment/overleaf --timeout=30m
```

> [!WARNING]
>
> Na primeira inicialização com o módulo ativado, o serviço web baixa a wiki inteira antes de aceitar requisições, o que leva vários minutos. Até lá, o pod permanece não pronto, então leve isso em conta no `rollout status --timeout` e em qualquer probe de inicialização ou de liveness que você adicionar. As inicializações seguintes reutilizam o cache no volume de dados.

Na primeira inicialização, antes de existir um cache, os pods precisam alcançar `WIKI_URL`: sem isso, o serviço web falha ao iniciar e é reiniciado dentro do pod repetidamente, de modo que o pod nunca fica pronto. Desative o módulo ou permita que os pods acessem a wiki. Depois que o cache existir, os pods iniciam e servem as páginas em cache mesmo enquanto a wiki não puder ser alcançada.

### Várias réplicas

Cada réplica mantém seu próprio cache no disco do seu nó, então cada uma baixa a wiki na sua primeira inicialização; com `podManagementPolicy: OrderedReady`, elas fazem isso uma após a outra. Um usuário pode ver uma página em uma versão ligeiramente diferente em outra réplica até que ela seja atualizada lá.

### Testado no Kubernetes

No Kubernetes 1.37 com três réplicas atrás do HAProxy, cada uma baixando `https://learnwiki.overleaf.com` para o cache do seu próprio nó na primeira inicialização, nossos testes de ponta a ponta para `/learn` passam (12 casos): o link Documentation no cabeçalho, a mensagem de boas-vindas e o menu Help do editor, a barra lateral de conteúdo, páginas, links e redirecionamentos dentro da wiki, imagens carregadas da wiki, 404 para páginas desconhecidas, o login exigido sem acesso público e uma página desatualizada servida do cache após `WIKI_URL` ser alterada para um endereço que não pode ser alcançado. Começando com um cache vazio e `WIKI_URL` apontando para um endereço que recusa conexões, o pod permaneceu não pronto sem reiniciar, enquanto o serviço web dentro dele iniciou e falhou 77 vezes em três minutos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.