ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

View In Browser

by adampresley ST2/ST3 Top 100

Open the contents of your current view/tab in a web browser

Details

  • 2016.07.12.00.59.24
  • github.​com
  • github.​com
  • 1 year ago
  • 2 hours ago
  • 5 years ago

Installs

  • Total 194K
  • Win 130K
  • OS X 49K
  • Linux 15K
Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6 Jul 5 Jul 4 Jul 3 Jul 2 Jul 1 Jun 30 Jun 29 Jun 28 Jun 27 Jun 26 Jun 25 Jun 24 Jun 23 Jun 22 Jun 21 Jun 20 Jun 19 Jun 18 Jun 17 Jun 16 Jun 15 Jun 14 Jun 13 Jun 12 Jun 11 Jun 10 Jun 9 Jun 8
Windows 122 145 168 212 217 212 190 148 165 175 226 181 207 175 117 135 161 211 181 195 205 114 127 188 154 159 154 163 109 131 172 165 205 188 195 97 116 172 198 196 193 186 115 119 165 165
OS X 56 47 55 69 71 83 101 45 48 60 76 75 74 63 45 53 47 66 62 64 68 34 39 53 72 55 75 50 40 41 47 77 61 75 66 25 47 88 63 82 70 60 37 37 61 72
Linux 10 12 16 12 18 22 14 13 11 18 6 15 12 24 13 5 14 17 13 17 16 13 12 12 17 12 19 11 7 12 10 14 10 13 19 18 9 20 12 11 17 16 15 14 11 13

Readme

Source
raw.​githubusercontent.​com

Sublime Text - View In Browser

View In Browser is a Sublime Text plugin that will open whatever is in your current view/tab. If the file current open is new and has not been saved a temporary file is created (in your default temp directory for your OS) with the extension of .htm and your browser will open it. However if the current open file is saved and has a name this plugin will open it in whatever you have set to handle its type.

By default the keystroke assigned to this plugin is CTRL + ALT + V.

Installation

Using the Sublime Text Package Control plugin (http://wbond.net/sublime_packages/package_control) press CTRL + SHIFT + P and find Package Control: Install Package and press Enter. Find this plugin in the list by name View In Browser.

Configuring Browsers

By default this plugin will open files in Firefox. You can configure it to open using another browser of your choice. To do this, choose Settings - User from Preferences > Package Settings > View In Browser.

The browser you wish to use to open files is set in the key named browser. The following is a list of browsers configured for use out of the box.

  • Firefox - Mac OS, Linux, Windows
  • Chrome - Mac OS, Linux, Windows
  • Chrome64 - Windows
  • Yandex - Windows
  • Safari - Mac OS
  • Internet Explorer - Windows
  • Chromium - Linux

Other Browsers

View In Browser also provides key bindings to open your current view in browser other than your browser setting. Below is a listing of the keys and what browser open with those key bindings.

  • CTRL + ALT + F - Firefox
  • CTRL + ALT + C - Chrome
  • CTRL + ALT + I - Internet Explorer
  • CTRL + ALT + S - Safari

Like any other key binding in Sublime these can be changed. Below is an example of the key configuration. You can remap these in your User key bindings configuration file.

[
    { "keys": [ "ctrl+alt+v" ], "command": "view_in_browser" },
    { "keys": [ "ctrl+alt+f" ], "command": "view_in_browser", "args": { "browser": "firefox" } },
    { "keys": [ "ctrl+alt+c" ], "command": "view_in_browser", "args": { "browser": "chrome" } },
    { "keys": [ "ctrl+alt+i" ], "command": "view_in_browser", "args": { "browser": "iexplore" } },
    { "keys": [ "ctrl+alt+s" ], "command": "view_in_browser", "args": { "browser": "safari" } }
]

Windows Considerations

One of the things you may notice in the Windows configuration for chrome is a variable in the command path that looks like: %Local AppData%. This is a reference to your Windows installation's AppData folder in your user profile directory. There is a variable there because this value will differ for each user on your computer, and Chrome installs to your AppData folder.

Here is a list of supported variables:

  • AppData - Your main application data folder for your profile (usually roaming)
  • Personal - Your documents location
  • Desktop - The path to your Desktop location (may be unreliable)
  • Start Menu - The path to your Start Menu items location
  • Local AppData - Your local application data folder for your profile
  • My Video - Path to your videos location
  • My Pictures - Path to your pictures location
  • My Music - Path to your music location

Note that many of these are not terribly useful for determining browser location, unless you have decided to install Firefox in your My Music folder.

Configure to View on Local Server

The View In Browser plugin also supports the ability to view files in the context of a local server. So if you have a local Apache, Tomcat, or some other server application running you can configure this plugin to open your file prefixed with a URL.

To configure this the View In Browser plugin reads the configuration of your currently loaded project. You can edit a project file by opening the sublime-project file by choosing Project -> Edit Project. In your project file you will need to specify two things:

  • baseUrl - The root URL to prefix files with
  • basePath - The base path where your site/application lives

Here's how that looks.

{
    "folders":
    [
        {
            "path": "/home/<username>/code/python/my-cool-website"
        }
    ],
    "settings": {
        "sublime-view-in-browser": {
            "baseUrl": "http://localhost:8080",
            "basePath": "/home/<username>/code/python/my-cool-website"
        }
    }
}

Notice the key named settings which is a dictionary that contains another key named sublime-view-in-browser. This is where you will put your baseUrl and basePath settings.

Now when you activate View In Browser your file will open with the HTTP protocol instead of the FILE protocol.

Change History

  • 03/11/2016:
    • Fix issue where parenthesis in paths would cause a failure to load. Solves #52
  • 10/06/2014:
    • Rewrite for version 2.0.0
    • Using subprocess instead of webbrowser. Seems to solve #19
    • Smaller, simplier sublime-settings file
  • 05/15/2014:
    • Current view only saves if there are modifications
  • 07/03/2013:
    • Changes to support Sublime Text 3 and Python 3
  • 06/15/2013:
    • Backslashes in Windows are now converted to forward slashes when using a local server configuration. Closes #16
  • 04/16/2013:
    • Added support for muliple paths per browser configuration (jadient #14)
  • 03/08/2013:
    • Avoid loading Windows special folder references when on a Mac
    • Added Mac Chrome to the supported browsers list
  • 02/18/2013:
    • Added ability to use Windows special folder references to browser commands. Closes #10
  • 01/30/2013:
    • All settings for this plugin now live in the file View In Browser.sublime-settings. This allows for a user to override them in their User directory. The old settings.json file is no longer used.
  • 01/28/2013:
    • Merged in change from imaginationac to remove menu nesting
  • 12/26/2012:
    • Added Linux Chromium to the supported browsers list
  • 11/01/2012:
    • Altered command to open Safari on Mac
    • When invoked the current view is auto-saved
  • 10/25/2012:
    • New settings.json file to map browser/commands to OSes
    • Plugin will use the specified browser to open files, or default to OS default when browser is unsupported
    • Addressed encoding issue when calling open_new_tab
    • Added ability to specify and respect local server config per project
  • 05/21/2012:
    • Temp file only created if view is unsaved
  • 05/18/2012:
    • Initial code

Contributors

License

The MIT License (MIT) Copyright © 2012 Adam Presley

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.