aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authordacctal <dacctal@symlinx.net>2026-04-28 10:11:46 +0000
committerdacctal <dacctal@symlinx.net>2026-04-28 10:11:46 +0000
commitd42afdbcb29d07ac72e46ddc401951612df30d17 (patch)
tree422b20fece50c5d601c132513267af87cb4e7f7a /README.md
parent8d5b2b3b4d6149b338f90875f4217a278fad4676 (diff)
changed some display stuff and added simple template to README.md
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',
+ },
+}
+```