Safari拡張機能を有効にする
- SourceShelfを起動します。
- 開いている Safari > 設定 > 拡張機能。
- SourceShelf拡張機能を有効にします。
キャプチャモード
- レシピデフォルトを使用する 選択したレシピの内容モードに従います。
- ページ全体をマークダウンとして保存する 広いページのボディを維持します。
- メインコンテンツをマークダウンとして保存する 主な記事または文書に焦点を当てます。
- 選択内容をマークダウンとして保存する 現在のSafariのテキスト選択を使用します。
- エリアをマークダウンとして選択する ページ領域を選択できます。
- ハイライトをマークダウンとして保存する オーダーメイドのハイライトバスケットとオプションのショートノートを組み合わせて使用します。
明示的なポップアップアクションは、そのキャプチャのレシピのデフォルトをオーバーライドします。
現在のウインドウをキャプチャする
SafariでSourceShelfを開き、リサーチ > 現在のウインドウをキャプチャを選び、そのウインドウについてSafariが返したタブを確認します。HTTP(S)以外のページ、ローカルファイル、内部ページは表示されますが選択できません。
必要なタブと1つの保存先を選びます。SourceShelfは選択順を保ち、個別の失敗後も続行し、すべて失敗した場合は空のパックを作らず、各項目に新しいローカルIDを付けます。単一ページのクイック操作は変わらず、バッチも同じMarkdown、レシピ、画像、履歴、出力フォルダの処理を再利用します。
Webサイトへのアクセスとセキュリティ
Safariが拡張機能のWebサイトアクセスを管理します。SourceShelfのツールバーボタンをクリックした直後に、Safariがアクセス許可を求めることがあります。このシステムダイアログの表示時期と文言はSafariが決めます。拒否した場合は、Safariの拡張機能設定で後から許可し、SourceShelfを開き直してください。
バッチ処理では、SourceShelfは選択したタブまたはllms.txtリソースに必要なHTTP(S)オリジンだけをSafariへ要求します。すべてのWebサイトへの恒久的なアクセスは宣言しません。開始前のレビュー画面では、利用可能、アクセスが必要、未対応のソースを区別します。
上限、キャンセル、失敗
同時取得は最大3ソース、応答は8 MiB、操作全体は256 MiB、1ソース100画像、リダイレクト5回、要求20秒が上限です。llms.txtのレビューは1,000件、探索は12候補までです。キャンセルすると未完了の要求を止めて一時データを削除します。権限、時間、HTTP、解析、抽出、サイズの個別エラーで成功済みソースが失われることはありません。
Safariのタブグループとブラウザの制限
キャプチャは公開APIのtabs.query({ currentWindow: true })を使います。Safariの公開WebExtensions APIには、タブグループのIDや所属を問い合わせる文書化されたAPIがありません。そのためSourceShelfは「現在のウインドウ」と表示し、アクティブなグループをSafariが同じウインドウについて公開する他のタブから識別できるとは主張しません。
正確な対象はSafariが決め、バージョンやウインドウ状態で変わる可能性があります。Safariが拡張機能に読ませないページは利用できず、HTTP Linkヘッダーや手動リダイレクトもSafariが公開する情報に依存します。出荷するSafariバージョンでは署名済み拡張機能で確認してください。
レシピをキャプチャする
開いている ソースシェルフ > 設定 > キャプチャ レシピを作成、コピー、再順序付け、または削除します。レシピは次のことを定義できます。
- ファイル名と相対フォルダテンプレート。
- カスタムYAMLフィールド；
- デフォルトコンテンツモード。
- 画像とリンクの動作；
- 保存前にレビューする動作。
- 錆び防止ポリシー；
- 正確なホストとワイルドカードドメインルールを順序しました。
正確なホストは、次のような主要なワイルドカードよりも具体的です。 *.example.com。複数のルールが同様に具体的である場合、それらの保存された順序が一致を決定します。
組み込みの 標準 レシピはクイックセーブ動作を反映しており、設定が欠落している場合、無効な場合、または削除されたレシピを参照している場合にデフォルトとして使用されます。
テンプレートとYAML
テンプレートは使用できます。 {title}、 {domain}、 {date}、 {time}、 {captured_at}、 {mode}、 {recipe}、 {url}、そして {note}. SourceShelfは、すべてのフォルダコンポーネントを消毒し、絶対パスと ..、および目的先を承認された出力フォルダの下に保持します。
カスタムYAMLキーは、ユニークで有効である必要があります。SourceShelfは、以下の情報を含むソースシフのキーを保護します。 title、 url、 domain、 captured_at、 source、そして created_by。
ワンステップキーボードキャプチャ
で 設定 > キャプチャ、Safariのクイックキャプチャショートカットレシピを選択します。次に、Safariの拡張機能キーボードショートカット設定を開き、SourceShelfのクイックキャプチャコマンドにキーパターンを割り当てます。
ソースシェルフが呼び出されたとき、ソースシェルフは次の順序でレシピを選択します。
- アクティブページの最も具体的なドメインルール。
- 構成されたショートカットレシピ。
- 標準のフォールバックレシピ。
シンプルなページ、メインコンテンツ、または互換性のある選択レシピは、ポップアップを開かずにすぐに保存できます。レビューが必要なレシピや、エリア選択やハイライトコレクションなどのインタラクティブなワークフローは、代わりに拡張機能を開きます。
研究のハイライト
ページ上のテキストを選択し、SourceShelfを開き、 現在の選択を追加する。順序のあるバスケットを構築するには、繰り返してください。抜粋を削除したり、再順序したりして、保存する前に短いメモを追加できます。 .highlights 捕獲する。
バスケットはブラウザタブに限定され、 URL。ネイティブハンドオフが受け入れられた後、またはナビゲーションによって時代遅れになった場合にのみクリアされます。
保存する前にレビューする
レビューが有効なレシピは、SourceShelfでローカルレビューシートをキューにします。相対的なデスティネーション、ファイル名、カスタムYAML、メモ、Markdownボディを編集した後、プレビューとMarkdownソースを切り替えることができます。原産地は読み取り専用のままです。
ドラフトのレビューは、アプリの再起動後も生き残り続けます。保存すると、編集されたMarkdownが再解析され、参照されているステージング済み画像のみがコピーされます。キャンセルすると、ドラフトとそのステージング済みアセットが削除されます。
トラブルシューティングレシピ
新しいレシピが Safari に表示されない場合は、次の手順を実行します。
- Safari で SourceShelf 拡張機能が有効になっていることを確認します。
- Open SourceShelfを一度開いて、現在のレシピをパブリッシュできるようにします。
- 拡張機能のポップアップを閉じて再度開きます。通常、Safari の再起動は必要ありません。
- メニューが空の場合は、開きます。 キャプチャ設定 ポップアップから、少なくとも標準レシピまたはカスタムレシピが存在することを確認します。
- Safariが繰り返しアクセスを求める場合やポップアップがページを読み取れない場合は、Safari > 設定 > 機能拡張でそのWebサイトへのSourceShelfアクセスを許可してから、もう一度試します。