Publicar artigos em suas outras ferramentas
Publique qualquer artigo do Clevera no Notion, Confluence, Google Docs, ClickUp, GitBook, ReadMe, Help Scout ou em um repositório Git a partir da janela Compartilhar: escolha para onde ele vai, publique novamente após edições e veja como imagens, vídeos e formatação são transferidos.
Publique um artigo finalizado do Clevera nas ferramentas que sua equipe já utiliza: uma wiki, um site de documentação, uma central de ajuda ou um repositório de código. Um proprietário ou administrador conecta cada ferramenta uma vez na página Integrações; depois, qualquer pessoa que possa editar o artigo o publica através do botão Compartilhar do editor.
Antes de começar
- Plano: as integrações fazem parte dos planos Profissional e Personalizado. Nos planos Gratuito e Inicial, a aba Publicar do editor exibe "A publicação em suas ferramentas está incluída no Profissional" com um botão Fazer upgrade.
- Uma ferramenta conectada: um proprietário ou administrador deve conectá-la primeiro. Veja Conecte suas ferramentas na página Integrações.
- Quem publica: qualquer pessoa que possa editar o artigo. Alguém que apenas possa visualizar verá "Você pode visualizar este item, mas não publicá-lo. Peça a alguém que possa editá-lo."
- Conteúdo: o que você publica é o artigo. O vídeo do qual ele se originou não é adicionado à página. Os vídeos chegam à outra ferramenta apenas quando você os coloca dentro do artigo como um bloco de vídeo (veja Como imagens e vídeos são transferidos). Para enviar o próprio vídeo para o YouTube, LinkedIn ou X, veja Publicar vídeos no YouTube, LinkedIn, X e mais.
Onde você pode publicar
| Ferramenta | O que o Clevera cria lá | Você escolhe | Como você conecta |
|---|---|---|---|
| Notion | Uma página | O nível superior do workspace, uma página ou um banco de dados | Entrar com o Notion |
| Confluence | Uma página no topo de um espaço | Um espaço | Entrar com o Confluence |
| Google Docs | Um novo Google Doc em Meu Drive | Nada (sempre Meu Drive) | Entrar com o Google Docs |
| ClickUp | Um Doc | Um Workspace | Entrar com o ClickUp |
| GitBook | Uma página no topo de um espaço | Um espaço | Chave de acesso |
| ReadMe | Um guia | Uma categoria de guia | Chave de API |
| Help Scout | Um artigo de Docs | Um site de Docs, depois uma coleção | Chave de API de Docs |
| GitHub, GitLab, Bitbucket | Um arquivo Markdown e suas capturas de tela, em um commit | Uma conta, um repositório e uma pasta | Entrar |
| WordPress | Nada é enviado: você coloca vídeos e artigos do Clevera em posts com blocos ou widgets | Configure a partir do plugin do WordPress | Plugin do WordPress |
Cada ferramenta possui uma conexão por workspace (o WordPress pode ter uma por site). Conectar novamente com uma conta diferente substitui a conexão antiga.
Publicar um artigo
Abra a aba Publicar
Abra o artigo (ou um vídeo que possua um artigo) e clique em Compartilhar → Publicar. Em Publicar o artigo, as ferramentas aparecem como blocos em dois grupos:
- Pronto para publicar: ferramentas conectadas. Um bloco diz "Conectado · Acme Inc." (a conta conectada), ou "Publicado há 2 horas" assim que este artigo for enviado para lá.
- Conectar para publicar: ferramentas marcadas como Não conectado ou Precisa reconectar. Clicar em uma delas abre a página de Integrações.
Gerenciar integrações abre a página de Integrações em uma nova aba. Acima das ferramentas, Sites de documentação Clevera oferece a opção de publicar o artigo em uma central de ajuda hospedada pelo Clevera para você.
Ferramentas conectadas aparecem primeiro. Escolha para onde ele vai
Clique em uma ferramenta conectada. Em Para onde ele vai, escolha o local nessa ferramenta (uma página, um espaço, um repositório e pasta...). O Clevera lembra o último local que você escolheu para cada ferramenta. Publicado como mostra o título que o artigo recebe lá.
Clique no ⓘ ao lado do título, O que é convertido no Notion (com o nome da sua ferramenta), para ver como a formatação é transferida.
Publicar
Clique em Publicar no Notion (com o nome da sua ferramenta). As etapas são exibidas conforme são executadas: "Procurando por uma cópia existente no Notion", depois Iniciando, Enviando arquivos 2 de 5 (Notion e Confluence enviam capturas de tela primeiro) e Escrevendo a página.
Se a ferramenta já tiver um artigo com o mesmo título lá, o Clevera pergunta o que fazer primeiro (veja Publicar novamente após editar).
Abra-o
Quando terminar, você verá "Publicado no Notion." com o título do artigo, sua localização e um Link que você pode copiar. Clique em Abrir no Notion para vê-lo, ou em Publicar em outro lugar para voltar à lista.
A publicação é executada em nossos servidores, então você pode fechar a janela Compartilhar enquanto ela trabalha. Quando terminar, uma notificação informa "Publicado no Notion.". Se falhar enquanto a janela estiver aberta, o motivo aparece no fluxo com Tente novamente, ou Reconectar quando a conexão precisar disso.
O artigo é publicado no idioma que você tem aberto no editor. Alterne o idioma na barra superior primeiro para publicar uma tradução. A publicação nunca usa créditos.
Você pode publicar até 20 vezes por minuto. Depois disso, você verá "Muitas tentativas de publicação. Por favor, aguarde um momento antes de tentar novamente."
Publicar novamente após editar
A publicação cria uma cópia, e ela funciona apenas em uma direção. Quando você altera o artigo no Clevera, a cópia na outra ferramenta permanece como estava até que você publique novamente. Edições que as pessoas fazem na cópia na outra ferramenta nunca retornam ao Clevera.
Ao publicar um artigo cujo título já existe no local escolhido, o Clevera mostra "Este artigo já está no Notion" e pede para você "Escolher o que acontece com o artigo existente." Clique em Visualizá-lo para abrir o existente, depois escolha:
| Opção | O que acontece | Botão |
|---|---|---|
| Atualizar o artigo existente | O artigo existente recebe esta versão (veja a tabela abaixo). | Atualizar no Notion |
| Criar um novo artigo | "Manter o existente e adicionar este sob um novo título." O Clevera sugere um Novo título como "Configurar faturamento (2)". | Criar novo artigo |
O que Atualizar o artigo existente faz depende da ferramenta:
| Ferramenta | Atualização |
|---|---|
| Confluence, GitBook, ReadMe, ClickUp, Help Scout | Atualiza a mesma página. Seu endereço permanece o mesmo. |
| GitHub, GitLab, Bitbucket | Sobrescreve o mesmo arquivo em um novo commit. |
| Notion | Cria uma nova página no mesmo local, depois move a página antiga para a lixeira do Notion. O endereço muda, e os comentários na página antiga permanecem com a página antiga. |
| Google Docs | Nunca pergunta: cada publicação cria um novo documento. |
Edições feitas por pessoas na outra ferramenta são sobrescritas por uma atualização.
Como imagens e vídeos são transferidos
Uma página publicada nunca começa com o vídeo do qual o artigo se originou. Apenas os blocos de vídeo que você colocou dentro do artigo (um Vídeo Clevera, um arquivo de vídeo ou uma incorporação como o YouTube) são publicados, cada um onde está posicionado no artigo. Veja Exibir um vídeo em um artigo.
Um bloco de Vídeo Clevera é publicado apenas quando o link de compartilhamento desse vídeo está ativado. Com o link desativado, o bloco é omitido da página publicada.
| Ferramenta | Capturas de tela | Vídeos dentro do artigo |
|---|---|---|
| Notion | Enviadas para o Notion | Arquivos de vídeo de até 20 MB são enviados; o YouTube é reproduzido em um bloco de vídeo; um Vídeo Clevera torna-se uma prévia de link |
| Confluence | Enviadas como anexos de página | Vídeos do YouTube e Clevera são reproduzidos na página; arquivos de vídeo tornam-se links |
| Google Docs | Copiadas para o documento | Links com ▶️ |
| Help Scout | Enviadas para o Help Scout | Vídeos do YouTube e Clevera são reproduzidos no artigo; arquivos de vídeo tornam-se links |
| GitHub, GitLab, Bitbucket | Enviadas para o repositório ao lado do arquivo Markdown | Uma miniatura ou pôster que vincula ao vídeo, além de um link ▶ |
| GitBook | Enviadas para o espaço | Blocos de incorporação |
| ReadMe | Enviadas para o ReadMe | Incorporações |
| ClickUp | Um link 🖼️ por captura de tela | Links ▶ |
O que muda na formatação
O Clevera converte o artigo para o formato de cada ferramenta. Cabeçalhos, parágrafos, negrito, itálico, links, listas, citações e divisores são transferidos para todos os lugares. Ícones de cartão nunca são transferidos, e links para outras páginas do Clevera mantêm seu texto, mas perdem o link, porque esses endereços não existem fora do Clevera.
| Ferramenta | O que é convertido |
|---|---|
| Notion | Abas, callouts, toggles, tabelas, código, equações e checklists são publicados nativamente; passos tornam-se uma lista numerada. |
| Confluence | Callouts, tabelas, código, checklists, expands e imagens são publicados nativamente; passos tornam-se uma lista numerada; abas tornam-se seções com cabeçalho. |
| Google Docs | Cabeçalhos, listas, tabelas, imagens e checklists são publicados nativamente; callouts, código e citações tornam-se parágrafos sombreados; passos tornam-se uma lista numerada; abas tornam-se seções rotuladas; vídeos tornam-se links. |
| Help Scout | Tabelas, código e vídeos são publicados nativamente; callouts tornam-se caixas coloridas; abas tornam-se seções com cabeçalho. |
| GitHub, GitLab | Callouts tornam-se alertas; tabelas, checklists, matemática e seções recolhíveis são publicados nativamente; passos tornam-se uma lista numerada; abas tornam-se seções rotuladas; vídeos tornam-se links. |
| Bitbucket | Tabelas e código são publicados nativamente; callouts tornam-se citações; abas tornam-se seções rotuladas; vídeos tornam-se links. |
| GitBook | Dicas, abas, passos, títulos de código e embeds são publicados nativamente. |
| ReadMe | Callouts, títulos de código e abas de código são publicados nativamente; abas tornam-se seções rotuladas. |
| ClickUp | Cabeçalhos, listas, tabelas e código são publicados; callouts tornam-se citações, checklists tornam-se linhas ☐/☑, vídeos e imagens tornam-se links. |
O mesmo resumo aparece em O que é convertido em … na aba Publicar. O artigo de cada ferramenta lista os detalhes.
Quando uma conexão para de funcionar
Se o login de uma ferramenta não puder ser renovado, ou se alguém remover o acesso do Clevera dentro da ferramenta, a publicação exibirá "Reconectar Notion para publicar" (com o nome da sua ferramenta) e um botão Reconectar no fluxo. Na aba Publicar, o bloco da ferramenta exibirá Precisa reconectar. Clique em Reconectar ou peça a um proprietário ou administrador para reconectá-la na página Integrações. Veja Reconectar uma ferramenta.
Solução de problemas
| Você vê | O que fazer |
|---|---|
| "Publicar em suas ferramentas está incluído no Pro" | Faça o upgrade do workspace. Veja Escolher um plano. |
| "Você pode visualizar este item, mas não publicá-lo. Peça a alguém que possa editá-lo." | Você só pode visualizar este artigo. Peça a alguém com acesso de edição para publicá-lo ou para lhe dar acesso de edição. |
| "Conecte o Notion na página Integrações primeiro." | A ferramenta não está conectada. Peça a um proprietário ou administrador para conectá-la. |
| "Não foi possível carregar seus locais do Notion" | Clique em Tente novamente. Se o erro persistir, reconecte a ferramenta. |
| "Não foi possível publicar no Notion" com o motivo da ferramenta | Clique em Tente novamente. Se a mensagem indicar que a conexão precisa ser feita, clique em Reconectar. |
| "Gere o artigo primeiro e, em seguida, publique-o aqui." | O artigo ainda não está pronto. Aguarde a conclusão. |
| "Nenhum artigo encontrado. Por favor, gere um artigo primeiro." | Este idioma não possui artigo. Mude o idioma ou gere um novo. |