Los enlaces deben permanecer en Docs

We use Discourse to communicate in our team. We have a special category for our internal handbook, where all posts are wikis.
The Docs plugin is perfect to search and view our internal documentation, except for the fact that when one docs page links to another page, it returns back to the normal forum view.
Is there a way to automagically rewrite the links so that when one post links to another post, this stays in the Knowledge Explorer?

7 Me gusta

It would be possible to do this, but it would be a relatively hacky implementation. We’d have to append a query param to each link click, then redirect to the Docs view via patching into the TopicController. However, not all internal links will point to a topic that’s in Docs, so there’s that to account for, too.

I’d like to see more requests for this before we attempt to implement it.

6 Me gusta

I’m in support of this, and would furthermore like a way to have “Docs” topics always default to the “Docs” view first, no matter where the link is coming from. Otherwise it is a somewhat inconsistent experience and can end up feeling a bit “hacky” in itself at times.

4 Me gusta

Esto sería muy útil. Acabo de importar muchos documentos de una plataforma diferente que enlazan a otros documentos, y parece que me veo obligado a reemplazarlos con enlaces a la página de documentos (/docs?category=123&topic=456) o a la página del tema (/t/topic-title/456).

Sería bueno poder usar el enlace informativo del tema (contiene el título del tema) pero que redirija al documento cuando se ve en la vista de Documentos.

Además, si movemos el tema a otra categoría, el enlace /docs?category ya no funciona correctamente. Sorprendentemente, de hecho presenta el tema en la vista de Documentos, pero establece el filtro para la categoría antigua.

4 Me gusta

¡Desenterrando este! ¡Exactamente lo que estamos buscando!

Actualmente estamos agregando enlaces a temas de Documentación de esta manera: /docs?ascending=false&category=22&topic=1564 lo cual es una gran molestia.

4 Me gusta

Solo una rápida actualización y pregunta si ustedes también admiten PRs para esto. Estaría feliz de patrocinar dicha función.

1 me gusta

Hola y gracias por la sugerencia y la oferta de PR. Hemos estado hablando de mejorar la documentación, incluida la idea de que cada documento tenga una única URL en lugar de 2 URL. Creo que eso resolvería este problema, pero requeriría una refactorización considerable de la función de documentación tal como existe ahora.

3 Me gusta

Oh, hay una solución rápida. ¿Creo que la función de enlace permanente integrada debería funcionar? Puedes definirlos en tu interfaz de administrador. Un poco de trabajo extra, pero te da URL muy limpias para compartir.

¡Gracias, chicos, aprecio los comentarios!

Por ahora, intentaremos usar la solución alternativa sugerida. Pero cuanto más llenemos nuestra /docs con temas, más complicadas podrían volverse las cosas si tenemos que administrar manualmente una larga lista de URL.

2 Me gusta