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-directRetorna apenas publicações em mensagens pessoais entre dois usuários in:all-pmsApenas para Administradores
Retorna publicações de todas as mensagens pessoais, incluindo aquelas das quais você não faz partein:allRetorna publicações de tópicos públicos e mensagens pessoais in:repliesRetorna apenas publicações que são respostas, exclui os OPs dos tópicos in:all-postsRetorna cada publicação que corresponde à consulta, mesmo quando várias publicações correspondem dentro do mesmo tópico in:taggedRetorna publicações de tópicos que têm pelo menos uma tag in:untaggedRetorna publicações de tópicos sem tags in:seenRetorna publicações que você viu (para usuários logados) in:unseenRetorna publicações que você não viu (para usuários logados) in:wikiRetorna publicações wiki in:watchingRetorna publicações de tópicos que você está assistindo in:trackingRetorna publicações de tópicos que você está acompanhando posts_count:XRetorna publicações de tópicos que têm exatamente X publicações min_posts:XRetorna publicações de tópicos com pelo menos X publicações max_posts:XRetorna publicações de tópicos com no máximo X publicações min_views:XRetorna publicações de tópicos com pelo menos X visualizações max_views:XRetorna publicações de tópicos com no máximo X visualizações badge:name_or_idRetorna publicações vinculadas a uma concessão de emblema específica created:@usernameRetorna publicações de tópicos criados por usernamegroup:group_nameRetorna publicações de usuários dentro do grupo group_namegroup_messages:group_nameRetorna publicações de mensagens pessoais enviadas ao grupo group_namepersonal_messages:username
Retorna publicações de mensagens pessoais do usuário especificado-tags:tag1,tag2,tag3Retorna publicações não marcadas com tag1,tag2outag3filetypes:ext1,ext2,ext3Retorna publicações com uploads das extensões de arquivo ext1,ext2ouext3categories:category1,category2Retorna publicações das categorias category1ecategory2status:openRetorna publicações de tópicos que não estão fechados ou arquivados status:closedRetorna publicações de tópicos fechados status:archivedRetorna publicações de tópicos arquivados status:norepliesRetorna publicações de tópicos sem respostas status:single_userRetorna publicações de tópicos com publicações de apenas um usuário status:publicRetorna publicações de tópicos em categorias públicas before:YYYY-MM-DDRetorna publicações criadas antes da data especificada after:YYYY-MM-DDRetorna publicações criadas após a data especificada with:imagesRetorna publicações contendo imagens Ordem
Você pode classificar seus resultados de pesquisa usando as seguintes opções de ordem:
Sintaxe Descrição order:latestClassifica os resultados do mais novo para o mais antigo (atalho: l) order:oldestClassifica os resultados do mais antigo para o mais novo order:latest_topicClassifica os resultados pela data do tópico, do mais novo para o mais antigo order:oldest_topicClassifica os resultados pela data do tópico, do mais antigo para o mais novo order:viewsClassifica os resultados pelo número de visualizações order:likesClassifica 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 lorder:latestin:personalin:messagesmin_post_count:min_post:in:minein:createdcategory:categories:#Pode ser usado tanto para categorias quanto para tags, dependendo do contexto user:@@me@your_own_usernamefin:firsttin:titlePesquisando 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.
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
%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-pmsestá disponível apenas para administradores, não para usuários regulares ou moderadores.personal_messages:usernameestá 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étodosadvanced_filter.Dicas Adicionais
Você também pode pesquisar menções de tags como Bug \u003chttps://meta.discourse.org/search?q=“%20%23bug”\u003e
Alguns filtros podem ser adicionados por plugins. Por exemplo, o plugin Solved adiciona:
status:solved: Retorna publicações de tópicos resolvidosstatus:unsolved: Retorna publicações de tópicos não resolvidos em categorias que permitem a marcação de resolvidoO 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.
Como faltam alguns filtros, como in:pinned ou in:bookmarks, e aqueles que têm um alias não são explicados, tentei adicionar as informações que faltavam. Então, a tabela ficou bem complexa, razão pela qual tentei separá-la em tabelas menores. Isso é algo que o bot também fez aqui. Não tenho certeza se todas as explicações estão corretas. As descrições no tópico e as da conversa do @sam com o bot diferem. Para alguns, perguntei novamente ao bot e obtive outro resultado (estes estão destacados). Talvez alguém possa ajudar a corrigir as descrições. Também não estou totalmente satisfeito com a aparência geral. As colunas da tabela têm larguras diferentes.
Filtros
Filtros de Pesquisa
| Sintaxe | Descrição |
|---|---|
topic:topic_id |
Retorna posts em um tópico específico |
in:titlet |
Retorna tópicos com o termo no título |
in:first f |
Retorna apenas os primeiros posts nos tópicos |
in:replies |
Retorna apenas posts que são respostas, exclui os OPs do tópico |
in:regular |
Exclui posts de ação pequenos, sussurros e posts com cor de equipe aplicada |
in:whispers in:whisper |
Apenas para usuários com acesso a sussurros Retorna posts de sussurro |
include:unlisted include:invisible |
Apenas para Nível de Confiança 4 e equipe Retorna posts, incluindo aqueles de tópicos não listados |
in:all |
Apenas para usuários logados Retorna posts de tópicos públicos e mensagens pessoais |
in:all-posts |
Retorna todos os posts que correspondem à consulta, mesmo que vários posts correspondam dentro do mesmo tópico |
in:pinned |
Retorna posts fixados |
in:wiki |
Retorna posts wiki |
with:images |
Retorna posts contendo imagens |
filetypes:ext1,ext2,ext3 filetype:ext1,ext2,ext3 |
Retorna posts com uploads das extensões de arquivo ext1, ext2 ou ext3 |
badge:name_or_id |
Retorna posts vinculados a uma concessão de emblema específica |
Filtros de Mensagem
(para usuários logados)
| Sintaxe | Descrição |
|---|---|
in:personal in:messages |
Retorna posts de mensagens pessoais |
in:personal-direct |
Retorna posts de mensagens pessoais entre você e exatamente outro usuário |
group_messages:group_name_or_id |
Retorna posts de mensagens pessoais enviadas para o grupo group_name (Isso só funciona quando o grupo e seus membros são visíveis para você) |
personal_messages:username |
Apenas para Administradores Retorna posts das mensagens pessoais do usuário especificado |
in:all-pms |
Apenas para Administradores Retorna posts de todas as mensagens pessoais, incluindo aquelas das quais você não faz parte |
Filtros Específicos de Usuário e Grupo
| Sintaxe | Descrição |
|---|---|
@username user:username_or_id |
Retorna posts de username |
created:@username in:first @username |
Retorna os primeiros posts em tópicos criados por username |
group:group_name_or_id |
Retorna posts de usuários dentro do grupo group_name |
in:bot in:bots |
Retorna posts de contas de sistema e bot (ex: @system, @discobot) |
in:humanin:humans |
Retorna posts de usuários regulares |
Filtros de Categoria e Tag
| Sintaxe | Descrição |
|---|---|
category:category1 #category1 |
Retorna posts de category1 |
categories:category1,category2category:category1,category2 |
Retorna posts das categorias category1 e category2 |
tag:tag1 #tag1 |
Retorna posts de tópicos com a tag tag1 |
-tag:tag1 |
Retorna posts de tópicos sem a tag tag1 |
tags:tag1,tag2 tag:tag1,tag2 |
Retorna posts de tópicos com a tag tag1 ou tag2 |
-tags:tag1,tag2-tag:tag1,tag2 |
Retorna posts de tópicos sem a tag tag1 ou tag2 |
tags:tag1+tag2 tag:tag1+tag2 |
Retorna posts de tópicos com as tags tag1 e tag2 |
-tags:tag1+tag2 -tag:tag1+tag2 |
Retorna posts de tópicos sem as tags tag1 e tag2 |
in:tagged |
Retorna posts de tópicos que têm pelo menos uma tag |
in:untagged |
Retorna posts de tópicos sem tags |
Filtros Personalizados (Específicos do Usuário)
(para usuários logados)
| Sintaxe | Descrição |
|---|---|
in:seen |
Retorna posts que você viu |
in:unseen |
Retorna posts que você não viu |
in:watching |
Retorna posts de tópicos que você está assistindo |
in:tracking |
Retorna posts de tópicos que você está rastreando |
in:bookmarks |
Retorna posts que você marcou |
@me@your_own_username |
Retorna posts escritos por você |
in:posted |
Retorna todos os posts de tópicos nos quais você postou |
in:created in:mine |
Retorna os primeiros posts de tópicos escritos por você |
Filtros de Contagem de Posts e Visualizações
| Sintaxe | Descrição |
|---|---|
min_posts:X min_post_count:X |
Retorna posts de tópicos com pelo menos X posts |
max_posts:X |
Retorna posts de tópicos com no máximo X posts |
posts_count:X |
Retorna posts de tópicos que têm exatamente X posts |
min_views:X |
Retorna posts de tópicos com pelo menos X visualizações |
max_views:X |
Retorna posts de tópicos com no máximo X visualizações |
Filtros de Data
Todas as datas estão em UTC, sempre usamos o início do dia UTC como hora de início para qualquer período.
| Sintaxe | Descrição |
|---|---|
before:YYYY-MM-DD |
Retorna posts criados antes da data especificada |
after:YYYY-MM-DD |
Retorna posts criados após a data especificada |
before:day_of_week |
Retorna posts criados antes do dia da semana especificado |
after:day_of_week |
Retorna posts criados no dia da semana especificado ou depois |
before:X |
Retorna posts criados há mais de X dias |
after:X |
Retorna posts criados nos últimos X dias |
before:month |
Retorna posts criados antes do mês especificado |
after:month |
Retorna posts criados dentro e após o mês especificado |
before:YYYY |
Retorna posts criados antes do ano especificado |
after:YYYY |
Retorna posts criados dentro e após o ano especificado |
Filtros de Status
| Sintaxe | Descrição |
|---|---|
status:open |
Retorna posts de tópicos que não estão fechados ou arquivados |
status:closed |
Retorna posts de tópicos fechados |
status:archived |
Retorna posts de tópicos arquivados |
status:noreplies |
Retorna posts de tópicos sem respostas |
status:single_user |
Retorna posts de tópicos com posts de apenas um usuário |
status:public |
Retorna posts de tópicos em categorias públicas |
Filtros de Idioma
| Sintaxe | Descrição |
|---|---|
locale:language_code |
Retorna posts escritos naquele idioma, ex: en, en_US, en-gb |
locale:any locale:present |
Retorna posts que têm um locale definido |
locale:none locale:null |
Retorna posts sem um locale |
Filtros Adicionados por Plugins
| Sintaxe | Descrição |
|---|---|
| Assign | |
in:assigned |
Retorna posts de tópicos atribuídos a alguém |
in:unassigned |
Retorna posts de tópicos não atribuídos a ninguém |
assigned:username |
Retorna posts de tópicos atribuídos a username |
| Docs | |
in:docs in:kb |
Retorna posts de categorias e tags incluídas em docs |
| Doc Categories | |
in:docs |
Retorna posts de categorias que têm um tópico de índice |
| Polls | |
in:polls |
Retorna posts contendo enquetes |
| Solved | |
status:solved |
Retorna posts de tópicos resolvidos |
status:unsolved |
Retorna posts de tópicos não resolvidos em categorias que permitem a marcação de resolvido |
| Topic voting | |
min_vote_count:X |
Retorna posts de tópicos com pelo menos X votos |
Ordem
| Sintaxe | Descrição |
|---|---|
order:latestl |
Ordena os resultados do mais novo para o mais antigo |
order:oldest |
Ordena os resultados do mais antigo para o mais novo |
order:latest_topic |
Ordena os resultados pela data do tópico, do mais novo para o mais antigo |
order:oldest_topic |
Ordena os resultados pela data do tópico, do mais antigo para o mais novo |
order:views |
Ordena os resultados pelo número de visualizações |
order:likes |
Ordena os resultados pelo número de curtidas |
order:readr |
Apenas para usuários logados Ordena os resultados pela data em que você visitou o tópico pela última vez |
Opções de Ordem adicionadas por Plugins
| Sintaxe | Descrição |
|---|---|
| Topic voting | |
order:votes |
Ordena os resultados pelo número de votos no tópico contendo o post |
Acho que é o mesmo que @me
Existe uma maneira de excluir respostas para que apenas tópicos apareçam em uma pesquisa?
Sim
Muito obrigado.
Este link leva para a página pretendida?
Eu acho que sim. Ele te leva para a lista de tópicos com a barra de filtro no topo.
O que você esperava?
Entendi. Clicar no link mostra isto:
então, se você não sabe o que é uma barra de filtros, não pode descobri-la! Obrigado por enviar o que o leitor deve ver.
Encontrei estes mais fáceis de ler com as quebras de linha.
A tabela no OP foi atualizada para incluir os recém-lançados in:all-posts e in:replies anunciados em Search improvements to make community management easier!
Obrigado. Eu teria apreciado se você também tivesse adicionado de volta as quebras de linha que foram removidas durante a edição anterior.
Eu também adicionarei os novos filtros à minha postagem. Existem planos para incluir os filtros ausentes na postagem oficial?
Olá @Moin,
Meu objetivo era apenas capturar os dois novos recursos antes que fossem esquecidos.
Vou atribuir este tópico e ver se podemos atualizar totalmente o OP quando alguém da equipe puder dedicar um tempo para isso.
Os filtros de localidade também foram adicionados no último mês: Search for localized title/content in Discourse search - #15 by nat.
Portanto, não ficou óbvio por que você adicionou estes, mas não os outros filtros.
Apenas porque eu estava envolvido e ciente do lançamento de in:replies e in:all-posts, e venho de um histórico de edição de documentação em tempo real. Não foi uma omissão intencional de quaisquer recursos específicos do OP.
Agradeço as atualizações oportunas, mas acho quase mais difícil descobrir o que está faltando porque não é mais suficiente olhar o que mudou desde a última edição. Minha sensação é que 2 das últimas 4 alterações foram adicionadas (ordem:read & in:replies/all-posts vs. in:bots/human & locale:language).
Há algo que você gostaria de ver em termos de como apontar as alterações? Adicionei in:bots há algum tempo. Eu poderia ter respondido aqui, mas minha impressão geral é que esses comentários raramente levam a mudanças. Desde a mudança para ‘somente membros da equipe podem editar’, sinto que o fluxo de trabalho para transformar aspectos encontrados pela comunidade em melhorias está faltando.
Não é uma decisão só minha, então levarei seu feedback de volta para a equipe e veremos onde chegamos.
Por enquanto, a menos que/até que voltemos a usar wikis para a documentação, acho que os comentários são úteis, porque assim, quando um membro da equipe puder priorizar a atualização de um documento, você terá ajudado a garantir que itens específicos não sejam esquecidos.
Você pode não ter a satisfação imediata de ver seus comentários incorporados imediatamente, mas eles serão sem dúvida apreciados quando uma atualização for feita.