Central de Ajuda: escrever, revisar e publicar artigos

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

Abra a Central de Ajuda, escolha o portal e o idioma e clique em Novo artigo.
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.
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.
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 (`/`)

No corpo do artigo, digite /. O menu de formatação abre no ponto do cursor.
Continue digitando para filtrar as opções pelo nome.
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

Digite /, escolha Vídeo.
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.
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".
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

Abra o artigo. O editor salva sozinho 500 ms depois da sua última tecla — o cabeçalho mostra "Salvando..." e depois "Salvo".
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.
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.
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.