Buscando conteúdo de forma eficaz

[Discourse]

Este guia fornece uma visão geral abrangente dos recursos de pesquisa do Discourse, incluindo filtros, opções e técnicas avançadas.

Nível de usuário necessário: Todos os usuários

O Discourse oferece uma funcionalidade de pesquisa poderosa com inúmeros filtros e critérios. Ao usar o formulário de pesquisa avançada, ele anexa automaticamente a sintaxe relevante à sua consulta. Por exemplo, selecionar \[x\] Em minhas mensagens adicionará in:personal à sua consulta de pesquisa.

Este guia abrange todas as opções e recursos de pesquisa disponíveis no Discourse e fornece dicas e truques úteis para usar a função de pesquisa.

Filtros

O Discourse fornece uma ampla gama de filtros para ajudar você a refinar seus resultados de pesquisa. Aqui está uma lista abrangente dos filtros disponíveis:

Sintaxe	Descrição
in:personal-direct	Retorna apenas publicações em mensagens pessoais entre dois usuários
in:all-pms	Apenas para Administradores Retorna publicações de todas as mensagens pessoais, incluindo aquelas das quais você não faz parte
in:all	Retorna publicações de tópicos públicos e mensagens pessoais
in:replies	Retorna apenas publicações que são respostas, exclui os OPs dos tópicos
in:all-posts	Retorna cada publicação que corresponde à consulta, mesmo quando várias publicações correspondem dentro do mesmo tópico
in:tagged	Retorna publicações de tópicos que têm pelo menos uma tag
in:untagged	Retorna publicações de tópicos sem tags
in:seen	Retorna publicações que você viu (para usuários logados)
in:unseen	Retorna publicações que você não viu (para usuários logados)
in:wiki	Retorna publicações wiki
in:watching	Retorna publicações de tópicos que você está assistindo
in:tracking	Retorna publicações de tópicos que você está acompanhando
posts_count:X	Retorna publicações de tópicos que têm exatamente X publicações
min_posts:X	Retorna publicações de tópicos com pelo menos X publicações
max_posts:X	Retorna publicações de tópicos com no máximo X publicações
min_views:X	Retorna publicações de tópicos com pelo menos X visualizações
max_views:X	Retorna publicações de tópicos com no máximo X visualizações
badge:name_or_id	Retorna publicações vinculadas a uma concessão de emblema específica
created:@username	Retorna publicações de tópicos criados por username
group:group_name	Retorna publicações de usuários dentro do grupo group_name
group_messages:group_name	Retorna publicações de mensagens pessoais enviadas ao grupo group_name
personal_messages:username	Apenas para Administradores Retorna publicações de mensagens pessoais do usuário especificado
-tags:tag1,tag2,tag3	Retorna publicações não marcadas com tag1, tag2 ou tag3
filetypes:ext1,ext2,ext3	Retorna publicações com uploads das extensões de arquivo ext1, ext2 ou ext3
categories:category1,category2	Retorna publicações das categorias category1 e category2
status:open	Retorna publicações de tópicos que não estão fechados ou arquivados
status:closed	Retorna publicações de tópicos fechados
status:archived	Retorna publicações de tópicos arquivados
status:noreplies	Retorna publicações de tópicos sem respostas
status:single_user	Retorna publicações de tópicos com publicações de apenas um usuário
status:public	Retorna publicações de tópicos em categorias públicas
before:YYYY-MM-DD	Retorna publicações criadas antes da data especificada
after:YYYY-MM-DD	Retorna publicações criadas após a data especificada
with:images	Retorna publicações contendo imagens

Ordem

Você pode classificar seus resultados de pesquisa usando as seguintes opções de ordem:

