/centered-window-mode

Keep your text centered when there's only one window.

Primary LanguageEmacs Lisp

NOTE: Due to a lack of time to solve the issues of this project and the responsabilities derived from my recent paternity, I’m looking for someone to transfer the ownership of the project and who’s willing to keep working in it.

Centered Window Mode

Global minor mode that centers the text of the window. If another window is visible the text goes back to normal if its width is less than cwm-centered-window-width.

You may want to activate visual-line-mode if your lines go out of reach.

Screenshots

https://raw.githubusercontent.com/ikame/centered-window-mode/master/img/s-1.png https://raw.githubusercontent.com/ikame/centered-window-mode/master/img/s-2.png https://raw.githubusercontent.com/ikame/centered-window-mode/master/img/s-3.png

Installation

Manual installation

First, download centered-window-mode.el in your emacs load path.

Then, to make it available, add this to your configuration file:

(require 'centered-window-mode)

Installation via el-get

If you use el-get, the emacs package manager, simply add centered-window-mode to your packages list.

Installation via use-package

If you use use-package, simply add the following to your init file.

(use-package centered-window :ensure t)

Activation

On-the-fly

Simply type M-x centered-window-mode in any buffer.

Permanent

To make this permanent, add this to your emacs configuration file:

(require 'centered-window-mode)
(centered-window-mode t)

Vertical padding

Adding vertical padding to an Emacs window is kind of hard, I have tried a lot of different solutions but most of them add a lot of complexity and source of bugs to the mode. Currently there are the options cwm-use-vertical-padding (default nil, set to t if you want this feature) and cwm-frame-internal-border (default 70) to add some padding to the frame, it’s far from ideal but I have found it at most acceptable for most of the use cases where I need this feature.

Customization

Once installed you can easily customize the mode use Emacs’ customization mechanism: M-x customize-group<RET>centered-window-mode

License

Copyleft (ɔ) Anler Hernández Peral

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.