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

Origami

by SublimeText ALL

Split the window however you like! Create new panes, delete panes, move and clone views from pane to pane.

Details

  • 2.3.0
    1.0.0
  • github.​com
  • github.​com
  • 6 months ago
  • 12 minutes ago
  • 12 years ago

Installs

  • Total 139K
  • Win 53K
  • Mac 55K
  • Linux 31K
Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11 Mar 10 Mar 9 Mar 8 Mar 7 Mar 6 Mar 5 Mar 4 Mar 3 Mar 2 Mar 1 Feb 29 Feb 28 Feb 27 Feb 26 Feb 25 Feb 24 Feb 23 Feb 22 Feb 21 Feb 20 Feb 19 Feb 18 Feb 17 Feb 16 Feb 15 Feb 14 Feb 13 Feb 12 Feb 11 Feb 10 Feb 9 Feb 8 Feb 7 Feb 6 Feb 5 Feb 4 Feb 3
Windows 2 9 4 2 7 7 7 9 7 4 10 7 6 10 5 6 5 6 6 10 9 8 3 2 4 5 10 5 5 4 7 9 6 9 5 8 7 4 5 8 7 8 8 13 8 6
Mac 3 1 3 3 6 2 5 5 6 2 2 4 11 5 3 4 5 6 2 8 4 3 6 4 2 7 3 8 4 2 3 2 5 4 2 8 9 5 5 4 7 6 6 8 2 2
Linux 1 4 0 3 1 4 2 5 5 7 5 7 11 2 11 14 5 5 7 8 4 6 1 7 3 6 5 9 4 5 4 3 4 3 4 3 2 4 8 4 5 0 6 6 9 4

Readme

Source
raw.​githubusercontent.​com

Origami

Origami is a new way of thinking about panes in Sublime Text: you tell Sublime Text where you want a new pane, and it makes one for you. It works seamlessly alongside the built-in layout commands.

Ordinarily one uses the commands under View>Layout, or if one is quite intrepid a custom keyboard shortcut can be made to give a specific layout, but both of these solutions were unsatisfactory to me. Perhaps they were to you too! That's what this plugin is for.

Try it out! I think you'll like it.

Keyboard shortcuts

Origami is driven by keyboard shortcuts. By default, these keyboard shortcuts are all two-stage, and are hidden behind command+k. First press command+k, then press the arrow keys with modifiers:

NOTE: Windows and Linux use ctrl instead of command.

First Then Action
command+k ▲►▼◄ travel to an adjacent pane
command+k shift+▲►▼◄ carry the current file to the destination
command+k alt (option on Mac)+▲►▼◄ clone the current file to the destination
command+k command+▲►▼◄ create an adjacent pane
command+k command+shift+▲►▼◄ destroy an adjacent pane
command+k ctrl+alt (command+option on Mac)+▲►▼◄ create an adjacent pane and carry the current file to the destination

These keyboard shortcuts are designed to make it really easy to modify the layout of your editor.

NOTE: The following keyboard shortcuts for zooming and editing pane sizes are not enabled by default due to a conflict with built-in ST features. Open the Preferences: Origami Key Bindings from the Command Palette to enable or edit them, or just use the Command Palette to trigger those commands.

Additionally, Origami allows one to zoom the current pane, making it take up a large portion of the window:

First Then Action
command+k command+z Zoom the current pane so it takes up 90% of the screen (the fraction is changeable in the keybindings)
command+k shift+command+z Un-zoom: equally space all panes

It is also possible to edit the pane sizes:

First Then Action
command+k command+r Adjust the top and bottom separator
command+k command+c Adjust the left and right separator

In the keybindings you can change a mode which specifies which separation lines you want to edit. * ALL means all horizontal (or vertical) separators * RELEVANT means all horizontal (or vertical) separators which intersect the column (row) of the selected row. * NEAREST means top and bottom (or left and right) separators. This is the default mode. * BEFORE means top (or left) separator * AFTER means bottom (or right) separator

Automation

You can have Origami automatically zoom the active pane by setting auto_zoom_on_focus in your Origami user preferences. Set it to true for the default zoom, or set it to a user-definable fraction of the screen, such as 0.75, or [0.5, 0.6] for horizontal and vertical correspondingly.

Origami can also automatically close a pane for you once you've closed the last file in it. Just set auto_close_empty_panes to true in the Origami preferences.

Installation

Using package control

  1. Open up the command palette: ctrl+shift+p (Linux, Windows) / cmd+shift+p (macOS)
  2. Search for Package Control: Install Package
  3. Search for Origami
  4. Hit enter :wink:

Using the command line

If you want to contribute to this package, first thanks, and second, you should download this using git so that you can propose your changes.

cd "%APPDATA%\Sublime Text 3\Packages"             # on Windows
cd ~/Library/Application\ Support/Sublime\ Text\ 3 # on Mac
cd ~/.config/sublime-text-3                        # on Linux

git clone "https://github.com/SublimeText/Origami.git"