## Visão geral

A Central de Ajuda da ConversaLabs é o site público de conteúdo da sua conta. Cada **portal** tem
**categorias** e **artigos**, e cada artigo existe em um idioma — as traduções de um mesmo artigo
ficam ligadas entre si.

Este artigo cobre o trabalho de quem escreve: o **editor** (com o menu que abre ao digitar `/`), o
fluxo de **rascunho de alterações** em um artigo que já está no ar, a tela de **comparação** entre o
rascunho e a versão publicada, e as ferramentas das listas de administração — **busca** e
**reordenação por arrastar**.

O ponto central é este: em um artigo **publicado**, o que você digita **não vai direto para o ar**.
Ele fica guardado como rascunho até você publicar as alterações. Em um artigo em **Rascunho** ou
**Arquivado**, cada edição salva direto no registro, porque não há nada publicado para proteger.

## Pré-requisitos

- Acesso à Central de Ajuda (Portais) na conta, com permissão para criar e editar artigos.
- O autor do artigo precisa ser um usuário da própria conta. Um autor inválido é recusado na
  criação e simplesmente ignorado na edição.
- Para o artigo aparecer no site público ele precisa estar **Publicado**, ter **visibilidade
  pública** e estar em uma **categoria pública do mesmo portal e da mesma conta**.
- Um artigo publicado precisa ter **conteúdo**: o corpo vazio impede a publicação.
- Limite do corpo do artigo: **200.000 caracteres**.

## Passo a passo

### Criar um artigo

1. Abra a Central de Ajuda, escolha o portal e o idioma e clique em **Novo artigo**.
2. Digite o **título**. O artigo é criado ao sair do campo de título e nasce em **Rascunho**, com
   **você como autor**, na **categoria que estava aberta** (ou na primeira categoria do idioma) e
   já com visibilidade pública.
3. Escreva o corpo no editor. Ajuste **autor**, **categoria** e as **propriedades do artigo**
   (meta título, meta descrição e meta tags) nos controles abaixo do título.
4. Clique em **Publicar** quando o texto estiver pronto. Use **Pré-visualizar** para abrir o artigo
   como o leitor o verá.

### Escrever com o menu de barra (`/`)

1. No corpo do artigo, digite `/`. O menu de formatação abre no ponto do cursor.
2. Continue digitando para filtrar as opções pelo nome.
3. Navegue com **seta para baixo** / **seta para cima** (ou `Ctrl+N` / `Ctrl+P`) e confirme com
   **Enter**. Você também pode clicar na opção. **Esc** fecha o menu.

Opções disponíveis no editor de artigos: **Heading 1**, **Heading 2**, **Heading 3**, **Bold**,
**Italic**, **Strikethrough**, **Code**, **Bullet List**, **Ordered List**, **Table**, **Imagem**,
**Vídeo** e **Divisor**. Link, desfazer e refazer também estão habilitados.

- **Table** insere uma tabela de 3 colunas com uma linha de cabeçalho e uma linha de dados.
- **Divisor** insere uma linha horizontal e deixa o cursor logo depois dela.
- **Imagem** abre o seletor de arquivos do seu computador, que aceita **PNG, JPEG, JPG, GIF e
  WebP**.

### Inserir um vídeo

1. Digite `/`, escolha **Vídeo**.
2. Cole o link no campo **Cole o link de um vídeo** e confirme em **Incorporar**. O botão só fica
   disponível quando o link é reconhecido; **Cancelar** ou **Esc** fecham a caixa sem inserir nada.
3. Links compatíveis: **YouTube**, **Vimeo**, **Loom**, **Wistia**, **Arcade**, **Bunny**,
   **CodePen**, **GuideJar** e arquivos **.mp4**. Um link fora dessa lista é recusado com a
   mensagem "Este link de vídeo não parece ser compatível".
4. O editor guarda o endereço como um link no texto; o portal público é quem transforma esse link
   no player incorporado.

### Editar um artigo já publicado

1. Abra o artigo. O editor salva sozinho **500 ms depois da sua última tecla** — o cabeçalho mostra
   "Salvando..." e depois "Salvo".
2. Como o artigo está publicado, o texto vai para um **rascunho** e o site continua exibindo a
   versão anterior. O cabeçalho passa a exibir o selo **Alterações pendentes**, e o cartão do artigo
   na lista mostra **Edições não publicadas**.
3. Clique no selo **Alterações pendentes** para abrir o painel de comparação. O selo é um botão;
   passar o mouse sobre ele mostra a dica **Ver alterações não publicadas**.
4. Para colocar no ar, clique em **Publicar alterações**. Para jogar fora o rascunho e manter o
   texto que está no ar, abra o menu ao lado do botão e escolha **Descartar alterações**.

### Comparar o rascunho com a versão no ar

O painel lateral **Alterações não publicadas** mostra apenas o que mudou — se só o corpo mudou, o
bloco do título nem aparece:

- O **título** é comparado palavra por palavra; o que saiu aparece riscado e o que entrou aparece
  destacado.
