notre entreprise utilise Discourse pour soutenir nos clients et renforcer les relations avec eux. Pour l’intégration du personnel, nous avons créé une documentation à l’aide des Catégories de documentation et de DiscoTOC, ce qui fonctionne très bien.
Cependant, j’aimerais demander une fonctionnalité qui permettrait d’exporter les sources de la documentation – spécifiquement le texte brut incluant le balisage – vers un fichier texte brut.
Je suis conscient de l’option d’impression PDF du navigateur, qui n’est pas utile lorsque des sources brutes sont nécessaires plutôt que des sources analysées. Je connais également la fonction de sauvegarde intégrée et les requêtes de base de données, mais ce ne sont pas des solutions pratiques pour l’administration frontale.
Pour l’instant, mon flux de travail est le suivant : Modifier le message → STRG-A, STRG-C → créer / ouvrir un fichier texte → STRG-V, STRG-S → Annuler les modifications… message suivant.
Une option d’exportation groupée intégrée offrirait plusieurs avantages :
maintenance beaucoup plus facile des bases de connaissances
meilleurs flux de sauvegarde et de versionnement pour les administrateurs dans le frontend
réutilisation flexible du contenu en dehors de Discourse
Une telle fonctionnalité serait un véritable gain de productivité pour les communautés qui utilisent Discourse comme centre de documentation, pas seulement pour le support.
L’un de mes problèmes est de traiter les demandes de fonctionnalités comme des demandes de support. Oups, je l’ai encore fait. Désolé si cela n’aide pas.
C’est assez facile à automatiser avec des outils en ligne de commande. Un outil intelligent pourrait obtenir le json du sujet pour voir combien de messages il y avait, puis les obtenir tous, en faisant peut-être une pause pour gérer les limitations de débit.
Un composant de thème pourrait vous donner des liens vers le texte brut de chaque message. Un plugin pourrait faire ce que vous voulez.
Merci pour le conseil, Richard Je vais consulter Data Explorer et les appels API quand j’aurai l’occasion. Néanmoins, ce n’est qu’une astuce, pas une fonctionnalité.
Prenez le plugin Doc Categories comme exemple : pour construire une documentation, tout ce dont vous avez techniquement besoin est un post d’index contenant les liens vers tous les sujets. Mais le plugin ajoute quelque chose en plus : une navigation automatique dans les pages.
C’est exactement le genre de demande de fonctionnalité que je fais : une fonctionnalité supplémentaire qui aide les utilisateurs réguliers – pas juste une autre solution de contournement pour les utilisateurs avancés ou les informaticiens.
Si je souhaitais une telle fonctionnalité, j’aimerais qu’elle me fournisse un fichier zip contenant toutes les sources markdown référencées par l’index de la documentation.
Comment voudrait-on nommer les fichiers individuels dans ce cas ?
Pourriez-vous décrire votre flux de travail prévu plus en détail ?
Si je devais construire un flux de travail de documentation comme vous le décrivez, je préférerais créer une option pour monter le markdown brut dans le système de fichiers, ce qui permettrait à d’autres outils automatisés de travailler dessus.
Je ne comprends pas ce point.
Pourquoi ne souhaitez-vous pas présenter votre documentation via Discourse ?
Salut Thomas, un conteneur zip fonctionnerait bien sûr très bien Il n’y a pas de flux de travail derrière, juste le souhait de conserver une sauvegarde simple.
Peut-être pourriez-vous me donner un bon exemple au lieu de répondre par une attaque ad hominem. Même votre premier message parle d’administrateurs et de personnes gérant des bases de connaissances.
Désolé, vous avez partagé vos opinions personnelles et je répondais simplement – aucune offense n’était intentionnelle.
Par exemple, les personnes qui gèrent des bases de connaissances, comme les gestionnaires de connaissances qui créent du contenu en tant qu’administrateurs mais ont une formation technique limitée, veulent gérer leur contenu elles-mêmes et pouvoir le sauvegarder localement.
Alors, l’explorateur de données serait une solution tout à fait valable.
Vous pouvez également rendre cette requête accessible aux utilisateurs non administrateurs.
Salut @soeren-1 et bienvenue dans notre communauté !
Votre demande de fonctionnalité semble intéressante ! Je pense qu’il est formidable d’avoir ce sujet disponible afin que d’autres personnes ayant une configuration similaire puissent y contribuer. Peut-être qu’un jour quelque chose comme cela fera partie de l’interface utilisateur. Mais je pense que vous n’avez pas encore démontré qu’il s’agissait d’une fonctionnalité largement utile.
Vous êtes nouveau ici, alors laissez-moi vous expliquer certaines choses qui ne vous seront peut-être pas évidentes. L’ajout de fonctionnalités prend du temps et des ressources, c’est pourquoi les nouvelles fonctionnalités sont généralement ajoutées à Discourse lorsqu’un de nos clients entreprise les demande ou lorsqu’il y a une forte demande pour celles-ci, par exemple la règle des trois. Elles commencent souvent sous forme de plugins ou de composants avant de finalement intégrer notre produit principal.
Pour de nombreux cas uniques, l’API Discourse et l’explorateur de données fournissent des solutions rapides et simples qui sont généralement « suffisamment bonnes ». Je reconnais que ce n’est pas ce que vous demandez ici ! Mais parfois, essayer de résoudre un problème à l’aide de l’API ou d’une requête d’explorateur de données peut aider à justifier l’ajout de fonctionnalités ou à trouver une meilleure façon de résoudre un problème particulier.
Avez-vous vu comment les requêtes de l’explorateur de données peuvent être mises à la disposition de groupes et avoir une interface utilisateur pour spécifier des paramètres ? Ceci convient aux « utilisateurs réguliers » et pourrait vous convenir, à vous et à votre équipe, comme solution intermédiaire pour vous aider à défendre votre nouvelle idée de fonctionnalité. Je ne sais pas s’il existe déjà une requête appropriée pour vous aider à démarrer – l’endroit pour commencer à chercher est Data & reporting.
@rgj Je pense que tu es un gars normal, peu importe ce que disent les autres !
Merci pour l’accueil, les clarifications et les conseils, Tobias.
Je ne suis pas si sûr pour les fonctionnalités largement utilisées – il existe de nombreuses options et paramètres dans Discourse où je me suis demandé : « qui a besoin de ça ? »
Les gens ont tendance à utiliser les outils qui sont disponibles et familiers. Si vous avez déjà un marteau, vous pourriez vous demander à quoi sert une massette.
Peut-être que d’autres utilisateurs verront un cas d’utilisation pour la fonctionnalité proposée et se joindront à la discussion.