diff options
| author | github-actions[bot] <github-actions[bot]@users.noreply.github.com> | 2023-02-14 11:20:19 +0000 |
|---|---|---|
| committer | Giuseppe Gadola <giusgadola@gmail.com> | 2023-02-14 19:17:20 +0100 |
| commit | e1c17bb7380357ae60a99d0cfd2b325d105d0e84 (patch) | |
| tree | 238fe4b08c7baf9ffac5a750dfef1fe59bd638e7 | |
| parent | chore: added auto-generate docs and check stylua actions (diff) | |
docs(help): auto generate docs
| -rw-r--r-- | doc/pets.nvim.txt | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/doc/pets.nvim.txt b/doc/pets.nvim.txt index e69de29..47d09ca 100644 --- a/doc/pets.nvim.txt +++ b/doc/pets.nvim.txt @@ -0,0 +1,96 @@ +*pets.nvim.txt* For NVIM v0.8.0 Last change: 2023 February 14 + +============================================================================== +Table of Contents *pets.nvim-table-of-contents* + +1. pets.nvim |pets.nvim-pets.nvim| + - βοΈ Configuration |pets.nvim-βοΈ-configuration| + - πΎ Available pets |pets.nvim-πΎ-available-pets| + +============================================================================== +1. pets.nvim *pets.nvim-pets.nvim* + +Pets.nvim is a plugin that provides the missing core functionality of showing +little animal friends inside your editor. It relies on the kitty graphics +protocol <https://sw.kovidgoyal.net/kitty/graphics-protocol/> and hologram.nvim +<https://github.com/edluffy/hologram.nvim> to be able to display images in a +terminal window. ## π¦ Installation Install with your favorite package +manager! Examples: + +With packer: + +> + use({ + "giusgad/pets.nvim", + config = function() + require("pets").setup({ + -- your options + }) + end, + requires = { + "edluffy/hologram.nvim", + "MunifTanjim/nui.nvim", + } + }) +< + + +With lazy: + +> + { + "giusgad/pets.nvim", + dependencies = { "MunifTanjim/nui.nvim", "edluffy/hologram.nvim" }, + config=true, + opts={ + -- your options + } + } +< + + +βοΈ CONFIGURATION *pets.nvim-βοΈ-configuration* + +This is the default configuration: + +> + { + row = 5, -- the row (height) to display the pet at + col = 0, -- the column to display the pet at (set to high number to have it stay still on the right side) + speed_multiplier = 1, -- you can make your pet move faster/slower. If slower the animation will have lower fps. + default_pet = "cat", -- the pet to use for the PetNew command + default_style = "brown", -- the style of the pet to use for the PetNew command + random = false, -- wether to use a random pet for the PetNew command, ovverides default_pet and default_style + } +< + + +πΎ AVAILABLE PETS *pets.nvim-πΎ-available-pets* + + +- cat: + - black + - red + - brown + - dark_grey + - light_grey + ## π Usage - commands + These are all the available commands: +- `PetsNew {name}`: creates a pet with the style and type defined by the configuration, and name {name} +- `PetsNewCustom {type} {style} {name}`: creates a new pet with type, style and name specified in the command +- `PetsList`: prints the names of all the pets that are currently alive +- `PetsKill {name}`: kills the pet with given name, which will immediately blink out of existence. Forever. +- `PetsKillAll`: kills all the pets, poor creatures. + ## β οΈ Limitations + This plugin relies on hologram.nvim <https://github.com/edluffy/hologram.nvim> to display the images, + and shares all of its limitations. Here are the most significant ones: +- Only works with terminal emulators that support the kitty graphics protocol <https://sw.kovidgoyal.net/kitty/graphics-protocol/> + To be more precise the only terminal I tested where I was able to have the protocol working correctly is kitty itself. +- Doesnβt currently work inside tmux + ## π Credits + All the beautiful cat assets were designed by SeethingSwarm <https://seethingswarm.itch.io/catset> + + +Generated by panvimdoc <https://github.com/kdheepak/panvimdoc> + +vim:tw=78:ts=8:noet:ft=help:norl: |