Интеграция Pandoc

Продолжение обсуждения из Конвертация ссылок из сырого Markdown в HTML:

Я за интеграцию Pandoc. Вижу, что существует веб-приложение с REST API. Ищу способ автоматизировать создание документации в формате MediaWiki из Discourse.

В данный момент я перетаскиваю Markdown-файлы в Try pandoc!.

Можете подробнее описать рабочий процесс?

Да, у нас уже давно работает установка MediaWiki: Noisebridge
наш форум на Discourse: Обсуждение
И эта хостинговая версия Pandoc, которую мы рекомендуем пользователям использовать для быстрого преобразования Markdown в более специфичную разметку MediaWiki.

Я надеюсь, что существует способ автоматизировать этот процесс, поскольку мы хотим получать страницы MediaWiki от нетехнических пользователей, у которых уже возникают трудности с простой регистрацией учётной записи.

Очевидно, что мы могли бы реализовать это внутри Discourse, но наша MediaWiki работает с ~2007 года и имеет давнюю аудиторию, поэтому никто не хочет вносить в неё изменения. Однако в 2020 году писать документацию в ней уже немного сложно и устарело. :slight_smile:

Я пока не до конца уверен в следующих шагах. Но это стало бы большой помощью для нашего пула волонтёров! Пока я обнаружил этот RESTful API-интерфейс для Pandoc или упомянутую выше демонстрационную версию на хостинге.

Мне всё ещё неясно, откуда берутся данные, но они направляются в вашу вики?

Какие экраны и элементы управления могут быть задействованы? Какую свободу выбора имеет пользователь в отношении того, куда они направляются?

Хм, отличные вопросы. Я не до конца уверен. Возможно, процесс черновика страниц MediaWiki лучше всего реализовать с помощью плагина Custom Wizard.

Проблема в том, что волонтёрам в 2020 году слишком сложно писать страницы MediaWiki. Это навык, которым люди либо овладевают на 100%, либо у них ничего не получается. Надеюсь, я правильно сформулировал проблему, которую хочу решить. Если нет, не хочу тратить ваше время. :slight_smile:

Меня очень интересует интеграция Discourse с нашей установкой MediaWiki для повышения удобства использования, но я заметил, что несколько попыток использовать Discourse для обсуждений в MediaWiki не увенчались успехом.

Если бы я был на вашем месте, я бы сначала подготовил макеты экранов, элементов управления и процесса, прежде чем двигаться дальше. Пока не беспокойтесь о решении.

Если старое программное обеспечение вам не нравится, как насчет миграции вики на Discourse?

Неважно, нравится ли мне это. Вики существует уже 12 лет и любима всеми. Ей просто нужна небольшая забота. :heart_decoration:

Итак, вы хотите публиковать посты из Discourse на вашем экземпляре Wikimedia через конвертацию Markdown в HTML с помощью Pandoc, верно?

Звучит очень интересно. Но также кажется, что эту задачу мог бы решить Zapier?

P.S. Я понимаю, почему вы можете предпочесть остаться на программном обеспечении для вики. Это надежный стандарт, разработанный именно для таких задач.

Сейчас я просто копирую текст MediaWiki в Pandoc, а затем вручную вставляю полученный Markdown в пост Discourse. Это утомительно, но работает.

Вы пишете черновик в Discourse и публикуете его в MediaWiki?

Или вы берёте контент из MediaWiki, чтобы опубликовать его в Discourse?

Возможно, какой-то плагин синхронизации MediaWiki был бы отличным решением для всех здесь. У меня уже были подобные обсуждения по поводу вики и Discourse (в частности, в Leigh Hackspace, который я основал ещё в 2015 году и где мы когда-то принимали Митча Альтмана, одного из основателей Noisebridge). Двусторонняя синхронизация могла бы сработать.

Да, поэтому я думаю, что было бы идеально добавить Pandoc для упрощения конвертации. Нас сдерживают следующие факторы:

  • Плагин Discourse Event пока не поддерживает планирование повторяющихся событий (еженедельных встреч).

Да, всё делаем вручную.

  • Шаблон формата Mediawiki в виде обычного текста разрабатывается совместно в Etherpad.
    • Завершённый текст публикуется на нашем сайте Mediawiki.
  • Текст также копируется в Pandoc.
  • Pandoc конвертирует его в Markdown.
  • Markdown вставляется в Discourse с указанием конкретной категории и тегов.

Надеюсь, мы сможем оптимизировать этот процесс. :+1:

:heart:

Если это возможно, это было бы здорово. И Mediawiki, и Discourse — полезные инструменты. Отлично, что важная информация хранится в вики, а обсуждения проходят на форуме. Очевидно, идеально было бы добавлять ссылки на URL, чтобы люди могли легко переходить между обоими инструментами.

Я знаю, что Фонд Викимедиа предпринимал попытки интегрировать эти два инструмента. Подробности можно найти на форуме. Я также надеялся реализовать вход в наш Discourse через SSO Mediawiki, но этот плагин ломает создание аккаунтов на нашем форуме.

Почему бы просто не оставить контент на MediaWiki и не вести обсуждение в Discourse, используя встраивание комментариев Discourse через JavaScript?