Add initial docs

docs/plugins/battery.md

@@ -0,0 +1,18 @@
+# Battery
+
+Shows the amount of charge in the battery and if it is charging/discharging.
+
+## Add to wish
+
+```ini
+[plugin]
+name = battery
+```
+
+## Config options
+
+| Key         | Meaning                                  | Default |
+|-------------|------------------------------------------|---------|
+| id          | ID of Battery to check.                  | BAT0    |
+| charging    | Symbol while the battery is charging.    | ϟ       |
+| discharging | Symbol while the battery is discharging. | ⏚       |

docs/plugins/bgjobs.md

@@ -0,0 +1,15 @@
+# Background Jobs
+
+Shows the number of background jobs running
+
+## Add to wish
+
+```ini
+[plugin]
+name = bg_jobs
+```
+## Config options
+
+| Key    | Meaning                                     | Default |
+|--------|---------------------------------------------|---------|
+| suffix | Suffix to add to number of background jobs. | &       |

docs/plugins/customtext.md

@@ -0,0 +1,17 @@
+# Custom Text
+
+Display the provided custom text in the prompt.
+
+
+## Add to wish
+
+```ini
+[plugin]
+name = custom_text
+```
+
+## Config options
+
+| Key  | Meaning              | Default |
+|------|----------------------|:-------:|
+| text | Custom text to show. |    -    |

docs/plugins/date.md

@@ -0,0 +1,16 @@
+# Date
+
+Shows the current date and time.
+
+## Add to wish
+
+```ini
+[plugin]
+name = date
+```
+
+## Config options
+
+| Key    | Meaning                                                                         | Default |
+|--------|---------------------------------------------------------------------------------|---------|
+| format | set the date format. Refer to `FORMAT` section of  `man date` for more details. | %F %T   |

docs/plugins/exitcode.md

@@ -0,0 +1,15 @@
+# Exit Code
+
+Shows the exit code of the last command if it is non-zero.
+
+
+## Add to wish
+
+```ini
+[plugin]
+name = exit_code
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/exitcodesmiley.md

@@ -0,0 +1,19 @@
+# Exit Code Smiley
+
+Shows a happy/sad smiley face based on whether the last command ran successfully or not.
+
+
+## Add to wish
+
+```ini
+[plugin]
+name = exit_code_smiley
+```
+
+## Config options
+
+| Key          | Meaning                                                      | Default |
+|--------------|--------------------------------------------------------------|---------|
+| pass         | Text to show when the last command ran successfully.         | :)      |
+| fail         | Text to show when the last command failed.                   | :(      |
+| hide_on_pass | Whether to hide the output if command executes successfully. | 0       |

docs/plugins/hostname.md

@@ -0,0 +1,14 @@
+# Hostname
+
+Shows the current system's hostname.
+
+## Add to wish
+
+```ini
+[plugin]
+name = hostname
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/newline.md

@@ -0,0 +1,14 @@
+# Newline
+
+Adds a newline to prompt to push the next plugins into next line.
+
+## Add to wish
+
+```ini
+[plugin]
+name = newline
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/path.md

@@ -0,0 +1,17 @@
+# Path
+
+Shows the current path and whether it is writeable.
+
+
+## Add to wish
+
+```ini
+[plugin]
+name = path
+```
+
+## Config options
+
+| Key             | Meaning                                      | Default |
+|-----------------|----------------------------------------------|---------|
+| no_write_suffix | Suffix if the current path is not writeable. |        |

docs/plugins/path_powerline.md

@@ -0,0 +1,28 @@
+# Path Powerline
+
+Shows the current path and whether it is writeable.
+
+## Features
+
+- Powerline symbols used as path separators.
+- Long paths are shrunk down to allow for more space for other plugins.
+	- e.g. `/usr/lib/systemd/system/` might get shortened to one of the
+	  following based on config + screen width: `/u/l/s/system`,
+	  `/u/l/systemd/system` or `/u/lib/systemd/system`
+	- This is configurable and disabled by default (check `max_perc` config)
+	- Recommended value for `max_perc` is `50`
+
+
+## Add to wish
+
+```ini
+[plugin]
+name = path
+```
+
+## Config options
+
+| Key             | Meaning                                                      | Default      |
+|-----------------|--------------------------------------------------------------|--------------|
+| no_write_suffix | Suffix if the current path is not writeable.                 |             |
+| max_perc        | Maximum percentage of screen width path should take. (0-100) | 0 (disabled) |

docs/plugins/pythonvenv.md

@@ -0,0 +1,14 @@
+# Python Virtualenv
+
+Shows the currently active virtualenv. If the venv is `.venv`, it shows the parent directory's name.
+
+## Add to wish
+
+```ini
+[plugin]
+name = python_venv
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/space.md

@@ -0,0 +1,14 @@
+# Space
+
+Simple plugin that adds an empty space.
+
+## Add to wish
+
+```ini
+[plugin]
+name = space
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/tmux.md

@@ -0,0 +1,14 @@
+# Tmux Detached Sessions
+
+Lists the number of tmux sessions that are detached.
+
+### Add to wish
+```ini
+[plugin]
+name = vcs
+```
+## Config options
+
+| Key    | Meaning                                          | Default |
+|--------|--------------------------------------------------|---------|
+| suffix | suffix to add after number of detached sessions. | d       |

docs/plugins/username.md

@@ -0,0 +1,14 @@
+# Username
+
+Shows the current unix username
+
+## Add to wish
+
+```ini
+[plugin]
+name = username
+```
+
+## Config options
+
+No plugin specific config options are available.

docs/plugins/vcs.md

@@ -0,0 +1,24 @@
+# Version Control System (Git)
+
+Provides the state of the git repository in the current directory.
+
+## Features
+
+- Notifies if there are any untracked symbols
+- Name of the current branch
+- Amount of changes (additions/subtractions)
+
+## Add to wish
+
+```ini
+[plugin]
+name = vcs
+```
+
+## Config options
+
+| Key                  | Meaning                                                         | Default |
+|----------------------|-----------------------------------------------------------------|---------|
+| git_symbol           | Symbol to indicate that the current directory is a git repo.    |        |
+| default              | Symbol to display when the current directory is not a git repo. | $       |
+| git_untracked_symbol | Symbol to show if the current git repo has untracked files.     | ●       |