aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md47
1 files changed, 46 insertions, 1 deletions
diff --git a/README.md b/README.md
index aa9d4d0..fecffae 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,49 @@
modal is a status line colorizer for vis
-right now, it's very opinionated, but I will eventually add the ability to customize it \ No newline at end of file
+# Installation
+To install vis-modal, clone this repository in your `~/.config/vis/plugins/` directory
+Then, you can use it with the default configuration by putting this into your `~/.config/vis/visrc.lua`:
+```
+local modal = require('plugins/modal')
+```
+
+# Customization
+You can change the colors and mode descriptors in vis-modal to your liking, with this template:
+```
+local modal = require('plugins/modal')
+modal.MODES = {
+ [vis.modes.NORMAL] = ' NORMAL ',
+ [vis.modes.INSERT] = ' INSERT ',
+ [vis.modes.VISUAL] = ' VISUAL ',
+ [vis.modes.REPLACE] = ' REPLACE ',
+ [vis.modes.VISUAL_LINE] = ' VISUAL_LINE ',
+ [vis.modes.OPERATOR_PENDING] = ' OPERATOR_PENDING '
+}
+modal.STYLES = {
+ [vis.modes.NORMAL] = {
+ REGULAR = 'fore:default,back:yellow',
+ INVERTED = 'fore:yellow,back:black',
+ },
+ [vis.modes.INSERT] = {
+ REGULAR = 'fore:default,back:green',
+ INVERTED = 'fore:green,back:black',
+ },
+ [vis.modes.VISUAL] = {
+ REGULAR = 'fore:default,back:magenta',
+ INVERTED = 'fore:magenta,back:black',
+ },
+ [vis.modes.REPLACE] = {
+ REGULAR = 'fore:default,back:blue',
+ INVERTED = 'fore:blue,back:black',
+ },
+ [vis.modes.VISUAL_LINE] = {
+ REGULAR = 'fore:default,back:magenta',
+ INVERTED = 'fore:magenta,back:black',
+ },
+ [vis.modes.OPERATOR_PENDING] = {
+ REGULAR = 'fore:default,back:blue',
+ INVERTED = 'fore:blue,back:black',
+ },
+}
+```