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 « J'aime »
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 « J'aime »
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 « J'aime »
Ce serait très utile. Je viens d’importer de nombreux documents d’une autre plateforme qui renvoient à d’autres documents, et je semble être obligé soit de les remplacer par des liens vers la page des documents (/docs?category=123&topic=456), soit vers la page du sujet (/t/topic-title/456).
Il serait agréable de pouvoir utiliser le lien informatif du sujet (contenant le titre du sujet) mais qu’il redirige vers le document lorsqu’il est vu dans la vue Documents.
De plus, si nous déplaçons le sujet vers une autre catégorie, le lien /docs?category ne fonctionne plus correctement. Étonnamment, il présente le sujet dans la vue Documents, mais il définit le filtre pour l’ancienne catégorie.
4 « J'aime »
Je déterre celui-ci ! Exactement ce que nous cherchons !
Actuellement, nous ajoutons des liens vers des sujets de documentation comme ceci : /docs?ascending=false&category=22&topic=1564, ce qui est un énorme problème.
4 « J'aime »
Juste un petit rappel et une question : est-ce que vous supportez aussi les PRs pour cela ? Je serais heureux de sponsoriser une telle fonctionnalité.
1 « J'aime »
Bonjour et merci pour la suggestion et l’offre de PR. Nous avons discuté de l’amélioration de la documentation, y compris de l’idée que chaque document ait une seule URL au lieu de 2 URLs. Je pense que cela résoudrait ce problème, mais cela nécessiterait un refactoring considérable de la fonctionnalité de documentation telle qu’elle existe actuellement.
3 « J'aime »
Oh, il y a une solution de contournement rapide. Je pense que la fonctionnalité de permalien intégrée devrait fonctionner ? Vous pouvez les définir dans votre interface d’administration. Un peu de travail supplémentaire, mais cela vous donne des URL très propres à partager.
Merci les gars, j’apprécie vos commentaires !
Nous allons essayer d’utiliser la solution de contournement suggérée pour l’instant. Mais plus nous remplirons notre /docs de sujets, plus les choses pourraient devenir compliquées si nous devons gérer manuellement une longue liste d’URL.
2 « J'aime »