- O **corpo** é comparado bloco a bloco (parágrafo, título, lista, bloco de código). Um bloco só
  aparece como alterado quando o resultado renderizado muda — reorganizar linhas em branco não
  gera diferença.
- Blocos de código cercados (por três crases ou três tis) e listas são tratados como um bloco só,
  para não aparecerem partidos ao meio.
- Um bloco que entrou aparece com marcador verde; um bloco que saiu aparece riscado, com marcador
  vermelho. A comparação decide pelo **HTML renderizado** em CommonMark — o mesmo dialeto do portal
  público —, e não pelo texto cru; é por isso que mexer só em espaçamento não gera diferença.
- Em textos muito grandes (acima de 2.000 blocos ou palavras de um dos lados) a comparação detalhada
  é abandonada: tudo o que está no ar aparece como removido e todo o rascunho aparece como
  adicionado.
- Tabelas são exibidas com as larguras de coluna que você definiu no editor.

## Configurações & opções

### Status do artigo

| Status | O que significa | Para onde vai o que você digita |
| --- | --- | --- |
| Rascunho | Não aparece no portal público. | Direto no registro do artigo. |
| Publicado | Aparece no portal público. | Para o rascunho de alterações, até você publicar. |
| Arquivado | Sai do portal; serve para marcar conteúdo obsoleto. | Direto no registro do artigo. |

A partir de **Publicado** o menu oferece **Arquivar** e **Rascunho**. A partir de **Arquivado**,
**Rascunho**. A partir de **Rascunho**, **Arquivar**. O botão **Publicar** fica desabilitado em um
artigo já publicado que não tenha alterações pendentes.

### Mudar o status com alterações pendentes

Se você mandar o artigo publicado para **Rascunho** ou **Arquivar** enquanto existe rascunho de
alterações — pelo menu do editor **ou** pelo menu do cartão na lista —, aparece a confirmação
**Alterações não publicadas** com duas saídas:

- **Aplicar alterações**: promove o rascunho para o texto do artigo e aplica o novo status.
- **Descartar alterações**: joga o rascunho fora e aplica o novo status.

Enquanto uma das duas ações está em andamento, a confirmação não fecha por **Esc** nem por clique
fora.

### Busca de artigos

- O campo **Pesquisar artigos...** fica no cabeçalho da lista e dispara **500 ms** depois que você
  para de digitar.
- O termo entra no endereço da página, então o resultado sobrevive a recarregar e pode ser
  compartilhado.
- A busca é feita no servidor sobre **título**, **descrição** e **conteúdo**, com peso maior para o
  título, e aceita começo de palavra.
- Sem resultado, a lista mostra "Nenhum artigo correspondente".

Na tela de **categorias** a busca é diferente: ela filtra as categorias já carregadas **pelo nome**.

### Abas, filtros e paginação

As abas **Todos os artigos**, **Minhas**, **Rascunho** e **Arquivado** trazem a contagem de cada
grupo. **Não existe aba "Publicado"**: para trabalhar com o que está no ar, fique em **Todos os
artigos** e use o rótulo de status de cada cartão. Há ainda filtro por **categoria** e por
**idioma**, e a lista pagina de **25 em 25**.

### Reordenar por arrastar

A ordem definida aqui é a ordem em que os artigos aparecem na categoria do portal.

- Arrastar só fica disponível **dentro de uma categoria**, com **mais de um artigo** (ou mais de uma
  página) e **sem busca ativa** nem seleção em massa.
- Pressione o cartão e arraste. O lugar de destino aparece como uma marca tracejada.
- Para levar um artigo para **outra página**, arraste até a borda esquerda ou direita da lista e
  segure: depois de cerca de **0,6 s** a página vira sozinha e você continua arrastando. Enquanto a
  borda está armada, ela acende e mostra uma seta — é um aviso de que a virada vai acontecer, não um
  botão para clicar.
- Perto do topo e do rodapé a lista rola sozinha enquanto você segura o cartão.
- **Esc** durante o arraste cancela a operação e nada é salvo.
- A nova posição aparece na hora e, se o servidor recusar, a ordem volta ao que era e surge a
  mensagem "Não foi possível reordenar os artigos. Por favor, tente novamente."
- Quando o servidor aceita, a lista adota as posições que ele devolveu, para que o próximo arraste
  não parta de um número desatualizado.

Categorias também podem ser reordenadas por arrastar na tela de categorias, e o arraste fica
desativado enquanto houver busca.

### Ações em massa

Selecione um ou mais cartões para abrir a barra de ações: **Publicar**, **Rascunho**, **Arquivar**,
**Categoria** (mover), **Traduzir** e **Excluir**.

- **Publicar** em massa também publica o rascunho de cada artigo que tiver alterações pendentes.
- **Rascunho** e **Arquivar** em massa **ignoram** os artigos com alterações pendentes e avisam
  quantos foram ignorados — abra cada um para publicar ou descartar. Se **todos** os selecionados
  tiverem edições não publicadas, nada é aplicado e aparece "Esses artigos têm edições não
  publicadas — abra cada um para publicar ou descartar."
