From a27e42a00bdccae028debe287a90f3ae842864aa Mon Sep 17 00:00:00 2001 From: David Tejada Date: Thu, 1 Feb 2024 16:53:19 +0100 Subject: [PATCH] Add instructions for enabling Rango in local files (#272) --- readme.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index 343a1754..57cdd8c8 100644 --- a/readme.md +++ b/readme.md @@ -65,6 +65,8 @@ folder. If not you need at least to have the following captures defined: ## Troubleshooting +### Commands Don't Work + If the hints are displayed but the commands don't work, most of the time it has to do with the configuration of the hotkey. In order to communicate with Rango, Talon presses a key combination to prompt Rango to read the command present on @@ -73,7 +75,7 @@ browsers except for Safari, where it is `ctrl-shift-3`. If Rango commands aren't working for you, make sure that the hotkey is properly set up. The shortcut that needs to be changed is `Get the talon request`. -### Where to Find the Extension Keyboard Shortcuts +#### Where to Find the Extension Keyboard Shortcuts In Firefox, navigate to [about:addons](about:addons), click on the cog at the top right and then "Manage Extension Shortcuts". @@ -83,6 +85,18 @@ In Chrome, navigate to In Edge, navigate to [edge://extensions/shortcuts](edge://extensions/shortcuts). +### No Hints Viewing Local Files + +In order for Rango to work within local files like +`file:///Users/david/Code/my-page/index.html` when using a Chromium browser you +will have to enable it. Navigate to the extension details and enable the setting +`Allow access to file URLs`. + +In Firefox access to file URLs is always enabled. + +Unfortunately, Safari doesn't allow extensions to access file URLs at all, so +this feature won't be available in this browser. + ## Settings There are several settings you can adjust to change the appearance of the hints