Buscando contenido eficazmente

[Discourse]

Esta guía proporciona una descripción completa de las capacidades de búsqueda de Discourse, incluyendo filtros, opciones y técnicas avanzadas.

Nivel de usuario requerido: Todos los usuarios

Discourse ofrece una potente funcionalidad de búsqueda con numerosos filtros y criterios. Cuando utilizas el formulario de búsqueda avanzada, este añade automáticamente la sintaxis relevante a tu consulta. Por ejemplo, seleccionar \[x\] En mis mensajes añadirá in:personal a tu consulta de búsqueda.

Esta guía cubre todas las opciones y características de búsqueda disponibles en Discourse, y proporciona consejos y trucos útiles para usar la función de búsqueda.

Filtros

Discourse proporciona una amplia gama de filtros para ayudarte a refinar tus resultados de búsqueda. Aquí tienes una lista completa de los filtros disponibles:

Sintaxis	Descripción
in:personal-direct	Devuelve solo publicaciones en mensajes personales entre dos usuarios
in:all-pms	Solo para administradores Devuelve publicaciones de todos los mensajes personales, incluidos aquellos en los que no participas
in:all	Devuelve publicaciones de temas públicos y mensajes personales
in:replies	Devuelve solo las publicaciones que son respuestas, excluye a los creadores de temas (OPs)
in:all-posts	Devuelve cada publicación que coincide con la consulta, incluso cuando coinciden varias publicaciones dentro del mismo tema
in:tagged	Devuelve publicaciones de temas que tienen al menos una etiqueta
in:untagged	Devuelve publicaciones de temas sin etiquetas
in:seen	Devuelve publicaciones que has visto (para usuarios registrados)
in:unseen	Devuelve publicaciones que no has visto (para usuarios registrados)
in:wiki	Devuelve publicaciones wiki
in:watching	Devuelve publicaciones de temas que estás siguiendo
in:tracking	Devuelve publicaciones de temas que estás rastreando
posts_count:X	Devuelve publicaciones de temas que tienen exactamente X publicaciones
min_posts:X	Devuelve publicaciones de temas con al menos X publicaciones
max_posts:X	Devuelve publicaciones de temas con como máximo X publicaciones
min_views:X	Devuelve publicaciones de temas con al menos X vistas
max_views:X	Devuelve publicaciones de temas con como máximo X vistas
badge:name_or_id	Devuelve publicaciones vinculadas a la concesión de una insignia específica
created:@username	Devuelve publicaciones de temas creados por username
group:group_name	Devuelve publicaciones de usuarios dentro del grupo group_name
group_messages:group_name	Devuelve publicaciones de mensajes personales enviados al grupo group_name
personal_messages:username	Solo para administradores Devuelve publicaciones de mensajes personales del usuario especificado
-tags:tag1,tag2,tag3	Devuelve publicaciones que no están etiquetadas con tag1, tag2 o tag3
filetypes:ext1,ext2,ext3	Devuelve publicaciones con subidas de extensiones de archivo ext1, ext2 o ext3
categories:category1,category2	Devuelve publicaciones de las categorías category1 y category2
status:open	Devuelve publicaciones de temas que no están cerrados o archivados
status:closed	Devuelve publicaciones de temas cerrados
status:archived	Devuelve publicaciones de temas archivados
status:noreplies	Devuelve publicaciones de temas sin respuestas
status:single_user	Devuelve publicaciones de temas con publicaciones de un solo usuario
status:public	Devuelve publicaciones de temas en categorías públicas
before:YYYY-MM-DD	Devuelve publicaciones creadas antes de la fecha especificada
after:YYYY-MM-DD	Devuelve publicaciones creadas después de la fecha especificada
with:images	Devuelve publicaciones que contienen imágenes

Orden

Puedes ordenar tus resultados de búsqueda utilizando las siguientes opciones de orden:

Sintaxis	Descripción
order:latest	Ordena los resultados del más nuevo al más antiguo (atajo: l)
order:oldest	Ordena los resultados del más antiguo al más nuevo
order:latest_topic	Ordena los resultados por fecha del tema, del más nuevo al más antiguo
order:oldest_topic	Ordena los resultados por fecha del tema, del más antiguo al más nuevo
order:views	Ordena los resultados por número de vistas
order:likes	Ordena los resultados por número de “me gusta”
order:read	(solo para usuarios registrados) ordena por la fecha de la última visita al tema (atajo: r)

