badjware
/
spacegray.vim
mirror of https://git.sr.ht/~ackyshake/spacegray.vim
1
0
Fork 0
Code Releases Activity
spacegray.vim/README.md

128 lines
4.2 KiB
Markdown
Raw Permalink Normal View History

Initial commit of spacegray.vim. - Work on support for terminal vim is being done.
2014-12-14 10:26:22 +00:00
# Spacegray.vim
Clarify that the colorscheme isn't trying to be faithful to the original
2014-12-14 21:55:42 +00:00
Spacegray is a colorscheme for Vim loosely modeled after
Initial commit of spacegray.vim. - Work on support for terminal vim is being done.
2014-12-14 10:26:22 +00:00
the [spacegray](https://github.com/zdne/spacegray-xcode) theme for Xcode.
Add options to tweak spacegray Adds italic comment support and the ability to use underline instead of the highlight search, which makes it much more pleasing to look at, in my opinion. Note that the italic comment support in terminal vim requires terminal support.
2016-05-22 03:59:58 +00:00
## Options
You can tweak Spacegray by enabling the following disabled options:
1. Underlined Search: Underline search text instead of using highlight color.
Put the following in your `~/.vimrc` to enable it:
> `let g:spacegray_underline_search = 1`
Use italics for inactive status line This also changes the variable name from `g:spacegray_italicize_comments` to `g:spacegray_use_italics` to reflect the new change.
2017-11-23 02:31:11 +00:00
2. Use Italics: Use italics when appropriate, e.g. for comments. (_note_:
terminal must support italics). Put the following in your `~/.vimrc` to
enable it:
Add options to tweak spacegray Adds italic comment support and the ability to use underline instead of the highlight search, which makes it much more pleasing to look at, in my opinion. Note that the italic comment support in terminal vim requires terminal support.
2016-05-22 03:59:58 +00:00
Use italics for inactive status line This also changes the variable name from `g:spacegray_italicize_comments` to `g:spacegray_use_italics` to reflect the new change.
2017-11-23 02:31:11 +00:00
> `let g:spacegray_use_italics = 1`
Add options to tweak spacegray Adds italic comment support and the ability to use underline instead of the highlight search, which makes it much more pleasing to look at, in my opinion. Note that the italic comment support in terminal vim requires terminal support.
2016-05-22 03:59:58 +00:00
Showcase lower contrast variant of Spacegray Also move all screenshots locally under the "screenshots" folder for easier management.
2017-11-23 03:10:50 +00:00
3. Use lower contrast: Use a low contrast variant of Spacegray. Put the
Introduce a lower contrast variant of Spacegray
2017-11-23 02:58:43 +00:00
following in your `~/.vimrc` to enable it:
Showcase lower contrast variant of Spacegray Also move all screenshots locally under the "screenshots" folder for easier management.
2017-11-23 03:10:50 +00:00
> `let g:spacegray_low_contrast = 1`
Introduce a lower contrast variant of Spacegray
2017-11-23 02:58:43 +00:00
Update Readme with screenshots.
2014-12-14 10:39:01 +00:00
## Screenshots
Add an additional screenshot
2019-02-23 04:51:12 +00:00
### Syntax Groups
![Syntax Groups](screenshots/hl_groups.png)
Update screenshots
2019-02-15 09:24:01 +00:00
### Spacegray Low Contrast
![Spacegray Low Contrast](screenshots/low_contrast.png)
Update Readme with screenshots.
2014-12-14 10:39:01 +00:00
Update screenshots
2019-02-15 09:24:01 +00:00
### Spacegray Dark
![Spacegray Dark](screenshots/dark.png)
Replace C GUI Screenshot with a Ruby Terminal one.
2015-01-20 01:08:45 +00:00
Initial commit of spacegray.vim. - Work on support for terminal vim is being done.
2014-12-14 10:26:22 +00:00
## Installation
Replace pathogen instructions with native Vim 8 instructions
2018-04-06 04:57:42 +00:00
If you use Vim 8 or better, simply copy and paste:
Initial commit of spacegray.vim. - Work on support for terminal vim is being done.
2014-12-14 10:26:22 +00:00
Replace pathogen instructions with native Vim 8 instructions
2018-04-06 04:57:42 +00:00
git clone git://github.com/ajh17/Spacegray.vim ~/.vim/pack/vendor/start/Spacegray
Initial commit of spacegray.vim. - Work on support for terminal vim is being done.
2014-12-14 10:26:22 +00:00
Then in your ~/.vimrc, add this line:
Update Readme with screenshots.
2014-12-14 10:39:01 +00:00
colorscheme spacegray
Add terminal configuration steps to Readme
2014-12-15 00:01:48 +00:00
## Terminal Environment
If you use Spacegray inside a Terminal, please make sure you use a Terminal
Update README with sample ~/.Xresources file. - Also reword terminal environment section.
2014-12-15 07:00:19 +00:00
with 256 color support. Most these days are. Ensure that the default TERM
contains the string `256color`. An example would be `xterm-256color` or
if using tmux or screen, `screen-256color`.
Add terminal configuration steps to Readme
2014-12-15 00:01:48 +00:00
Update Readme to explain `'guicolors'`
2016-04-24 17:43:53 +00:00
NOTE: If you use Vim 7.4.1778 or higher, you can now use Spacegray's GUI colors
inside terminal Vim as long as your terminal supports true colors (24-bit
Fix legacy guicolors option Option was renamed to 'termguicolors'
2016-10-31 04:04:08 +00:00
colors). To enable this, put `:set termguicolors` and ignore the rest of the
Update Readme to explain `'guicolors'`
2016-04-24 17:43:53 +00:00
terminal color sections of this document.
Update README with sample ~/.Xresources file. - Also reword terminal environment section.
2014-12-15 07:00:19 +00:00
### Terminal Color Palette
Document the new itemcolors in the README.
2014-12-15 04:27:23 +00:00
Update README with sample ~/.Xresources file. - Also reword terminal environment section.
2014-12-15 07:00:19 +00:00
Spacegray will look good in a dark terminal colorscheme, but if you use
Spacegray's color palette, it will look beautiful.
README fixes
2014-12-15 00:02:22 +00:00
Update README to consolidate information about terminal colorschemes.
2015-01-06 09:12:22 +00:00
### Terminal Colorschemes
add mostly default terminator config with spacegray palette
2014-12-15 17:53:21 +00:00
Update README to consolidate information about terminal colorschemes.
2015-01-06 09:12:22 +00:00
On OS X, colorschemes for iTerm2 and Terminal.app are provided with the download.
Simply double click to install.
Add terminal configuration steps to Readme
2014-12-15 00:01:48 +00:00
Increase heading level for terminal color subsections
2016-10-31 04:02:59 +00:00
### Terminator
Update instructions for gnome-terminal The previous instructions no longer worked on the latest Ubuntu LTS/Gnome 3.20. This commit provides an alternative way to set Spacegray colors using dconf to set the values.
2016-10-31 03:59:37 +00:00
Spacegray.terminator is provided for Terminator and can be installed by
Update README to consolidate information about terminal colorschemes.
2015-01-06 09:12:22 +00:00
copying to `~/.config/terminator/config` on Linux or
`$XDG_CONFIG_HOME/terminator/config` if you're running OS X.
add mostly default terminator config with spacegray palette
2014-12-15 17:53:21 +00:00
Increase heading level for terminal color subsections
2016-10-31 04:02:59 +00:00
### Gnome Terminal
Update instructions for gnome-terminal The previous instructions no longer worked on the latest Ubuntu LTS/Gnome 3.20. This commit provides an alternative way to set Spacegray colors using dconf to set the values.
2016-10-31 03:59:37 +00:00
Simplify gnome-terminal configurations Use gsettings to get the default profile ID so the user doesn't have to copy and paste.
2017-04-26 08:48:35 +00:00
For gnome terminal, you can configure the terminal with the following set of
gsettings commands:
profile_key=$(gsettings get org.gnome.Terminal.ProfilesList default | sed -e "s/'//g" | tr -d "\n")
gsettings set org.gnome.Terminal.Legacy.Profile:/org/gnome/terminal/legacy/profiles:/:$profile_key/ visible-name "'Spacegray'"
gsettings set org.gnome.Terminal.Legacy.Profile:/org/gnome/terminal/legacy/profiles:/:$profile_key/ background-color "'rgb(17,19,20)'"
gsettings set org.gnome.Terminal.Legacy.Profile:/org/gnome/terminal/legacy/profiles:/:$profile_key/ foreground-color "'rgb(183,187,183)'"
gsettings set org.gnome.Terminal.Legacy.Profile:/org/gnome/terminal/legacy/profiles:/:$profile_key/ use-theme-colors "false"
gsettings set org.gnome.Terminal.Legacy.Profile:/org/gnome/terminal/legacy/profiles:/:$profile_key/ palette "['rgb(44,47,51)', 'rgb(176,76,80)', 'rgb(145,150,82)', 'rgb(226,153,92)', 'rgb(102,137,157)', 'rgb(141,100,148)', 'rgb(82,124,119)', 'rgb(96,99,96)', 'rgb(75,80,86)', 'rgb(176,76,80)', 'rgb(148,152,91)', 'rgb(226,153,92)', 'rgb(102,137,157)', 'rgb(141,100,148)', 'rgb(82,124,119)', 'rgb(221,227,220)']"
gnome-terminal should then immediately reflect Spacegray colors.
Add gnome-terminal colorscheme.
2015-01-08 10:22:04 +00:00
Add reference to Xcode colorscheme that closely matches Spacegray.vim
2020-09-18 05:47:16 +00:00
### Xcode
Use Xcode? Try out [Spacegray-Xcode](https://github.com/ajh17/spacegray-xcode).
Increase heading level for terminal color subsections
2016-10-31 04:02:59 +00:00
### Xresources
add mostly default terminator config with spacegray palette
2014-12-15 17:53:21 +00:00
Update README with sample ~/.Xresources file. - Also reword terminal environment section.
2014-12-15 07:00:19 +00:00
For Linux/BSD users, here is a sample ~/.Xresources:
*background: #111314
*foreground: #B7BBB7
! black
*color0: #2C2F33
*color8: #4B5056
! red
*color1: #B04C50
*color9: #B04C50
! green
*color2: #919652
*color10: #94985B
! yellow
*color3: #E2995C
*color11: #E2995C
! blue
*color4: #66899D
*color12: #66899D
! magenta
*color5: #8D6494
*color13: #8D6494
! cyan
*color6: #527C77
*color14: #527C77
! white
*color7: #606360
*color15: #DDE3DC
Make Constant cterm color orange to match the GUI colors. - Also add License (Vim License)
2014-12-26 23:51:50 +00:00
Update README
2018-04-07 20:21:39 +00:00
For lower contrast Spacegray, use a background color of #242424
Make Constant cterm color orange to match the GUI colors. - Also add License (Vim License)
2014-12-26 23:51:50 +00:00
# License
Copyright (c) Akshay Hegde. Distributed under the same terms as Vim itself. See `:help license`