Usamos o Discourse para nos comunicarmos em nossa equipe. Temos uma categoria especial para nosso manual interno, onde todas as postagens são wikis.
O plugin Docs é perfeito para pesquisar e visualizar nossa documentação interna, exceto pelo fato de que, quando uma página de docs linka para outra página, ele retorna à visualização normal do fórum.
Existe alguma maneira de reescrever automaticamente os links para que, quando uma postagem linkar para outra, isso permaneça no Knowledge Explorer?
Seria possível fazer isso, mas seria uma implementação relativamente ‘hacky’. Teríamos que adicionar um parâmetro de consulta a cada clique em um link e, em seguida, redirecionar para a visualização da Docs, modificando o TopicController. No entanto, nem todos os links internos apontarão para um tópico que esteja na Docs, então isso também precisa ser considerado.
Gostaria de ver mais solicitações sobre isso antes de tentarmos implementá-lo.
Eu apoio isso e, além disso, gostaria de uma maneira de fazer com que os tópicos de “Docs” sempre tenham a visualização “Docs” como padrão, independentemente de onde o link esteja vindo. Caso contrário, a experiência acaba sendo um tanto inconsistente e, às vezes, pode parecer um pouco “gambiarra” em si mesma.
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.
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.
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.
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.
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.