Alias

Discourse proporciona varios alias para facilitar la búsqueda:

Sintaxis	Equivalente
l	order:latest
in:personal	in:messages
min_post_count:	min_post:
in:mine	in:created
category:	categories:
#	Se puede usar tanto para categorías como para etiquetas, dependiendo del contexto
user:	@
@me	@your_own_username
f	in:first
t	in:title

Búsqueda de Palabras Exactas

Discourse utiliza una técnica llamada Stemming (lematización) para encontrar palabras relacionadas. Si bien esto a menudo es útil, puede haber ocasiones en las que desees buscar una palabra exacta. Puedes hacerlo encerrando tu palabra con espacios y comillas dobles, así: \" término \".

Esto asegura que solo buscará la palabra “término” y excluirá otras palabras relacionadas.

Ten en cuenta que debido a que los espacios se consideran parte del término de búsqueda, no devolverá “término” si es la primera o la última palabra de una publicación, ya que no estará precedida ni seguida de un espacio.

Ejemplo: Búsqueda de menciones @

Actualmente, la búsqueda de menciones @ no es compatible directamente. Sin embargo, puedes lograr esto utilizando el método de búsqueda de palabra exacta:

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

Esto funciona porque %20 es cómo se codifican los espacios en las URL y %40 es cómo se codifica el símbolo @.

Esta consulta buscará específicamente @username (encerrado entre espacios).

Combinación de Opciones de Búsqueda

Puedes combinar varias opciones de búsqueda para crear consultas más específicas. Por ejemplo:

• status:open category:support tag:urgent after:2023-01-01 order:latest
  Esto buscará temas de soporte abiertos etiquetados como urgentes, creados después del 1 de enero de 2023, y ordenará los resultados por la publicación más reciente.

• @jane_doe in:watching min_posts:5 with:images
  Esto buscará publicaciones de Jane Doe en temas que estás siguiendo, con al menos 5 publicaciones y que contengan imágenes.

Permisos y Limitaciones

Algunas opciones de búsqueda avanzada pueden requerir ciertos permisos de usuario o pueden estar limitadas a roles de usuario específicos. Por ejemplo:

• in:all-pms solo está disponible para administradores, no para usuarios regulares o moderadores.
• personal_messages:username solo está disponible para administradores.

Siempre considera tu rol de usuario y permisos al utilizar opciones de búsqueda avanzada.

Alternativa de Búsqueda: Filtro de Lista de Temas

Hay disponible una característica experimental de /filter que admite muchos tipos de filtros. Puedes obtener más información en el tema oficial: Experimental topics list filter feature

Archivos Fuente

Para una visión más técnica de estas opciones, todos los filtros y parámetros de búsqueda se pueden encontrar en search.rb - busca los métodos advanced_filter.

Consejos Adicionales

1. También puedes buscar menciones de etiquetas como Bug \u003chttps://meta.discourse.org/search?q=“%20%23bug”\u003e

2. Algunos filtros pueden ser añadidos por plugins. Por ejemplo, el plugin Solved añade:

• status:solved: Devuelve publicaciones de temas resueltos
• status:unsolved: Devuelve publicaciones de temas no resueltos en categorías que permiten la marca de resuelto

3. El plugin Topic Voting añade una opción de orden adicional:

• order:votes: Ordena los resultados por el número de votos en el tema que contiene la publicación

Tómate un tiempo para experimentar con diferentes combinaciones de filtros y opciones para encontrar la estrategia de búsqueda más efectiva para tus necesidades.

[Moin]

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. Em seguida, a tabela tornou-se bastante complexa, razão pela qual tentei separá-la em tabelas menores. Isto é 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 publicações em um tópico específico
in:title
t	Retorna tópicos com o termo no título
in:first
f	Retorna apenas as primeiras publicações nos tópicos
in:replies	Retorna apenas publicações que são respostas, exclui os OPs do tópico
in:regular	Exclui publicações de ação pequenas, sussurros e publicações com cor de equipe aplicada
in:whispers
in:whisper	Apenas para usuários com acesso a sussurros
Retorna publicações de sussurros
include:unlisted
include:invisible	Apenas para Nível de Confiança 4 e equipe
Retorna publicações, incluindo aquelas de tópicos não listados
in:all	Apenas para usuários logados
Retorna publicações de tópicos públicos e mensagens pessoais
in:all-posts	Retorna cada publicação que corresponde à consulta, mesmo quando várias publicações correspondem dentro do mesmo tópico
in:pinned	Retorna publicações fixadas
in:wiki	Retorna publicações wiki
with:images	Retorna publicações contendo imagens
filetypes:ext1,ext2,ext3
filetype:ext1,ext2,ext3	Retorna publicações com uploads das extensões de arquivo ext1, ext2 ou ext3
badge:name_or_id	Retorna publicações vinculadas a uma concessão de emblema específica

