ウェブページを Markdown としてヴォルトに保存する。
いま読んでいるページを——あるいは選択した部分だけを——あなた自身のマシンで動く Altretta アプリへ切り抜くブラウザ拡張機能です。切り抜きはヴォルトのノートとしてではなく、レビュー用の受信箱に提案として届きます。
1クリックで、出典つきの Markdown ファイル1つ。
拡張機能はいま開いているタブのページを読み、記事のまわりのナビゲーションや広告を取り除き、残ったものを Markdown に変換します。
ページ全体を切り抜く
リーダー表示と同じやり方で記事を取り出すので、残るのは本文だけ、まわりの余計な要素は落ちます。抽出がうまくいかないページでは本文全体に切り替え、そのことをきちんとお伝えします。期待より薄い内容を黙って保存したりはしません。
選択部分だけを切り抜く
先にテキストを選ぶと2つ目のボタンが点灯します。変換されるのは選択された HTML だけなので、引用したい1段落がページ全体に包まれて届くことはありません。
素の Markdown、独自形式なし
できあがるのは、ヴォルトのほかのノートと同じ Markdown ファイルです。クリッパー専用の形式はなく、あとで書き出すものもありません。
出典はいつも一緒に
どの切り抜きにも、出どころのページ、切り抜いた時刻、保留の状態、ウェブ切り抜きのタグを記した front matter が付きます。ページが示していれば、著者名・サイト名・公開日も添えます。
切り抜きはノートではなく、提案です。
拡張機能は切り抜きを、ヴォルトの受信箱フォルダに保留状態で置きます。索引付けもされず、意味グラフにも加わらず、署名もされません。アプリを開いてあなたが承認するまで、そのどれもがあなたの知識基盤の一部にはなりません。
ウェブ切り抜きこそ受信箱を必要とする理由
クリッパーは、読んでいない資料で知識基盤を満たす最短の道です。それをノートへ直接書かせれば、あなたのヴォルト——AI が答えの根拠にする場所——が、読むつもりだっただけのページで静かに埋まっていきます。だから切り抜きは AI の提案と同じ場所へ行きます。レビュー用の受信箱、人間の判断の手前です。
- 拡張機能は何も署名せず、グラフにも書きません。その仕事は「置く」ところで終わります。
- 承認こそが責任を伴う行為であり、署名された操作として記録されるのは承認のほうです。
- 却下は提案を削除せず、アーカイブします。
- 同じ内容のページを2度切り抜いても、重複ではなく同一と認識されます。
アプリでトークンを生成し、拡張機能に貼り付けます。
アカウントもサインインも、クラウドを経由する手順もありません。拡張機能が話す相手はあなた自身のマシンで動く Altretta アプリで、トークンはそれが許されていることの証明です。
アプリの接続設定を開く
設定 →「AI と接続」→「外部アシスタント」のセクション。そこに Web Clipper 専用のブロックがあります。
エンドポイントとトークンをコピー
エンドポイントのアドレスはコピーボタン付きで表示されます。「ペアリングトークンを取得」を押すと、クリッパー向けのラベルが付いたトークンが発行され、表示してコピーできます。
両方を拡張機能に貼り付ける
拡張機能のオプションページを開き——未ペアリングの間はポップアップからリンクされています——そこにエンドポイントとトークンを貼り付けます。
接続を試してから保存
「接続をテスト」はアプリと実際にハンドシェイクし、どのサーバーが応答したかを返します。アプリが動いていなければその場でそう伝えるので、最初の切り抜きで初めて失敗することはありません。
トークンはそのマシンの、あなた自身のブラウザの拡張機能ストレージに保存されます。どこにも同期されず、アプリ側で失効させればペアリングは終わります。
現時点では Chromium 系ブラウザ。
拡張機能は Manifest V3 標準に沿って Chromium の拡張 API 向けに作られており、導入手順は Chrome と Edge の拡張機能ページを想定して書かれています。
Chrome と Edge
どちらも同じマニフェストを読み、下で使う開発者モードのインストールを備えています。同じページを持つほかの Chromium 系ブラウザでも動く可能性は高いものの、動作確認をしたのはこの2つなので、それ以上は主張しません。
Firefox と Safari
非対応です。拡張機能は Firefox アドオンの識別情報も Safari 向けのパッケージも持たないため、そこにインストールできるものがまだありません。これは決定ではなく、埋めるべき穴です。
ダウンロードして、展開したまま読み込む。
クリッパーはアプリのリリースごとに、インストーラーと同じ配信元から zip として公開されます。ストアの掲載はまだないので、導入はボタン1つではなく2段階です。
拡張機能を入手
アーカイブ1つで、アプリを作ったのと同じリリースがビルドし公開したものです。ファイル名のバージョンは同梱されたアプリのバージョンで、拡張機能そのものにも刻まれています。つまり、ブラウザの拡張機能ページに出る番号が、問題を報告するときに伝える番号です。
拡張機能をダウンロードバージョン 0.9.4 · Altretta_0.9.4_web-clipper.zip
そのまま置いておける場所に展開してください。ブラウザは起動のたびにそのフォルダから拡張機能を読むので、フォルダを移動または削除するとアンインストールになります。
ブラウザに読み込む
zip は展開したまま読み込む形で入れます。これは回避策ではなく、ブラウザの機能です。
- 01上のアーカイブをダウンロードし、残しておくつもりのフォルダに展開します。
- 02ブラウザの拡張機能ページを開きます。
- 03デベロッパーモードを有効にします。
- 04「パッケージ化されていない拡張機能を読み込む」を選び、展開したフォルダを指定します。
- 05上のトークンでアプリとペアリングします。
展開したまま読み込んだ拡張機能は、削除するまでインストールされたままで、ブラウザを再起動してもペアリングのトークンを保持します。
新しいバージョンが出たら
展開したまま読み込んだ拡張機能は自分を更新しません。ブラウザはそのフォルダにあるコピーをいつまでも実行し続け、新しいものが出ていることは何も知らせません。だからこの段落は、当然のこととせずにここに置いてあります。アプリが更新されたら、このページに戻って新しいアーカイブをダウンロードし、同じフォルダに上書き展開し、ブラウザの拡張機能ページで「再読み込み」を押してください。これがストア掲載がないことの代償で、リリースごとに一度だけ払います。
ストア掲載はまだありません
クリッパーは Chrome ウェブストアにも Edge アドオンにも公開していません。掲載があればインストールは1クリックになり、更新も自動になります。今日あるのは zip で、このページの残りは zip を前提に書いてあります。
届くのはあなたのマシンまで、それ以上はありません。
行き先はひとつ
拡張機能に許されているのはループバックアドレスだけ、つまりインストールされたコンピュータ上のアプリだけです。解析はなく、CDN から何も読み込まず、ほかのネットワーク通信も行いません。
いま開いているタブ
ボタンを押したときにアクティブなタブを読み、そのときだけです。ページ上で常時動くことはなく、閲覧内容を見張ることもありません。
あなたのディスクの、あなたのヴォルト
切り抜きは、どのエディタでも開けるファイルとして、あなた自身のヴォルトフォルダに書き込まれます。何もアップロードされず、そのどれもマシンの外へ出ません。