Integração do Pandoc

Continuando a discussão de Convertendo links de markdown bruto para HTML:

Eu sou a favor da integração com o Pandoc. Vejo que há um aplicativo web disponível com uma API REST. Estou procurando uma maneira de automatizar a criação de documentação em MediaWiki a partir do Discourse.

Atualmente, arrasto e solto markdown no Try pandoc!.

Você poderia descrever o fluxo de trabalho com mais detalhes?

Sim, temos uma instalação do MediaWiki há muito tempo: Noisebridge
nosso fórum Discourse: Discutir
E esta versão hospedada do Pandoc que incentivamos os usuários a usar para converter rapidamente Markdown na marcação mais esotérica do MediaWiki.

Espero que haja uma maneira de transformar isso em um fluxo de trabalho mais automatizado, pois queremos páginas do MediaWiki para pessoas não técnicas que já têm dificuldade apenas em registrar uma conta.

Obviamente, poderíamos fazer isso dentro do Discourse, mas nosso MediaWiki está online desde ~2007 e tem um público fiel há muito tempo, então ninguém quer mexer nele. No entanto, é um pouco difícil e antiquado para redigir documentação em 2020. :slight_smile:

Não tenho certeza total sobre os próximos passos. Mas, isso seria uma grande ajuda para nosso grupo de voluntários! Até agora, descobri esta versão de API RESTful do Pandoc, ou a demonstração hospedada vinculada acima.

Ainda não está claro de onde os dados estão vindo, mas eles estão indo para sua wiki?

Quais telas e controles podem estar envolvidos? Que discrição o usuário tem sobre para onde os dados estão indo?

Hmm, excelentes perguntas. Não tenho certeza total. Talvez o processo de rascunhar páginas do MediaWiki seja melhor atendido pelo plugin Custom Wizard.

O problema é que os voluntários estão tendo muita dificuldade para escrever páginas do MediaWiki em 2020. É algo que as pessoas dominam 100% ou são terríveis nisso. Espero que isso faça sentido como um problema que pretendo resolver. Se não, não quero perder seu tempo. :slight_smile:

Tenho tido muito interesse em integrar o Discourse com nossa instalação do MediaWiki para adicionar facilidade de uso, mas percebo que algumas tentativas de usar o Discourse para discussões no MediaWiki não deram certo.

Se eu fosse você, faria um protótipo das telas, controles e processos antes de prosseguir. Não se preocupe com a solução por enquanto.

Se você não gosta do software antigo, que tal migrar a wiki para o Discourse?

Não importa se eu gosto ou não. A wiki existe há 12 anos e é amada. Só precisa de um pouco de carinho. :heart_decoration:

Então, você quer uma maneira de publicar uma postagem do Discourse em sua instância Wikimedia por meio de uma tradução do Markdown para HTML usando o Pandoc, é isso?

Parece muito interessante. Mas também parece algo que o Zapier poderia resolver?

PS: Entendo por que você pode querer permanecer no software Wiki. É um padrão robusto projetado para esse caso de uso.

No momento, estou apenas copiando o texto do MediaWiki para o Pandoc e, em seguida, colando o Markdown convertido em uma postagem do Discourse manualmente. É trabalhoso, mas funciona.

Você está rascunhando no Discourse e publicando no MediaWiki?

Ou está pegando conteúdo do MediaWiki para publicá-lo no Discourse?

Um plugin de sincronização do MediaWiki poderia ser uma boa maneira de agradar a todos aqui. Já tive discussões semelhantes sobre wiki/Discourse no passado (não apenas no Leigh Hackspace, que fundei em 2015 e onde já recebemos Mitch Altman, um dos fundadores do Noisebridge), e uma sincronização bidirecional pode funcionar.

Sim, é por isso que estou pensando que seria ideal adicionar o Pandoc para simplificar a conversão. Estamos limitados por:

Sim, fazendo tudo manualmente.

  • O modelo de formato MediaWiki como texto simples é colaborado no etherpad.
    • Texto concluído postado no nosso MediaWiki
  • Texto também copiado para o Pandoc
  • Pandoc converte para Markdown
  • Markdown colado no Discourse com categoria e tags específicas.

Esperando agilizar esse processo. :+1:

:heart:

Se possível, isso seria incrível. Tanto o MediaWiki quanto o Discourse são ferramentas úteis. É ótimo ter informações importantes na wiki, além de discussões no fórum. Obviamente, o ideal é incluir links de URL para que as pessoas possam navegar facilmente entre as duas ferramentas.

Sei que houve tentativas pela Fundação Wikimedia de integrar essas duas ferramentas. Você pode encontrar detalhes no fórum. Também esperava permitir login no nosso Discourse via SSO do MediaWiki, mas esse plugin quebra a criação de contas no nosso fórum.

Por que não deixar o conteúdo no MediaWiki e realizar a discussão no Discourse com incorporação de comentários do Discourse via JavaScript?