Mini Trans

Website rules

Websites vary widely in structure. Use Website rules and Allow & Block lists to translate only article bodies or comments while skipping sidebars, usernames, navigation, or code blocks.

Rule precedence & rule tiers

Open Settings › Websites › Website rules. Three rule tiers are evaluated in order:

My rules > Subscriptions > System

  1. System: Ships with Mini Trans and updates online with hundreds of curated rules for popular documentation, news, and community sites.
  2. Subscriptions: Add http:// or https:// rule package URLs; Mini Trans refreshes them daily (or manually via Refresh).
  3. My rules: Custom rules you create or import, taking top precedence.
Settings › Websites › Website rules: System, Subscriptions, and My rules

Creating rules & subscriptions

Click Add under My rules to define a rule:

  • Include URLs / Exclude URLs: One pattern per line—globs by default (e.g. github.com/*) or /regex/flags wrapped in slashes.
  • Only on pages matching: Optional CSS selectors; the rule applies only when at least one selector matches.
  • Translate only / Never translate: One CSS selector per line. Setting Translate only restricts translation strictly to those containers; Never translate excludes specific blocks inside them.
  • Inject CSS: Applied while the page is translated and removed on restore—ideal for lifting line-clamp rules that would otherwise clip bilingual text.

Rules support batch enable/disable/delete and JSON / JSONC import & export.

Allow & Block lists

Switch to Settings › Websites › Allow & Block lists to manage domain-level policies:

  • Always translate websites: Translate automatically on load regardless of default strategy.
  • Never translate websites: Skip automatic translation (you can still click Translate anyway in the popup).
  • Translate-all-elements websites: Ignore site rules and excluded areas on that domain and translate all readable elements.
  • Widget Disable Lists: View and manage Floating ball disabled websites and Selection translate disabled websites.
Settings › Websites › Allow & Block lists: domain policy and widget disable lists

Contents

On this page

  1. Rule precedence & rule tiers
  2. Creating rules & subscriptions
  3. Allow & Block lists