Site da base de conhecimento 2.0

O site da base de conhecimento 2.0 apresenta uma experiência aprimorada para acessar artigos e navegar por informações. Com uma interface aprimorada, funcionalidades de busca melhores usando IA e organização de conteúdo simplificada, os usuários podem encontrar rapidamente artigos relevantes e resolver problemas de forma eficiente. Novos recursos, como atualizações em tempo real e elementos interativos, facilitam a navegação e o engajamento com o conteúdo. O site da Knowledge Base garante uma experiência de compartilhamento de conhecimento mais intuitiva e eficiente para todos os usuários.

Para sua informação (para sua informação)

O suporte ao KB Site 1.0 termina em dezembro de 2025. Atualize para o KB Site 2.0 para acessar novos recursos, segurança aprimorada e total conformidade com o WCAG 2.1 AA. Nossa equipe cuidará de toda a migração para você, sem exigir esforço da sua parte. Para mais informações, leia o artigo sobre   migração do site 2.0 da KB.

Recursos exclusivos do site da base de conhecimento 2.0

Visão geral abrangente do site da base de conhecimento 2.0

A imagem a seguir ilustra a seção Cabeçalho (1), o painel de navegação à esquerda (2), a seção do artigo (3) e o painel do lado direito (4) no site da base de conhecimento.

1. Imagem do logo: Exibe o elemento/logotipo de branding da sua organização. Clicar nela te leva até a página inicial da sua documentação.

2. Espaço de Trabalho:

   Use o menu suspenso para navegar pelos diferentes espaços de trabalho disponíveis na base de conhecimento.

   Clique no espaço de trabalho de documentação da API para navegar até a página inicial da documentação da API.

3. Navegação principal: Personalize a navegação principal para ajudar a navegar para diferentes páginas da sua página inicial ou do site da Knowledge Base.

4. Ícone de anúncio (): A página "Novidades" exibe uma lista de artigos publicados recentemente (novos e forked) no espaço de trabalho selecionado.

5. Obrigatório de reconhecimento (): Esta página exibe a lista de artigos obrigatórios/reconhecidos de reconhecimento.

6. Tema: Alterne entre tema do Sistema, temas de luz e temas das trevas no site da base de conhecimento.
   Por padrão, o tema claro será definido como tema do sistema.

7. Idioma: Selecione o idioma desejado na lista disponível para ler os artigos.

   NOTA

   Se apenas uma linguagem estiver configurada para um espaço de trabalho, o menu suspenso da linguagem não aparecerá no site da Base de Conhecimento.  

8. Navegação secundária: Personalize a navegação secundária para ajudar a navegar para diferentes páginas da sua página inicial ou do site da sua base de conhecimento.

2. Painel de navegação à esquerda

3. Seção de artigos

1. Migalhas de pão: Volte para a categoria e subcategoria do artigo.

2. Título do artigo: Exibe o título do artigo.

3. Copiar link: Clique para copiar a URL do artigo para a prancheta.

4. Distintivo de status: Exibe o status dos artigos (novos, atualizados, personalizados).

5. Data do artigo: Veja a data de publicação ou atualização do artigo.

6. Hora da leitura: Veja o tempo médio estimado para ler o artigo com base na contagem de palavras.

7. Colaboradores: Veja a lista de colaboradores que trabalharam neste artigo.

8. Ícone de compartilhamento: Compartilhe o artigo pelo Twitter, LinkedIn, Facebook ou e-mail.

9. Mais opções de compartilhamento: Clique em Exportar PDF para baixar um ou mais artigos, guias passo a passo ou categorias de página em PDF. Alternativamente, clique em Imprimir para imprimir o artigo ou exportá-lo como PDF. As opções disponíveis dependem das configurações de impressão do seu navegador.

10. Siga: Clique aqui para acompanhar os artigos. Este recurso está disponível para relatos de leitores.

11. Resumo do artigo: Clique para ver o resumo do artigo gerado pela Eddy AI.

12. Agradecimentos necessários: Role até o final do artigo e reconheça o artigo.

4. Imagem

Quando você clica em uma imagem no site da sua base de conhecimento, a imagem se abre em um visualizador de imagens.

1. Texto do título: Mostra a legenda da imagem, se houver.

