aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorgithub-actions[bot] <github-actions[bot]@users.noreply.github.com>2023-02-14 11:20:19 +0000
committerGiuseppe Gadola <giusgadola@gmail.com>2023-02-14 19:17:20 +0100
commite1c17bb7380357ae60a99d0cfd2b325d105d0e84 (patch)
tree238fe4b08c7baf9ffac5a750dfef1fe59bd638e7
parentchore: added auto-generate docs and check stylua actions (diff)
docs(help): auto generate docs
-rw-r--r--doc/pets.nvim.txt96
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: