/Origami

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

Primary LanguagePython

Origami

Origami is a new way of thinking about panes in Sublime Text 2 and 3: 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 super+k. First press super+k, then press the arrow keys with modifiers:

  • no modifiers: travel to an adjacent pane
  • shift: carry the current file to the destination
  • alt (option): clone the current file to the destination
  • super: create an adjacent pane
  • super+shift: destroy an adjacent pane

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

Additionally, Origami allows one to zoom the current pane, making it take up a large portion of the window. As above, first press super+k, then press:

  • super+z: Zoom the current pane so it takes up 90% of the screen (the fraction is changeable in the keybindings)
  • shift+super+z: Unzoom: equally space all panes

It is also possible to edit the pane sizes. After super+k press:

  • super+r: Adjust the top and bottom separator
  • super+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
  • BEFORE means top (or left) separator
  • AFTER means bottom (or right) separator

(Note: Windows and Linux use ctrl instead of super.)

Automation

You can have Origami automatically zoom the active pane by setting origami_auto_zoom_on_focus in your 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.

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

Install

Search for Origami on Package Control!