Trecho

Planos de suporte à reutilização de conteúdo

Trechos é um conjunto predefinido de blocos de conteúdo que o gerente de conteúdo ou autor usa como conteúdo reutilizável. O conteúdo do Snippet pode variar de texto ou frases simples a parágrafos longos, tabelas, imagens e muito mais. No Document360, os snippets são armazenados em uma biblioteca e você pode inseri-los facilmente em artigos durante a edição com apenas um clique de um botão.

NOTA

O Snippet aparecerá como conteúdo normal para o leitor no site da base de conhecimento. O leitor não saberá que o conteúdo foi renderizado por meio do Snippet.

Criando um snippet

Para criar um snippet:

1. Navegue até Documentação () > Ferramentas de conteúdo > Reutilização de conteúdo > Trechos no portal da base de dados de conhecimento.

   A página Trechos é exibida. Se você adicionou algum snippet anteriormente, poderá vê-lo listado aqui.

2. Clique em Criar snippets na parte superior para selecionar snippets específicos do idioma (Global, inglês, francês etc.) adicionados ao seu projeto.

3. Insira o Nome do snippet.

   NOTA

   O nome do snippet pode incluir letras, números, hífens e sublinhados, com um comprimento máximo de 30 caracteres.

4. O valor do código de mesclagem será o nome do snippet que aparece com a tag do snippet no editor.

   Por exemplo, se o nome do snippet for Disclaimer, o valor do código de mesclagem será {{snippet. Isenção de responsabilidade}}.

5. No menu suspenso Seleção de idioma , a seleção padrão é Global (disponível em todos os idiomas). No entanto, se necessário, você pode escolher um idioma disponível desejado para criar um snippet específico do idioma.

6. No campo Conteúdo , insira o conteúdo do snippet.

   Por padrão, o editor de snippets será WYSIWYG (HTML). No entanto, você pode alternar para o editor Markdown, se necessário.

NOTA

Mudando para Markdown:

1. Clique em Alternar para Markdown.

2. Clique em Continuar no prompt de confirmação de alteração .

Você perderá o conteúdo WYSIWYG ao alternar para Markdown.

7. Feito isso, clique em Criar snippet.

WYSIWYG

As opções de formatação abaixo estão disponíveis para o conteúdo do snippet em WYSIWYG:

• Opções básicas de formatação de texto, como Negrito, Itálico, Tachado e Sublinhado , estão disponíveis.

• As opções de formatação adicionais incluem Tamanho da fonte, Família de fontes, Cor do texto, Cor do plano de fundo, Subscrito, Sobrescrito e Limpar formatação.

• Você pode criar listas ordenadas e não ordenadas para listar itens.

• Inserir imagem permite inserir uma imagem de um URL, armazenamento local ou unidade.

• Inserir link permite adicionar um hiperlink de uma URL fornecida ou link para um artigo da base de conhecimento.

• Você pode usar textos explicativos de Inserção como Informações, Aviso, Erro e Êxito.

• Inserir látex permite adicionar expressões e equações:

  • Clique na opção Inserir látex e um painel Inserir expressão de látex será exibido.

  • Digite a sintaxe Latex desejada e clique em Inserir.

  • Leia este artigo para obter os comandos básicos do Latex usados na sintaxe do Latex.

• Inserir tabela permite que você crie uma tabela selecionando o número necessário de linhas e colunas.

• Inserir bloco de código permite adicionar blocos de código.

  • Clique em Inserir bloco de código e selecione o idioma do código desejado na lista suspensa.

  • Adicione código no campo Inserir seu código e clique em Inserir.

• Você pode visualizar o snippet na Visualização de código (HTML). Clique em Visualização de código para exibir a visualização. Se você quiser voltar para a visualização do editor, clique em Visualização de código novamente.

Redução de preço

O Markdown é útil quando texto significativo e mídia mínima estão envolvidos no Snippet. Você pode usar a sintaxe Markdown manualmente ao escrever ou formatar texto usando a barra de ferramentas Markdown.

Por exemplo, você pode fazer um texto aparecer em negrito escrevendo a respectiva sintaxe ou usando o ícone Negrito () na barra de ferramentas Markdown.

• Opções básicas de formatação de texto, como Negrito, Itálico, Tachado estão disponíveis.

• A citação em bloco permite adicionar aspas em bloco.

• Linha permite inserir uma linha horizontal.

• Lista ordenada e Lista não ordenada estão disponíveis para listar itens.

• Inserir tabela permite criar uma tabela selecionando o número necessário de linhas e colunas.

• Inserir imagem permite inserir uma imagem de um URL, armazenamento local ou unidade.

• Inserir bloco de código permite adicionar blocos de código:

  • Clique em Inserir bloco de código e digite o código desejado dentro do bloco de código.

  • Exemplo: `code`.

• Você pode usar textos explicativos de Inserção como Informações, Aviso, Erro e Êxito.

• Inserir látex permite adicionar expressões e equações.

  • Clique na opção Inserir látex e uma sintaxe de látex de amostra () será exibida.

  • Digite a sintaxe desejada.

  • A sintaxe deve começar e terminar com $.

NOTA

Ao adicionar látex, não inclua um espaço entre $ e sintaxe. Para obter mais informações, leia este artigo para obter os comandos básicos do latex.

• Inserir link permite adicionar um hiperlink de uma URL fornecida ou link para um artigo da base de conhecimento.

• O Glossário permite adicionar termos do glossário ao seu Snippet.

Inserindo trecho no artigo

Existem dois métodos pelos quais você pode adicionar um snippet ao seu artigo.

