From 80d634bcae6f095849ae12b733dfe8d6dc5995e5 Mon Sep 17 00:00:00 2001 From: zbirenbaum Date: Fri, 22 Apr 2022 00:44:31 -0400 Subject: add README.md --- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..947c035 --- /dev/null +++ b/README.md @@ -0,0 +1,51 @@ +# NvChad Official Terminal Plugin + +## Setup: + +### Installation: + +Simply install the plugin with packer as you would for any other: + +``` +use { + "NvChad/chadterm", + config = function () + require("chadterm").setup() + end, +} +``` + +### Configuration: +Pass a table of configuration options to the plugin's `.setup()` function above. +A sample configuration table with the default options is shown below: + +```lua +require("chadterm").setup({ + terminals = { + list = {}, + type_opts = { + float = { + relative = 'editor', + row = 0.3, + col = 0.25, + width = 0.5, + height = 0.4, + border = "single", + }, + horizontal = { location = "rightbelow", split_ratio = .3, }, + vertical = { location = "rightbelow", split_ratio = .5 }, + } + }, + behavior = { + close_on_exit = true, + auto_insert = true, + }, + mappings = { + toggle = { + { '', function () terminal.new_or_toggle('float') end }, + { '', function () terminal.new_or_toggle('horizontal') end }, + { '', function () terminal.new_or_toggle('vertical') end }, + } + } +}) +``` -- cgit v1.2.3-70-g09d2