Export en masse des sources de publication brutes avec balisage

Salut,

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.

:information_source: 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 messageSTRG-A, STRG-Ccréer / ouvrir un fichier texteSTRG-V, STRG-SAnnuler 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

:right_arrow: 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.

Je serais curieux d’entendre vos réflexions.

Cordialement

2 « J'aime »

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.

Donc, vous voulez quelque chose comme ceci : https://meta.discourse.org/posts/1849580/raw ou ceci : https://meta.discourse.org/raw/381447 ou ceci https://meta.discourse.org/raw/381447/1

Oh. Vous voulez le texte brut de tous les messages du sujet.

Ce n’est pas une solution, mais une version améliorée de celle-ci l’est. Mais cela ne permet pas d’économiser beaucoup de clics.

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.

3 « J'aime »

Salut Jay,

Merci pour ta réponse.

Cette solution est déjà discutée dans How to iterate over all the topics in order to export them as Markdown?, mais elle n’est pas pratique pour les documentations plus importantes (→ efficacité) et l’administration frontale (→ compétence).

Donc oui… pas de support, mais une vraie demande de fonctionnalité de ma part :wink:

Cordialement

2 « J'aime »

Je pense que 📄 Copy Post Component qui copie directement la publication pourrait être utile dans ce cas. Il réduit

à un clic. Mais ce n’est toujours pas une copie en masse.

5 « J'aime »

Ça soulage la douleur… mis en favoris.

Merci

3 « J'aime »

Vous pouvez créer une requête Data Explorer qui renvoie posts.raw, et appeler la requête à l’aide de l’API.

7 « J'aime »

Merci pour le conseil, Richard :slight_smile: 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.

3 « J'aime »

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 :wink: Il n’y a pas de flux de travail derrière, juste le souhait de conserver une sauvegarde simple.

1 « J'aime »

Je ne peux pas imaginer comment un utilisateur régulier utiliserait les sources de publication brutes.

3 « J'aime »

C’est peut-être parce que vous n’êtes pas un utilisateur lambda.

1 « J'aime »

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.

3 « J'aime »

Je ne considérerais pas un gestionnaire de connaissances comme un utilisateur régulier, c’est un rôle très spécifique.

Laissons le débat sur les « utilisateurs réguliers » pour une autre fois, s’il vous plaît.

1 « J'aime »

Alors, l’explorateur de données serait une solution tout à fait valable.
Vous pouvez également rendre cette requête accessible aux utilisateurs non administrateurs.

1 « J'aime »

Salut @soeren-1 et bienvenue dans notre communauté ! :hugs:

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 !

d he's just a regular guy like you and me..gif

3 « J'aime »

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.

Merci à tous les contributeurs !

2 « J'aime »