Você pode inserir snippet nos artigos em dois métodos:

Método 1: Usando a sintaxe (editor Markdown)

Método 2: Na barra de ferramentas (Markdown, editor WYSIWYG e editor WYSIWYG avançado)

Página de snippets

Você pode exibir, editar ou excluir um snippet na página Trechos .

1. Navegue até Documentação () > Ferramentas de conteúdo > Reutilização de conteúdo > Trechos no portal da base de dados de conhecimento.

   A página Trechos é exibida, onde você pode encontrar a lista de snippets que você já adicionou.

1. Idiomas: para filtrar o snippet em Global ou em um idioma específico.

2. Pesquisar snippets: pesquise a lista de snippets com base no nome.

3. Usado em: Se um snippet não for adicionado a nenhuma página de artigo/categoria, o status será -. Se um snippet for adicionado a qualquer página de artigo/categoria, você poderá clicar no botão Exibir para ver a lista de páginas de artigos/categorias que contêm o snippet.  

4. Idioma: o idioma desejado de cada snippet.

5. Última modificação: a última vez que o conteúdo do snippet foi atualizado.

6. Visualização: Clique no nome do snippet e você poderá visualizar o conteúdo do snippet.

7. Progresso: clique no ícone de globo para ver o progresso do snippet em vários idiomas.

8. Ícone Editar (): para editar o conteúdo do snippet.

9. Ícone Excluir (): para remover o snippet.

Exibir dependência de página de artigo/categoria

Na página Trechos , você pode encontrar a coluna Usado em .

1. Na coluna Usado em , clique no botão Exibir .

   O painel Exibir referências aparecerá, onde você pode visualizar a lista de artigos/páginas de categoria às quais o snippet foi adicionado.

2. Clique no artigo para expandir a seção.

3. Você pode encontrar as seguintes informações:

   • A versão do artigo.

   • O espaço de trabalho e o idioma do projeto.

   • O nome da conta da equipe e a foto do perfil que adicionou o snippet.

   • O artigo afirma (Publicado, Rascunho, Novo Artigo).

   • As informações de hora/data em que o snippet foi inserido na página do artigo/categoria.

Editando um trecho existente

1. Navegue até Documentação () > Ferramentas de conteúdo > Reutilização de conteúdo > Trechos no portal da base de dados de conhecimento.

   A página Trechos é exibida. Você pode encontrar a lista de snippets que já adicionou.

2. Passe o mouse sobre o snippet desejado e clique no ícone Editar ().

3. Depois de concluir a edição do conteúdo, clique no botão Atualizar .

NOTA

Quando você atualiza um snippet na biblioteca, as alterações são refletidas automaticamente em todos os artigos e páginas de categoria que o utilizam. Isso inclui artigos publicados, que serão atualizados sem a necessidade de republicá-los.

Excluindo um snippet

1. Navegue até Documentação () > Ferramentas de conteúdo > Reutilização de conteúdo > Trechos no portal da base de dados de conhecimento.

   A página Snippets aparecerá. Você pode encontrar a lista de snippets que já adicionou.

2. Passe o mouse sobre o snippet desejado e clique no ícone Excluir ().

3. Clique em Sim no prompt de confirmação.

Para excluir vários snippets em massa

Selecione vários snippets pretendidos na página Snippets e clique na opção Excluir na parte superior da lista.

Traduzindo trechos

Você pode criar e gerenciar snippets em vários idiomas. Isso garante que, quando seus artigos forem traduzidos, os snippets correspondam ao idioma do artigo, proporcionando uma experiência de usuário consistente e localizada.  

NOTA

Os snippets globais não podem ser traduzidos.

Traduzindo novos snippets

1. Navegue até o > Ferramentas de conteúdo > Reutilização de conteúdo > Trechos Documentação () no portal da base de dados de conhecimento.

2. Clique em Criar snippet.

3. No menu suspenso Idioma , selecione o idioma pretendido.

4. Insira o nome do snippet e o conteúdo do snippet em inglês (ou no idioma padrão).

5. Clique em Alternar para markdown para alterar o editor de conteúdo de WYSIWYG para o editor Markdown.

6. Para traduzir o conteúdo para outros idiomas, clique no menu suspenso Traduzir para outros idiomas .

7. Selecione o(s) idioma(s) desejado(s) no menu suspenso e clique em Traduzir.

NOTA

• O idioma padrão será marcado como Principal.

• Os idiomas traduzidos serão indicados com uma marca verde para mostrar que a tradução foi concluída. Se necessário, você pode navegar para idiomas não traduzidos e concluir sua tradução.

7. Quando as traduções estiverem concluídas, clique em Criar snippet para salvá-lo junto com suas traduções.

Por exemplo, se você criar um snippet para uma mensagem de boas-vindas em inglês, poderá usar o recurso de tradução para adicionar a mesma mensagem em francês, espanhol, holandês etc.

Traduzindo snippets existentes

1. Clique no snippet existente desejado que você deseja traduzir.

2. Navegue até Traduzir para outros idiomas e selecione o idioma desejado para o qual o snippet precisa ser traduzido.

3. Clique em Traduzir.

4. Se necessário, você pode navegar para outros idiomas e traduzir novamente para esses idiomas.

5. Para traduzir o conteúdo novamente, clique em Traduzir novamente. Isso substituirá a tradução existente por uma nova.

6. Se você precisar remover o snippet traduzido para um idioma específico, clique em Remover idioma.

   Você pode retraduzir o conteúdo a qualquer momento, se necessário.