 |
요약 | RSS Polling Onebox는 RSS Polling 가져오기를 원본 기사의 원박스(onebox)로 렌더링하며, 선택적으로 피드 요약, YouTube 설명, 제목 형식을 제공합니다 |
 |
리포지토리 링크 | Peter-Petrik/discourse-rss-onebox |
 |
설치 가이드 | Discourse에서 플러그인 설치 방법 |
기능
- 원박스 렌더링: 사용자가 선택한 카테고리에서 RSS Polling으로 가져온 항목은 피드 본문의 첫 단락으로 잘린 대신, 기사 URL의 원박스(기사 페이지의 제목, 이미지, 설명)로 표시됩니다. 다른 카테고리의 가져오기는 변경되지 않습니다.
- “전체 게시물 보기” 숨김: 선택한 카테고리에서만 숨겨집니다.
- 피드 요약 (선택 사항): 기사 페이지에 자체 설명이 없는 경우, 피드에서 가져온 요약이 원박스 안에 표시되거나, 원박스를 만들 수 없는 경우 링크 아래에 표시됩니다.
- YouTube 설명 (선택 사항): 채널 피드에서 가져온 전체 영상 설명이 플레이어 아래에 줄바꿈과 클릭 가능한 링크를 포함하여 표시됩니다.
- 제목 형식 (선택 사항): 블로그와 YouTube 주제에 대해
%{title}과%{source}를 사용하여 개별 형식을 사용할 수 있습니다. 예를 들어%{source} blog: %{title}. 이름 변경은 조용히 이루어지며(수정 이력, 알림 없음) 기존 링크는 계속 작동합니다. - 표시 이름: 관리자 페이지에서 모든 RSS Polling 피드와 게시된 이름을 나열하여
%{source}에 사용할 이름을 설정할 수 있습니다. 저장하면 해당 피드의 제목이 다시 렌더링됩니다. - 피드 업데이트에 대한 보호: 수정된 원본 게시물이나 변경된 피드 형식이 더 이상 원박스화된 주제를 덮어쓰지 않습니다.
- 기존 주제를 위한 Rake 작업:
rss_onebox:convert은 이전 가져오기를 원박스로 변환하고,rss_onebox:enhance는 요약, 설명, 제목을 백필(backfill)합니다. 둘 다 기본적으로 건실행(dry run)으로 실행됩니다.
근거
우리는 회원들의 블로그와 YouTube 채널을 하나의 카테고리로 가져오는 포럼을 운영합니다. RSS Polling의 발췌문은 많은 피드를 poorly 렌더링했습니다(깨진 서식, 누락된 이미지, 페이지를 다시 스크래핑하는 “전체 게시물 보기” 버튼) 반면, 게시물에 동일한 URL을 붙여넣으면 깔끔한 원박스가 생성되었습니다. 이 플러그인은 모든 가져오기가 그 붙여넣은 링크처럼 보이게 하고, 페이지만으로는 제공할 수 없었던 내용을 채워 넣습니다.
설정
설치 후 관리자 → 플러그인 → RSS Polling Onebox로 이동합니다:
- 설정: 플러그인을 활성화하고, 원박스로 표시할 가져오기가 있는 카테고리를 선택하며, 선택적 기능을 켜세요.
- 표시 이름: 제목의
%{source}에 사용할 이름을 피드별로 설정하거나, 피드가 게시하는 이름을 사용하려면 비워 두세요. 게시된 이름 새로고침은 모든 활성화된 피드를 읽습니다.
설치 전에 가져온 주제에 대해서는 컨테이너 내에서 rake rss_onebox:convert을 실행한 다음 rake rss_onebox:enhance를 실행하세요(둘 다 건실행이며, 작성하려면 APPLY=1을 추가). README에는 모든 설정과 작업이 문서화되어 있으며, CHANGELOG에는 모든 릴리스가 나열되어 있습니다.
주의사항
- Discourse 2026.7 ESR에서 테스트되었습니다. 2026년 9월 기준
main과의 호환성은 코드에서 확인되었습니다. 이전 버전은 테스트되지 않았습니다. - Discourse에 번들로 제공되는 RSS Polling이 필요합니다.
- 일부 기능은 문서화된 훅이 아직 존재하지 않기 때문에 RSS Polling과
TopicEmbed의 내부 구조를 래핑합니다. RSS Polling: 플러그인을 위한 확장 지점을 참조하세요. - RSS Polling에서 YouTube 설명을 네이티브로 읽는 기능은 RSS Polling: YouTube 채널 피드에서 영상 설명 읽기에서 논의 중입니다. 코어에 포함되면 이 플러그인이 이를 사용할 것입니다.
- 원박스 품질은 각 기사 페이지의 Open Graph 태그에 따라 달라집니다.
질문 및 문제: 여기에 답변을 달거나 GitHub에서 이슈를 열 수 있습니다.