Pandoc 통합

Converting links from raw markdown to HTML에서 이어지는 논의입니다:

저는 Pandoc 통합에 찬성합니다. REST API가 포함된 웹 앱이 있다는 것을 확인했습니다. Discourse에서 mediawiki 문서를 자동으로 작성하는 방법을 찾고 있습니다.

현재는 markdown을 Try pandoc! 로 드래그 앤 드롭하여 사용하고 있습니다.

워크플로우를 더 자세히 설명해 주시겠어요?

네, 우리는 오래된 MediaWiki 설치 환경이 있습니다: Making sure you're not a bot!
우리의 Discourse 포럼: Discuss
그리고 Pandoc의 호스팅 버전으로, 사용자들이 Markdown을 더 난해한 MediaWiki 마크업으로 빠르게 변환하도록 장려해 왔습니다.

기술적 배경이 없는 사람들이 계정을 등록하는 것조차 어려움을 겪고 있는 상황에서 MediaWiki 페이지를 작성해야 하므로, 이 과정을 더 자동화된 워크플로우로 전환할 수 있는 방법이 있는지 희망하고 있습니다.

물론 Discourse 내에서 이를 처리할 수도 있지만, 우리의 MediaWiki는 약 2007년부터 온라인에 있으며 오랜 기간 동안 많은 이용자를 확보하고 있어 아무도 이를 건드리고 싶어 하지 않습니다. 하지만 2020년 기준으로 문서 작성을 위해 이 시스템을 사용하는 것은 다소 어렵고 오래된 느낌을 줍니다. :slight_smile:

다음 단계에 대해 완전히 확신하지는 못합니다. 하지만 이 기능은 우리의 자원봉사자 풀에 큰 도움이 될 것입니다. 지금까지 Pandoc의 RESTful API 버전이나 위에 링크된 호스팅 데모를 발견했습니다.

데이터가 어디서 오는지 여전히 명확하지 않지만, 해당 위키로 전송되는 건가요?

어떤 화면과 컨트롤이 관여할 수 있을까요? 사용자가 데이터가 어디로 전송되는지에 대해 얼마나 많은 선택권을 가질 수 있을까요?

흠, 훌륭한 질문이네요. 저는 완전히 확신하지 못하겠습니다. 아마도 미디어위키(MediaWiki) 페이지 작성 과정을 가장 잘 해결할 수 있는 방법은 Custom Wizard 플러그인을 사용하는 것일 수 있습니다.

문제는 2020년 현재 자원봉사자들이 미디어위키 페이지를 작성하는 데 너무 많은 어려움을 겪고 있다는 점입니다. 이는 사람들이 100% 숙달하거나, 아니면 전혀 못 하는 것 중 하나인 것처럼 보입니다. 제가 해결하고자 하는 문제로서 이 설명이 합리적으로 들리기를 바랍니다. 그렇지 않다면 여러분의 시간을 낭비하고 싶지 않습니다. :slight_smile:

저는 사용성을 높이기 위해 Discourse를 우리의 미디어위키 설치 환경과 통합하는 데 큰 관심을 가지고 있었지만, 미디어위키에서 토론을 위해 Discourse를 사용하려는 몇 가지 시도가 성공적으로 이루어지지 않은 것을 알게 되었습니다.

나라면 더 깊이 들어가기 전에 화면, 컨트롤, 프로세스를 먼저 목업해볼 거야. 지금은 솔루션에 대해 걱정하지 마.

기존 소프트웨어가 마음에 들지 않으시다면, 위키를 디스커스로 이전하는 것은 어떨까요?

제가 좋아하든 말든 중요하지 않아요. 이 위키는 12년 동안 운영되어 왔고, 많은 사랑을 받고 있어요. 그저 조금 더 관심을 기울여 주면 될 뿐입니다. :heart_decoration:

즉, Discourse에서 게시물을 Pandoc을 사용해 Markdown을 HTML로 변환한 뒤 Wikimedia 인스턴스에 게시하는 방법을 찾고 계신 거죠?

매우 흥미롭네요. 하지만 Zapier로 해결할 수 있는 문제처럼 보이기도 합니다.

P.S. Wiki 소프트웨어를 계속 사용하시려는 이유가 충분히 이해됩니다. 해당 용도에 맞게 설계된 견고한 표준이니까요.

현재 저는 미디어위키 텍스트를 Pandoc에 복사한 다음, 변환된 마크다운을 수동으로 Discourse 게시물에 게시하고 있습니다. 다소 번거롭지만 잘 작동합니다.

디스커스에서 초안을 작성해서 미디어위키에 게시하는 건가요?

아니면 미디어위키에서 콘텐츠를 가져와서 디스커스에 게시하는 건가요?

여기서 모두를 만족시킬 좋은 방법은 미디어위키 동기화 플러그인일 수 있습니다. 과거에 비슷한 위키/디스커스 논의를 해본 적이 있습니다(2015년에 제가 창립한 리 해크스페이스(Leigh Hackspace)가 대표적이며, 그곳에서는 노이즈브릿지(Noisebridge) 창립 멤버 중 한 명인 미치 올트만(Mitch Altman)을 한때 초청하기도 했습니다). 양방향 동기화가 작동할 수 있을 것 같습니다.

네, 그래서 변환을 단순화하기 위해 Pandoc을 추가하는 것이 이상적이라고 생각하고 있습니다. 현재 우리를 가로막는 문제는 다음과 같습니다:

네, 모든 것을 수동으로 처리하고 있습니다.

  • 미디어위키 형식 템플릿(평문)은 에더패드(etherpad)에서 공동 작업으로 작성됩니다.
    • 완성된 텍스트가 미디어위키에 게시됩니다.
  • 텍스트가 Pandoc으로 복사됩니다.
  • Pandoc이 Markdown으로 변환합니다.
  • Markdown이 특정 카테고리와 태그를 지정하여 디스커스에 붙여넣습니다.

이 과정을 효율화하길 희망합니다. :+1:

:heart:

가능하다면 정말 훌륭할 것입니다. 미디어위키와 디스커스는 모두 유용한 도구입니다. 위키에 중요한 정보를, 포럼에 토론을 두는 것은 매우 좋습니다. 당연히, 사람들이 두 도구 사이를 쉽게 오갈 수 있도록 URL 링크를 넣는 것이 이상적입니다.

위키미디어 재단의 통합 시도가 있었다는 것을 알고 있습니다. 자세한 내용은 포럼에서 찾을 수 있습니다. 또한 미디어위키 SSO를 통해 디스커스에 로그인할 수 있기를 희망했지만, 그 플러그인이 우리 포럼의 계정 생성을 깨뜨립니다.

MediaWiki에 콘텐츠를 그대로 두고, JavaScript를 통해 Discourse 댓글을 임베딩하는 방법으로 Discourse에서 토론을 진행하면 안 될까요?