zk-phi / sublimity

Smooth-scrolling and minimap like sublime editor
492 stars 27 forks source link
emacs

sublime 風のスムーススクロール、ミニマップ、集中モード

smooth-scrolling, minimap and distraction-free mode (inspired by the sublime editor)

** Screencast

[[screencast.png]]

** Installation

Require this script and some of =sublimity-scroll=, =sublimity-map= and =sublimity-attractive=.

: (require 'sublimity) : ;; (require 'sublimity-scroll) : ;; (require 'sublimity-map) ;; experimental : ;; (require 'sublimity-attractive)

then call command =M-x sublimity-mode= (or put the following expression in your init file).

: (sublimity-mode 1)

** Notes

When you turn =sublimity-mode= on, =auto-hscroll-mode= is automatically disabled, and =sublimity-auto-hscroll-mode= will work instead. Thus, to disable horizontal scrolling, set =sublimity-auto-hscroll-mode= but not =auto-hscroll-mode= while =sublimity-mode= is turned on.

=sublimity-scroll= currently requires an unset/zero =scroll-margin=.

** Customization *** sublimity-scroll (smooth scrolling)

You may configure the speed of smooth-scroll by setting two variables.

: (setq sublimity-scroll-weight 10 : sublimity-scroll-drift-length 5)

Scroll is basically divided into (weight + drift-length) steps. for example, with the configuration above, 100 lines of scrolling is divided into 15 (= 10 + 5) steps

: (17 15 14 12 11 8 7 5 4 2 1 1 1 1 1)

and it looks smoother than 1 step scroll. Note that last 5 steps are all 1 line scrolls, because drift-length is set 5. So you may make scroll more smooth by setting drift-length greater. try :

: (setq sublimity-scroll-weight 5 : sublimity-scroll-drift-length 10)

With the configuration above, scroll is divided into 15 steps again,

: (30 24 18 12 6 1 1 1 1 1 1 1 1 1 1)

but the last 10 steps are all 1 line scrolls. this looks smoother but perhaps more annoying for some users.

For fast computers where the smooth scrolling effect happens too quickly, you can configure a small delay (in seconds) that occurs between scroll steps:

: (setq sublimity-scroll-vertical-frame-delay 0.01)

* sublimity-map (minimap, experimental) ** sublimity-map-size, fraction, text-scale

: (setq sublimity-map-size 20) : (setq sublimity-map-fraction 0.3) : (setq sublimity-map-text-scale -7)

=sublimity-map-fraction= defines the maximum fraction of width that minimap can get. =sublimity-map-text-scale= is passed to =text-scale-set= on minimap setup.

**** sublimity-map-setup-hook

: (add-hook 'sublimity-map-setup-hook : (lambda () : (setq buffer-face-mode-face '(:family "Monospace")) : (buffer-face-mode)))

=sublimity-map-setup-hook= will run when minimap is created.

**** sublimity-map-set-delay

: (sublimity-map-set-delay 5)

With the setting above, minimap is displayed after 5 seconds of idle time. When =sublimity-map-set-delay= is called with =nil=, then minimap is shown with no delay. This defers from setting delay to 0, especially when used with sublimity-scroll, in the sense that minimap looks not deleted at all but gets worse performance.

* sublimity-attractive (distraction-free mode) ** sublimity-attractive-centering-width

: (setq sublimity-attractive-centering-width 110)

When a positive integer is set, buffer width is truncated to this value and drawn centered. To cancel this feature, set this value nil.

**** sublimity-attractive-hide-xxxx

Following functions are available to hide some UI parts.

: (sublimity-attractive-hide-bars) : (sublimity-attractive-hide-vertical-border) : (sublimity-attractive-hide-fringes) : (sublimity-attractive-hide-modelines)