X-Git-Url: https://git.sthu.org/?p=vimconf.git;a=blobdiff_plain;f=README.md;h=43f7882f5f5e11bdf7e5461016a4233120182982;hp=6d316eab09a5d4b33ed2f97252dfc0c320fd18fd;hb=HEAD;hpb=d84fe6741f5f4e90439f8c6ac3cc03acf62b4cd1

diff --git a/README.md b/README.md
index 6d316ea..6f6760b 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,43 @@
 # A modular vim configuration
 
-This is my personal vim configuration that is partly inspired by SpaceVim. It
-is compatible to vim, gvim (8.0+) and neovim (0.2+). The configuration is split
-up into multiple files such that personal customization is separated from
-boilerplate code.
 
+<div class="hideonwebsite">
+This repository is a replication of the repository <a
+href="https://git.sthu.org/?p=vimconf.git;a=summary">here</a>. The <a
+href="https://www.sthu.org/code/codesnippets/vimconf.html">website</a> gives
+further details and more screenshots.
+</div>
+
+
+This is my personal vim configuration. The [git
+repo](https://git.sthu.org/?p=vimconf.git;a=summary) of this configuration is
+under constant flux, however, it should be compatible with (g)vim (8.0+) and
+neovim (0.2+), yet some features are only available with newer versions.
+
+![A demo screenshot](https://www.sthu.org/code/codesnippets/img/vimconf-startify.png)
+
+
+## Flavors on different machines
+
+I would like to use this configuration on a large variety of machines with
+different needs. To accommodate for this, the configuration is split up into
+multiple files and a different set of plugins is used:
+
+- In any case, the plugin set in `plugins-mini.vim` is loaded.
+- Furthermore, `plugins-midi.vim`, `plugins-full.vim` and `plugins-local.vim`
+  are loaded if present. They are provided as `plugins-xxx.vim.example` and you
+  can create a symlink `plugins-xxx.vim` to have them loaded. (In case of
+  `plugins-local.vim` you will probably provide a machine-dedicated version
+  rather than symlinking the example file.)
+
+Similar to `plugins-local.vim`, also the following files are sourced if
+existent:
+
+  - `macros-local.vim`
+  - `keymaps-local.vim`
+  - `init-local.vim`
+
+Example files are shipped with the repository.
 
 ## Installation
 
@@ -24,17 +57,20 @@ sudo apt-get install aspell aspell-de python3-pip
 pip3 install neovim
 ````
 
+Note that vim-tiny in Debian does not support python3, but vim-nox, vim-gtk3 or
+neovim does. You also want to make sure that you have curl and git installed.
+
 ### Clone & install
 
 If you already have a vim configuration in place then you may first move your
-~/.vim directory first
+`~/.vim` directory first
 
 ````
 mv ~/.vim ~/.vim-old
 ````
 
-Assumung that there is ~/.vim anymore, simply clone this repository into ~/.vim
-and invoke install.sh therein.
+Assuming that there is no `~/.vim` anymore, simply clone this repository into
+`~/.vim` and invoke `install.sh` therein.
 
 ````
 git clone https://git.sthu.org/repos/vimconf.git ~/.vim
@@ -42,21 +78,7 @@ git clone https://git.sthu.org/repos/vimconf.git ~/.vim
 ````
 
 This install script creates backups of existing configuration files (e.g.,
-~/.vimrc) and then creates symlinks to configuration files in ~/.vim.
-
-
-## Specialization for local machines
-
-I personally would like to have the same vim configuration on all my accounts.
-Still, on certain machines I would like to personalize and specialize the
-configuration. The following files are read if existent:
-
-  - plugins-local.vim
-  - macros-local.vim
-  - keymaps-local.vim
-  - init-local.vim
-
-Example files are shipped with the repository.
+`~/.vimrc`) and then creates symlinks to configuration files in `~/.vim`.
 
 
 ## Terminal color settings