2. Abrir link: Para abrir a URL da imagem, se disponível.

3. Afaste o zoom (): Para diminuir ou minimizar a imagem.

4. Amplie (): Para dar zoom ou ampliar a imagem.

5. Baixe (): Para baixar a imagem no seu armazenamento local.

6. Fechar (X): Para fechar a imagem.

7. Próximo (): Para passar para a próxima imagem.

8. Anterior (): Para mover para a imagem anterior.

   Segure e arraste a imagem para movê-la para qualquer lugar da tela. A imagem fecha quando você clica em qualquer lugar da tela fora da imagem.

   

5. Vidro do lado direito

6. Rodapé do artigo

1. Feedback sobre o artigo: Clique em Sim ou Não e insira seu feedback para o artigo.

2. Artigo Anterior e Próximo: Navegue para os artigos anteriores e próximos na categoria.

3. Artigos relacionados: Veja uma lista de artigos relacionados associados.

Localize ou personalize o texto padrão da interface no site da base de conhecimento

Você pode localizar ou personalizar o texto padrão da interface exibido no site da base de conhecimento usando o recurso Variáveis de Localização . Isso permite traduzir rótulos gerados pelo sistema para outros idiomas ou modificá-los em inglês.

Para atualizar o texto da interface:

1. Navegue até Configurações () na barra de navegação da esquerda.

2. No painel de navegação à esquerda, navegue até o portal Portal da base de conhecimento > Espaço de trabalho e localização.

3. Na aba Variáveis de Localização , expanda a categoria relevante para visualizar e editar os campos de texto disponíveis.

4. Faça suas alterações e clique em Salvar.

NOTA

Por padrão, o sistema localiza variáveis para o idioma respectivo.

Solução de problemas

Problemas de acesso e disponibilidade

Esta seção fornece orientações passo a passo para lidar com desafios comuns que você pode encontrar ao gerenciar ou acessar seu site de base de conhecimento. Desde problemas de acessibilidade em sites até erros de configuração, cada solução é personalizada para ajudar você a identificar e resolver rapidamente possíveis obstáculos.

Site não carrega após inserir a URL

Se um site não estiver acessível ao inserir uma URL, possíveis causas podem ser entrada incorreta de URL, problemas no cache do navegador, interferência na VPN, problemas de rede, tempo de inatividade no servidor, navegadores desatualizados ou configurações incorretas de data e hora do sistema.

Passos para resolver:

1. Certifique-se de que a URL do site esteja inserida corretamente.

2. Recarregue a página.

3. Limpar o cache do navegador:

   1. Clique com o botão direito em qualquer lugar da página e selecione Inspecionar para abrir o menu de ferramentas para desenvolvedores.

   2. Clique com o botão direito no botão de recarregar do navegador e escolha Recarregar Direto ou Esvaziar cache e Recarregar Forçado.

4. Verifique se uma VPN está ativa no seu dispositivo. Se estiver, desligue a VPN e tente acessar o site novamente.

5. Certifique-se de que a data, hora e fuso horário do seu sistema estejam corretamente definidos.

Se o problema persistir após essas etapas, considere entrar em contato com a equipe de suporte para obter mais assistência.

Problemas de conexão segura no site da base de conhecimento

Erro:

• Este site não pode fornecer uma conexão segura

• Sua conexão não é privada

• A conexão deste site não é segura

Passos para resolver:

1. Verifique o registro da CAA no DNS:

   1. Verifique se um registro CAA (Autorização da Autoridade de Certificação) foi adicionado aos registros DNS do seu site de base de conhecimento.

   2. Se nenhum registro CAA for encontrado, inspecione o certificado SSL usado no site. Para orientação, consulte os passos no vídeo fornecido.

2. Atualize o Registro da CAA:

   1. Adicione o registro CAA correspondente ao seu DNS com base no provedor do certificado SSL.

   2. Por exemplo, se o provedor do certificado for Let's Encrypt, adicione o segundo registro CAA conforme especificado nas instruções. Da mesma forma, certifique-se de que o registro correto da CAA seja adicionado para o seu tipo de certificado.

3. Referência para os Registros da CAA:

   Saiba mais sobre os registros da CAA e sua importância revisando o artigo a seguir:
   Registro CAA e por que ele é necessário (relacionado ao SSL).

