Buscando contenido eficazmente

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

:person_raising_hand: 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 :information_source: 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 :information_source: 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.

:information_source: 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

:information_source: 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
  1. 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
  1. 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

:bulb: 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.

12 Me gusta

Dado que faltan algunos filtros, como in:pinned o in:bookmarks, y los que tienen un alias no se explican, intenté añadir la información que faltaba. Luego la tabla se volvió bastante compleja, por lo que intenté separarla en tablas más pequeñas. Esto es algo que el bot también hizo aquí. No estoy seguro de que todas las explicaciones sean correctas. Las descripciones en el tema y las de la conversación de @sam con el bot difieren. Para algunos, incluso volví a preguntar al bot y obtuve otro resultado (estos son los resaltados). Quizás alguien pueda ayudar a corregir las descripciones. Tampoco estoy del todo satisfecho con la apariencia general. Las columnas de la tabla tienen anchos diferentes.


Filtros

Filtros de Búsqueda

Sintaxis Descripción
topic:topic_id Devuelve publicaciones en un tema específico
in:title
t
Devuelve temas con el término en el título
in:first
f
Devuelve solo las primeras publicaciones de los temas
in:replies Devuelve solo las publicaciones que son respuestas, excluye los OP del tema
in:regular Excluye publicaciones de acción pequeña, susurros y publicaciones con color de personal aplicado
in:whispers
in:whisper
:information_source: Solo para usuarios con acceso a susurros
Devuelve publicaciones de susurros
include:unlisted
include:invisible
:information_source: Solo para Nivel de Confianza 4 y personal
Devuelve publicaciones, incluidas las de temas no listados
in:all :information_source: Solo para usuarios registrados
Devuelve publicaciones de temas públicos y mensajes personales
in:all-posts Devuelve cada publicación que coincide con la consulta, incluso cuando coinciden varias publicaciones dentro del mismo tema
in:pinned Devuelve publicaciones fijadas
in:wiki Devuelve publicaciones wiki
with:images Devuelve publicaciones que contienen imágenes
filetypes:ext1,ext2,ext3
filetype:ext1,ext2,ext3
Devuelve publicaciones con subidas de extensiones de archivo ext1, ext2 o ext3
badge:name_or_id Devuelve publicaciones vinculadas a una concesión de insignia específica

Filtros de Mensajes

(para usuarios registrados)

Sintaxis Descripción
in:personal
in:messages
Devuelve publicaciones de mensajes personales
in:personal-direct Devuelve publicaciones de mensajes personales entre tú y exactamente otro usuario
group_messages:group_name_or_id Devuelve publicaciones de mensajes personales enviados al grupo group_name (Esto solo funciona cuando el grupo y sus miembros son visibles para ti)
personal_messages:username :information_source: Solo para administradores
Devuelve publicaciones de los mensajes personales del usuario especificado
in:all-pms :information_source: Solo para administradores
Devuelve publicaciones de todos los mensajes personales, incluidos aquellos en los que no participas

Filtros Específicos de Usuario y Grupo

Sintaxis Descripción
@username
user:username_or_id
Devuelve publicaciones de username
created:@username
in:first @username
Devuelve las primeras publicaciones de temas creados por username
group:group_name_or_id Devuelve publicaciones de usuarios dentro del grupo group_name
in:bot
in:bots
Devuelve publicaciones de cuentas de sistema y bots (ej. @system, @discobot)
in:human
in:humans
Devuelve publicaciones de usuarios regulares

Filtros de Categoría y Etiqueta

Sintaxis Descripción
category:category1
#category1
Devuelve publicaciones de category1 y sus subcategorías
category:=category1
#=category1
Devuelve publicaciones de category1, excluyendo sus subcategorías
categories:category1,category2
category:category1,category2
Devuelve publicaciones de las categorías category1 y category2 y sus subcategorías
categories:=category1,=category2
category:=category1,=category2
Devuelve publicaciones de las categorías category1 y category2, excluyendo sus subcategorías.
tag:tag1
#tag1
Devuelve publicaciones de temas etiquetados con tag1
-tag:tag1 Devuelve publicaciones de temas no etiquetados con tag1
tags:tag1,tag2
tag:tag1,tag2
Devuelve publicaciones de temas etiquetados con tag1 o tag2
-tags:tag1,tag2
-tag:tag1,tag2
Devuelve publicaciones de temas no etiquetados con tag1 o tag2
tags:tag1+tag2
tag:tag1+tag2
Devuelve publicaciones de temas etiquetados con tag1 y tag2
-tags:tag1+tag2
-tag:tag1+tag2
Devuelve publicaciones de temas no etiquetados con tag1 y tag2
in:tagged Devuelve publicaciones de temas que tienen al menos una etiqueta
in:untagged Devuelve publicaciones de temas sin etiquetas

