Read Frog

사이트 제어 및 사이트 규칙

블랙/화이트리스트와 URL, selector, 레이아웃, 임계값, CSS를 다루는 per-site JSON 규칙을 설명합니다.

기능위치목적
사이트 제어설정 → 일반호스트 단위로 확장 프로그램 전체를 허용/차단합니다.
사이트 규칙설정 → 사이트 규칙일치하는 페이지의 파싱, 레이아웃, 필터와 CSS를 변경합니다.

사이트 제어는 권한 정책용입니다. 확장은 동작하지만 노드 선택, 인라인 배치, 코드 제외 등이 잘못될 때 사이트 규칙을 사용합니다.

호스트와 URL pattern

블랙리스트는 목록 밖에서, 화이트리스트는 목록 안에서만 동작합니다. example.com은 하위 도메인도 포함하지만 경로나 와일드카드를 허용하지 않습니다.

사이트 규칙은 query string을 무시하고 다음 pattern을 지원합니다.

Pattern일치 범위
github.com해당 호스트의 HTTP/HTTPS
*.example.com루트 및 하위 도메인
docs.example.com/guides/*특정 경로
https://example.com/*HTTPS만
www.amazon.*여러 TLD의 일치 호스트
javdb*.comjavdb 뒤 문자가 있는 호스트

scheme은 http, https, *이며 명시적 port는 허용하지 않습니다. 제외는 excludeMatches를 사용합니다.

우선순위와 병합

일치하고 활성화된 내장 규칙을 먼저, 사용자 규칙을 나중에 적용합니다. 내장 규칙은 ID로 비활성화할 수 있습니다.

  • selector 배열은 base, .add, .remove 순서로 처리합니다.
  • minCharacters, minWords는 마지막 값이 우선합니다.
  • injectedCss, injectedCss.add는 순서대로 연결합니다.
  • 잘못된 pattern/selector는 경고 후 무시합니다.

배열은 단순 교체가 아닙니다. 이전 selector를 취소하려면 .remove, 확장하려면 .add를 사용합니다.

필드와 안전한 예

각 규칙에는 고유한 idmatches가 필요합니다. excludeSelectors, includeSelectors, forceBlockSelectors, forceInlineSelectors, preserveTextSelectors, minCharacters, minWords, injectedCss를 사용할 수 있습니다.

[
  {
    "id": "example-docs",
    "description": "Translate article copy but leave navigation and code untouched.",
    "matches": ["docs.example.com/*"],
    "excludeSelectors": ["nav", "pre", "code", "[aria-label='Breadcrumb']"],
    "includeSelectors": ["main article"],
    "forceBlockSelectors": ["article p", "article li"],
    "preserveTextSelectors": [".product-name", ".command-name"],
    "minCharacters": 2,
    "minWords": 1,
    "injectedCss": ".read-frog-translated-content-wrapper { max-width: 100%; }"
  }
]

좁은 호스트에서 저장하고 새로고침한 뒤 pattern을 넓히세요. 생성 class보다 안정적인 속성을 사용합니다.

[
  {
    "id": "example-docs-adjustment",
    "matches": ["docs.example.com/*"],
    "excludeSelectors.add": [".sidebar-ad"],
    "excludeSelectors.remove": [".article-summary"],
    "forceInlineSelectors.add": [".term-with-tooltip"]
  }
]

편집기는 JSON, schema, 중복 ID, selector, pattern과 크기를 검증합니다. 최대 200개 사용자 규칙, JSON 65,536자, CSS 값마다 8,192자입니다.

CSS는 일치하는 모든 페이지에 주입됩니다. pattern을 좁게 유지하고 로그인, 보안, 계정 UI를 숨기지 마세요.

On this page