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 curtidas
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 curtidas
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 curtidas
Isso seria muito útil. Acabei de importar muitos documentos de uma plataforma diferente que se vinculam a outros documentos e pareço ser forçado a substituí-los por links para a página de documentos (/docs?category=123&topic=456) ou para a página do tópico (/t/topic-title/456).
Seria bom poder usar o link informativo do tópico (contém o título do tópico), mas fazer com que ele redirecione para o Documento quando visualizado na visualização de Documentos.
Além disso, se movermos o tópico para outra categoria, o link /docs?category não funcionará mais corretamente. Surpreendentemente, ele realmente apresenta o tópico na visualização de Documentos, mas define o filtro para a categoria antiga.
4 curtidas
Desenterrando este! Exatamente o que procuramos!
Atualmente, estamos adicionando links para tópicos da documentação como este: /docs?ascending=false&category=22&topic=1564, o que é um grande incômodo.
4 curtidas
Apenas um rápido lembrete e uma pergunta se vocês também oferecem suporte a PRs para isso? Ficaria feliz em patrocinar tal recurso.
1 curtida
Olá e obrigado pela sugestão e oferta de PR. Temos conversado sobre a melhoria da Documentação, incluindo a ideia de cada documento ter um único URL em vez de 2 URLs. Acho que isso resolveria esse problema, mas exigiria uma refatoração considerável do recurso de Documentação como existe agora.
3 curtidas
Ah, existe uma solução rápida. Acho que o recurso de link permanente integrado deve funcionar? Você pode defini-los em sua interface de administrador. Um pouco de trabalho extra, mas oferece URLs muito limpas para compartilhar.
Valeu pessoal, agradeço o feedback!
Vamos tentar usar a solução alternativa sugerida por enquanto. Mas quanto mais preenchermos nossa /docs com tópicos, mais complicadas as coisas podem se tornar se tivermos que gerenciar manualmente uma longa lista de URLs.
2 curtidas