Sintaxe	Descrição
order:latest	Classifica os resultados do mais novo para o mais antigo (atalho: l)
order:oldest	Classifica os resultados do mais antigo para o mais novo
order:latest_topic	Classifica os resultados pela data do tópico, do mais novo para o mais antigo
order:oldest_topic	Classifica os resultados pela data do tópico, do mais antigo para o mais novo
order:views	Classifica os resultados pelo número de visualizações
order:likes	Classifica os resultados pelo número de curtidas
order:read	(apenas logado) classifica pela data em que você visitou o tópico pela última vez (atalho: r)

Aliases

O Discourse fornece vários aliases para facilitar a pesquisa:

Sintaxe	Equivalente
l	order:latest
in:personal	in:messages
min_post_count:	min_post:
in:mine	in:created
category:	categories:
#	Pode ser usado tanto para categorias quanto para tags, dependendo do contexto
user:	@
@me	@your_own_username
f	in:first
t	in:title

Pesquisando por Palavras Exatas

O Discourse usa uma técnica chamada Stemming para encontrar palavras relacionadas. Embora isso seja frequentemente útil, pode haver momentos em que você deseja pesquisar uma palavra exata. Você pode fazer isso envolvendo sua palavra com espaços e aspas duplas, assim: \" term \".

Isso garante que ele pesquisará apenas pela palavra “term” e excluirá outras palavras relacionadas.

Observe que, como os espaços são considerados parte do termo de pesquisa, ele não retornará “term” se for a primeira ou a última palavra de uma publicação, pois não será precedido ou seguido por um espaço.

Exemplo: Pesquisando por @menções

Atualmente, a pesquisa por @menções não é suportada diretamente. No entanto, você pode conseguir isso usando o método de pesquisa de palavra exata:

\u003chttps://meta.discourse.org/search?q=“%20%40username%20”\u003e

Isso funciona porque %20 é como os espaços são codificados em URLs e %40 é como o símbolo @ é codificado.

Esta consulta procurará especificamente por @username (envolvido em espaços).

Combinando Opções de Pesquisa

Você pode combinar várias opções de pesquisa para criar consultas mais específicas. Por exemplo:

• status:open category:support tag:urgent after:2023-01-01 order:latest
  Isso pesquisará tópicos de suporte abertos marcados como urgentes, criados após 1º de janeiro de 2023, e classificará os resultados pela publicação mais recente.

• @jane_doe in:watching min_posts:5 with:images
  Isso pesquisará publicações de Jane Doe em tópicos que você está acompanhando, com pelo menos 5 publicações e contendo imagens.

Permissões e Limitações

Algumas opções de pesquisa avançada podem exigir certas permissões de usuário ou podem ser limitadas a funções de usuário específicas. Por exemplo:

• in:all-pms está disponível apenas para administradores, não para usuários regulares ou moderadores.
• personal_messages:username está disponível apenas para administradores.

Sempre considere sua função de usuário e permissões ao usar opções de pesquisa avançada.

Alternativa de Pesquisa: Filtro da Lista de Tópicos

Um recurso experimental /filter está disponível que suporta muitos tipos de filtro. Você pode saber mais no tópico oficial: Experimental topics list filter feature

Arquivos Fonte

Para uma visão mais técnica dessas opções, todos os filtros e parâmetros de pesquisa podem ser encontrados em search.rb - procure pelos métodos advanced_filter.

Dicas Adicionais

1. Você também pode pesquisar menções de tags como Bug \u003chttps://meta.discourse.org/search?q=“%20%23bug”\u003e

2. Alguns filtros podem ser adicionados por plugins. Por exemplo, o plugin Solved adiciona:

   • status:solved: Retorna publicações de tópicos resolvidos
   • status:unsolved: Retorna publicações de tópicos não resolvidos em categorias que permitem a marcação de resolvido

3. O plugin Topic Voting adiciona uma opção de ordem adicional:

   • order:votes: Classifica os resultados pelo número de votos no tópico contendo a publicação

Reserve um tempo para experimentar diferentes combinações de filtros e opções para encontrar a estratégia de pesquisa mais eficaz para suas necessidades.