4. Entre em contato com o provedor de DNS:

   Se o problema persistir durante a configuração do domínio personalizado, entre em contato com seu provedor de DNS para confirmar se há outros problemas.

Tempo limite do gateway 504 ao acessar o site

Erro: Tempo limite do gateway 504

Se um erro 504 ocorrer ao acessar o site, um possível motivo pode ser a configuração das subpastas.

Passos para resolver:

1. Verifique as mudanças recentes na configuração do servidor web:

   1. Revise os blocos de localização ou arquivos de configuração no servidor web para ver se há mudanças recentes.

   2. Se mudanças forem identificadas, reverta-as para o estado anterior.

2. Verifique a configuração da subpasta:

   1. Uma alteração no slug da subpasta dentro da configuração da subpasta pode causar o problema.

   2. Reverta quaisquer mudanças recentes na configuração das subpastas para resolver o problema.

   Para mais informações sobre configuração de subpastas, consulte o artigo sobre Hospedagem do Document360 em um subdiretório.

Erro ao acessar o site

Erro:
1. Desculpe, você foi bloqueado. Você não consegue acessar us.document360.io
2. O site não carrega corretamente ou exibe o código de erro: 6003

O site da base de conhecimento não está carregando ou está inacessível para certos usuários. A Cloudflare pode ter sinalizado o endereço IP ou o agente de usuário do navegador como suspeito ou parecido com um bot. Isso pode resultar em acesso restrito ao site.

Ou, esse problema pode ocorrer se o segredo do cliente JWT (JSON Web Token) tiver sido regenerado. Quando o segredo é alterado, mas não atualizado no aplicativo, a autenticação falha, levando a problemas de acesso.

Passos para resolver:
Se você tiver o primeiro problema, entre em contato conosco pelo support@document360.com. Nossa equipe investigará a pontuação IP ou agente do navegador e auxiliará na resolução do problema.

Se você tiver o segundo problema,

1. Se o segredo foi regenerado recentemente e não atualizado, regenere um novo segredo do cliente.

2. Após a regeneração, certifique-se de que o novo cliente secreto esteja corretamente atualizado nas configurações da aplicação JWT.

Encontrando a mensagem "/home/error/" ao acessar o site

Erro: /home/error/

Possíveis causas desse erro incluem configuração incorreta do site, problemas no lado do servidor ou erros não resolvidos no backend do site. Você pode encontrar esse erro na seção de URL após a URL do domínio.

Passos para resolver:

1. Entre em contato conosco support@document360.com com os seguintes detalhes:

   1. Um vídeo de compartilhamento de tela demonstrando o problema na página.

   2. Passos para reproduzir o erro, se possível.

2. Siga os passos descritos em isso Guia para baixar o arquivo HAR.

3. Compartilhar erros no console:

   1. Após baixar o arquivo HAR, clique na aba 'console' nas ferramentas de desenvolvimento do seu navegador.

   2. Tire uma captura de tela dos erros exibidos no console e inclua-a no seu e-mail.

Questões de autenticação e autorização

A página não está funcionando devido a muitosredirecionamentos s

Erro: Página não está funcionando: página redirecionada muitas vezes

Possíveis causas desse erro incluem configuração incorreta da URL de login do JWT, uso da URL do domínio como URL de login, causando loops de redirecionamento e configurações desatualizadas na configuração do JWT.
Outra possível razão é uma configuração inadequada de um caminho de subpasta personalizado diferente de /docs, causando um loop de redirecionamento devido à configuração incompleta da subpasta.

Passos para resolver:

1. Revise quaisquer atualizações recentes feitas na URL de login do JWT na configuração.

2. Certifique-se de que a URL do domínio não esteja definida como URL de login. Usar a URL do domínio pode causar múltiplos problemas de redirecionamento.

3. Remova a URL de login incorreta da configuração do JWT e substitua-a pela correta.

4. Configure o servidor web para suportar o caminho de subpasta personalizado. Ou, reverter o caminho da subpasta para /docs.

Para instruções detalhadas sobre como configurar o JWT, consulte o artigo sobre o JWT.

Desculpa! Projeto não encontrado durante a configuração de domínio personalizado

Erro: Desculpa! Esse projeto não existe.

