kevin/darkcloud-nvimconfig
1
0
Fork 0
mirror of https://github.com/prurigro/darkcloud-nvimconfig.git synced 2024-09-19 11:54:23 -04:00
Code Issues Projects Releases Packages Wiki Activity
darkcloud-nvimconfig/README.md

209 lines
18 KiB
Markdown
Raw Normal View History

Added commandline argument support to the update script that includes options to display help and version information, as well as to disable colour output (with both English and American spellings of colour). Some minor changes to wording/style were also made in the title blocks and README.
2014-06-17 01:49:46 -04:00
# darkcloud-vimconfig #
A theme, config and collection of plugins for Vim.
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
## Requirements ##
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
* **Vim**: The latest [vim](http://www.vim.org) should be installed to use this distribution (versions 7.3 and below aren't tested or guaranteed to work).
* **Bash**: Required by the _update_ and _gentags_ scripts.
* **Git**: Required by the _update_ script and git-related plugins.
Updated dependencies in the README
2014-07-16 09:19:08 -04:00
* **Python**: Required by the _gundo_ and _MatchTagAlways_ plugins.
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
## Optional Requirements ##
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
* **Artistic Style**: Required by the _autoformat_ plugin to format C, C++, C++/CLI, C#, and Java source ([astyle website](http://astyle.sourceforge.net)).
* **autopep8**: Required by the _autoformat_ plugin to format Python using the PEP 8 style guide ([autopep8 repo](https://github.com/hhatto/autopep8)).
Submodules have been updated. FKey toggles were tweaked a bit along with general improvements to keyboard mappings. Fixed some issues with the update script, including incorrect log placement as well as allowing it to fail after a timeout when vim hangs (happens when vim displays an error on startup, for example), added better and more consistant error output/logging and fixed some errors along with dozens of tweaks.
2014-06-17 08:19:40 -04:00
* **Compilers and Runtimes**: The syntastic plugin can use the compiler or runtime for most languages to provide real-time syntax checking.
* **CTags**: Required by the _tagbar_ and _neocomplcache_ plugins as well as the _gentags_ script ([ctags website](http://ctags.sourceforge.net)).
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
* **JS Beautifier**: Required by the _autoformat_ plugin to format Javascript source and HTML ([js-beautify repo](https://github.com/Chiel92/vim-autoformat)).
Submodules have been updated. FKey toggles were tweaked a bit along with general improvements to keyboard mappings. Fixed some issues with the update script, including incorrect log placement as well as allowing it to fail after a timeout when vim hangs (happens when vim displays an error on startup, for example), added better and more consistant error output/logging and fixed some errors along with dozens of tweaks.
2014-06-17 08:19:40 -04:00
* **Powerline Fonts**: Required to enable the fancier looking status line ([powerline-fonts repo](https://github.com/Lokaltog/powerline-fonts)).
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
* **Tidy**: Required by the _autoformat_ plugin to format XHTML and XML ([tidy website](http://tidy.sourceforge.net)).
## Distribution Features ##
* **Default Configuration**: A complete set of defaults, focusing on the most modern settings that still provide a compatible experience.
* **Custom theme**: An original colour scheme with explicit values set to optimize the look of individual filetypes.
* **Key Bindings/Aliases**: A set of bindings and aliases defined to group similar features and provide numerous (and sometimes more familiar) ways to access options.
* **Plugins**: A set of plugins have been included and configured to provide support for most normally-unsupported filetypes, and a set of features useful when using Vim as an editor.
* **Custom Configuration**: A second vimrc and bundle folder are included that aren't maintained as part of the repo, making custom plugins and configuration easy to add.
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Update screenshot to reflect current look and feel
2015-03-10 07:37:02 -04:00
![Darkcloud Vim Distribution Theme](http://i.imgur.com/oIqgie0.png)
Tweaked the tagbar and added a screenshot to the README
2014-04-09 15:39:22 -04:00
Added a screenshot of the update tool in action
2014-07-24 01:00:56 -04:00
![Darkcloud Vimconfig Update Tool](http://i.imgur.com/AOXSL7S.png)
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
## Installation ##
Added a writeup of features and some information about accessing them to the README, made <backspace> delete the selection and cursor character in visual and normal modes respectively, and set \| to add the currently selected word to the local dictionary for spellcheck (remembering that \\ displays a list of correct spellings)
2014-03-28 11:13:10 -04:00
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
1. Clone the darkcloud-vimconfig repo and use the _update_ script to install the plugins:
Fixed some keybindings, added help dialog sidebar toggles (help dialogs now always pop up veritcally, which made sense to me considering their column width and the average size of screens these day), touched up the readme and some missing keyboard toggles, added a few more formats relevant to emmet, and gave variables default values in the configs so they don't need to be declared (default values are stated in the README)
2014-04-05 03:20:53 -04:00
* `git clone https://github.com/prurigro/darkcloud-vimconfig.git`
Added commandline argument support to the update script that includes options to display help and version information, as well as to disable colour output (with both English and American spellings of colour). Some minor changes to wording/style were also made in the title blocks and README.
2014-06-17 01:49:46 -04:00
* `./darkcloud-vimconfig/update` (if you don't want colour output, run: `./darkcloud-vimconfig/update --no-colour` instead)
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
* **Note**: The _update_ script requires bash, but if it's not available you can enter the _darkcloud-vimconfig/_ folder and run: `git submodule update --init` to install the plugins manually, then create _vim/vimrc.user_ and remember to run: `:Helptags` once everything else is running.
Tweaked the update script to drop the user variables from vimrc into vimrc.user when it's created. a new user-based config file can be used to specify the location of the project folder without altering vimrc, if it's a symlink and bound to bump into conflicts as changes are made. The README was updated to reflect a few of the recent changes. The tagbar now outputs to the lightline statusline if there's anything to report. A new variable was added to choose whether to always start with the tagbar enabled if the format is compatible, or use the older behaviour, where it would only appear when triggered. The default is to enable it 24/7.
2014-04-08 03:39:10 -04:00
2. If you don't know where vim expects to find your vimrc, start vim and run: `:version` to find the values "user vimrc file" (for a single-user install) and "system vimrc file" (for a system-wide install). T
3. Copy or symlink the vimrc file from `darkcloud-vimconfig/vimrc` to one of the locations vim expects to find it, based on whether you want a local or system-wide install, then choose one of the following:
Fixed a spelling mistake in the README
2014-07-30 04:55:35 -04:00
* Edit the _g:darkcloudpath_ variable in the vimrc file itself, pointing it to the location you're keeping the _darkcloud-vimconfig_ repo folder.
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
* Create a file @ _~/.vim/darkcloud-path.vim_ and in it put the following: `let g:darkcloudpath="/etc/darkcloud-vimconfig"`, but replacing _"/etc/darkcloud-vimconfig"_ with the path to the _darkcloud-vimconfig_ repo folder.
* Place _darkcloud-vimconfig_ in the default location @ _/etc/darkcloud-vimconfig_.
* Create your own vimrc and have that set the _g:darkcloudpath_ variable before sourcing the included vimrc.
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
Added vimpager info to the README + removed keyboard.vim from vimpager and instead specified a custom set of mappings. Removed the SpellCheck plugin (it stopped working and wasn't very useful anyway)
2014-07-26 03:08:33 -04:00
### Vimpager ###
Add note about vimpager compatibility being for 1.x
2015-07-29 15:19:56 -04:00
Once darkcloud-vimconfig has been set up, you can configure `vimpager` _1.x_ to use it by running (assuming the default path @ _"/etc/darkcloud-vimconfig"_):
Added vimpager info to the README + removed keyboard.vim from vimpager and instead specified a custom set of mappings. Removed the SpellCheck plugin (it stopped working and wasn't very useful anyway)
2014-07-26 03:08:33 -04:00
compress the vimpager stuff into fewer lines
2014-07-31 01:51:21 -04:00
`ln -s /etc/darkcloud-vimconfig/vimpagerrc /etc/vimpagerrc` (for a system-wide configuration), or:
Improved vimpager documentation
2014-07-31 01:44:10 -04:00
`ln -s /etc/darkcloud-vimconfig/vimpagerrc ~/.vimpagerrc` (for a given user).
As usual, to have your system use `vimpager` in place of `less`, you'll need to set the **$PAGER** environment variable to `vimpager`:
Removed the junk about vimcat; the default config works better
2014-07-31 03:09:56 -04:00
`export PAGER=vimpager`, and configure aliases for less in _"/etc/bash.bashrc"_ or _"~/.bashrc"_: `alias less='vimpager'`
Added vimpager info to the README + removed keyboard.vim from vimpager and instead specified a custom set of mappings. Removed the SpellCheck plugin (it stopped working and wasn't very useful anyway)
2014-07-26 03:08:33 -04:00
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
## Configuration ##
Cleaned up the README a bit and added the autoswap plugin to better handle opening vim when a swapfile exists.
2014-04-21 08:17:31 -04:00
* **Configure Variables**: The following variables can be added to _vim/vimrc.user_ and have their values set to the values you require:
Syntastic doesn't check on :wq when disabled, and toggling active/passive also toggles check on open/wq. A new variable was added to prevent autochecking tags, and the README and update script were updated to reflect this. Disabling the linebreaks is now defaulted to off (flip it back on if you like it). The update script is a bit more careful about how it runs when executed from other directories. A bug preventing the g:disablelinebreaks variable from being possible to disable has been squashed, and no default is set when it's not enabled. Added Emmet javascript (rather than just json), and tried to sync up the webformat list between plugins that enable themselves for those.
2014-07-14 10:30:02 -04:00
* `g:autostartfiler`: **1** = Start the filer file manager when vim is run and the buffer is empty | **0** = Do nothing when vim is run and the buffer is empty (_default_: **1**)
* `g:autostartchecker`: **1** = Check syntax once an appropriate file is loaded | **0** = Check syntax only after syntax checking is toggled on (_default_: **0**)
* `g:autostarttagbar`: **1** = Have the tagbar load automatically when a compatible format is run | **0** = The tagbar will stay hidden until triggered on demand with its toggle (_default_: **0**)
autotags is enabled by default again, but with much better config
2014-08-25 00:43:41 -04:00
* `g:disableautotags`: **1** = Prevent tags from being automatically generated and highlighted | **0** = Automatically generate and highlight tags (_default_: **0**)
Syntastic doesn't check on :wq when disabled, and toggling active/passive also toggles check on open/wq. A new variable was added to prevent autochecking tags, and the README and update script were updated to reflect this. Disabling the linebreaks is now defaulted to off (flip it back on if you like it). The update script is a bit more careful about how it runs when executed from other directories. A bug preventing the g:disablelinebreaks variable from being possible to disable has been squashed, and no default is set when it's not enabled. Added Emmet javascript (rather than just json), and tried to sync up the webformat list between plugins that enable themselves for those.
2014-07-14 10:30:02 -04:00
* `g:disablelinebreaks`: **1** = Override filetype plugins so linebreaks never occur | **0** = Linebreaks are disabled by default, but filetype plugins can override this setting (_default_: **0**)
* `g:powerlinefonts`: **1** = Render the statusline using characters available with powerline-patched fonts | **0** = Render the statusbar with less attractive but more compatible characters available in all fonts (_default_: **0**)
Cleaned up the README a bit and added the autoswap plugin to better handle opening vim when a swapfile exists.
2014-04-21 08:17:31 -04:00
* **Custom Settings**: Settings with priority over those set by darkcloud-vimconfig can be added to a file named _vimrc.user_, located in _darkcloud-vimconfig/vim/_ or any of the folders in the runtimepath.
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
* **Custom Plugins**: Pathogen compatible plugins can be cloned or extracted to "darkcloud-vimconfig/vim/bundle.user/", or a folder named "bundle" or "bundle.user" in any of the folders in the runtimepath.
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
* **Custom Snippets**: To add or override Emmet snippets, create _~/.vim/snippets.json_ and add your own definitions using json like shown in the [Emmet Documentation](http://docs.emmet.io/customization/snippets/).
uploading gitmodules for gitgutter. tweaked the keybindings and settings for diff so its settings will be enabled by default when it's being used regardless of where it gets initiated, and won't be used at all when it's not initiated. Improved vimdiff settings in general. Improved the help popup tab (it's now sized exactly to the width of the help page). The theme now takes colour hex codes with or without #s at the start so they can be used with the coloresque plugin to show the colours while editing. The theme now considers gitgutter. vimdiff now uses <leader>> and <leader>< to make a change because I realized the current way was leading to changes being made when you reversed direction.
2014-04-07 10:04:48 -04:00
* **File Associations**: To use the file manager in vim to run files with external programs, create "~/.vim/filetypes.vim" and on each line, write an association between a file extension and the program to launch files of that type that looks like: `call vimfiler#set_execute_file('mp4','xdg-open')`.
Tweaked the update script to drop the user variables from vimrc into vimrc.user when it's created. a new user-based config file can be used to specify the location of the project folder without altering vimrc, if it's a symlink and bound to bump into conflicts as changes are made. The README was updated to reflect a few of the recent changes. The tagbar now outputs to the lightline statusline if there's anything to report. A new variable was added to choose whether to always start with the tagbar enabled if the format is compatible, or use the older behaviour, where it would only appear when triggered. The default is to enable it 24/7.
2014-04-08 03:39:10 -04:00
* **Update Script**: (requires: bash+git) Use this to update the project and submodules, as well as handle any required maintenance, generate docs from the pathogen plugins and create missing config scripts with preset values.
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
* **Generate System Tags**: (requires: bash+ctags) Generate a list of ctags for your system libraries in _/usr/include_ and _/usr/local/include_ as well as any folders passed as arguments by running the _gentags_ script.
## Mappings ##
### Mouse ###
conceal current line in normal mode for vimpager + tweak README
2014-10-26 11:13:07 -04:00
| Binding | Mode | Action |
|----------------------|------|----------------------------------------------|
| Ctrl+ScrollUp | ALL | Scroll right a few characters at a time |
| Ctrl+ScrollDown | ALL | Scroll left a few characters at a time |
| Alt+ScrollUp | ALL | Scroll right one character at a time |
| Alt+ScrollDown | ALL | Scroll left one character at a time |
| | | |
| MiddleClick | ALL | Select between the cursor and the mouse |
| Ctrl+LeftClick | ALL | Select between the cursor and the mouse |
| Alt+LeftClick | ALL | Select the line at the mouse |
| Ctrl+Alt+LeftClick | ALL | Select the paragraph at the mouse |
| | | |
| Ctrl+RightClick | ALL | Copy selection or character under the cursor |
| Ctrl+MiddleClick | ALL | Copy selection or character under the cursor |
| Alt+RightClick | ALL | Cut selection or character under the cursor |
| Alt+MiddleClick | ALL | Cut selection or character under the cursor |
| Ctrl+Alt+RightClick | ALL | Paste at the cursor |
| Ctrl+Alt+MiddleClick | ALL | Paste at the cursor |
| Shift+MiddleClick | ALL | Paste the contents of the xorg buffer |
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
### Keyboard ###
Played with keybindings to make them more consistent and logical and making room to add more complete spellcheck support via the custom bindings (starting with ?).
2014-06-25 02:47:29 -04:00
#### Sidebars ####
Reorganized and improved and added to the mappings, and updated the README with a few more.
2014-06-13 00:58:13 -04:00
Tweak sidebar keys again and remove cursor column for the tagbar
2015-03-10 07:27:53 -04:00
| Binding | Mode | Action |
|----------------------|------|-----------------------------------------------|
| F9 and Backslash+} | ALL | Toggle the **extradite** git history window |
| F10 and Backslash+{ | ALL | Toggle the **tagbar** source code tag sidebar |
| F11 and Backslash+\] | ALL | Toggle the **gundo** undo history sidebar |
| F12 and Backslash+\[ | ALL | Toggle **vimfiler** file manager sidebar |
Played with keybindings to make them more consistent and logical and making room to add more complete spellcheck support via the custom bindings (starting with ?).
2014-06-25 02:47:29 -04:00
#### Toggles ####
conceal current line in normal mode for vimpager + tweak README
2014-10-26 11:13:07 -04:00
| Binding | Mode | Action |
|-----------------|------|--------------------------------------------------|
| ~ | N | Popup a command list dialog |
| | | |
| F1 | ALL | Toggle line wrapping |
| F2 | ALL | Toggle highlighting of spelling mistakes |
| F3 | ALL | Toggle source code syntax checking |
| F4 | ALL | Toggle external-paste mode |
| | | |
| \` | N | Toggle gutter (left bar with line numbers etc.) |
Change sidebars to F9-F12 and use the same mappings for Ctrl/Alt+F-Keys
2015-02-27 05:46:46 -05:00
| Backslash+\` | N | Toggle the **goyo** distraction-free UI |
| Backslash+? | N | Toggle the **vim** reference manual |
Played with keybindings to make them more consistent and logical and making room to add more complete spellcheck support via the custom bindings (starting with ?).
2014-06-25 02:47:29 -04:00
#### Spell Check ####
conceal current line in normal mode for vimpager + tweak README
2014-10-26 11:13:07 -04:00
| Binding | Mode | Action |
|---------|------|-----------------------------------------------|
| ?+ | N | Add the selected word to the local dictionary |
| ?? | N | Show spelling suggestions for selected word |
| ?N | N | Go to the next spelling mistake |
| ?P | N | Go to the previous spelling mistake |
Tons of mapping issues fixed, re-add mkd table fmt, tweak keys+settings
2014-10-22 03:41:50 -04:00
#### Formatting ####
conceal current line in normal mode for vimpager + tweak README
2014-10-26 11:13:07 -04:00
| Binding | Mode | Action |
|----------|------|---------------------------------------------------------------|
| Leader+J | N+V | Format line/selected lines to a max width of the _textwidth_ |
| Leader+f | N+V | Format document/selection alignment using Vim syntax |
| Leader+F | N | Format based on file-type using Autoformat |
| Leader+F | N+V | (Markdown) Format table cursor is currently on |
| Leader+t | N | Convert all tabs into spaces and continue session with spaces |
| Leader+T | N | Convert all spaces into tabs and continue session with tabs |
| Leader+w | N | Remove all trailing whitespace |
| Leader+A | N+V | Align comments in document/selection |
| Leader+a | N+V | Align comments following non-comments in document/selection |
Tons of mapping issues fixed, re-add mkd table fmt, tweak keys+settings
2014-10-22 03:41:50 -04:00
#### GVim ####
conceal current line in normal mode for vimpager + tweak README
2014-10-26 11:13:07 -04:00
| Binding | Mode | Action |
|--------------|------|-----------------------|
| Backslash+F1 | ALL | Toggle the menubar |
| Backslash+F2 | ALL | Toggle the toolbar |
| Backslash+F3 | ALL | Toggle the scrollbars |
Reorganized and improved and added to the mappings, and updated the README with a few more.
2014-06-13 00:58:13 -04:00
A few more README tweaks
2014-06-13 01:14:33 -04:00
### Complete Reference ###
Added commandline argument support to the update script that includes options to display help and version information, as well as to disable colour output (with both English and American spellings of colour). Some minor changes to wording/style were also made in the title blocks and README.
2014-06-17 01:49:46 -04:00
For a complete list of mappings specific to **darkcloud-vimconfig**, check the list in the comments at the top of [vim/config/keyboard.vim](https://github.com/prurigro/darkcloud-vimconfig/blob/master/vim/config/keyboard.vim).
Updated info in the README as well as adding the mappings for mouse buttons and the list of plugins. Two extensions that never really got integrated into the config have been removed, so you should readd them to bundle.user if you use them. A lot of the keyboard config has changed, but most of that is just formatting; the additions are the new mouse button mappings, and the return of shift+middleclick to paste from X, which was accidentally removed at some point before. I also switched the default state of the syntax checker to off to avoid having people run into issues and not already know how to enable/disable it.
2014-04-18 05:12:35 -04:00
## Plugins ##
Added the autoformat module, an associated keybinding and an entry and list of new (optional) requirements it adds in the README, as well as making some general improvements to the README.
2014-05-29 11:02:23 -04:00
* [auto-autoformat](https://github.com/Chiel92/vim-autoformat): Provides easy code formatting in Vim by integrating existing code formatters.
Cleaned up the README a bit and added the autoswap plugin to better handle opening vim when a swapfile exists.
2014-04-21 08:17:31 -04:00
* [autoswap.vim](https://github.com/vim-scripts/autoswap.vim): Switch to open editor window instead of asking what to do with swapfile.
Added vim-easytags, set the tagfile to the one we've been using, included the vim-misc dependency and updated the README to reflect all this.
2014-07-14 09:24:38 -04:00
* [emmet-vim](https://github.com/mattn/emmet-vim): Support for expanding abbreviations.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [webapi-vim](https://github.com/mattn/webapi-vim): A web library used by emmet to provide support for custom snippets.
* [goyo.vim](https://github.com/junegunn/goyo.vim): Distraction-free writing in Vim.
Added vim-easytags, set the tagfile to the one we've been using, included the vim-misc dependency and updated the README to reflect all this.
2014-07-14 09:24:38 -04:00
* [gundo.vim](https://github.com/sjl/gundo.vim): Sidebar to visualize your undo tree and browse the differences of each change.
Added the incsearch plugin to the README
2014-10-19 14:03:33 -04:00
* [incsearch.vim](https://github.com/haya14busa/incsearch.vim): Improved incremental searching for Vim.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [lightline.vim](https://github.com/itchyny/lightline.vim): A light and configurable statusline/tabline for Vim.
* [MatchTagAlways](https://github.com/Valloric/MatchTagAlways): A Vim plugin that always highlights the enclosing html/xml tags.
* [neocomplcache.vim](https://github.com/Shougo/neocomplcache.vim): The '*ultimate*' auto-completion system for Vim.
Add the patchreview-vim plugin for vimdiff of changes a patch will make
2014-10-21 03:09:43 -04:00
* [patchreview-vim](https://github.com/junkblocker/patchreview-vim): A Vim plugin for doing single, multi-patch or diff code reviews.
Add the rename.vim plugin
2014-10-28 14:34:49 -04:00
* [rename.vim](https://github.com/danro/rename.vim): Rename the current file in the vim buffer + retain relative path.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [ReplaceWithRegister](https://github.com/vim-scripts/ReplaceWithRegister): Replace text with the contents of a register (for paste+replace without writing over the buffer).
* [SudoEdit.vim](https://github.com/vim-scripts/SudoEdit.vim): Read and write files without the necessary permissions through the use of sudo.
* [syntastic](https://github.com/scrooloose/syntastic): Uses system compilers and parsers to check syntax either on-the-fly or after saving a compatible document.
* [tabular](https://github.com/godlygeek/tabular): Vim script for text filtering and alignment.
* [tagbar](https://github.com/majutsushi/tagbar): Uses ctags to generate a sidebar of the tags for the current file.
Added the incsearch plugin to the README
2014-10-19 14:03:33 -04:00
* [tcommand_vim](https://github.com/tomtom/tcommand_vim): Select commands, menu items etc. from a list.
* [tlib_vim](https://github.com/tomtom/tlib_vim): Some utility functions for VIM.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [tcomment_vim](https://github.com/tomtom/tcomment_vim): File-type sensible comments that can be easily toggled on and off for blocks of text.
Improve organization of colorscheme definitions + add/configure vim-bookmarks
2014-10-28 15:33:37 -04:00
* [vim-bookmarks](https://github.com/MattesGroeger/vim-bookmarks): Bookmark or annotate lines and quickly navigate between them.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [vim-easytags](https://github.com/xolox/vim-easytags): Automated tag file generation and syntax highlighting of tags in Vim.
Improve organization of colorscheme definitions + add/configure vim-bookmarks
2014-10-28 15:33:37 -04:00
* [vim-misc](https://github.com/xolox/vim-misc): Miscellaneous auto-load Vim scripts required by vim-easytags.
Small non-functional touchup to the README
2014-07-30 02:53:05 -04:00
* [vim-extradite](https://github.com/int3/vim-extradite): A git commit browser extending vim-fugitive that displays differences and optionally loads old revisions.
* [vimfiler.vim](https://github.com/Shougo/vimfiler.vim): A curses-style file manager for vim that runs on it's own or in a sidebar and can associate handlers for file types.
* [unite.vim](https://github.com/Shougo/unite.vim): A library used by Vim Filer to help build its user interface.
* [vim-fixkey](https://github.com/drmikehenry/vim-fixkey): A set of keyboard mappings that override differences in different environments that might normally break consistency or compatibility.
* [vim-fugitive](https://github.com/tpope/vim-fugitive): A wrapper integrating git into vim in such a way as to provide features neither of them could offer on their own.
* [vim-move](https://github.com/matze/vim-move): Provides a few convenient ways to move selected text.
* [vim-pathogen](https://github.com/tpope/vim-pathogen): A plugin to load other plugins while keeping them isolated in their own directory structure rather than all dumped together.
* [vim-polyglot](https://github.com/prurigro/vim-polyglot): The darkcloud-vimconfig fork of a meta-package that attempts to provide the best syntax plugins for each file type.
* [vim-signify](https://github.com/mhinz/vim-signify): When a version controlled file is changed, this displays a column showing where and how, and allows for navigation to and between differences.
* [vim-surround](https://github.com/tpope/vim-surround): Provides functionality to exchange surrounding delimiters and xml-style tags with another, or simply remove them.
* [vim-repeat](https://github.com/tpope/vim-repeat): A library used by vim-surround to allow its delimiter-switching functions to be repeated with the `.` command.
* [vim-togglelist](https://github.com/milkypostman/vim-togglelist): Supplies toggle functions for the *location* and *error* lists, which are used by a number of plugins and normally require separate open and close commands.
* [vim-trailing-whitespace](https://github.com/bronson/vim-trailing-whitespace): Highlights and allows for the easy removal of trailing whitespace in documents.
Added new submodule vim-unimpaired
2014-10-27 14:39:47 -04:00
* [vim-unimpaired](https://github.com/tpope/vim-unimpaired): Pairs of handy bracket mappings.
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
## Credits ##
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Added commandline argument support to the update script that includes options to display help and version information, as well as to disable colour output (with both English and American spellings of colour). Some minor changes to wording/style were also made in the title blocks and README.
2014-06-17 01:49:46 -04:00
* By Kevin MacMartin: [GitHub Projects](https://github.com/prurigro?tab=repositories) | [Arch Linux AUR Packages](https://aur.archlinux.org/packages/?SeB=m&K=prurigro)
* The jellybean theme for Vim by [NanoTech](http://nanotech.nanotechcorp.net) was stripped down and used as a starting point to build the darkcloud theme included in this project.
Tons of mapping issues fixed, re-add mkd table fmt, tweak keys+settings
2014-10-22 03:41:50 -04:00
* The [vim-markdown](https://github.com/plasticboy/vim-markdown) plugin **TableFormat** command, used to format tables in markdown files, was pulled into [plugins.vim](https://github.com/prurigro/darkcloud-vimconfig/blob/master/vim/config/plugins.vim) from [ftplugin/mkd](https://github.com/plasticboy/vim-markdown/blob/master/ftplugin/mkd.vim).
Initial commit with a relatively well configured package (config, theme and plugins), and a README to explain the details
2014-02-20 23:24:20 -05:00
Tons of changes all in one commit because I'd broken a commit a while back and opted to simply reverse them all- Lots of colour changes, the update script now removes decommissioned bundles, gentags script can now have additional paths added to it when generating a tags file, README is much improved, fixed a few issues that required remapping some toggles, fixed a bunch of issues with the colourscheme between the terminal and gvim. You can now setup a custom config file to have loaded after the darkcloud-vimconfig ones, and there's a custom location for pathogen modules too, to make things tidier without necessarily needing to use an additional runtimepath. You can also create a file in your home directory to assign filetypes to programs, for use with the file manager. A file can be placed in ~/.vim/ with file associations and prorams to launch them with. The file manager will also open a file with vim by hitting shift+enter, since e isn't all that comfortablly placed. The vimrc can now also point to the darkcloud-vimconfig folder, rather than relying on the vim folder being in a specific location, and the after folder is now configured to work in the project too.
2014-04-04 19:49:02 -04:00
## License ##
Disabled linebreaks globally by default and added a variable to get them back. Added the linebreak variable and another one I'd missed before to the vimrc.user creation in the update script. Added a second general settings file called "after.vim" for settings that need to be loaded after everything else. Updated maintainer tag to my real name.
2014-06-04 03:18:29 -04:00
Added commandline argument support to the update script that includes options to display help and version information, as well as to disable colour output (with both English and American spellings of colour). Some minor changes to wording/style were also made in the title blocks and README.
2014-06-17 01:49:46 -04:00
Licensed under the [MIT license](http://opensource.org/licenses/MIT).
Reference in a new issue Copy permalink