高度な使い方
ルール
オプションページのほか、「このサイトをブロックする」ダイアログでもルールを編集できます。
マッチパターン
マッチパターンはワイルドカードを含む URL のようなものです。詳細は MDN web docs を参照してください。
有効なマッチパターンの例です。
パターン | マッチする例 |
---|---|
*://example.com/* ( example.com 上の URL) | http://example.com/ https://example.com/hoge |
*://*.example.net/* ( example.net またはそのサブドメイン上の URL) | http://example.net/ https://foo.example.net/hoge |
*://example.org/hoge/* ( example.org 上の URL で、パスが /hoge/ で始まるもの) | http://example.org/hoge/fuga.html |
無効なマッチパターンの例です。
無効なパターン | 理由 |
---|---|
*://www.qinterest.*/ | * が先頭以外に置かれています。代わりに正規表現を使ってください。 |
<all_urls> | サポートされていません。 |
正規表現
正規表現を使ってより柔軟にルールを書くことができます。
正規表現ルールは、/
で囲まれた、JavaScript の正規表現リテラルの形でなければなりません (例: /example\.(net|org)/
)。
有効な正規表現の例です。
正規表現 | マッチする例 |
---|---|
/^https:\/\/www\.qinterest\./ ( https://www.qinterest. で始まる URL) | https://www.qinterest.com/ https://www.qinterest.jp/hoge |
/^https?:\/\/([^/.]+\.)*?xn--/ (国際化ドメイン名を含む URL) | http://例.テスト/ |
無効な正規表現の例です。
無効な正規表現 | 理由 |
---|---|
^https?:\/\/example\.com\/ | / で囲まれていません。 |
/^https?://example\.com// | 正規表現内の / がエスケープされていません。 |
正規表現 (タイトルでブロック)
特定のタイトルを持つサイトをブロックするには、正規表現ルールの前に title
を追加します。
例えば、ルール title/example domain/i
は、タイトルに "example domain" を含む (大文字小文字を区別しない) サイトをブロックします。
ブロック解除ルール
マッチパターンまたは正規表現の前に @
をつけると、そのサイトをブロックしないという意味になります。
これは購読したルールセットによるブロックを解除するのに便利です。例えば、もし http://example.com/
が購読中のルールセットによりブロックされていれば、ルール @*://example.com/*
でそれを解除することができます。
ハイライトルール
マッチパターンまたは正規表現の前に @N
(N=1,2,3,...) をつけると、そのサイトをハイライトするという意味になります。
例えば、@1*://github.com/*
で GitHub をハイライトすることができます。
デフォルトでは、@1
(青) のみが使用できます。色を変更または追加するには、オプションページの「外観」セクションを参照してください。
コメント
コメントは #
で始まります。ルールとして解釈できない行は全て実質的にコメントですが、 #
で始まるコメントには 2 つの利点があります。
#
で始まるコメントは、将来新しいシンタックスが追加されても、コメントであることが保証されます。#
で始まるコメントは、ルールの後に置くことができます。
# example.com またはそのサブドメイン上のサイトをブロックする
*://*.example.com/*
/example\.(net|org)/ # example.net または example.org を URL に含むサイトをブロックする
Google 以外の検索エンジン
Bing、Brave、DuckDuckGo、Ecosia、Qwant、SearX、Startpage.com、Yahoo! JAPAN、Yandex がサポートされています。この機能はデフォルトで無効ですが、オプションページで有効にすることができます。
検索結果を開いているときに、ツールバーのアイコンをクリックすることでも有効にできます。
Bing
Brave
DuckDuckGo
Ecosia
Qwant
動画検索上では、"Always read on Qwant.com" を無効にする必要があります。
Lite バージョンでは、Web 検索のみがサポートされています。
SearX
Startpage.com
Yahoo! JAPAN
Yandex
同期
ルールセットを Google ドライブまたは Dropbox で同期することができます。
同期を有効にするには、オプションページの「同期を有効にする」ボタンを押し、クラウドを選択します。
ダイアログの指示に従って認証してください。
認証が成功すると、ルールセットが定期的に選択したクラウドと同期されるようになります。
Google ドライブ
Firefox またはその派生ブラウザでは、https://www.googleapis.com
へのアクセスを許可する必要があります。
ルールセットは Google ドライブのアプリケーションデータフォルダーに保存されます。このフォルダーを見ることはできませんが、設定ページから削除することは可能です。
Dropbox
ルールセットは Dropbox の /アプリ/uBlacklist/
フォルダーに保存されます。フォルダーの名前は言語によって異なるかもしれません。
購読
公開されたルールセットを購読することができます。
購読を追加するには、オプションページの「購読を追加する」ボタンを押して、名前と URL を入力します。その URL へのアクセス許可を求められる場合があります。
購読を表示、更新、削除することができます。
購読を公開する
ルールセットを購読として公開するには、UTF-8 でエンコードしたルールセットファイルを適切な HTTP(S) サーバーに配置し、URL を公開します。
購読を GitHub で公開するのはよい考えです。Raw URL (例えば https://raw.githubusercontent.com/iorate/ublacklist-example-subscription/master/uBlacklist.txt) を公開してください。