Discourse 커뮤니티 여러분께,
여러분께 작은 
크리스마스 선물 
을 하나 준비했습니다. 단순하지만 유용하며, 단순히 제가 필요해서 만든 것입니다.
Simon Willison의 LLM을 개발에 활용하는 방법에 대한 멋진 블로그에 영감을 받아, 저는 크리스마스 기간 동안 사회적 모임, 영화 관람, 선물 포장 사이사이 이 프로젝트를 vibe-coding으로 진행했습니다. 저는 코드를 전혀 작성하지 않았지만, 코드를 검토하고 LLM을 감독했습니다. 모든 작업은 spec.md와 roadmap.md를 기반으로 진행되었습니다.
용도
저는 셀프호스팅된 개인 Discourse를 노트북, 저널, 블로그, 이력서, 위키, AI 도구 및 개발 지식 베이스로 사용하고 있습니다. 저는 웹에서 콘텐츠를 ‘클립’하여 Discourse에 바로 넣고, 이를 노트나 저널 항목에 통합하고 싶어 하는 경우가 많습니다.
Clip To Discourse는 현재 네 가지 클리핑 스타일을 지원합니다: 페이지 제목 + URL, 제목 + URL + 발췌문, 전체 페이지 텍스트, 선택된 텍스트.
개인정보 보호
- 개발자는 확장 프로그램 사용에서 데이터를 수집하지 않습니다.
- 클립된 콘텐츠와 자격 증명은 브라우저에서 사용자가 설정한 Discourse 인스턴스로 직접 전송됩니다.
- Clip To Discourse 중개 서비스는 관여되지 않습니다.
- 프로필과 자격 증명은 사용자의 기기에서 Chrome 확장 프로그램 저장소에 로컬로 저장됩니다.
- 오픈 소스입니다. GitHub 저장소: GitHub - koloki-co/clip-to-discourse-chromium-extension: A Chromium Browser extension which clips web content to your private Discourse. · GitHub
기능
- 페이지를 제목 + URL, 제목 + URL + 발췌문, 전체 페이지 텍스트, 또는 텍스트 선택으로 클립합니다.
- 각 클립마다 새로운 토픽을 생성하거나, 클립을 기존 토픽에 답변으로 추가합니다.
- 관리자가 API 키를 생성할 필요가 없이 Discourse 사용자 API를 통해 인증합니다. 관리자가 제공한 사용자 범위의 API 키는 폴백으로 사용할 수 있습니다.
- 서로 다른 Discourse 인스턴스, 사용자, 자격 증명, 템플릿, 기본 설정을 위한 다중 프로필을 지원합니다. 프로필은 이름 변경, 복제, 삭제할 수 있습니다.
- 연결된 계정에 사용 가능한 카테고리에서 대상 카테고리를 선택합니다.
- 페이지 메타데이터, 발췌문, 전체 텍스트, 선택된 텍스트, 날짜 플레이스홀더를 사용하여 제목과 본문 템플릿을 사용자 지정합니다.
- 시스템, 라이트, 다크 외관을 선택합니다.
- 선택적으로 Clip To Discourse 도구 모음 아이콘을 선택된 프로필의 사이트 파비콘으로 변경하여, 어디로 클립하는지 쉽게 알 수 있도록 합니다.
Ctrl+Shift+K(macOS의 경우Command+Shift+K)를 사용하여 팝업을 엽니다.chrome://extensions/shortcuts에서 설정할 수 있습니다.
제한 사항
- Discourse 사이트는 사용자 API 키를 활성화하고 사용자의 그룹이 이를 인증할 수 있도록 허용해야 합니다. 사용자 API 인증이 불가능한 경우, 사이트 관리자가 세밀한 권한을 가진 단일 사용자 API 키를 제공할 수 있습니다.
- 명확하게 말씀드리자면, Clip To Discourse 기능이 너무 많은 사용자에게 활성화되면 공유 또는 공개 Discourse 인스턴스에서 저품질 게시물이 대량으로 생성될 수 있습니다. 따라서 이 확장 프로그램은 저처럼 Discourse를 개인 노트북으로 사용하는 분들을 주로 대상으로 하고 있습니다.
설치 방법
- Chrome Web Store를 통해 Chrome 또는 기타 호환되는 Chromium 기반 브라우저(버전 127 이상)에 설치합니다: https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi
- 선택적으로 확장 프로그램을 브라우저 도구 모음에 ‘고정’합니다.
- 확장 프로그램 아이콘을 클릭하고 설정을 열어 Discourse 기본 URL을 입력합니다.
- 사용자 API를 선택하고 Clip To Discourse 인증을 클릭합니다. Discourse 계정에 로그인하고, 요청 시 표시된 기기 코드를 입력한 후 액세스를 승인합니다.
- 사용자 API 인증이 불가능한 경우, 관리자 API 키 탭을 사용하여 관리자가 제공한 단일 사용자 API 키를 사용합니다. 글로벌 API 키는 피하세요.
- 기본 클립 스타일, 대상, 카테고리 또는 기존 토픽 ID를 선택하고, 선택적으로 템플릿을 사용자 지정합니다.
- 설정을 저장하고 선택적으로 연결을 테스트합니다.
- 설정을 닫고 테스트할 내용을 클립해 보세요!
Clip To Discourse 인증
Discourse로 클리핑
로드맵
- Firefox 또는 Safari 확장 프로그램은 계획하고 있지 않습니다(해당 브라우저를 사용하지 않기 때문이므로), 하지만 이 확장 프로그램을 이식하는 작업을 누군가가 맡아주면 기쁩니다. 하나의 저장소에서 모두를 유지하고 기능 동등성을 유지하기 위해 협력할 수 있습니다.
- 가능한 향후 추가 기능에는 태그, 추가 키보드 단축키, 그리고 클리핑 워크플로우의 추가 개선이 포함됩니다.
관련 토론
이 도구를 요청한 토론: Chrome/Firefox extension “Share to discourse” - #28 by supermathie
Discourse를 클리핑할 때 추가 기능을 제안한 관련 게시물: Need Web Clipper for Discourse Post
Social Share는 관련 개념이지만 단순한 URL을 사용합니다: Social Share
피드백, 아이디어, 기여
이 토픽은 피드백을 남기기 좋은 곳입니다. 확장 프로그램을 과도하게 복잡하게 만들거나 저에게 덜 유용하게 만들지 않는 한, 개선 아이디어에 개방적입니다!
이슈를 열거나 PR을 만들고 싶다면, GitHub 저장소는 여기에 있습니다:
이 확장 프로그램은 무료, 오픈 소스, 그리고 개인정보 보호 우선 도구의 도구로, Koloki.co에서 Discourse 커뮤니티를 위해 만들었습니다.