- A seleção é limpa sozinha sempre que a lista muda (troca de página, de aba, de filtro ou de
  busca), então confira o que está marcado antes de disparar a ação.
- **Excluir** pede confirmação e é permanente.
- **Traduzir** só aparece em instalações Enterprise com o recurso **Captain Tasks**
  (`captain_tasks`) habilitado para a conta.
- O menu de cada cartão traz as mesmas mudanças de status e, quando há rascunho pendente, também
  **Descartar alterações**.

## Casos de uso

- **Corrigir um artigo que está no ar sem tirá-lo do ar**: edite à vontade, confira no painel de
  comparação e só então clique em **Publicar alterações**.
- **Revisão a quatro mãos**: quem escreve deixa o rascunho pronto e avisa; quem revisa abre o mesmo
  artigo, usa o painel de comparação e decide entre publicar ou descartar.
- **Reorganizar uma categoria**: entre na categoria, arraste os artigos para a ordem que o leitor
  deve encontrar e use o arraste até a borda para mover um artigo entre páginas.
- **Limpeza de conteúdo antigo**: em **Todos os artigos** (ou dentro de uma categoria), marque
  pelo rótulo de status os artigos vencidos e use **Arquivar** em massa.
- **Encontrar um trecho específico**: use a busca — ela também procura dentro do corpo do artigo,
  não só no título.

## Dicas, limites e boas práticas

- O salvamento automático envia **título e corpo juntos**, então editar um campo nunca descarta uma
  edição recente do outro.
- Um salvamento que só mexe no rascunho **não muda a data de atualização** do artigo. Essa data só
  avança quando algo é gravado no registro — publicar as alterações, trocar a categoria ou o autor.
- Se o rascunho voltar a ser igual ao que está no ar, ele é **descartado sozinho** e o selo de
  alterações pendentes desaparece — é o caso de desfazer uma edição ou de mexer só em espaçamento.
- Se você mandar um artigo publicado para **Rascunho** e depois editar, o rascunho antigo é
  promovido e limpo, para que uma publicação futura não ressuscite um texto velho.
- Sair do editor com um salvamento pendente **não perde a edição**: ela é enviada na saída.
- **Descartar alterações** não tem desfazer.
- Cada imagem enviada pelo editor precisa ter **menos de 4 MB**. Acima disso aparece "O tamanho da
  imagem deve ser menor que 4MB" e o arquivo não é enviado.
- Dentro de uma célula de tabela o menu `/` esconde títulos, listas, imagem, tabela, divisor e
  vídeo: uma célula de tabela em markdown só guarda conteúdo em linha, e o resto se perderia ao
  salvar.
- Os endereços `search`, `articles` e `categories` são reservados e não podem ser usados como
  endereço de um artigo.
- Dois artigos com a mesma posição não trocam de lugar sozinhos entre visitas: o desempate é
  estável.

## Solução de problemas

- **O botão Publicar está desabilitado.** O artigo já está publicado e não há alterações pendentes.
  Edite alguma coisa, ou use o menu ao lado para mudar o status.
- **Apareceu "Ainda salvando as alterações mais recentes".** Um salvamento automático está em
  andamento. Espere um instante e repita — publicar nesse momento colocaria no ar um texto
  desatualizado.
- **Publiquei, mas o artigo dá erro de página não encontrada no portal.** Confirme se a
  **categoria** do artigo é pública e pertence ao mesmo portal e conta. Artigos antigos, sem
  visibilidade definida, também são recusados na publicação até que um administrador da plataforma
  classifique a origem deles.
- **O selo de alterações pendentes sumiu depois que salvei.** O rascunho ficou idêntico à versão no
  ar — normalmente porque a edição foi desfeita ou só mexeu em espaçamento, que não muda o
  resultado publicado.
- **A ação em massa avisou que ignorou artigos.** Esses artigos tinham edições não publicadas. Abra
  cada um e escolha entre publicar ou descartar antes de repetir a ação.
- **Não consigo arrastar os cartões.** Verifique se você está dentro de uma categoria, se não há
  busca ativa, se nenhum artigo está selecionado e se existe mais de um artigo.
- **Faltam opções no menu `/`.** O cursor provavelmente está dentro de uma célula de tabela.
- **O link do vídeo foi recusado.** O provedor não está na lista de compatíveis. Hospede o vídeo em
  um dos serviços aceitos ou use um arquivo `.mp4`.
- **O artigo não salva.** Verifique se o corpo não passou de 200.000 caracteres e se o artigo tem
  conteúdo antes de tentar publicar.

## Veja também

- [Configurações do portal da Central de Ajuda](/hc/ajuda/articles/administration-central-de-ajuda-portal-pt-br)
- [Visão geral de Administração](/hc/ajuda/articles/administration-overview-pt-br)
- [Whitelabel (marca própria)](/hc/ajuda/articles/administration-whitelabel-pt-br)
- [Custom Scripts: injetar JS/CSS no dashboard, portal e widget](/hc/ajuda/articles/administration-custom-scripts-pt-br)
- [Variáveis dinâmicas](/hc/ajuda/articles/administration-variaveis-dinamicas-pt-br)