Filtros Personalizados (Específicos del Usuario)

(para usuarios registrados)

Sintaxis Descripción
in:seen Devuelve publicaciones que has visto
in:unseen Devuelve publicaciones que no has visto
in:watching Devuelve publicaciones de temas que estás siguiendo
in:tracking Devuelve publicaciones de temas que estás rastreando
in:bookmarks Devuelve publicaciones que has marcado como favoritas
@me
@your_own_username
Devuelve publicaciones escritas por ti
in:posted Devuelve todas las publicaciones de temas en los que has publicado
in:created
in:mine
Devuelve las primeras publicaciones de temas escritos por ti

Filtros de Conteo de Publicaciones y Vistas

Sintaxis Descripción
min_posts:X
min_post_count:X
Devuelve publicaciones de temas con al menos X publicaciones
max_posts:X Devuelve publicaciones de temas con como máximo X publicaciones
posts_count:X Devuelve publicaciones de temas que tienen exactamente 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

Filtros de Fecha

Todas las fechas están en UTC, siempre usamos el comienzo del día UTC como hora de inicio para cualquier período.

Sintaxis Descripción
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
before:day_of_week Devuelve publicaciones creadas antes del día de la semana especificado
after:day_of_week Devuelve publicaciones creadas en o después del día de la semana especificado
before:X Devuelve publicaciones creadas hace más de X días
after:X Devuelve publicaciones creadas dentro de los últimos X días
before:month Devuelve publicaciones creadas antes del mes especificado
after:month Devuelve publicaciones creadas dentro y después del mes especificado
before:YYYY Devuelve publicaciones creadas antes del año especificado
after:YYYY Devuelve publicaciones creadas dentro y después del año especificado

Filtros de Estado

Sintaxis Descripción
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

Filtros de Idioma

Sintaxis Descripción
locale:language_code Devuelve publicaciones escritas en ese idioma, ej. en, en_US, en-gb
locale:any
locale:present
Devuelve publicaciones que tienen un idioma establecido
locale:none
locale:null
Devuelve publicaciones sin un idioma

Filtros añadidos por Plugins

Sintaxis Descripción
Assign
in:assigned Devuelve publicaciones de temas asignados a alguien
in:unassigned Devuelve publicaciones de temas no asignados a nadie
assigned:username Devuelve publicaciones de temas asignados a username
Docs
in:docs
in:kb
Devuelve publicaciones de categorías y etiquetas incluidas en docs
Doc Categories
in:docs Devuelve publicaciones de categorías que tienen un tema de índice
Polls
in:polls Devuelve publicaciones que contienen encuestas
Solved
status:solved Devuelve publicaciones de temas resueltos
status:unsolved Devuelve publicaciones de temas no resueltos en categorías que permiten marcar como resuelto
Topic voting
min_vote_count:X Devuelve publicaciones de temas con al menos X votos

Orden

Sintaxis Descripción
order:latest
l
Ordena los resultados de más nuevo a más antiguo
order:oldest Ordena los resultados de más antiguo a más nuevo
order:latest_topic Ordena los resultados por fecha del tema, de más nuevo a más antiguo
order:oldest_topic Ordena los resultados por fecha del tema, de más antiguo a 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
r
:information_source: Solo para usuarios registrados
Ordena los resultados por la fecha en que visitaste el tema por última vez

Opciones de orden añadidas por Plugins

Sintaxis Descripción
Topic voting
order:votes Ordena los resultados por el número de votos en el tema que contiene la publicación
5 Me gusta

Creo que es lo mismo que @me

1 me gusta

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

5 Me gusta

Muchas gracias.

1 me gusta

¿Este enlace lleva a la página deseada?

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

¿Qué esperabas?

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.

1 me gusta

I found these easier to read with the line breaks.

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!

3 Me gusta

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?

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.

2 Me gusta

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.

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.

1 me gusta

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.

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.

1 me gusta