m-vim_plugins/vim-thematic
1
0
Fork 0
mirror of https://github.com/preservim/vim-thematic.git synced 2025-11-13 04:13:48 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

first cut

Browse Source
This commit is contained in:
Reed Esau
2013-12-29 15:49:12 -07:00
parent 1918cc0621
commit b045eccaab
1 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
README.markdown
View File

@@ -1,4 +1,4 @@
# `thematic.vim` # thematic.vim
> Conveniently manage Vim’s appearance to suit your task and environment > Conveniently manage Vim’s appearance to suit your task and environment
@@ -9,7 +9,7 @@
available with GUI-based support for: font, fullscreen, etc. available with GUI-based support for: font, fullscreen, etc.
* Integrates with [airline][https://github.com/bling/vim-airline] * Integrates with [airline][https://github.com/bling/vim-airline]
## Why `thematic`? ## Why thematic?
You may be among the many Vim users who keep things simple by sticking You may be among the many Vim users who keep things simple by sticking
with a single theme that suits your needs, configuring it in your `.vimrc` with a single theme that suits your needs, configuring it in your `.vimrc`
@@ -28,7 +28,7 @@ the screen stripped of all extraneous detail, with a traditional font and
generous left and right margins. generous left and right margins.
Managing such an multi-theme environment in Vim has traditionally been Managing such an multi-theme environment in Vim has traditionally been
a hassle. The `thematic` plugin is intended to solve that problem, a hassle. The thematic plugin is intended to solve that problem,
providing you flexibility and convenience. providing you flexibility and convenience.
## Installation ## Installation
@@ -65,7 +65,7 @@ you'll want to override them with your own, like this:
\ } \ }
``` ```
If you don't specify a `colorscheme`, `thematic` will attempt to load one If you don't specify a `colorscheme`, thematic will attempt to load one
given your theme name. given your theme name.
You can also specify a dictionary of default values, to be shared by all You can also specify a dictionary of default values, to be shared by all
@@ -80,14 +80,14 @@ of your themes.
Note that an explicit setting in a theme will always override these defaults. Note that an explicit setting in a theme will always override these defaults.
Note also that `thematic` stays out of your way, ignoring any settings Note also that thematic stays out of your way, ignoring any settings
that you aren't explicitly setting through your `thematic` configuration. that you aren't explicitly setting through your thematic configuration.
For example, you can `set guifont=` in your .gvimrc independent of your For example, you can `set guifont=` in your .gvimrc independent of your
`thematic` configuration. thematic configuration.
### Commands ### Commands
Running `:ThematicFirst` invoke `thematic` and chooses the first theme, Running `:ThematicFirst` invoke thematic and chooses the first theme,
as your themes will be reordered alphabetically by name. as your themes will be reordered alphabetically by name.
```vim ```vim
@@ -99,7 +99,7 @@ as your themes will be reordered alphabetically by name.
:Thematic {theme_name} " load a theme by name :Thematic {theme_name} " load a theme by name
``` ```
`thematic` does not map any keys by default, but you can easily do so in thematic does not map any keys by default, but you can easily do so in
your `.vimrc` file: your `.vimrc` file:
```vim ```vim
@@ -126,7 +126,7 @@ For console or GUI Vim:
character color character color
* `fold-column-color-mute` - temporarily modifies colorscheme to hide * `fold-column-color-mute` - temporarily modifies colorscheme to hide
indicators in foldcolumn indicators in foldcolumn
* `force-redraw` - if 1, forces a `redraw!` after `thematic` makes changes * `force-redraw` - if 1, forces a `redraw!` after thematic makes changes
For GUI-based options, see the `vim-thematic-gui` plugin. Here’s For GUI-based options, see the `vim-thematic-gui` plugin. Here’s
a summary: a summary:
@@ -141,7 +141,7 @@ a summary:
### Q: I want to set `cursorline`, `wrap`, `textwidth`, etc. in my themes. ### Q: I want to set `cursorline`, `wrap`, `textwidth`, etc. in my themes.
`thematic` focuses exclusively on global settings. The settings above are thematic focuses exclusively on global settings. The settings above are
not globally-scoped but are instead scoped to individual buffers and not globally-scoped but are instead scoped to individual buffers and
windows. These are best set using the `FileType` feature in Vim. windows. These are best set using the `FileType` feature in Vim.
@@ -154,7 +154,7 @@ It works best with GUI Vim's fullscreen. A few steps are involved:
(1) Install a few plugins: (1) Install a few plugins:
* [vim-thematic-gui](https://github.com/reedes/vim-thematic-gui) - support GUI features in `thematic` * [vim-thematic-gui](https://github.com/reedes/vim-thematic-gui) - support GUI features in thematic
* [vim-markdown](https://github.com/tpope/vim-markdown) - support for editing markdown * [vim-markdown](https://github.com/tpope/vim-markdown) - support for editing markdown
* [vim-writer](https://github.com/reedes/vim-writer) - to configure for word processing * [vim-writer](https://github.com/reedes/vim-writer) - to configure for word processing
@@ -174,7 +174,7 @@ MacVim:
``` ```
let g:thematic#themes = { let g:thematic#themes = {
\ 'mark_lite' :{ 'colorscheme': 'solarized', \ 'iawriter' :{ 'colorscheme': 'solarized',
\ 'background': 'light', \ 'background': 'light',
\ 'columns': 75, \ 'columns': 75,
\ 'font-size': 20, \ 'font-size': 20,
@@ -211,7 +211,7 @@ If you like this plugin, you might like these others from the same author:
* [vim-litecorrect](http://github.com/reedes/vim-litecorrect) - Lightweight auto-correction for Vim * [vim-litecorrect](http://github.com/reedes/vim-litecorrect) - Lightweight auto-correction for Vim
* [vim-quotable](http://github.com/reedes/vim-quotable) - extends Vim to support typographic (‘curly’) quotes * [vim-quotable](http://github.com/reedes/vim-quotable) - extends Vim to support typographic (‘curly’) quotes
* [vim-thematic-gui](http://github.com/reedes/vim-thematic-gui) — A GUI-based extension to the `thematic` plugin for Vim * [vim-thematic-gui](http://github.com/reedes/vim-thematic-gui) — A GUI-based extension to the thematic plugin for Vim
* [vim-writer](http://github.com/reedes/vim-writer) - Extending Vim to better support writing prose and documentation * [vim-writer](http://github.com/reedes/vim-writer) - Extending Vim to better support writing prose and documentation
## Future development ## Future development