Filtros de Mensagem

(para usuários logados)

Sintaxe	Descrição
in:personal
in:messages	Retorna publicações de mensagens pessoais
in:personal-direct	Retorna publicações de mensagens pessoais entre você e exatamente outro usuário
group_messages:group_name_or_id	Retorna publicações de mensagens pessoais enviadas ao grupo group_name (Isto só funciona quando o grupo e seus membros são visíveis para você)
personal_messages:username	Apenas para Administradores
Retorna publicações de mensagens pessoais do usuário especificado
in:all-pms	Apenas para Administradores
Retorna publicações 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 publicações de username
created:@username
in:first @username	Retorna as primeiras publicações de tópicos criados por username
group:group_name_or_id	Retorna publicações de usuários dentro do grupo group_name
in:bot
in:bots	Retorna publicações de contas de sistema e bots (ex: @system, @discobot)
in:human
in:humans	Retorna publicações de usuários regulares

Filtros de Categoria e Tag

Sintaxe	Descrição
category:category1
#category1	Retorna publicações de category1
categories:category1,category2
category:category1,category2	Retorna publicações das categorias category1 e category2
tag:tag1
#tag1	Retorna publicações de tópicos com a tag tag1
-tag:tag1	Retorna publicações de tópicos sem a tag tag1
tags:tag1,tag2
tag:tag1,tag2	Retorna publicações de tópicos com a tag tag1 ou tag2
-tags:tag1,tag2
-tag:tag1,tag2	Retorna publicações de tópicos sem a tag tag1 ou tag2
tags:tag1+tag2
tag:tag1+tag2	Retorna publicações de tópicos com as tags tag1 e tag2
-tags:tag1+tag2
-tag:tag1+tag2	Retorna publicações de tópicos sem as tags tag1 e tag2
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

Filtros Personalizados (Específicos do Usuário)

(para usuários logados)

Sintaxe	Descrição
in:seen	Retorna publicações que você viu
in:unseen	Retorna publicações que você não viu
in:watching	Retorna publicações de tópicos que você está assistindo
in:tracking	Retorna publicações de tópicos que você está rastreando
in:bookmarks	Retorna publicações que você marcou
@me
@your_own_username	Retorna publicações escritas por você
in:posted	Retorna todas as publicações de tópicos nos quais você publicou
in:created
in:mine	Retorna as primeiras publicações de tópicos escritos por você

Filtros de Contagem de Publicações e Visualizações

Sintaxe	Descrição
min_posts:X
min_post_count: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
posts_count:X	Retorna publicações de tópicos que têm exatamente 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

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 publicações criadas antes da data especificada
after:YYYY-MM-DD	Retorna publicações criadas após a data especificada
before:day_of_week	Retorna publicações criadas antes do dia da semana especificado
after:day_of_week	Retorna publicações criadas no dia da semana especificado ou depois
before:X	Retorna publicações criadas há mais de X dias
after:X	Retorna publicações criadas nos últimos X dias
before:month	Retorna publicações criadas antes do mês especificado
after:month	Retorna publicações criadas dentro e após o mês especificado
before:YYYY	Retorna publicações criadas antes do ano especificado
after:YYYY	Retorna publicações criadas dentro e após o ano especificado

Filtros de Status

Sintaxe	Descrição
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

Filtros de Idioma

Sintaxe	Descrição
locale:language_code	Retorna publicações escritas nesse idioma, ex: en, en_US, en-gb
locale:any
locale:present	Retorna publicações que têm um local definido
locale:none
locale:null	Retorna publicações sem um local

Filtros Adicionados por Plugins