Possíveis causas desse erro incluem configuração incorreta ou ausente de registros CNAME, registros CNAME expirados no DNS ou verificação incompleta do domínio no portal Document360.

Passos para resolver:

1. Certifique-se de que o registro CNAME seja adicionado corretamente e clique no botão 'Verify' na página do domínio personalizado no portal Document360. Uma vez verificado, o domínio personalizado será configurado e ativo imediatamente.

2. Se o registro CNAME foi atualizado no DNS após algum tempo, ele pode ter expirado, impedindo a verificação do domínio e resultando na mensagem de erro.

3. Reconfigure o domínio personalizado, atualize o registro CNAME e verifique o domínio no Document360.

Para instruções detalhadas, consulte o artigo sobre mapeamento de domínio personalizado.

Acesso ao site da base de conhecimento bloqueado

Erro: Desculpe, você foi bloqueado

Esse erro aparece para leitores quando tentam acessar o site da base de conhecimento e são bloqueados por filtros de segurança. O endereço IP ou navegador do usuário pode ter sido visto como suspeito pela Cloudflare, possivelmente porque o IP tem um histórico de atividades incomuns ou prejudiciais (conhecido como má reputação).

Passos para resolver:

1. Verifique e confirme se o problema afeta todas as contas de leitores ou apenas usuários específicos.

2. Descubra se os usuários afetados estão usando uma VPN ou acessando o site por meio de uma máquina virtual. Essas situações às vezes podem acionar a segurança da Cloudflare.

3. Peça aos usuários afetados para mudarem de conexão de internet (por exemplo, hotspot móvel ou outra rede Wi-Fi) para ver se o erro persiste.

4. Entre em contato com support@document360.com com os detalhes abaixo:

   • Arquivo HAR (registro da rede do navegador)

   • Endereço IP

Problema de acesso ao visualizar a documentação no site da Base de Conhecimento

Erro: Desculpe, você não está autorizado a acessar esta documentação

Você pode enfrentar esse problema por um dos seguintes motivos:

• Projeto mudou para privado: Se o projeto foi transferido de público para privado, leitores sem acesso de login serão restringidos de visualizar o conteúdo.

• Espaço de trabalho privado em um projeto misto: Se o artigo pertencer a um espaço de trabalho privado dentro de um projeto de acesso misto, o acesso será negado a menos que o leitor tenha as permissões necessárias para visualizar a documentação.

• Permissões do grupo de leitores: A conta do leitor pode não ter as permissões necessárias para acessar a documentação através do grupo de leitores designado.

• Configurações de segurança em nível de categoria: Mesmo que o leitor tenha acesso ao espaço de trabalho, restrições em nível de categoria podem impedi-lo de visualizar determinado conteúdo.

• Restrições do grupo de leitores: Se um leitor fizer parte de vários grupos e um deles estiver restrito, o acesso pode ser negado devido a restrições herdadas.

Passos para resolver:

1. Verifique se o projeto ou suas configurações de acesso ao conteúdo foram recentemente alteradas de público para privado.

2. Se o problema ocorrer em um artigo específico, verifique se o espaço de trabalho ao qual ele pertence foi configurado como privado.

3. Revise as permissões do grupo de leitores para a conta do leitor afetado para garantir que ele tenha acesso aos espaços de trabalho ou conteúdos relevantes.

4. Certifique-se de que o artigo não esteja escondido. Se estiver oculto, passe o mouse sobre o artigo ou categoria, clique no ícone Mais () e selecione o ícone Remover ().

5. Se restringir o acesso das contas da equipe dentro do site da Base de Conhecimento:

   1. Navegue até Documentação () e passe o mouse sobre a categoria desejada.

   2. Clique no ícone de Mais () ao lado da categoria desejada.

   3. Clique no site da base de conhecimento de Segurança > e confira o seguinte:

      • Na aba Leitor , certifique-se de que o e-mail do leitor esteja listado.

      • Na aba do grupo de leitores , verifique se o grupo do leitor está incluído. Se não, adicione e clique em Fechar. O leitor agora deve poder visualizar o artigo.

