Discourseコミュニティの皆さんへ、私の小さな:wrapped_gift:クリスマスプレゼント:christmas_tree:です。シンプルですが実用的で、私が欲しかったからという理由だけで作りました。
Simon Willison氏のLLMを開発に活用する素晴らしいブログに触発され、クリスマスの間に、社交行事や映画鑑賞、プレゼントのラッピングの合間に、Vibe Codingでこれを作りました。コードは一切自分で書いていませんが、コードのレビューとLLMの監督は行いました。すべてはspec.mdとroadmap.mdから駆動されています。
用途
私はセルフホストの個人的なDiscourseを、ノートブック、ジャーナル、ブログ、履歴書、ウィキ、AIツール、そして開発者向けナレッジベースとして使用しています。頻繁に、Webからコンテンツを「クリップ」してDiscourseに直接投入したくなり、そこからノートやジャーナルエントリに組み込みたいと感じます。
Clip To Discourseは現在、4つのクリップスタイルをサポートしています：ページタイトル+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 User APIを通じて認証を行います。管理者が提供するユーザースコープのAPIキーはフォールバックとして利用可能です。
- 異なるDiscourseインスタンス、ユーザー、認証情報、テンプレート、デフォルト設定用の複数プロファイルをサポートします。プロファイルは名前の変更、複製、削除が可能です。
- 接続されたアカウントが利用可能なカテゴリから、宛先カテゴリを選択します。
- ページメタデータ、抜粋、全文、選択テキスト、日付プレースホルダーを使用して、タイトルと本文のテンプレートをカスタマイズします。
- System、Light、Darkの外観を選択します。
- Clip To Discourseのツールバーアイコンを、選択されたプロファイルのサイトファビコンに変更し、クリップの宛先を簡単に識別できるようにできます（オプション）。
- ポップアップを
Ctrl+Shift+K（macOSではCommand+Shift+K）で開きます。chrome://extensions/shortcutsで設定可能です。
制限事項
- DiscourseサイトはUser APIキーを有効にし、アカウントのグループがそれらを認証することを許可している必要があります。User API認証が利用できない場合、サイト管理者が細かな権限を持つ単一ユーザーAPIキーを提供できます。
- 明らかに、Clip To Discourse機能が多くのユーザーに対して有効化されると、共有またはパブリックなDiscourseインスタンスで低品質な投稿が大量に発生する可能性があります。そのため、この拡張機能は私のようにDiscourseを個人的なノートブックとして使用している方を主な対象としています。
インストール方法
- Chromeまたは他の互換性のあるChromiumベースのブラウザ（バージョン127以降）で、Chrome Web Storeからインストールします: https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi
- オプションで、拡張機能をブラウザのツールバーに「ピン留め」します。
- 拡張機能のアイコンをクリックし、設定を開き、DiscourseのベースURLを入力します。
- User APIを選択し、Clip To Discourseを認証をクリックします。Discourseアカウントにサインインし、求められた場合は表示されたデバイスコードを入力して、アクセスを承認します。
- User API認証が利用できない場合は、Admin API Keyタブを使用し、管理者が提供する単一ユーザー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
フィードバック、アイデア、コントリビューション
このトピックは、フィードバックを投稿するのによい場所です。拡張機能を複雑にしすぎず、かつ私にとって有用性を損なわない限り、改善のアイデアにはオープンです！
Issueを開いたりPRを送ったりしたい場合は、GitHubリポジトリはこちらです:
この拡張機能は、無料、オープンソース、プライバシーファーストのツールで、私の会社Koloki.coがDiscourseコミュニティのために作成しました。