Sintaxe	Descrição
Assign
in:assigned	Retorna publicações de tópicos atribuídos a alguém
in:unassigned	Retorna publicações de tópicos não atribuídos a ninguém
assigned:username	Retorna publicações de tópicos atribuídos a username
Docs
in:docs
in:kb	Retorna publicações de categorias e tags incluídas em docs
Doc Categories
in:docs	Retorna publicações de categorias que têm um tópico de índice
Polls
in:polls	Retorna publicações contendo enquetes
Solved
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
Topic voting
min_vote_count:X	Retorna publicações de tópicos com pelo menos X votos

Ordem

Sintaxe	Descrição
order:latest
l	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:read
r	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 a publicação

[Moin]

@Moin

in:posted	Devuelve todas las publicaciones de los temas en los que has publicado

Issue with advanced search when scoping to messages I posted

That filter is used to search in your posts

Creo que es lo mismo que @me

[MortenCopenhagen (Morten)]

¿Hay alguna forma de excluir las respuestas para que solo los temas aparezcan en una búsqueda?

[Moin]

Sí

@Moin

Filtros de búsqueda

Sintaxis	Descripción
in:first
f	Devuelve solo las primeras publicaciones en los temas

[MortenCopenhagen (Morten)]

Muchas gracias.

[David_Romano]

@Discourse

Un experimental /filter

¿Este enlace lleva a la página deseada?

[Moin]

Creo que sí. Te lleva a la lista de temas con la barra de filtros en la parte superior.

¿Qué esperabas?

[David_Romano]

Entiendo. Al hacer clic en el enlace, se muestra esto:

¡Así que si no sabes qué es una barra de filtros, no puedes descubrirla! Gracias por enviar lo que se supone que debe ver el lector.

[Moin]

I found these easier to read with the line breaks.

@Discourse

Solo para administradores Devuelve publicaciones de todos los mensajes personales, incluidos aquellos en los que no participas

…

Solo para administradores Devuelve publicaciones de mensajes personales del usuario especificado

[southpaw]

La tabla en el OP ha sido actualizada para incluir los recién lanzados in:all-posts y in:replies anunciados en Search improvements to make community management easier!

[Moin]

Gracias. Le habría agradecido que también hubiera añadido los saltos de línea que se eliminaron durante la edición anterior.

También añadiré los nuevos filtros a mi publicación. ¿Hay planes para incluir los filtros que faltan en la publicación oficial?

[southpaw]

Hola @Moin,

Mi objetivo era solo capturar las dos nuevas características antes de que pasaran desapercibidas.

Asignaré este tema y veré si podemos actualizar completamente al OP cuando alguien del equipo pueda dedicarle tiempo.

[Moin]

@southpaw

Mi objetivo era solo capturar las dos nuevas características antes de que pasaran desapercibidas.

Los filtros de localización también se añadieron durante el último mes: Search for localized title/content in Discourse search - #15 by nat.
Así que no estaba claro por qué añadiste estos pero no los otros filtros.

[southpaw]

@Moin

Así que no fue obvio por qué añadiste estos filtros y no los otros.

Solo porque tuve la suerte de estar involucrado y ser consciente del lanzamiento de in:replies y in:all-posts, y provengo de un entorno de edición de documentación en tiempo real. No fue una omisión intencional de ninguna característica específica del OP.

[Moin]

Aprecio las actualizaciones oportunas, pero me resulta casi más difícil averiguar qué falta porque ya no es suficiente ver lo que ha cambiado desde la última edición. Mi sensación es que 2 de los últimos 4 cambios se han añadido ahora (orden:read y in:replies/all-posts frente a in:bots/human y locale:language).

¿Hay algo que le gustaría ver en cuanto a cómo señalar los cambios? Añadí in:bots hace algún tiempo. Podría haber respondido aquí, pero mi impresión general es que estos comentarios rara vez conducen a cambios. Desde el cambio a ‘solo los miembros del equipo pueden editar’, siento que falta el flujo de trabajo para convertir los aspectos encontrados por la comunidad en mejoras.

[southpaw]

@Moin

¿Hay algo que te gustaría ver en términos de cómo señalar los cambios?

No es una decisión solo mía, así que llevaré tus comentarios al equipo y veré dónde aterrizamos.

Por ahora, a menos que/hasta que volvamos a usar wikis para la documentación, creo que los comentarios son útiles, porque así, cuando un miembro del equipo pueda priorizar la actualización de un documento, habrás ayudado a asegurar que elementos específicos no se pasen por alto.

Puede que no obtengas la gratificación inmediata de ver tus comentarios incorporados de inmediato, pero sin duda serán apreciados cuando se realice una actualización.