6. Se restringir o acesso das contas da equipe dentro do portal da Base de Conhecimento:

   • Navegue até Documentação () e passe o mouse sobre a categoria desejada.

   • Clique no ícone de Mais () ao lado da categoria desejada.

   • Selecione o portal da base de conhecimento de Segurança > e confira:

     • Na aba de contas da equipe , confirme que a conta da equipe está listada.

     • Na aba de grupos de conta do time , verifique se o grupo da conta do time está incluído. Se não, adicione.

7. Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360

Problemas de exibição de conteúdo e funcionalidade

Ícones não estão renderizando corretamente no site do usuário

Em alguns casos, ícones no site do usuário podem não ser renderizados corretamente, especialmente quando há um grande número de ícones para diferentes navegações. A principal razão para ícones quebrados é uma modificação não intencional da família FontAwesome fornecida pelo Document360. Isso ocorre quando alterações em outras classes ou tags HTML no site do usuário alteram involuntariamente as configurações da fonte dos ícones.
Para evitar esse problema,

• Certifique-se de que mudanças no estilo do site ou nas definições de classes não impactem as configurações das classes ou da família de fontes do FontAwesome.

• Ao mirar em elementos específicos, verifique novamente que os estilos relacionados a ícones permanecem intactos e não sejam sobrescritos por cima.

Passos para resolver:

1. Inspecionar o ícone quebrado:

1. Use as ferramentas de desenvolvimento do seu navegador para inspecionar o site do usuário.

2. Clique no ícone quebrado usando a ferramenta seletor para identificar o problema.

2. Confira CSS personalizado:

1. Navegue até Configurações () > site da base de conhecimento > Personalizar site > CSS e JavaScript personalizados no portal da base de conhecimento.

2. Revise quaisquer regras de fonte aplicadas a várias classes. Em alguns casos, mudanças na fonte podem se aplicar involuntariamente a classes mais amplas, afetando os ícones.

3. Garanta que as alterações na fonte sejam aplicadas apenas às classes específicas que as exigem. Isso ajudará a preservar as configurações padrão do Font Awesome e evitar qualquer impacto não intencional nos ícones.

A página não responde ao editar um artigo

Erro: A página não está funcionando. example.com te redirecionei muitas vezes. ERR_TOO_MANY_REDIRECTS.

Ao editar um artigo, a página pode ficar sem resposta ou apresentar erros relacionados ao redirecionamento. Algumas causas comuns incluem:

• Cache de navegador desatualizado interferindo no carregamento da página

• Tamanho grande do artigo com muitas imagens, tabelas ou conteúdo longo

• Tags HTML de fechamento incorretas ou faltantes (especialmente no Markdown)

• Redirecionamentos excessivos devido à configuração incorreta do artigo

• Problemas relacionados à plataforma que afetam todos os artigos, não apenas um específico

Passos para resolver:

• Limpe o cache, recarregue o navegador e verifique se o problema persiste. Um cache corrompido ou desatualizado pode interferir na funcionalidade da página.

• Use uma janela privada/incógnita. Isso ajuda a descartar problemas relacionados ao cache e cookies.

• Identifique a dimensão do problema. Verifique se o problema ocorre em todos os artigos ou apenas em um específico.

  Se todos os artigos forem afetados:

  • Gerar um arquivo HAR e enviá-lo para support@document360.com análise.

  • Vá em Configurações () > Portal da base de conhecimento > Geral e ative a opção de acesso ao Suporte para que a equipe de suporte possa investigar.

  Se um artigo específico for afetado:

  • Artigos grandes podem causar problemas de desempenho. Considere dividir o conteúdo em artigos menores e organizá-los sob categorias apropriadas.

  • Certifique-se de que todas as tags HTML no artigo tenham tags de fechamento correspondentes (por exemplo, <table>, <div>, <p>), especialmente no formato Markdown.

• Se o problema persistir, entre em contato com support@document360.com com os seguintes detalhes:

  • Uma captura de tela da edição

  • O arquivo HAR para análise

  • O acesso ao suporte está habilitado no seu projeto

Carregamento de site da base de conhecimento sem estilo CSS

Esse problema normalmente ocorre quando o site é acessado a partir de uma rede onde domínios Document360 são bloqueados ou não colocados na lista branca pela sua empresa ou organização.

Passos para resolver:

1. Verifique se o site funciona corretamente quando acessado de outra rede. Se acontecer, o problema provavelmente está relacionado a restrições de rede.

