Intégration Pandoc

Suite à la discussion sur la conversion des liens du markdown brut en HTML :

Je suis favorable à l’intégration de Pandoc. Je vois qu’il existe une application web disponible avec une API REST. Je cherche un moyen d’automatiser la rédaction de la documentation MediaWiki à partir de Discourse.

Actuellement, je glisse-dépose du markdown sur Try pandoc!.

3 « J'aime »

Pourriez-vous décrire le flux de travail en plus de détails ?

2 « J'aime »

Oui, nous avons une installation MediaWiki de longue date : Noisebridge
notre forum Discourse : Discuter
Et cette version hébergée de Pandoc que nous avons encouragé les utilisateurs à utiliser pour convertir rapidement le Markdown en un langage MediaWiki plus ésotérique.

J’espère qu’il existe un moyen de rendre cela plus automatisé, car nous souhaitons obtenir des pages MediaWiki de la part de personnes non techniques qui ont déjà du mal à s’inscrire.

Bien sûr, nous pourrions le faire dans Discourse, mais notre MediaWiki est en ligne depuis environ 2007 et a une communauté fidèle, donc personne ne veut y toucher. Cependant, il est un peu difficile et vieillot pour rédiger de la documentation en 2020. :slight_smile:

Je ne suis pas tout à fait sûr des prochaines étapes. Mais, cela serait une grande aide pour notre pool de bénévoles ! Jusqu’à présent, j’ai découvert cette version API REST de Pandoc, ou la démo hébergée liée ci-dessus.

Je ne suis toujours pas clair sur l’origine des données, mais elles sont envoyées vers votre wiki ?

Quels écrans et contrôles pourraient être impliqués ? De quelle marge de manœuvre dispose l’utilisateur concernant la destination des données ?

2 « J'aime »

Hmm, d’excellentes questions. Je ne suis pas tout à fait certain. Peut-être que le processus de rédaction de pages MediaWiki serait mieux servi par le plugin Custom Wizard.

Le problème est que les bénévoles ont trop de mal à rédiger des pages MediaWiki en 2020. C’est quelque chose que les gens maîtrisent à 100 % ou pour quoi ils sont totalement incompétents. J’espère que cela a du sens en tant que problème que je souhaite résoudre. Sinon, je ne veux pas perdre votre temps. :slight_smile:

Je suis très intéressé par l’intégration de Discourse à notre installation MediaWiki pour améliorer l’expérience utilisateur, mais je remarque plusieurs tentatives d’utiliser Discourse pour les discussions dans MediaWiki qui n’ont pas abouti.

Si j’étais vous, je ferais des maquettes des écrans, des contrôles et du processus avant d’aller plus loin. Ne vous souciez pas de la solution pour l’instant.

1 « J'aime »

Si vous n’aimez pas l’ancien logiciel, pourquoi ne pas migrer le wiki vers Discourse ?

Cela n’a pas d’importance si ça me plaît. Le wiki existe depuis 12 ans et il est adoré. Il a juste besoin d’un peu d’attention. :heart_decoration:

2 « J'aime »

Donc, vous souhaitez publier un message de Discourse vers votre instance Wikimedia via une traduction Pandoc du Markdown en HTML, c’est bien cela ?

Cela semble très intéressant. Mais cela ressemble aussi à quelque chose que Zapier pourrait résoudre ?

PS : Je comprends pourquoi vous pourriez souhaiter rester sur le logiciel wiki. C’est une norme robuste conçue pour ce cas d’usage.

1 « J'aime »

Pour l’instant, je copie simplement le texte MediaWiki dans Pandoc, puis je publie manuellement le Markdown converti dans un message Discourse. C’est fastidieux, mais cela fonctionne.

1 « J'aime »

Préparez-vous vos textes dans Discourse pour les publier sur MediaWiki ?

Ou bien récupérez-vous du contenu depuis MediaWiki pour le publier sur Discourse ?

Une sorte de plugin de synchronisation MediaWiki pourrait être une solution agréable pour satisfaire tout le monde ici. J’ai déjà eu des discussions similaires sur le wiki/Discourse par le passé (notamment au Leigh Hackspace, que j’ai fondé en 2015 et où nous avons un jour accueilli Mitch Altman, membre de l’équipe fondatrice de Noisebridge), et une synchronisation bidirectionnelle pourrait fonctionner.

2 « J'aime »

Oui, c’est pourquoi je pense qu’il serait idéal d’intégrer Pandoc pour simplifier la conversion. Nous sommes limités par :

Oui, nous faisons tout manuellement.

  • Le modèle de format Mediawiki en texte brut est collaboré sur etherpad.
    • Le texte terminé est publié sur notre mediawiki
  • Le texte est également copié dans Pandoc
  • Pandoc convertit en Markdown
  • Le Markdown est collé dans Discourse avec une catégorie et des balises spécifiques.

Nous espérons rationaliser ce processus. :+1:

:heart:

Si c’est possible, ce serait formidable. Mediawiki et Discourse sont tous deux des outils utiles. Il est excellent d’avoir des informations importantes dans le wiki, ainsi que des discussions sur le forum. Évidemment, l’idéal est d’insérer des liens URL pour que les personnes puissent facilement naviguer entre les deux outils.

Je sais que la fondation wikimedia a tenté d’intégrer ces deux outils ensemble. Vous pouvez trouver des détails sur le forum. J’espérais également permettre la connexion à notre Discourse via SSO Mediawiki, mais ce plugin casse la création de compte sur notre forum.

Pourquoi ne pas simplement laisser le contenu sur MediaWiki et discuter sur Discourse avec l’intégration des commentaires Discourse via JavaScript ?

1 « J'aime »