From e1c17bb7380357ae60a99d0cfd2b325d105d0e84 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 14 Feb 2023 11:20:19 +0000 Subject: docs(help): auto generate docs --- doc/pets.nvim.txt | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) (limited to 'doc') 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 and 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 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 + 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 + + +Generated by panvimdoc + +vim:tw=78:ts=8:noet:ft=help:norl: -- cgit v1.3-2-g11bf