2. Para resolver isso, coloque os seguintes domínios na lista branca nas configurações da rede para garantir o acesso e a funcionalidade adequados.

Fotos de perfil das contas/leitores da equipe estão quebradas

Fotos de perfil de contas de equipe ou leitores podem parecer quebradas no site da base de conhecimento. Esse problema ocorre quando o tipo de conteúdo da imagem é identificado incorretamente, impedindo que ele carregue corretamente.

Passos para resolver:

1. Abra qualquer artigo no site da Knowledge Base e verifique se a foto de perfil do colaborador parece quebrada.

2. Clique com o botão direito na aba do navegador, clique em Inspecionar e vá até a aba Rede no painel de ferramentas de desenvolvimento .

3. Localize a solicitação que carrega a imagem de perfil e verifique o Tipo de Conteúdo:

   • Se for "texto/simples", a imagem não carrega direito.

   • Se for "image/jpeg", "application/octet-stream" ou outro formato válido, a imagem deve carregar normalmente.

   

4. Tente recarregar a foto de perfil:

   • Navegue até seu projeto no portal da Base de Conhecimento.

   • Clique no ícone do seu perfil no canto superior direito.

   • Selecione Meu perfil no menu suspenso.

   • No painel Meu perfil , clique em Editar e depois no ícone Editar () próximo à foto de perfil.

   • Envie a imagem de perfil desejada.

   

5. Se o problema persistir, gere um arquivo HAR e envie um chamado de suporte para support@document360.io para investigação mais aprofundada.

Problemas de acesso a arquivos e mídias

Encontrando o erro "ResourceNotFound" ao acessar imagens, arquivos ou anexos

Erro: ResourceNotFound

Esse erro ocorre quando o token SAS (Assinatura de Acesso Compartilhado) não é adicionado à URL do arquivo em projetos privados e mistos. O Document360 adiciona um token SAS para garantir que apenas usuários autorizados possam acessar o arquivo.

Passos para resolver:

• Certifique-se de que o token SAS esteja anexado à URL do arquivo antes de acessar ou compartilhar o arquivo.

• Tente baixar o arquivo novamente diretamente do Document360.

Encontrando erro "AuthenticationFailed" ao acessar imagens, arquivos ou anexos

Erro: AutenticaçãoFalha

Esse erro ocorre quando o token SAS expira em projetos privados e mistos. No Document360, o token SAS é válido por 15 minutos antes de ser atualizado automaticamente. Se um arquivo com um token SAS expirado for compartilhado, os usuários não poderão acessá-lo. As possíveis causas incluem:

1. Acesso restrito a projetos ou conteúdos privados

   Arquivos em projetos privados ou conteúdos privados em projetos de visibilidade mista são restritos a usuários que não possuem as permissões necessárias.

2. Vencimento do Token SAS

   • Arquivos Document360 usam tokens SAS anexados às URLs para acesso temporário. Uma vez que o token expira, os usuários não podem acessar o arquivo.

   • O tempo de vencimento varia de acordo com o tipo de arquivo:

     • Arquivos padrão: O token SAS expira 15 minutos após a geração do link.

     • Arquivos de vídeo: O token SAS expira após 1 hora.

Exemplo de token SAS:

https://cdn.document360.io/4214231-3333-4222-huafgesu/exp/PaygOps-2024-Oct-29-03-54-19.zip?sv=2023-12-05&spr=https&st=2024-12-02T04%3A22%3A08Z&se=2024-12-02T04%3A52%3A08Z&sr=c&sp=r&sig=BtPheGpDGeLzQWNyv02oxWqWxvn%2FHwef05UCGJ6RsgHU%3D

Passos para resolver

• Atualize a página de origem e gere um novo link de arquivo.

• Certifique-se de compartilhar o arquivo dentro do período válido do token (15 minutos para arquivos padrão, 1 hora para arquivos de vídeo) para evitar a expiração.

document.addEventListener("DOMContentLoaded", function () {
  document.addEventListener("contextmenu", function (e) {
    let el = e.target;
    while (el && el !== document) {
      if (el.tagName === "A") {
        e.preventDefault();
        break;
      }
      el = el.parentElement;
    }
  });
});